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. Ribbon residue class can be switched with ribclass, and spline method with ribspline.

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, and the orientation atom sets the plane of the ribbon. Named classes can be accessed with the command ribclass.

Built-in residue classes include:

class	guide atom	orientation atom	mainchain atoms
amino acid	CA	O	N,CA,C,O
nucleic acid	C5'	C1'	P,OP1,OP2,OP3,O5',C5',O3' (and synonyms)
nucleic acid p trace	P	C1'	P

There is also a nucleic acid rotated class, which differs from nucleic acid only in that the option to rotate the ribbon is on.

The ribbon path is smoothed over successive residues. By default, when ribbon is shown for a residue, the mainchain atoms of that residue are hidden, except where bonded to other displayed atoms (such as the sidechain). For drawing these bonds, the apparent locations of the mainchain atoms are adjusted to fall on the ribbon. Thus, bonds from ribboned mainchain to sidechain may appear as unnaturally short or long, but measurements involving mainchain atoms (bond length, etc.) will still reflect their real, unadjusted positions. The command ribbackbone enables simultaneous display of ribbon and the mainchain atoms in their true positions. However, the atoms may be “floating” away from the ribbon in some places.

There is a trade-off between the smoothness of the ribbon path and how closely it follows the true positions of the atoms. Two methods of determinining the path are available:

• B-spline (default) - uses five successive residues and may not coincide exactly with any mainchain atoms
• cardinal spline - uses four successive residues and coincides exactly with the guide atoms, unless additional smoothing is applied; to minimize the appearance of kinks, a tubular ribbon (for example, style: rounded and scaling: licorice) may be preferred

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)