The Render/Select by Attribute interface performs several functions related to attributes: Attributes of atoms, residues, molecule models, and segmentation regions are handled.

Render by Attribute Render by Attribute icon

Render by Attribute can show attribute values with colors, atomic radii, or worms (modified ribbons):

Colors Radii Worms
residue mavConservation (AL2CO) alpha-carbon bfactor residue kdHydrophobicity

There are several ways to start Render by Attribute, a tool in the Depiction and Structure Analysis categories. See also: Select by Attribute, Define Attribute, rangecolor, Values at Atom Positions, Surface Color, Coulombic Surface Coloring, Color Actions, examples on the Chimera website: Mapping Sequence Conservation, Coloring by NMR Chemical Shift Perturbation

The first step is to indicate whether attributes of atoms, residues, molecules (molecule models), or map segmentation regions will be used. Next, the Models and Attribute of interest should be chosen.

The Models list includes all open models of the appropriate type. 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.

The available attributes (those of the chosen models) are listed in a pulldown menu. Only numerical attributes are available for rendering. These may include:

Custom (user-defined) attributes of atoms, residues, and molecule models can be created: Custom attributes of segmentation regions can be created arbitrarily with the Region Attributes dialog.

The name of an (atom, residue) attribute controls whether it is automatically available as an average or total at the next higher level (residue, model). If area, charge, or volume is a component of the name, the attribute will be totaled; if not, it will be averaged. Name components are indicated with underscores or camel-caps. For example, the components of my_charge are my and charge; the components of voronoiVolume are voronoi and volume.

If Render/Select by Attribute was opened before values were assigned for some attribute, the new attribute can be listed using Refresh... Menus. When attribute values have been changed or parts of the chosen models have been deleted, the display can be updated with Refresh... Values. The data will refresh automatically, however, when the set of chosen models is changed.

Once an attribute has been chosen, a histogram of the corresponding values is shown. Histogram bar heights are logarithmic by default, but can be changed to linear (and back) with the Scaling menu.

Thresholds for defining the interpolation function (for Colors, Radii, or Worms) are shown as vertical bars on the histogram. Clicking on a threshold shows its Value in black. Clicking elsewhere within the histogram shows the Value (X-coordinate) of the mouseclick in gray. A threshold can be moved by changing its Value and then pressing Enter (return) or by dragging it horizontally with the left mouse button. Holding the Shift key down reduces the speed (mouse sensitivity) of threshold dragging tenfold, allowing finer control. Thresholds can be added by Ctrl-clicking with the left mouse button on the histogram. Ctrl-clicking on an existing threshold deletes it.

The rendering can be restricted to the current selection (Restrict OK/Apply...). OK performs the rendering and dismisses the dialog, whereas Apply performs the rendering without dismissing the dialog. Close simply dismisses the dialog. Help opens this manual page in a browser window.

Colors

Atoms and surfaces (molecular, VDW) can be colored by atom, residue, or molecule model attribute values; ribbons can be colored by residue or molecule model attribute values; segmentation regions can be colored by segmentation region attribute values. Each threshold or vertical bar on the histogram has a Value (position on the histogram) and a Color. Together, the thresholds specify how colors map to values. Thresholds can be moved, added, or deleted as described above, and their colors can be changed:

An attribute value is compared to the thresholds on the histogram. Color is defined by red, green, blue and opacity/transparency components. The color of the closest threshold at a lower value (to the left) and the color of the closest threshold at a higher value (to the right) are linearly interpolated. Items with attribute values less than the leftmost threshold are colored according to the leftmost threshold, while items with attribute values greater than the rightmost threshold are colored according to the rightmost threshold. The Keep opaque options for atom and ribbon coloring indicate that any transparency in the color definitions should be ignored.

There may be cases where the atoms (residues, molecule models) have no value for the chosen attribute. For example, nucleic acid residues do not have kdHydrophobicity values, and residues not associated with a position in a sequence alignment open in Multalign Viewer do not have mavPercentConserved values. In these cases, the No-value color (also shown in a color well) applies.

Create corresponding color key opens the Color Key dialog and populates it with the current colors and values; a color key can then be created interactively with the mouse.

alpha-carbon bfactor

Radii

Atom radii can be assigned according to atom, residue, or molecule model attribute values. The Atom style controls which draw mode will be used for the affected atoms (ball or sphere). Ball radius equals atom radius multiplied by a molecule model's ball scale factor, whereas sphere radius is the same as atom radius.

Besides a Value (position on the histogram), each threshold has an associated Atom radius, expressed in Å. The Atom radius value corresponds to the threshold most recently moved or clicked and can be adjusted by entering a different number.

The thresholds define a function that maps attribute values to atom radii. For each atom (residue, molecule model) the attribute value is compared to the thresholds on the histogram. The atom radius of the closest threshold at a lower value (to the left) and the atom radius of the closest threshold at a higher value (to the right) are linearly interpolated. Atoms (or atoms within residues or models) with attribute values less than the leftmost threshold are assigned the atom radius of the leftmost threshold, while those with attribute values greater than the rightmost threshold are assigned the atom radius of the rightmost threshold.

When there are atoms (residues, molecule models) with no value for the chosen attribute: if Affect no-value atoms is true, atoms (or atoms within residues or models) with no value will be assigned the No-value radius. Otherwise, the radii of these atoms will not be changed.

Radii can be returned to their default values with the command ~vdwdefine.

residue kdHydrophobicity

Worms

Worms are similar to the “sausage” or “putty” representations in other graphics programs, where fatness (radius) shows the attribute values of residues or molecule models. Worms are actually ribbons with a special scaling based on attribute values instead of secondary structure. Rendering as worms displays a ribbon for the affected residues in the style named rounded with the special scaling. Like other ribbons, worms can be shown only for amino acid and nucleic acid residues bonded to at least one other residue. The Worm style controls whether the radius is smoothed continuously along the ribbon (smooth) or changes abruptly for each residue (segmented). To obtain standard, secondary-structure-dependent ribbons after rendering as worms, it is necessary to render again with the Worm style set to non-worm.

Besides a Value (position on the histogram), each threshold has an associated Worm radius, expressed in Å. The Worm radius value corresponds to the threshold most recently moved or clicked and can be adjusted by entering a different number.

The thresholds define a function that maps attribute values to worm radii. For each residue (or molecule model) the attribute value is compared to the thresholds on the histogram. The worm radius of the closest threshold at a lower value (to the left) and the worm radius of the closest threshold at a higher value (to the right) are linearly interpolated. Residues (or residues within models) with attribute values less than the leftmost threshold are assigned the worm radius of the leftmost threshold, while those with attribute values greater than the rightmost threshold are assigned the worm radius of the rightmost threshold.

When there are residues (or molecule models) with no value for the chosen attribute: if Affect no-value residues is true, residues (or residues within models) with no value will be shown as worms with the No-value worm radius, unless the Worm style is non-worm. Rendering with the non-worm style restores the standard ribbon for all affected residues.

Select by Attribute

Select by Attribute allows selection of atoms, residues, molecule models, and map segmentation regions by their attribute values. It can be opened by choosing By Attribute Value... from the Chimera Select menu or Structure... Select by Conservation from the menu in in Multalign Viewer. See also: Render by Attribute

One must choose one or more models and then one of the attributes available for the chosen models. These may include the numerical attributes available for rendering plus various string-valued and boolean attributes assigned by Chimera or defined by the user. Some examples:

Once an attribute has been chosen, a histogram (if numerical), list (if character strings), or set of checkbox options (if boolean) of the corresponding values is shown. The data can be refreshed after new attributes have been added, attribute values have been changed, or parts of the chosen models have been deleted.

OK performs the selection and dismisses the dialog, whereas Apply performs the selection without dismissing the dialog. Close simply dismisses the dialog. Help opens this manual page in a browser window.

Saving Attributes

An attribute and its associated values can be saved to an attribute assignment file by choosing File... Save Attributes from the menu of Render/Select by Attribute.

The attribute to save, its level (atoms, residues, molecules, or segmentation regions*) and the model(s) to include should be chosen from the menus in the resulting save dialog. Additional options:

* Files for segmentation regions are mainly informational, as they cannot be used to assign attributes (Define Attribute only handles atoms, residues, and molecule models).
UCSF Computer Graphics Laboratory / December 2017