RCSB PDB Help

FAQs/Scenarios

How do I navigate the 3D canvas using a mouse, touchpad, or touchscreen?

To rotate the structure, click the left mouse button and move. Alternatively, use the Shift button + left mouse button and drag.

To translate the structure, click the right mouse button and move. Alternatively, use the Control button + the left mouse button and move. On a touchscreen device, use a two-finger drag.

To zoom in or out, use the mouse wheel. On a touchpad, use a two-finger drag. On a touchscreen device, pinch two fingers.

To zoom in and center on a part of a structure, use the right mouse button to click onto the part of the structure you wish to focus on.

To change the clipping planes, use the Shift button + the mouse wheel. On a touchpad, use the Shift button + a two-finger drag.

See also the keyboard controls for navigating the canvas

How do I make selections?

There are several ways to make selections in Mol*. You first need to open Selection Mode and change the Picking Level, if needed. To make selections, you can either click on parts of the structure in the 3D canvas or Sequence Panel, or use the Set Operations Menus in the Selection Mode toolbar.

What are the four buttons with overlapping circles in the Selection Mode toolbar?

The four buttons are used to modify a current selection with a new selection. The Add/Union button takes the current selection and adds a new selection to it. The Subtract/Remove button takes the current selection and removes the parts of it that are in a new selection. The Intersect button takes the current selection and selects the parts of it that are in the new selection. The Set button takes the current selection and replaces it entirely with a new selection.

For example, suppose all leucine residues are selected in a structure. A user then uses each button in the toolbar and clicks the “helices” option. For the Add/Union button, Mol* will select all leucine residues and all helices. For the Subtract/Remove button, Mol* will select all leucine residues not in helices. For the Intersect button, Mol* will select all leucine residues in helices. For the Set button and selects helices, Mol* will select all helices.

How do I select by secondary structures?

If you want to select only secondary structures (alpha helices and beta strands/sheets), there are options to do this in the Selection Mode toolbar. Go to Set Selection, then click Structure Property. At this point you can choose either Helix or Beta Strand/Sheet to select either.

How do I invert my selection?

After making a selection of the region you want to exclude from the selection, click the Set Selection button in the Selection Mode toolbar. Under this menu, choose Manipulate Selection, then choose Inverse/Complement of Selection.

How do I select a specific type of amino acid throughout the structure?

Within the Selection Mode toolbar, go to Set Selection, and under Amino Acid, choose the amino acid you would like to select. For example, to select all histidine residues, click on “Set Selection” then scroll down to Amino Acid and click on “Histidine (HIS).”

How can I replace which sequence is shown in the Sequence Panel?

There are three drop-down menus in the Sequence Panel. The leftmost menu allows you to decide which PDB structure the new sequence should be from. The centermost menu allows you to decide which entity the new sequence should be from. The rightmost menu allows you to decide which part of the entity the new sequence should be from (if the entity contains duplicate copies).

How do I switch between different models and biological assemblies for display in the 3D canvas?

Go to the Controls Panel and to the Structure Panel. Clicking the presets button will show various structure presets (default, unit cell, super cell). Click next to Type to choose between the various models and assemblies available.

How do I view all models of an NMR ensemble?

Click on the icon right of the PDB ID and title at the top of the control panel (on the right of the screen). From the options that are presented select ‘All Models’ to display all models of the ensemble simultaneously.

How do I select specific models from an ensemble to see them - i.e., say I want to see models #1,3, and 5 only?

  • Begin by showing all the models in the ensemble as described here.
  • Now hide the display of all the models by clicking on the trashcan icon next to Polymer in the Control panel. This should clear the 3D canvas. Although no models are seen on the 3D canvas the tool is aware of all the 20 models as evidenced by the words "2KQP|20 structures" written in the control panel (below Structure).
  • Click on the label "2KQP|20 structures" to see a list of models. Click on the word Models to close that list and open a list of Structures.
  • In both the Models and Structures lists click on the xNone option to remove all selection. Note that the model numbers in either lists is not shown in bold.
  • Click on the Models list to close this list and see the "Structures" for each of the models for selection.
  • Now click on each of the models that you would like to see on the 3D canvas - i.e., model 1, model 3, and model 5. As you click on these in your list, these models should be shown in bold.
  • Scroll down to the Components section in the Control panel. Note that next to the PDB ID the number of structures that you have selected above is listed. Here you should see "2KQP 3 Structures"
  • Click on the "+Add" button to create a new representation for these structures.
    • From the "Selection" options, select "All".
    • From the "Representation" options, select "Cartoons".
    • Click "Options" and in the Label box type in a suitable name
  • Click on "Create Component" to display the selected models in the 3D canvas
Sequential steps for displaying a specific model in a strucutre
Sequential steps for displaying a specific model in a strucutre

How do I show or hide hydrogen atoms in a structure?

In order to show any non-covalent interactions, the components’ representations need to be adjusted by clicking on the options under the button next to Add in the Components Panel. Once the options button is clicked, a drop-down menu will show the various menus, including one with options for displaying and hiding hydrogens. Click on the Show All (default) options to select the other options e.g., "Hide All" and "Only Polar" hydrogens.

Options to show and hide hydrogen atoms included in a structure.
Options to show and hide hydrogen atoms included in a structure.

How do I color a structure by the rainbow/spectrum color scheme?

To color an entire structure from N-terminus to C-terminus as a rainbow, go to Polymer under the Components Panel. Click the Options button to the right, and select Set Coloring. Under this menu, select Residue Property, which will open another menu. Select Sequence Id. This will color each of the polymer chains from N- to C-terminus from blue to red color. Learn more about coloring options.

How do I color based on chain?

Polymer entities in the structure are also called Chains, and both linear and branched polymer chains are each assigned unique Chain IDs. Multiple copies of a protein chain in the asymmetric unit of a structure are assigned different chain IDs.

In most cases, when the PDB structure is loaded or opened in Mol*, by default the polymer chain(s) in the structure are colored by Chain ID. Settings for this display can be viewed under the Components Panel by clicking on the options button to the right of the Polymer(s) component and selecting the Set Coloring and Chain Property option called Chain ID. Select a different option in the Set Coloring options to change the coloring. Learn more about coloring options.

Note:When displaying an assembly that is composed of two or more copies of a polymer chain related by symmetry (e.g., crystallographic, or icosahedral), the symmetry related chains have the same Chain ID. So instead of coloring by Chain ID, different instances of the symmetry related polymer chains can be colored by Instance. This option is available at the same level under Set Coloring, Chain Property, and then Chain Instance.

How do I color a structure based on hydrophobicity?

To color an entire structure based on hydrophobicity, go to Polymer under the Components Panel. Click the Options button to the right, and select Set Coloring. Under this menu, select Residue Property, which will open another menu. Select Hydrophobicity. Hydrophilic residues will be colored in shades of red/orange and hydrophobic residues will be colored in shades of green. Learn more about coloring options.

Hydrophobicity color key
Hydrophobicity color key

How do I color a whole structure based on secondary structural elements (alpha helices and beta strands/sheets)?

To color an entire structure based on secondary structural elements, go to Polymer under the Components Panel. Click the Options button to the right, and select Set Coloring. Under this menu, select Residue Property, which will open another menu. Select Secondary Structure. This coloring scheme is best viewed when the protein(s) in the structure is are being visualized in the cartoon representation. The alpha helices will be colored magenta, beta strands/sheets will be colored in gold, coils are colored in white, etc. You may notice that some of the helices are slightly darker in color. These are possibly 3-10 or pi helices.

You can access the complete color code for all secondary structural elements and types of biological macromolecules using the following steps listed below and also marked in the figure below:

  1. click on the three dots to for Polymer options
  2. click on the bolded Cartoon Representation of the Polymer
  3. click on the three dots next to the row called Color Theme to expand the options
  4. click on the Colors options and change it from Default to Custom
  5. Click on the three dots to expand the Colors options to view the complete color code used in the tool.
Steps for coloring a structure by secondary structural elements
Steps for coloring a structure by secondary structural elements

How do I color a domain?

To color a domain, use Selection Mode to select the domain using either the Sequence Panel or by clicking on the residues in the domain in the 3D canvas. Click the Apply Theme to Selection button and select a color. When done, click Apply Theme.

How do I color atoms by the standard CPK color scheme and its variations?

The CPK (Corey-Pauling-Koltun) convention represents atoms in a molecular representation in specific colors - hydrogen is white, oxygen is red, nitrogen is blue, carbon is black (or grey) etc. Variations of this color scheme are used to visualize structures with multiple polymer chains and/or small molecule ligands. In these variations the color of the carbon atom may be changed to match the polymer chain ID or to a unique color of choice so that it is easy to visualize.

Directions for three different variations of coloring atoms by CPK colors are listed here.

  • Carbon atom matches the polymer chain coloring (default option used in Mol*): follow the steps listed below.
    • Click on any amino acid, nucleotide, ligand, cofactor etc., in Mol* while in the default mode (i.e., without activating the toggle menu for selections). It is displayed in the ball and stick representation, and amino acids/ nucleotides, ligands etc. in its 5 angstrom neighborhood are shown.
    • The displayed atoms are colored so that they are colored to match the color used for the polymer chain.
    • This is very helpful in visualizing interactions at the interface of two polymer chains.
Interactions of a selected amino acid in PDB entry 7pqq - the amino acids are shown in ball and stick representation and colored using the CPK color scheme for non-carbon atoms. The carbon atoms in each polymer chain is colored the same.
Interactions of a selected amino acid in PDB entry 7pqq - the amino acids are shown in ball and stick representation and colored using the CPK color scheme for non-carbon atoms. The carbon atoms in each polymer chain is colored the same.
  • Carbon atom follows elemental colors: follow the steps listed and shown in the figure below.
    • Select one or a set of amino acids or ligands and create a component to display in the "Ball and Stick representation".
    • In the Control panel expand the options for display by clicking on the "..." next to the component (in this example the component name is Ks)
    • Click on the "Ball & Stick Representation" to expand its options
    • Expand the Color Theme options by clicking on the "..." next to "Element Symbol"
    • In the menu that opens click on the word "Chain ID" and select "Element Symbol" from the options for Carbon Color. This should color the carbon atoms of the selection grey. Clear selections by clicking on any part of the white background on the 3D canvas.
Steps for coloring carbon atoms by the elemental color defined by the CPK color scheme
Steps for coloring carbon atoms by the elemental color defined by the CPK color scheme
  • Carbon atoms are colored in a unique color of choice: The example used here will illustrate a drug molecule (STI) in complex with a protein. The main idea here is to select only the carbon atoms of the inhibitor (drug) and color them in a color of choice. Follow the steps listed and shown in the figure below.
    • On the structure summary page of the PDB entry, scroll down to the small molecules section. Find the ligand of interest and click on the "Ligand Interactions" button (in the column labeled 3D interactions. Activate the Selection mode by clicking on the arrow button in the Toggle menu, and select the ligand by clicking on it. Alternatively you can open a structure in Mol* and select any amino acid, ligand etc. of interest. The selected ligand/residues should now be highlighted with a green halo.
    • While the ligand (or set of specific atoms) are selected, click on the intersect icon in the top selection menu options.
    • From the menu that opens up click on the "Element Symbol" options.
    • Scroll down the options as needed to select "Carbon (C)" from the options. This should change the selections display in the 3D canvas to show only carbon atoms in the selected set as highlighted with the green halo.
    • Click on the paintbrush icon in the selection menu on the top part of the 3D canvas. This should open a menu with various color choices.
    • Select the color you wish to paint the selected carbon atoms and click on Apply Theme. This should color the ligand or other selected atoms so that the carbon atoms are colored in the selected color, while the nitrogen and oxygen etc. are still colored by their CPK colors.
Steps for coloring carbon atoms in a user-chosen color.
Steps for coloring carbon atoms in a user-chosen color.

How do I change the transparency of representations and surfaces?

To change the transparency, select the whole structure or part of the structure using Selection Mode. To display a molecular surface click the Create Components options to select "Molecular Surface" in its Representation. Click on "Apply Theme" to display the molecular surface. Expand the Molecular Surface Representation created and click on the three dots next to it to display its Type Properties. Use the Opacity slider to adjust the transparency of the surface. The transparency can be similarly adjusted using the Opacity slider for any representation (e.g., Ball and stick)

Options to change transparency of the selected object (e.g., Molecular Surface)
Options to change transparency of the selected object (e.g., Molecular Surface)

How do I hide certain parts of a structure?

If a component of that region does not already exist, make a selection of the region you wish to hide, and create a component out of it. Go to the Components Panel and click the eye icon next to the component of choice to hide it. The component can be shown again by clicking the eye icon again.

How do I change the representation of my structure?

Depending on which part of the structure you want to change representation for, choose one of the components under the Components Panel. If you want to change the representation for a selection and a component does not exist, create a component from this selection. Select Options for the component of choice, and click Add Representation and choose the representation you desire.

How do I show the surface of my structure?

Go to the Components Panel and click Options for Polymer. Click Add Representation and select Gaussian Surface or Molecular Surface.

How do I focus on part of a structure?

There are several ways to focus on part of a structure. In default mode, click on a residue in the 3D canvas or in the Sequence Panel to focus on it along with surrounding residues. Alternatively, click on an object listed in the Components Panel to focus on it. If an object is currently selected, click on it in the Structure Panel to focus on it.

How do I measure distances?

Select two items that you want to measure the distance between. Go to the Measurements Panel, and select Add. Select Distance. The distance will be labeled in the 3D canvas and have a new menu under Controls.

How do I measure angles?

Select three items that you want to measure the angle between, making sure that the second selection is the vertex. Go to the Measurements Panel, and select Add. Select Angle. The angle will be labeled in the 3D canvas and have a new menu under Controls.

How do I label my structure?

Select an item that you want to label. Go to the Measurements Panel, and select Add. Select Label. The label will be displayed in the 3D canvas and have a new menu under Controls.

How do I compare/superpose multiple structures?

The Superposition Panel allows for multiple structures to be superposed. First, visit rcsb.org/3D-view and upload two or more structures. In order to superpose by chains, select two or more polymer chains/residues from multiple structures and click “Superpose” to superpose them. In order to superpose by atoms, select one or more atoms from multiple structures and click “Superpose” to superpose them.

Video: MolStar Superposing Two Structures.

The level of similarity between the selections in the two structures can be assessed by examining the superposed structures visually in the 3D canvas and also by monitoring the root-mean-square deviation (RMSD) displayed at the bottom of the page in the Log Panel.

When would I use superposition to compare structures “by chains” and “by atoms?”

There are advantages to superposing “by chains” and “by atoms.” For instance, superposing by chains is useful when seeking to align dissimilar structures. If the regions that need to be aligned are unknown, superposing by chains helps orient secondary structural elements in the 3D canvas. Another benefit of superposing by chains is aligning selected residues. This enables parts of chains (e.g., domains, active sites) to be aligned in multiple structures. In this example, the PDB IDs 6PVP and 6DVW are used. These structures represent open and closed state transient receptor proteins. It is possible to align the proteins by chain, which yields an RMSD of 3.35. When 34 residues from only one of the helices is selected from the same chain in each structure, an RMSD of 1.08 is recorded. This is a good method to reduce the RMSD.

Superposition of whole chains
Superposition of whole chains
Superposition of parts of a chain
Superposition of parts of a chain

Superposing by atoms is helpful when looking at the orientations of a small molecule present in multiple structures.This is an example of where superposing structures by atoms is helpful: the antibiotic structures for actinomycin 1A7Y and 1A7Z. In this structure, the core atoms that remain the same were selected in the same order, and this superposition gives an RMSD value of 0.12.

Superposition of selected atoms in two structures
Superposition of selected atoms in two structures
Controls panel view of superposition of selected atoms in two structures
Controls panel view of superposition of selected atoms in two structures

How can I improve the RMSD value for my superposition?

When superposing structures, an RMSD value is given that is calculated from the superposed regions. The lower the number the better the match between the regions compared. It is up to the user which regions they want to superpose, depending on their research question. However, there are a few ways to improve the superposition and RMSD value.

If you have superimposed your structures by chain, the RMSD value for that alignment may be large if some of the loops or termini of these structures are not well aligned.. In this case, it may be valuable to limit the selections to certain regions of the chains, such as secondary structures like alpha helices or beta sheets.

Superposition of two chains to compute rmsd (using the whole chain)
Superposition of two chains to compute rmsd (using the whole chain)

In this example, in a superposition of the structures 1D0T and 1D0U, the whole chain is selected for both structures to align them. This gives an RMSD value of 1.62.

Now, when only a portion of the sequence is selected to align the structures, an RMSD value of 1.41 is obtained.

Superposition of two chains to compute rmsd (using part of the chain)
Superposition of two chains to compute rmsd (using part of the chain)

If you are superposing the structures by atoms, you can conduct a similar process. It is important to note that a lower RMSD value may not mean an overall better superposition. Again, it is up to the researcher to decide what they want to superpose.

Using the example of the structures 1A7Y and 1A7Z, if only three pairs of atoms are chosen to superpose the structures, an RMSD value of 0.01 is observed, but the rest of the structure is not as well aligned.

Superposition of two sets of atoms to compute rmsd - using three pairs of atoms
Superposition of two sets of atoms to compute rmsd - using three pairs of atoms

Now if we choose 6 pairs of atoms from across the molecule, then a higher RMSD value of 0.50 is obtained, but there is a neater overall alignment of the two structures.

Superposition of two sets of atoms to compute rmsd - using six pairs of atoms
Superposition of two sets of atoms to compute rmsd - using six pairs of atoms

It is up to the user on how to optimize the superposition of the structures.

How do I represent my ligand when it is a peptide-like molecule?

Sometimes, when a structure is loaded, a portion of the structure may have multiple representations, and changing the representation does not fix the problem. In this case, it is helpful to empty out all the preset components and create them again with the representation you desire. In this example, we will use the structure (6LU7) for the SARS-CoV-2 main protease with an inhibitor N3. When you pull up this structure, it shows the whole structure with the inhibitor as well.

Displaying a peptide-like molecule in the structure
Displaying a peptide-like molecule in the structure

The inhibitor is shown in ball-and-stick form, as the Components Panel suggests, but there is also a cartoon backbone that is not hidden by trying to make the representation of the ligand ball-and-stick.

Peptide inhibitor show in ball and stick and cartoon representation
Peptide inhibitor show in ball and stick and cartoon representation

In this case, the best plan of action is to empty the preset components, and this clears the 3D canvas.

Clearing out the 3D canvas
Clearing out the 3D canvas

Then select the chain of whichever component you will be creating. In this case, I chose the ligand, and selected the chain in the Sequence Panel. Then create a component in the Selection Mode toolbar as shown below.

Select a chain to display using the sequence panel
Select a chain to display using the sequence panel
Create a new component for the peptide-like inhibitor
Create a new component for the peptide-like inhibitor

At this point the ligand shows in the 3D canvas as a ball-and-stick representation without the cartoon showing.

Display peptide-like inhibitor in the ball and stick representation
Display peptide-like inhibitor in the ball and stick representation

At this point, a covalent bond to a cysteine on the protein from the ligand does not show. There are a few ways to fix this. You can either zoom into the structure in default mode by focusing on the residues near this bond. You can also make a component of the residues involved in the bond, and show them using a ball-and-stick representation.

How do I change the color or representation of one chain in the structure?

The easiest way to do this is to make a component of the chain you are trying to change. In the Components Panel, you can then select the component of the chain to change its color or representation. For example, PDB structure 6lu7 depicts the main protease of SARS-CoV-2 with an inhibitor N3. The biological assembly contains two identical chains (which we will call chain A ASM_1 and chain A ASM_2). When this structure is opened in Mol*, both chains are colored green and are shown in the ribbon representation. Suppose you wanted to show the molecular surface only chain A ASM_1and color it based on hydrophobicity. The first step is to select the entirety of chain A ASM_1 and create a component of it. To change the representation, open the components menu for the chain A ASM_1 component (shown in a black box with a dashed line in the image below ). Use the Add Representation menu and click on “molecular surface.” The display should look like the following:

Changing representation of a the specific instance of a polymer chain
Changing representation of a the specific instance of a polymer chain

Next, we change the color of chain A ASM_1 by opening up the components menu for the chain A ASM_1 component and using the Set Coloring menu and click on “hydrophobicity.” As can be seen in the image below, the coloring and representation changes have been applied to only chain A ASM_1 and not chain A ASM_2.

Changing color of a the specific instance of a polymer chain
Changing color of a the specific instance of a polymer chain

How do I customize the types of non-covalent interactions displayed in Mol*?

By default, only common types of non-covalent interactions are shown (i.e., 𝜋-stacking interactions, 𝜋-cation interactions, Halogen bonds, Hydrogen bonds, and Metal coordination). Additional types of interactions (e.g., Ionic interactions, Weak hydrogen bonds and Hydrophobic interactions) can be shown using the steps shown in Figure 3. Expand the global representation options in the controls panel on the right (marked as 1 in Figure below) and then expand the Non-covalent Interactions Section (marked as 2 in the same figure). From the list of different types of non-covalent interactions toggle on/off the desired ones, such as turn on ionic interactions ( as shown in Figure below). Once turned on, this interaction will shown along with the default types of non-covalent interactions.

Global representation options for selectively displaying or hiding non-covalent interactions in Mol* for the PDB entry 1gtr
Global representation options for selectively displaying or hiding non-covalent interactions in Mol* for the PDB entry 1gtr

How do I show hydrogen bonds (non-covalent interactions)?

In the default mode, clicking on any part of the structure (amino acid or ligand in a structure loaded into Mol*) the tool centers on that part the structure, zooms in, and displays both covalent and non-covalent interactions within 5Å - including hydrogen bonds, 𝜋-stacking interactions etc. You can mouse over any interaction (represented as differently colored dashed lines) to learn about its identity at the bottom right corner of the 3D canvas. Sometimes displaying all these interactions simultaneously can be difficult to view clearly. You can selectively turn on and off specific types of interactions for clarity. Learn more about customizing the types of non-covalent interactions displayed.

Here we describe steps to view only hydrogen bonds in the structure being viewed or selected part of the structure. In order to show only hydrogen bonds you can modify the options under the button next to Add in the Components Panel. Once Non-covalent Interactions is clicked on, a drop-down menu will show the various non-covalent interactions that can be toggled on and off for viewing.

Displaying specific types of non-covalent interactions
Displaying specific types of non-covalent interactions

Now, the non-covalent interactions turned on above can be added as a representation. For this example, non-covalent interactions for the entire polymer of 3PQR will be shown. For reference, the structure looks like this prior to adding representations to the cartoon representation of the polymer.

Starting (default) view of PDB entry 3pqr
Starting (default) view of PDB entry 3pqr

At this point, click on Polymer, and click Add Representation. To be able to visualize the atoms that are involved in the non-covalent interactions, turn on both the Ball & Stick and Non-covalent Interactions. Now there should be three representations, and the structure should look like this.

Steps to display non-covalent interactions in PDB entry 3pqr
Steps to display non-covalent interactions in PDB entry 3pqr
View of PDB entry 3pqr showing non-covalent interactions in the entire structure
View of PDB entry 3pqr showing non-covalent interactions in the entire structure

Now if you want to see what interaction is being shown, mouse over the interaction, and it will show in the bottom right corner of the 3D canvas.
The same steps can also be applied to view the hydrogen bonds within a selected set of amino acids/ligands/polymer chains.

How do I tweak the hydrogen bond distance threshold?

In order to change the parameters for hydrogen bonds, or any other non-covalent interactions, click on the Global Representation Options button in the Components panel, to view a list of types of interactions. For the specific interaction type whose threshold you wish to change (e.g., hydrogen bonds), click on the three dots (or options) at the end of the row. This will open up various options for tweaking the parameters. Clicking on the question mark for any of the options will give a short description of what that option is responsible for calculating.

Note: Also check out the separate non-colvalent interaction - called "Weak Hydrogen Bonds".

Viewing and adjusting hydrogen bond distance threshold
Viewing and adjusting hydrogen bond distance threshold

How do I show disulfide bonds (covalent interaction)?

Disulfide bonds are formed between specific pairs of Cysteine amino acid side chains. To show these bonds you need to select the S-S bond forming residues. Click on the arrow button to activate the Selection Mode and then click on the Add/Union selection button. From the pull down menu select Bond Properties, and Disulfide Bridges.

1. activate the selection mode
2. select the Add/Union option
3. select Disulfide Bridges from the Bond Properties options
1. activate the selection mode 2. select the Add/Union option 3. select Disulfide Bridges from the Bond Properties options

On the 3D canvas you should now see the disulfide bond forming amino acids are selected and shown with a green halo. For example, in the case of PDB ID 1trz, you will see as follows:

Selection of disulfide bond forming Cys residues
Selection of disulfide bond forming Cys residues

Go back to the Selection Mode toolbar and click on the create a component option. Select Ball and Stick for the Representation, assign the component a name (e.g., S-S), and click on the Create Component button at the bottom of the box.

1. activate create component box
2. select representation
3. label component
4. Create Component
1. activate create component box 2. select representation 3. label component 4. Create Component

The S-S bonds are now displayed on the 3D canvas.

Disulfide bonds displayed in PDB entry 1trz
Disulfide bonds displayed in PDB entry 1trz

How to display the interactions of a ligand with amino acids and ligands bound nearby? - from the Mol* tool

If you want to show the interactions nearby a ligand, including the hydrogen bonding and any other kinds of bonding, you need to focus on the target first. For example, if you want to show how a ligand binds to a protein, and you want to color the surrounding residues while showing the interactions, there are a set of steps to follow in a specific order.

First you need to focus on the target ligand. In this example, the structure 4HHB will be used. If you want to show the heme group and its interactions with the hemoglobin structure, first you need to focus on the heme group. Make sure you are in the default mode and click on the heme group in the 3D canvas. This will focus on the heme group and show the interactions with the residues around it.

Examining the neighborhood of a ligand in PDB entry 4hhb
Examining the neighborhood of a ligand in PDB entry 4hhb

Now the interactions between the heme group and the protein are shown. If you click away from this, the structure will unfocus and go back to the starting display. You will need to focus again. To color the heme group one color and the surrounding residues a separate color, these are the steps that can be taken. In order to first color the heme group, you will need to select it. Click open the Selection Mode toolbar. Select the heme group by clicking on it in the 3D canvas. Now color it the desired color using the color tool in the Selection Mode toolbar, and clicking Apply Theme.

Color the ligand of interest in a different color
Color the ligand of interest in a different color

Now to invert the selection to the surrounding 5 Å of residues, in the Selection Mode toolbar, go to Set Selection, then Manipulate Selection, and choose Surrounding Residues (5 Å) of Selection. It should look like the following.

Select amino acids in the surrounding 5 Å of a specific ligand
Select amino acids in the surrounding 5 Å of a specific ligand

Now color this selection as before to the color of your choosing. If you deselect everything, you will see an image like the following.

Color residues within the surrounding 5 Å of the selected ligand in a specific color
Color residues within the surrounding 5 Å of the selected ligand in a specific color

You can now save this image using the Screenshot / State Snapshot option in the toggle menu.

How to display the interactions of a ligand with amino acids and ligands bound nearby? - from the Structure Summary Page

Click on the Interactions button in the Small Molecules section of the Structure Summary Page to focus on a specific ligand to explore. This will open the Mol* page showing the structure centered on the selected small molecule and displays it in a ball and stick representation. All residues within 5 Å of the selected ligand are also displayed along with covalent and non-covalent interactions between them. To see the ligand its neighborhood only, hide the Polymers, Ligands, and Waters by clicking on the eye icon next to these Components (see red outlined box with 4 written above it.)

Steps for displaying a ligand and interactions in its 5 Å neighborhood (starting from the Structure Summary Page of a 3D structure).
Steps for displaying a ligand and interactions in its 5 Å neighborhood (starting from the Structure Summary Page of a 3D structure).

How do I display the hydrophobicity of a binding pocket's surface?

The binding pocket refers to the amino acid residues surrounding the location (pocket) in the protein where a specific ligand binds. Select the amino acid residues interacting with the ligand of interest. Now use the following steps (also shown as the numbered screenshots in the figure below):
1. Click on the three dots (Action button) next to the component called "[Focus] Surroundings (5 Å)" and then click on the "Select This" option.
2. This will select the ligand of interest and all the residues in the binding pocket (within 5 Å) and highlight them with a green halo.
3. Click on the arrow icon at the bottom of the Toggle menu to activate the selection mode
4. Click on the ligand in the center of the display to remove it from the selection. Now only the residues in the neighborhood of the ligand should be selected.
5. Select the Create Components icon in the horizontal menu that is presented on the 3D Canvas to display the Molecular Surface of the selected amino acids
6. The molecular surface is colored by the polymer chain Id.
7. To change the color of the surface click on the three dots (Action button) next to the component called "Custom Selection". Scroll down to Molecular Surface Representation options and from the "Color Theme" options select "Hydrophobicity" under the "Residue Properties"
8. The molecular surface shows hydrophobic regions in shades of green and hydrophobic regions in shades of red.
9. Turn on the polymer chains, water, and ligands using the components panel eye-icon to see the binding pocket in the context of the overall structure.

Steps involved in displaying the surface of a igand binding pocket and coloring it by hydrophobicity
Steps involved in displaying the surface of a igand binding pocket and coloring it by hydrophobicity

If I have multiple structures uploaded, how can I toggle between the display of the structures?

It can be tricky dealing with multiple structures. To make it simpler, it is important to know how to display only one structure at a time, and to be familiar with switching between which structure is displayed. After the structures are uploaded, you’ll need to use the Structure Panel and Components Panel to do this. In the example below, PDB structures 6lu7 (SARS-CoV-2 main protease bound by an inhibitor) and 6yb7 (SARS-CoV-2 main protease with an unliganded active site) were uploaded at rcsb.org/3D-view. A simple superposition using chain A ASM_1 in each structure was performed to overlay the two structures. The Mol* page should look like the following image, with 6lu7 shown in green and 6yb7 shown in purple:

Superpose two structures (PDB entries 6lu7 and 6yb7) in Mol*
Superpose two structures (PDB entries 6lu7 and 6yb7) in Mol*

Next, we want to hide one of the structures while showing the other structure. Suppose the structure we want to hide is 6lu7. To do this, go into the Structure Panel and locate the Structures menu. This menu lists each structure uploaded into Mol*. Clicking on one of the structures in this menu will show the components for just that structure in the Components Panel. We want to see the components for only 6lu7 so we can opt to hide them. In the Structures menu, click on “None” to deselect both structures, then click on “6LU7 | Assembly 1” to display its components. The Structures menu should look like the following image:

Steps to select the PDB entry that you do not wish to see in the 3D canvas
Steps to select the PDB entry that you do not wish to see in the 3D canvas

Then go to the Components Panel where it lists the components of only 6lu7. Click the “eye” icon to hide each component. In the 3D canvas, you should only see 6yb7.

Next, suppose we want to show 6lu7 and hide 6yb7. First, we need to reshow the components of 6lu7. To do this, go the Structures menu in the Structure Panel and select only 6lu7. Then, use the Components Panel to show the components of 6lu7. In the 3D canvas, you should see both structures. To hide 6yb7, use the Structures menu to select only 6yb. It should look like the following image:

Steps to show a specific PDB entry in the 3D canvas following a superposition
Steps to show a specific PDB entry in the 3D canvas following a superposition

Then go to the Components Panel where it lists the components of only 6yb7. Click the “eye” icon to hide each component. In the 3D canvas, you should only see 6lu7.

How can I save a Mol* session or state and return to it at a later time?

Load relevant file(s) in Mol*. Once the molecules have been visualized and rendered as desired you can save an image or a session by clicking on the Screenshot/State Snapshot button. From the menu that opens, click on either the State or Session download options.

Steps in saving a session or state
Steps in saving a session or state

The save "State" option creates a *.molj file where the instructions to load the coordinates from a specific PDB entry and render it in a specific representation (e.g., cartoon, molecular surface) are saved. Note that the save "State" option only works for files that were loaded from a publicly available URL, so structural data loaded to Mol* from local files are not saved.
The save "Session" option creates a *.molx file where the structural data and specific instructions to render them in a specific representation (e.g., cartoon, molecular surface) are saved. These files may be large in size.
In the standalone version of Mol* the save State and Session options can also be accessed under the Session options in the right hand Control panel.
Opening the state or session files is possible using the Open button in the State and Session options.

How can I save multiple views of a structure in a Mol* session or state for sharing?

Collections of views can be prepared for and used in teaching/learning and also for sharing with collaborators. This can be done in the standalone version of Mol* (rcsb.org/3D-view) by saving each view with a unique name. Detailed instructions for how to save, delete/replace, open and cycle through the views.

Video: Multiple views in a Mol* Session.



Please report any encountered broken links to [email protected]
Last updated: 10/16/2024