ChimeraX docs icon
1bzm, 1urt, sequence alignment
Models #1 1bzm and #2 1urt associated with sequences in an alignment, with ChimeraX selection sequence region.

Tool: Sequence Viewer

The Sequence Viewer displays individual sequences and sequence alignments of amino acids and nucleotides, with crosstalk to any associated structures. To find and select a specified sequence or sequence pattern, use Select... Sequence in the menu or the select command. See also: sequence, Modeller Comparative, Model Loops, Coloring by Sequence Conservation

Sequences for biopolymer structures in ChimeraX can be shown:

Independent of structure, sequence alignments and individual sequences can also be opened from files or fetched from UniProt. Other tools or commands may generate new sequence alignments (e.g., Blast Protein results, Matchmaker, sequence realignment).

Multiple Sequence Viewer windows can be shown at the same time, and they can be manipulated like other panels in ChimeraX (more...).

Context Menu
Headers
Regions
    Region Browser
    UniProt Sequence Features
Sequence-Structure Association
Settings

Sequence Viewer Context Menu

Each Sequence Viewer window has a context menu with choices including:

Headers

Sequence headers are rows of information above the sequences, such as a Consensus sequence, Conservation histogram, or histogram of the RMSD (root-mean-square displacement) among multiple associated structures. Which headers are shown initially and how they are calculated can be controlled in the Headers settings. Headers for a specific window can be shown, hidden, or saved to a file with the Sequence Viewer context menu or the sequence header command. Numbering can also be controlled using the Sequence Viewer context menu.

Per-column header values are assigned as attributes of the structure residues associated with sequences in the alignment. The numerical attributes (those from headers displayed as histograms) are named “seq_name,“ where name is the name of the header, for example, seq_conservation or seq_rmsd. The structures can be colored to show the values of such numerical attributes, as in the tutorial: Coloring by Sequence Conservation. See also the video Coloring Aligned Proteins by Cα RMSD.

Regions (Colored Boxes)

Sequence regions are colored boxes or outlines that enclose one or more residue symbols. A single region may contain any number of disjoint and/or abutting boxes. Pausing the cursor over a region (but not directly over a residue symbol) shows its name in a pop-up balloon.

Some regions are created automatically, such as by association with a structure. Regions can also be created manually by dragging within the sequence window. Manually created regions are shown in this color (default, see Regions settings). The display and colors of existing regions can be controlled with the Region Browser.

The active region is the region most recently clicked, created by dragging, or designated as Active in the Region Browser. The active region is indicated with a dashed outline, and the corresponding parts of any associated structures are selected. Shift-dragging with the left mouse button adds to the active region, whereas Ctrl-dragging creates a new region and makes it the active region. (On Mac, command key replaces Ctrl.) Backspace/delete deletes the active region. Clicking the active region deactivates it, and clicking a different region deactivates the former active region and makes the new region active. A region with no interior color is only responsive to clicks on its borders. Where regions overlap, only the highest is responsive to clicks.

apoe_human regions

Region Browser

The Region Browser can be opened by choosing Annotations... Regions... from the context menu.

Regions applicable to the entire alignment or to any of the individual sequences in the alignment can be listed using the pulldown menu near the top of the dialog. Regions applicable to the entire alignment include the ChimeraX selection and any hand-drawn regions, even if they only enclose parts of a single sequence. Regions applicable to an individual sequence include UniProt sequence features and regions created by structure association.

Region Browser columns:

Clicking a row in the Region Browser highlights the line and chooses the region. More than one region can be chosen at a time, and checkbox settings specify whether Choosing in table shows all chosen regions, hides other regions, and/or makes the last chosen region the active region.

If Include gaps is turned off (unchecked), the chosen region(s) will be drawn to enclose only residues, not gap positions. Although a given region may then appear as disjoint blocks, it will still be a single region.

Since regions may overlap, a region can be considered higher or lower than another. When the mouse focus is in the sequence window, the up arrow and down arrow keys can be used to raise and lower the active region, respectively, and pressing the Delete key will delete the active region. Alternatively, Region Browser buttons can be used to act on the chosen region(s):

cah1_human sequence features

UniProt Sequence Features

Sequences fetched from UniProt may include several annotations. These “sequence features” are automatically assigned as regions in the sequence window. The features are hidden by default, but a dialog for browsing and displaying them appears when the sequence is first opened. This dialog can be reshown at any time by choosing Annotations... Sequence Features... from the context menu.

Choosing a feature type on the left side of the dialog shows the regions for all features of that type; if multiple features of that type are listed on the right, clicking (choosing) any one shows just the region for the individual feature. When the dialog has mouse focus, starting to type the name of a feature type instantly chooses that entry. The up and down arrow keys can also be used to navigate the dialog. Feature listings may include links to evidence code descriptions in the Evidence & Conclusion Ontology and/or sequence variant entries in dbSNP.

The border and interior colors of the currently shown feature region(s) can be changed by clicking the color wells and using the system color editor, and checkboxes allow leaving either the border or the interior uncolored. Region colors can also be changed using the Region Browser. The initially assigned colors may vary between different instances of opening the same data.

If a structure is associated with the sequence, the corresponding structure residues are listed in the lower right area of the dialog. For example, the figure shows all metal ion-binding site regions in UniProt sequence cah1_human, corresponding to residues 64,67,94,96,119, and 200 in chain A of the associated structure, PDB 1bzm. A checkbox option allows automatically selecting the associated structure residues (if any) as features are chosen.

Sequence-Structure Association

A sequence that arose from a structure's chain information is automatically associated with that chain, with regions for protein structure helices and structure strands. Such sequences are closed when their structure chains are deleted or closed, and they are not automatically associated with other structure chains.

When sequences and structures are opened independently, a structure chain will be associated automatically with a sequence if their sequences can be aligned without mismatches exceeding 1/10 of the residues in the structure chain. The association and number of mismatches will be reported in the Log. For automatic association,

For manual association, both of the above are allowed, but only the “extra” residues in the structure not associated with any positions in the sequence (minus the length difference if the structure sequence is longer) are counted along with mismatches and reported in the Log.

Associations can be controlled manually (forced or removed):

In the sequence window, regions may be created to show mismatches and missing residues according to the association. If a mismatch or missing residue only occurs in a subset of multiple associated chains, a pink box or gray outline is shown instead (default, see Regions settings).

Further effects of association:

Sequence Viewer Settings (Preferences)

Choosing Settings... from the Sequence Viewer context menu shows its settings in a separate window, with sections:

The settings window can be manipulated like other panels in the ChimeraX interface (more...).

Save saves the current settings as preferences, Reset replaces the current settings with the initial “factory” defaults (values shown in bold below), and Restore restores values that were saved previously. The Buttons below... option indicates whether these buttons should apply only to the currently shown section (e.g., Appearance) or to all of the Sequence Viewer preferences. Although there can be multiple settings windows with different values for multiple Sequence Viewer windows, there can be only one set of saved preference values.

Appearance – how text is displayed in the Sequence Viewer window

Headers – rows of information above the sequences in an alignment (more...)

Regions – creation and display of regions (colored boxes)

The Regions section of settings controls whether different types of regions should be shown, and if so, their initial colors. Each color well can be clicked to choose a color interactively. On/off checkboxes indicate whether to color the region border (box outline) and/or interior (box fill), whereas full and partial refer to whether the region applies to all structures associated with a position or to only some fraction of those structures.


UCSF Resource for Biocomputing, Visualization, and Informatics / October 2023