Atoms, residues, and molecule models have attributes
(properties) that can be created:
Attribute values can be rendered visually
(Render by Attribute,
and used in
specification and selection
(Select by Attribute).
The values of atom attributes can be displayed as atom labels (for example,
- automatically by Chimera:
- arbitrarily with Define Attribute
(see also setattr)
- by combining other attributes using the
- with various other Chimera tools; for example, the following create
Define Attribute allows assignment of attribute values to
atoms, residues, and models. New attributes can be created or values
(re)assigned for existing attributes.
Define Attribute is also implemented as the command
There are several ways to start
Define Attribute, a tool in the Structure Analysis category.
Starting Define Attribute brings up a dialog for
an input attribute assignment file.
One or more molecule models should be chosen from
the Restrict to models list; only these will be considered
during attribute assignment. Individual models
or blocks of models can be chosen with the left mouse
button. Ctrl-click toggles the status of an individual model.
To choose a block of models without dragging,
click on the first (or last) and then Shift-click
on the last (or first) in the desired block.
OK performs the assignment and dismisses the dialog,
whereas Apply performs the assignment without dismissing the dialog.
Close simply dismisses the dialog. Help opens
this manual page in a browser window.
- Open Render/Select by Attribute - whether to open the
Render/Select by Attribute tool
after assigning attribute values. Even when this option is off,
the attribute(s) will be available within the
by Attribute tool if it is opened later in the session.
- Send match info to Reply Log - whether to send details
about the attribute assignments to the
Assignments can only affect molecule models that are open when
the attribute is defined/assigned.
For example, atoms in models opened after radii have been
assigned by element will have the
not the element-based ones.
Examples are provided below.
A hash symbol # at the beginning of a line indicates a comment.
Basic properties of an attribute are described
in control lines of the form:
Possible control line contents:
|alphanumeric string without spaces;
can include underscores; cannot begin with a digit, underscore,
or capital letter
||attribute name, existing or new
|expected matches per
(an error message will be sent to the
when a line's match behavior differs from the match mode)
|level of attribute assignment
The attribute assignments are described in
Any kind of
specification can be used.
Control lines and comments
can be interspersed with assignment lines.
However, if multiple attributes are defined in the same file, the
attribute control line should precede all other
lines for the corresponding attribute.
Allowed attr-value types are:
New numerical attributes will appear in the attribute lists of
Render/Select by Attribute;
boolean and string attributes will be listed only in the
Select by Attribute
portion; color attributes will not be listed.
- real number (float)
- boolean (true or false, case-independent)
- color - an attribute whose name
ends with color (case-independent) will be interpreted as
a color-valued attribute. A color value can be expressed as:
- a color name (a
or one defined previously with
- RGBA values, four space-separated numbers each ranging from 0 to 1
(inclusive) that represent the red, green, blue, and opacity
components of the color; if the last number is omitted, the opacity is
set to 1 (completely opaque)
- string - a string of any characters except tabs;
values that might be interpreted as one of the other types
should be enclosed in double quotes
creates a new residue attribute, percentExposed, and assigns
values previously calculated by
Getarea for the protein structure 121p.
The figure at the top of the page was generated
by opening the structure, defining the attribute, and then using
Render by Attribute
to color the structure and render it as a worm. Atoms are undisplayed
except for the ligand (yellow spheres).
assigns atomic radii, i.e., sets values for the existing
radius. The first specification in the file is #, which
assigns a value to all atoms. Subsequent lines
reassign the radii of atoms of particular elements.
Remember that atoms in models opened after the assignment
will have the default radii
instead of those in midasrad.txt.
- rescol.txt sets values for the existing
color and the existing
ribbonColor according to amino acid type.
Non-amino-acid residues are colored dark gray.
The colors are specified with
Note that the same results can be achieved with a Chimera
creates a new residue attribute, wwHydrophobicity, with values
according to the "interface"
hydrophobicity scale of
Wimley and White (literature reference provided in the file).
creates a new residue attribute, hhHydrophobicity, with values
according to the "biological"
hydrophobicity scale of
Hessa et al. (literature reference provided in the file).
UCSF Computer Graphics Laboratory / August 2006