help/html/features/jmol.html

   1 <html>\r
   2 <!--\r
   3  * Jalview - A Sequence Alignment Editor and Viewer (Version 2.5)\r
   4  * Copyright (C) 2010 J Procter, AM Waterhouse, G Barton, M Clamp, S Searle\r
   5  * \r
   6  * This file is part of Jalview.\r
   7  * \r
   8  * Jalview is free software: you can redistribute it and/or\r
   9  * modify it under the terms of the GNU General Public License \r
  10  * as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.\r
  11  * \r
  12  * Jalview is distributed in the hope that it will be useful, but \r
  13  * WITHOUT ANY WARRANTY; without even the implied warranty \r
  14  * of MERCHANTABILITY or FITNESS FOR A PARTICULAR \r
  15  * PURPOSE.  See the GNU General Public License for more details.\r
  16  * \r
  17  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.\r
  18 -->
  19 <head>\r
  20 <title>The Jmol PDB Viewer</title>\r
  21 </head>\r
  22 <body>\r
  23 <p><strong>The Jmol PDB Viewer</strong>\r
  24 <p>The interactive structure viewing window is opened by selecting\r
  25 the <strong>&quot;Sequence&#8594;View PDB entry:&quot;</strong> entry in\r
  26 the <a href="../menus/popupMenu.html">sequence id pop-up menu</a>. This\r
  27 can only be done for sequences which have an <a href="viewingpdbs.html">associated\r
  28 PDB structure</a>.\r
  29 <p>Since Jalview 2.3, <a href="http://jmol.sourceforge.net/">Jmol</a>\r
  30 has been integrated into Jalview. It is automatically used by the\r
  31 application, and should also run in the applet in all latest web\r
  32 browsers. If jmol is not available, then the original <a\r
  33 href="pdbviewer.html">internal pdb viewer</a> will be used as a fallback.\r
  34 </p>\r
  35 <p><strong>Controls</strong></p>\r
  36 <p>The structure is by default rendered as a ribbon diagram. Moving the\r
  37 mouse over the structure brings up tooltips giving the residue name,\r
  38 PDB residue number and chain code, atom name and number\r
  39 ([RES]Num:Chain.AtomName#AtomNumber). If a mapping exists to a residue\r
  40 in any associated sequences, then this will be highlighted in each\r
  41 one's alignment window. The converse also occurs - moving the mouse\r
  42 over an associated residue in an alignment window highlights the associated\r
  43 atoms in the displayed structures.</p>\r
  44 <p>Selecting a residue highlights its associated sequence residue\r
  45 and alpha carbon location. Double clicking an atom allows distances to\r
  46 be measured from it to any other atom in the structure.</p>\r
  47 <p>\r
  48 <table>\r
  49         <tr>\r
  50                 <td><strong>Action</strong></td>\r
  51                 <td><strong>Windows</strong></td>\r
  52                 <td><strong>Unix</strong></td>\r
  53                 <td><strong>Mac/OSX</strong></td>\r
  54         </tr>\r
  55         <tr>\r
  56                 <td>Rotate View</td>\r
  57                 <td>Left Click and Drag</td>\r
  58                 <td>Left Click and Drag</td>\r
  59                 <td>Click and Drag</td>\r
  60         </tr>\r
  61         <tr>\r
  62                 <td>Zoom</td>\r
  63                 <td>Shift + Left Click<br>drag mouse up or down</td>\r
  64                 <td>Shift + Left Click<br>or middle button<br>drag\r
  65                 mouse up or down</td>\r
  66                 <td>Left-Alt + Click and drag mouse up or down</td>\r
  67         </tr>\r
  68         <tr>\r
  69                 <td>Select/<br>\r
  70                 Deselect<br>\r
  71                 Residue</td>\r
  72                 <td>Left Click</td>\r
  73                 <td>Left Click</td>\r
  74                 <td>Click</td>\r
  75         </tr>\r
  76         <tr>\r
  77                 <td>Roll View</td>\r
  78                 <td>Shift + Left Click<br>drag mouse to left or\r
  79                 right</td>\r
  80                 <td>Shift + Left Click<br>or middle button<br>drag mouse to left or right</td>\r
  81                 <td>Left-Alt + Click and drag mouse to left or right</td>\r
  82         </tr>\r
  83         <tr>\r
  84                 <td>Move Origin</td>\r
  85                 <td>Shift+Control+Left Click<br>or Middle Button<br>\r
  86                 + Drag</td>\r
  87                 <td>Middle-Button<br>and<br>drag</td>\r
  88                 <td>Shift+Control+Left Click<br>or Middle Button<br>\r
  89                 and drag</td>\r
  90         </tr>\r
  91         <tr>\r
  92                 <td>Jmol Menu</td>\r
  93                 <td>Right-Click</td>\r
  94                 <td>Right-Click</td>\r
  95                 <td>Apple-Click</td>\r
  96         </tr>\r
  97 </table>\r
  98 </p>\r
  99 <p>The window has four menus:\r
 100 <ul>\r
 101         <li><Strong>File<br>\r
 102         </strong>\r
 103         <ul>\r
 104                 <li><strong>Save As<br>\r
 105                 </strong><em>Save the displayed PDB File, or the current view as an EPS or PNG file.</em></li>\r
 106                 <li><strong>View Mapping<br>\r
 107                 </strong><em> Opens a text window showing the alignment between the\r
 108                 residues corresponding to alpha-carbon atoms in the PDB structure and\r
 109                 the residues in the associated sequence.</em></li>\r
 110         </ul>\r
 111         </li>\r
 112         <li><strong>View</strong>\r
 113         <ul>\r
 114         <li><strong>Show Chains<br></strong><em>Select which of the PDB\r
 115         file's chains are to be displayed.</em>\r
 116         </li>\r
 117         </ul>\r
 118         <li><strong>Colours<br>\r
 119         </strong>\r
 120         <ul>\r
 121                 <li><strong>By Sequence<br>\r
 122                 </strong><em> Colours each residue in the structure with the colour of its\r
 123                 corresponding residue in the associated sequence as rendered in the\r
 124                 associated alignment view, including any Uniprot sequence features or\r
 125                 region colourings.<br>\r
 126                 Residues which only exist in the PDB structure are coloured white if\r
 127                 they are insertions (relative to the associated sequence in the\r
 128                 alignment) and grey if they are N or C terminal flanks outside the\r
 129                 region mapped to the alignment window's sequence.</em></li>\r
 130                 <li><strong>By Chain<br>\r
 131                 </strong><em> Assigns a random colour to each PDB chain.</em>\r
 132                 <li><strong>Charge &amp; Cysteine<br>\r
 133                 </strong><em> Highlights cysteines in yellow, anionic (Aspartic Acid or\r
 134                 Glutamic Acid) residues in red, and cationic (Lysine or Arginine)\r
 135                 residues in blue.</em></li>\r
 136                 <li><strong>Standard and User Defined Jalview\r
 137                 colourschemes.<br>\r
 138                 </strong><em>The remaining entries apply the colourschemes available from the\r
 139                 standard and user defined <a href="../colourSchemes/index.html">amino\r
 140                 acid colours</a>.</em></li>\r
 141         </ul>\r
 142         </li>\r
 143         <li><strong>Help<br></strong><ul><li><strong>Jmol Help<br></strong><em>Access the Jmol Help\r
 144         documentation in a new browser window.</em>\r
 145         </li>\r
 146         </ul>\r
 147 </li></ul>\r
 148 </p>\r
 149 <p><strong>Functionality provided by Jmol</strong>\r
 150 </p><p>The Jmol menu provides access to a number of features for\r
 151 controlling the colour and display of molecules, adding measurements and\r
 152 labels, plotting surfaces, and display animation. The 'Set Picking'\r
 153 menu controls the behaviour of single and double mouse clicking on the\r
 154 structure.</p>\r
 155 <p>The state of each Jmol display is stored within <a\r
 156 href="jalarchive.html">jalview archives</a> as a jmol state recovery script\r
 157 file. This means that any Jmol visualization effects that\r
 158 you add beyond those provided by Jalview will be able to be stored and\r
 159 recovered along with the displayed alignments in Jalview.\r
 160 </p><p><strong>More Information</strong>\r
 161 </p><p>Jmol is a sophisticated program in its own right, with its own\r
 162 command console and scripting language. Only the essentials have been\r
 163 described here - the interested reader is referred to \r
 164 <a href="http://jmol.sourceforge.net/docs/">Jmol's own comprehensive\r
 165 online documenation</a>.</p></p>\r
 166 </body>\r
 167 </html>\r