ChimeraX docs icon

Command: sym

Usage:
sym  model-spec

Usage:
sym  model-spec   assembly  identifier   copy-options

Usage:
sym  model-spec   sym-typeaxis  axis ] [ center  center ] [ coordinateSystem  N ]  copy-options

Usage:
sym clear  model-spec

The sym command generates symmetry copies of an atomic model. The command sym clear removes all graphical clones from the specified model(s), but not any copies that were opened as full atomic models. See also: open, close, fitmap, view, surface, Cage Builder

Assemblies from mmCIF
User-Specified Symmetry
Copy Representation Options

Assemblies from mmCIF

Usage: sym  model-spec
Usage: sym  model-spec   assembly  identifier   copy-options

Given without options, sym reports any assemblies read from mmCIF for the specified model as a table in the Log. Similar information is shown automatically when the structure is first opened. The table gives a brief description of each assembly and a character-string identifier, usually a number, that can be clicked to generate the assembly (with default options) and adjust the view to encompass it.

By default, the additional copies are simply graphical clones; however, for detailed analyses such as calculating hydrogen bonds for the whole assembly, the sym command should be used with copies true to add full atomic copies instead. The assembly of interest is specified with the identifier mentioned above.

User-Specified Symmetry

Usage: sym  model-spec   sym-typeaxis  axis ] [ center  center ] [ coordinateSystem  N ]  copy-options

Alternatively, symmetry information can specified explicitly in the command. The sym-type can be:

The axis option specifies axis of symmetry (default z), where axis can be: The center option specifies center of symmetry (default 0,0,0), where center can be: The coordinateSystem option specifies a reference model (default is the atomic model containing the specified atoms) by model number N preceded by #. The reference coordinate system is used for interpreting specifications of axis and center of symmetry.

Copy Representation Options

newModel  true | false
The newModel option indicates whether to open the assembly as a new model (default true for assemblies from mmCIF, default false for user-specified symmetry). In addition, copies true automatically sets newModel true. When an assembly is opened as a new model, the original atomic model is hidden but not closed; the original state can be restored by closing the new model and showing (with target m) the original model. An advantage of opening the assembly as a new model is that any parts of the original asymmetric unit that are not part of the specified assembly will be deleted from that model, not merely hidden as they would be with newModel false. Parts that are merely hidden could be displayed inadvertently and cause confusion later.
copies  true | false
The copies option indicates whether the additional copies needed to reconstitute the assembly should be opened as full atomic models (true) or as graphical clones (false, default). Graphical clones of an atomic model cannot be displayed in different styles and colors than the original. Generating full atomic models instead of graphical clones allows their independent control and is required for more detailed analyses such as calculating hydrogen bonds for the whole assembly. However, it requires more memory and may not be practical for larger assemblies.

With newModel true but copies false, the new model will contain at least one full atomic copy, but the remainder will be graphical clones. The command sym clear removes all graphical clones from the specified model(s),

Even when both copies and newModel are false, one or more copies of the full atomic model may be added, namely when the assembly specifies different sets of matrices for different chains. In that case, restoring the original state may require not only using sym clear but also closing the added model(s) and showing all chains of the original copy (some chains may have been hidden when the assembly was shown).

surfaceOnly  true | false
For a simple appearance and economical use of memory, surfaceOnly true (default false) indicates calculating per-chain surfaces for the original structure and then showing only surfaces for the copies. The surfaces can be created as graphical clones, or if copies is also used, as molecular surface models that can be displayed and colored independently of one another (along with their underlying full atomic data). The surface calculation is the same as for the surface command with default parameters:

UCSF Resource for Biocomputing, Visualization, and Informatics / July 2017