Ribbon Style Editor

Barstar (1bta) ribbon with Chimera default scaling in the style named aitch

Ribbon Style Editor allows ribbon scalings, styles, and residue classes to be edited directly and/or named and saved for subsequent use.

Ribbons for peptides, proteins, and nucleic acids can be displayed using the command ribbon or Actions... Ribbon... show. Ribbon style can be switched with ribrepr or Actions... Ribbon... style-name. Ribbon scaling can be switched with ribscale.

There are several ways to start Ribbon Style Editor, a tool in the Depiction category. It has three panels shown as index cards:

• Scaling
• Cross Section
• Residue Class

SCALING

The scaling of a ribbon is its secondary-structure-specific dimensions. Named scalings can be accessed with the command ribscale.

Known problem: reassigning secondary structure (for example, by using ksdssp) sets the scaling of some residues to Chimera default; any other scalings previously in effect need to be reapplied.

In the Scaling panel of the Ribbon Style Editor, changes can be entered directly, or the arrows on either side of a field can be clicked to increase or decrease the value by 0.05-angstrom increments. Only values greater than zero are allowed. Changes will not take effect until either Apply or OK is clicked; OK also dismisses the panel. Restrict OK/Apply... allows the scaling to be applied to only the current selection. If a scaling has been named, it can also be applied using the command ribscale.

If a ribbon were laid out on a flat surface, width would be the dimension parallel to the surface but perpendicular to the long axis of the ribbon, and height would be the dimension normal to the surface. The Width and Height values are doubled to give the maximum ribbon dimensions (the dimensions mapped to the cross-section grid). For example, with any of the built-in styles, a Width of 0.9 yields a ribbon 1.8 Å wide.

Nucleic acid structures are shown with the Nucleic ribbon. For proteins, Helix and Sheet assignments are taken from the input structure file or generated with ksdssp; the remainder is shown as Coil. Strands (the Sheet segments) are shown by default as arrows pointing in the C-terminal direction. To also show helices as arrows, see below. Setting the Arrow (tip) and Arrow (base) widths the same as the Sheet width turns off the arrows. The scaling named licorice is effectively independent of helix/strand assignments because all widths are the same and all heights are the same.

The settings in the Scaling panel collectively define a scaling, which can be named, saved, and later retrieved from the pulldown list indicated by the solid black triangle next to the Ribbon Scaling field. When the name of a built-in scaling (Chimera default or licorice) is shown, it is only possible to save to a different name, using Save As.... When another name is shown, it is possible to:

• Save the scaling to the name shown
• use Save As... to save the scaling to a new name
• Delete the scaling whose name is shown (if previously saved)

The Arrow parameters apply only to strands, not helices. To show arrowheads at the ends of helices, the workaround is to reassign the helices as strands. This can be done with commands something like:

Command: select helix
Command: setattr r isStrand true sel
Command: setattr r isHelix false sel
Command: ~select

Custom style "aitch"

CROSS SECTION

The style of a ribbon is defined by its cross section (general shape perpendicular to the long axis) and how the cross section is smoothed. Named styles can be accessed with the command ribrepr and from the Actions... Ribbon menu.

In the Cross Section panel of the Ribbon Style Editor, a cross-section can be defined by placing points on a grid. The Number of grid divisions can be adjusted as needed for the complexity of the desired cross-section. A ribbon with a particular cross-section is subject to whichever scaling is in effect. The extent of the grid X-axis equals the width and the extent of the grid Y-axis equals the height. Using the built-in styles as examples:

• the edged (sharp) style corresponds to a square outlining the grid; when width differs from height, the cross-section is "squashed" to a rectangle
• the flat (ribbon) style corresponds to a horizontal line bisecting the grid; only the width matters, as this style has no height
• the rounded (round, smooth) style corresponds to the largest circle that fits in the grid; when width differs from height, the cross-section is "squashed" to an oval
• the supersmooth style is the same as rounded, except that its cross section is defined with a greater number of points (useful when generating raytraced images)

A style is further defined by Display Options:

• Closed cross section - close the cross section automatically as it is being drawn on the grid (a line will connect the first and last points drawn); unnecessary if the closing line is created manually
• Smooth across ribbon - slightly round the corners of the cross section when drawing the ribbon
• Smooth along ribbon - generate a ribbon that flows smoothly from one residue to another (as opposed to a ribbon with obvious residue segmentation)

The settings in the Cross Section panel collectively define a style, which can be named, saved, and later retrieved from the pulldown list indicated by the solid black triangle next to the Ribbon Cross Section field. When the name of a built-in style is shown, it is only possible to save to a different name, using Save As.... When another name is shown, it is possible to:

• Save the style to the name shown
• use Save As... to save the style to a new name
• Delete the style whose name is shown (if previously saved)

RESIDUE CLASS

A ribbon residue class is defined by which atoms control the path of the ribbon and which atoms are considered part of the backbone (mainchain atoms). The path of the ribbon is controlled by two atoms per residue: the guide atom sets ribbon location (the path is smoothed over five successive residues), and the orientation atom sets the plane of the ribbon.

By default, when ribbon is shown, mainchain atoms are hidden and their locations are adjusted to fall on the ribbon. The command ribbackbone can be used to allow display of the mainchain atoms in their true positions at the same time as the ribbon. However, because the ribbon path is interpolated over several successive residues, the mainchain atoms in their true positions often appear to be offset or "floating" away from the ribbon (more...).

The Residue Class panel of the Ribbon Style Editor allows new ribbon residue classes to be defined. Names for the Guide atom, Orientation atom, and Mainchain Atoms must be supplied; letters in these names are automatically entered in uppercase. A mainchain atom's Position is how far along a residue's ribbon segment the atom is placed when adjusted to fall on the ribbon (possible values range from 0 to 1). Clicking Set adds the contents of the Name and Position fields to the Mainchain Atoms list. Choosing (clicking) an entry in the list and then clicking Remove deletes that entry.

Further Options:

• Non-helix/sheet uses "Nucleic" scaling - whether the ribbon for residues without secondary structure assignments should have the Nucleic dimensions in the current scaling scheme (otherwise the Coil dimensions will be used)
• Rotate orientation 90 degrees - whether the plane of the ribbon should be perpendicular to a line drawn from the middle (widthwise) of the ribbon to the orientation atom (otherwise parallel)

The settings in the Residue Class panel collectively define a ribbon residue class, which can be named, saved, and later retrieved from the pulldown list indicated by the solid black triangle next to the Ribbon Residue Class field. When the name of one of the built-in classes is shown, it is only possible to save to a different name, using Save As.... When another name is shown, it is possible to:

• Save the class to the name shown
• use Save As... to save the class to a new name
• Delete the class whose name is shown (if previously saved)

The path of the ribbon is controlled by two atoms per residue: the guide atom sets ribbon location (the path is smoothed over five successive residues), and the orientation atom sets the plane of the ribbon. Ribbon residue class specifies which atoms play these roles, as well as which are considered mainchain, or part of the backbone.

By default, when ribbon is shown, the mainchain atoms are hidden and their locations are adjusted to fall on the ribbon. The command ribbackbone can be used to allow display of the mainchain atoms in their true positions at the same time as the ribbon. However, because the ribbon path is interpolated over several successive residues, the mainchain atoms in their true positions often appear to be offset or "floating" away from the ribbon, especially in loops where there are abrupt changes in chain direction. Currently there is no way to constrain the ribbon to be closer to these true positions.

However, if a constant-radius tubular representation of the backbone (as in the licorice ribbon scaling) is acceptable, it can be generated along the true positions of backbone atoms using the command shape tube. Instead of a ribbon, this generates a tubular surface enclosing the specified atoms. For peptides/proteins, it is probably best to use the α-carbons (CA atoms) since they are the points of attachment of sidechains. Then any sidechains of interest can be displayed along with the tube. Example commands:

open 2mnr
~ribbon
show side chain/base.with CA/C1'
setattr m autochain 0
shape tube @ca radius 0.35 bandLength 4 modelId 1

rainbow
close 1
shape tube @ca radius 0.35 bandLength 4 modelId 1