help/html/features/jmol.html

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