Skip to content

SYMMETRY Symmetry Group Input

SYMMETRY: Symmetry Group Input

The SYMMETRY directive is used (optionally) within the compound GEOMETRY directive to specify the point group for the molecular geometry or space group for the crystal structure. The general form of the directive, as described above within the general form of the GEOMETRY directive, is as follows:

   [SYMMETRY [group] <string group_name>|<integer group number> \
   [setting <integer setting>] [print] \  
          [tol <real tol default 1d-2>]]

The keyword group is optional, and can be omitted without affecting how the input for this directive is processed. However, if the SYMMETRY directive is used, a group name must be specified by supplying an entry for the string variable <group_name> or <group number>. The latter is useful for the space groups discussed in the section below. The group name should be specified as the standard Schöflies symbol. Examples of expected input for the variable group_name include such entries as:

  • c2v - for molecular symmetry C2v
  • d2h - for molecular symmetry D2h
  • Td - for molecular symmetry Td
  • d6h - for molecular symmetry D6h

The SYMMETRY directive is optional. The default is no symmetry (i.e., C1 point group). Automatic detection of point group symmetry is available through the use of autosym in the GEOMETRY directive main line (discussed in Keywords for the GEOMETRY directive). Note: if the SYMMETRY directive is present the autosym keyword is ignored.

If only symmetry-unique atoms are specified, the others will be generated through the action of the point group operators, but the user if free to specify all atoms. The user must know the symmetry of the molecule being modeled, and be able to specify the coordinates of the atoms in a suitable orientation relative to the rotation axes and planes of symmetry. The section Geometry Examples lists a number of examples of the GEOMETRY directive input for specific molecules having symmetry patterns recognized by NWChem. The exact point group symmetry will be forced upon the molecule, and atoms within 10−3 A.U. of a symmetry element (e.g., a mirror plane or rotation axis) will be forced onto that element. Thus, it is not necessary to specify to a high precision those coordinates that are determined solely by symmetry.

The keyword print gives information concerning the point group generation, including the group generators, a character table, the mapping of centers, and the group operations.

The keyword tol relates to the accuracy with which the symmetry-unique atoms should be specified. When the atoms are generated, those that are within the tolerance, tol, are considered the same.