The following commands are intended for supplying state information to a program that is controlling Chimera remotely via tools such as ReadStdin and RESTServer.

• listen
• listmodels
• listchains
• listphysicalchains
• listresidues
• listatoms
• listselection
• sequence

The listen command tells Chimera to start or stop generating notifications when certain events take place; what may be models or selection. Example: listen start models

If what is models, then the events of interest are the addition or removal of a model. Each notification message is prefixed with prefix (default ModelChanged). Typical messages are:

ModelChanged: add model #0
ModelChanged: remove model #0

If what is selection, then the event of interest is a change in selected items. Each message is prefixed with prefix (default SelectionChanged). A typical message is:

SelectionChanged: selection changed

Normally, notification messages are sent to stdout. If URL is specified, then the messages are sent to the given URL with the message encoded as parameter chimeraNotification.

The listmodels command reports the value of an attribute for models. Information is sent to the Reply Log. By default, the name attribute is reported for all models. If spec is given, only models containing the specified atoms are reported. If type is given, only models with the matching type are reported. Common types include molecule, msmsmodel surfacemodel and vrmlmodel. If attribute is given, the value for attribute_name is reported instead of the model name.

The listchains command reports the value of an attribute of chains. Information is sent to the Reply Log. By default, the chain attribute is reported for all chains in all molecule models. If spec is given, only chains in models containing the specified atoms are reported. If attribute is given, the value for attribute_name is reported instead of chain.

The listphysicalchains command reports the starting and ending sequence numbers for physically connected chains (no missing residues). Information is sent to the Reply Log. By default, all chains in all molecule models are reported. If spec is given, only chains in models containing the specified atoms are reported.

The listresidues command reports the value of an attribute of residues. Information is sent to the Reply Log. By default, the type attribute is reported for all residues in all molecule models. If spec is given, only residues containing the specified atoms are reported. If attribute is given, the value for attribute_name is reported instead of type.

The listatoms command reports the value of an attribute of atoms. Information is sent to the Reply Log. By default, the idatmType attribute is reported for all atoms in all molecule models. If spec is given, only the specified atoms are reported. If attribute is given, the value for attribute_name is reported instead of idatmType.

The listselection command reports the value of an attribute for items that are currently selected. Information is sent to the Reply Log. The granularity determines which items are reported. Supported values are atom (default), residue, chain and molecule. The mode may be either any (default) or all. If any, items with any selected subitems are reported; if all, only items whose subitems are all selected are reported. For example, with any a residue of five atoms will be reported if any of the five atoms are selected; with all, all five atoms must be selected for the residue to be reported. If attribute is given, the value for attribute_name is reported instead of the default, which is idatmType for atoms, type for residues, chain for chains, and name for molecules.

The sequence command displays the Sequence dialog for all chains containing the specified atoms.