User Guide Page 1 of 30
User Guide
Here is the step-by-step guide for using the Ligand Explorer application. If you are
running the applet from the PDB site, please start from step 4:
1. Once you have successfully installed the Ligand Explorer application on your
computer, you should see a"Ligand Explorer" icon on your desktop. Click on this
icon to start the program.
2. If you know the pdb id of the structure file you want to examine, you can load the
structure by
(a) type in the pdb id in the text box and then return(press the enter key on your
keyboard);
or
(b) click on the right side of the text box(see the screenshot below), wait for the pdb
list to show up and then select your pdb id.
3. You can also load a pdb/mmCIF structure file by going to File/Open.
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 2 of 30
4. When the structure is loaded, the program dynamically generates the ligand list
associated with this structure and displays it on the left panel. In the structure viewer,
the protein backbones are shown in tracelines (the same color scheme as in the
sequence viewer on the top), and all the ligands are shown in ball and stick.
Hold down the left button of the mouse and then drag to rotate the structure, hold down
the middle button and then drag to zoom in and out, and hold down the right button of
the mouse and then drag to move up/down and left/right. Click on the "Reset" button on
the left panel to bring the structure to the initial position.
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 3 of 30
Click on a protein residue in the sequence viewer, the full residue will be draw in the
structure viewer and the chain id and residue id of this residue can be found in the
status bar:
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 4 of 30
Click on a protein fragement in the structure viewer, this fragment will be highlighted in
the structure viewer and the sequence viewer. Information about this fragment will be
given in the status bar:
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 5 of 30
5. Select a ligand of interest and click on "Apply", the program will center the view
around this ligand.
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 6 of 30
You can click on an atom to see the atom name in the status bar; or click on a bond to
see the names of the atoms that form this bond.
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 7 of 30
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 8 of 30
6. If you choose to examine the hydrophilic (H-bond) interactions for ATP_1 ligand,
select this option and click on "Apply". In the sequence viewer (1 in the screenshot
below), the protein residues that interact with this ligand within your specified range will
be highlighted in red (2). Mouse over to any protein residue in the sequence viewer, you
will see the three-letter code and its residue id (3). In the structure viewer, the
interacting protein residues will be fully drawn (4), and the name of each interacting
protein residue is displayed at its alpha-C position in the format of
"chain_id:three_letter_code residue_id" (5).
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 9 of 30
You will see a summary of calculated interactions in the status bar:
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 10 of 30
To examine the details of the binding site, you can use the options in the Analysis
menu: "Measure Distance" measures the distance between any two atoms in the
display, "Measure Angle" measures the angle between any three atoms, and "Dihedral
Angle" measures the torsion angle of four contiguous atoms. For example, if you want
to check the angle of the three atoms highlighted in the screenshot below, select
"Measure Angle".
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 11 of 30
You will see a dialog. Enter the name of the atom by clicking on this atom in the
structure viewer or typing its name into the text box, then click on "Execute".
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 12 of 30
The caculated angle will be shown in the status bar.
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 13 of 30
7. Click on the interacting protein residue (1 in the screenshot below) in the sequence
viewer, it will highlight the protein residue in the structure viewer (2). Note if the feature
is still under construction, then a message will tell so in the status bar (3); if an error
occured while you are running the program, the status bar is where you look for the
error message.
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 14 of 30
8. You can also turn the distance label off. The screenshot below shows the
hydrophobic interactions with distance label off.
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 15 of 30
9. You can adjust the interaction threshold. The following shows hydrophobic
interactions between 1.9Å to 5.0Å.
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 16 of 30
10. You can examine different interactions at the same time. For example, the following
shows the hydrophobic interactions (magenta dashed lines, 1 in the screenshot below)
and hydrophilic interactions(green dashed lines, 2).
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 17 of 30
11. Select "Other" to see other ligand-protein interactions.
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 18 of 30
12. Select "ligand-H2O-protein" to see ligand-H2O interactions and ligand-protein
interactions bridged by ordered H2O molecules.
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 19 of 30
13. Select "inter-ligand" to see inter-ligand interactions.
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 20 of 30
14. If you would like to see the details of an atom or a particular bond, go to Tools in the
menu and click on "Show Inspector".
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 21 of 30
You will see a poped-up table.
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 22 of 30
Click on an atom in the structure viewer, the program will populate the table with
detailed information about this atom.
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 23 of 30
Click on a bond in the structure viewer, the program will populate the table with detailed
information about this bond.
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 24 of 30
15. If you would like to save the image in the structure viewer, select "Save Image" in
File menu.
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 25 of 30
You will see a popped-up window. Select a format (.jpg or .png) and fill in the "File
Name"(Note you need to include .jpg or .png in your file name). Click on Save.
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 26 of 30
Your saved image looks like this:
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 27 of 30
16. You can save interactions into three different file format: .xls(Microsoft Excel), .txt,
or .doc. To save interactions, click on "Save Interactions" in "File" menu.
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 28 of 30
You'll see a dialog. Select directory and type in the file name(Don't forget to indicate the
file format by typing in the file extension---.xls, .txt, or .doc).
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004
User Guide Page 29 of 30
This is your saved interaction file in excel format:
http://users.sdsc.edu/~qzhang/ligand/help/userGuide.htm 4/23/2004