Usage:
setattr ( a | r | m | M | b | p | g | s )  attr_name  attr_value  atom-spec

Usage:
~setattr ( a | r | m | M | b | p | g | s )  attr_name

The command setattr sets an attribute (existing or new) to a specified single value. The attribute may remain multi-valued, however, as the assignment may affect only a subset of the entities with the attribute. To assign multiple values simultaneously, use defattr. For attr_name (attribute name) lookup, see the balloon help of attribute inspector dialogs (more...).

Although setattr does not contain restrictions on which attributes can be affected, it may not make sense to change certain attributes. It is possible, however, to set an attribute that is also used in the atom-spec because the specification will be evaluated before the attribute value is changed.

The attribute level can specified as:

• a (atom) - set the value for all atoms in atom-spec (see atom attributes)
• r (residue) - set the value for all residues with any atoms in atom-spec (see residue attributes)
• m (molecule model) - set the value for all molecule models with any atoms in atom-spec (see molecule model attributes)
• M (Models of all relevant types) - set the value for all specified models that can have the attribute (for example, the text-valued attribute note is an annotation that can be shown for any type of model in the Model Panel)
• b (bond) - set the value for all bonds with both flanking atoms in atom-spec
• p (pseudobond) - set the value for all pseudobonds with both flanking atoms in atom-spec
• g (pseudobond group) - set the value for all pseudobond groups containing pseudobonds with both flanking atoms in atom-spec (see the pseudobond group attributes panel)
• s (surface) - set the value for the specified molecular surface models (see the molecular surface attributes panel). Molecular surface attributes include:
  • probeRadius
  • (vertex) density
  • allComponents (true or false) - whether to include multiple disconnected parts such as interior bubbles
  For other (nonmolecular) surface models, see the command sop.

If the attribute already exists, attr_value should be of the appropriate type. Allowed attribute types:

• real number (float)
• integer
• boolean - true or false, case-independent, or 0 or 1
• color - none or any color name that specifies a single color
• string - a string of any characters except tabs; strings with spaces, or that might be interpreted as one of the other attribute types, should be enclosed in single or double quotation marks, and adjacent quotation marks "" are needed to set the value to an empty string

The ~setattr command deletes the attribute entirely.

Examples:

setattr a label "pick me!" element.S

setattr s density 5.0

setattr r isHelix false :30-45.a

setattr p color hot pink ions za<5

setattr g lineWidth 3