LAMMPS WWW Site - LAMMPS Documentation - LAMMPS Commands

### group command

Syntax:

    group ID style args

- ID = user-defined name of the group
- style = delete or region or type or id or molecule or subtract or union or intersect

        delete = no args
        region args = region-ID
        type or id or molecule
          args = one or more atom types, atom IDs, or molecule IDs
          args = logical value
            logical = "<" or "<=" or ">" or ">=" or "==" or "!="
            value = an atom type or atom ID or molecule ID (depending on style)
          args = logical value1 value2
            logical = "<>"
            value1,value2 = atom types or atom IDs or molecule IDs
            	(depending on style)
        subtract args = two or more group IDs
        union args = one or more group IDs
        intersect args = two or more group IDs

Examples:

    group edge region regstrip
    group water type 3 4
    group sub id <= 150
    group polyA molecule <> 50 250
    group boundary subtract all a2 a3
    group boundary union lower upper
    group boundary intersect upper flow
    group boundary delete

Description:

Identify a collection of atoms as belonging to a group. The group ID can then be used in other commands such as fix, compute, dump, or velocity to act on those atoms together.

If the group ID already exists, the group command adds the specified atoms to the group.

The delete style removes the named group and un-assigns all atoms that were assigned to that group. Since there is a restriction (see below) that no more than 32 groups can be defined at any time, the delete style allows you to remove groups that are no longer needed, so that more can be specified. You cannot delete a group if it has been used to define a current fix or compute or dump.

The region style puts all atoms in the region volume into the group. Note that this is a static one-time assignment. The atoms remain assigned (or not assigned) to the group even in they later move out of the region volume.

The type, id, and molecule styles put all atoms with the specified atom types, atom IDs, or molecule IDs into the group. These 3 styles can have their arguments specified in one of two formats. The 1st format is a list of values (types or IDs). For example, the 2nd command in the examples above puts all atoms of type 3 or 4 into the group named water. The 2nd format is a logical followed by one or two values (type or ID). The 7 valid logicals are listed above. All the logicals except <> take a single argument. The 3rd example above adds all atoms with IDs from 1 to 150 to the group named sub. The logical <> means "between" and takes 2 arguments. The 4th example above adds all atoms belonging to molecules with IDs from 50 to 250 (inclusive) to the group named polyA.

The subtract style takes a list of two or more existing group names as arguments. All atoms that belong to the 1st group, but not to any of the other groups are added to the specified group.

The union style takes a list of one or more existing group names as arguments. All atoms that belong to any of the listed groups are added to the specified group.

The intersect style takes a list of two or more existing group names as arguments. Atoms that belong to every one of the listed groups are added to the specified group.

A group with the ID all is predefined. All atoms belong to this group. This group cannot be deleted.

Restrictions:

There can be no more than 32 groups defined at one time, including "all".

Related commands:

dump, fix, region, velocity

Default:

All atoms belong to the "all" group.