LIGGGHTS(R)-PUBLIC WWW Site - LIGGGHTS(R)-PUBLIC Documentation - LIGGGHTS(R)-PUBLIC Commands

### partition command

Syntax:

    partition style N command ...

- style = yes or no
- N = partition number (see asterisk form below)
- command = any LIGGGHTS(R)-PUBLIC command

Examples:

    partition yes 1 processors 4 10 6
    partition no 5 print "Active partition"
    partition yes *5 fix all nve

Description:

This command invokes the specified command on a subset of the partitions of processors you have defined via the -partition command-line switch. See Section_start 6 for an explanation of the switch.

Normally, every input script command in your script is invoked by every partition. This behavior can be modified by defining world- or universe-style variables that have different values for each partition. This mechanism can be used to cause your script to jump to different input script files on different partitions, if such a variable is used in a jump command.

The "partition" command is another mechanism for having as input script operate differently on different partitions. It is basically a prefix on any LIGGGHTS(R)-PUBLIC command. The commmand will only be invoked on the partition(s) specified by the style and N arguments.

If the style is yes, the command will be invoked on any partition which matches the N argument. If the style is no the command will be invoked on all the partitions which do not match the Np argument.

Partitions are numbered from 1 to Np, where Np is the number of partitions specified by the -partition command-line switch.

N can be specified in one of two ways. An explicit numeric value can be used, as in the 1st example above. Or a wild-card asterisk can be used to span a range of partition numbers. This takes the form "*" or "*n" or "n*" or "m*n". An asterisk with no numeric values means all partitions from 1 to Np. A leading asterisk means all partitions from 1 to n (inclusive). A trailing asterisk means all partitions from n to Np (inclusive). A middle asterisk means all partitions from m to n (inclusive).

Restrictions: none

Related commands: none

Default: none