help/html/features/chimera.html

   1 <html>
   2 <!--
   3  * Jalview - A Sequence Alignment Editor and Viewer (Version 2.8.2)
   4  * Copyright (C) 2014 The Jalview Authors
   5  *
   6  * This file is part of Jalview.
   7  *
   8  * Jalview is free software: you can redistribute it and/or
   9  * modify it under the terms of the GNU General Public License
  10  * as published by the Free Software Foundation, either version 3
  11  * of the License, or (at your option) any later version.
  12  *
  13  * Jalview is distributed in the hope that it will be useful, but
  14  * WITHOUT ANY WARRANTY; without even the implied warranty
  15  * of MERCHANTABILITY or FITNESS FOR A PARTICULAR
  16  * PURPOSE.  See the GNU General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
  20  * The Jalview Authors are detailed in the 'AUTHORS' file.
  21  -->
  22 <head>
  23 <title>The Chimera PDB Viewer</title>
  24 </head>
  25 <body>
  26 <p><strong>The Chimera Viewer</strong></p>
  27 <p>Since Jalview 2.8.2, <a href="http://www.cgl.ucsf.edu/chimera/">Chimera</a> (http://www.cgl.ucsf.edu/chimera/)
  28 has been integrated into Jalview for interactively viewing structures
  29 opened by entries in the <strong>&quot;Structure&quot;</strong> submenu in the <a href="../menus/popupMenu.html">sequence
  30 id pop-up menu</a> (if you can't see this, then you need to <a
  31         href="viewingpdbs.html">associate a PDB structure</a> with the
  32 sequence). Chimera is available from the Jalview desktop, provided Chimera has been separately installed.</p>
  33 <p>You can set a default choice of Jmol or Chimera structure viewer in <a href="preferences.html#structure"> Preferences</a>.
  34 You can also optionally specify the path to the Chimera program here (if it differs from the standard paths searched by Jalview).
  35 <p>The following menu entries are provided for viewing structure data<br>
  36   <ul>
  37     <li>The <strong>&quot;Structure&#8594;View
  38         Structure&#8594;</strong> submenu allows a single PDB structure to be chosen
  39       for display from the available structures for a sequence.
  40     </li>
  41     <li>The <strong>&quot;Structure&#8594;View all <em>N</em>
  42         structures
  43     </strong> option will open a new window containing all structures associated
  44       with the current selection.
  45     </li>
  46     <li>The <strong>&quot;Structure&#8594;View all <em>N</em>
  47         representative structures
  48     </strong> option will open a new window containing exactly one structure per
  49       currently selected sequence.<br /></li>
  50   </ul>
  51   <br>
  52 </p>
  53 <p><a name="align"><strong>Superposing structures based
  54 on their aligned sequences</strong></a><br>
  55 <p>If several structures are available on the alignment, you may add
  56 additional structures to an existing Chimera view by selecting their entry
  57 in the appropriate pop-up menu. Jalview will ask you if you wish to add
  58 the structure to the existing alignment, and if you do, it will import
  59 and superimpose the new PDB file using the corresponding positions from
  60 the alignment. If the alignment is subsequently edited, you can use the
  61 <a href="#sAlign"><em>Chimera&#8594;Align</em></a> menu option from the
  62 menu bar of the structure view window to superpose the structures using
  63 the updated alignment.<br>
  64 </p>
  65 <p><strong>Chimera Controls</strong><br>
  66 <p>The structure is by default rendered as a ribbon diagram. Moving the
  67 mouse over the structure brings up tooltips giving the residue name, PDB
  68 residue number and chain code
  69 ([RES]Num:Chain). Moving the mouse over an
  70 associated residue in an alignment window highlights the associated
  71 atoms in the displayed structures. For comprehensive details of Chimera's commands, refer to the tool's Help menu.</p>
  72 <p>Basic screen operations (see <a href="http://www.cgl.ucsf.edu/chimera/current/docs/UsersGuide/mouse.html">Chimera help</a>
  73 (http://www.cgl.ucsf.edu/chimera/current/docs/UsersGuide/mouse.html) for full details).
  74 <table border="1">
  75         <tr>
  76                 <td><strong>Action</strong></td>
  77                 <td><strong>Windows</strong></td>
  78                 <td><strong>Unix</strong></td>
  79                 <td><strong>Mac/OSX</strong></td>
  80         </tr>
  81         <tr>
  82                 <td>Rotate View</td>
  83                 <td>Left Click and Drag</td>
  84                 <td>Left Click and Drag</td>
  85                 <td>Left Click and Drag</td>
  86         </tr>
  87         <tr>
  88                 <td>Zoom</td><td>Right Click<br>
  89                 drag mouse up or down</td>
  90                 <td>Right Click<br>drag mouse up or down</td>
  91                 <td>cmd or Right + Click and drag mouse up or down, <br>or use mouse scroll button</td>
  92         </tr>
  93         <tr>
  94                 <td>Move Origin</td>
  95                 <td>Middle Button + Drag</td>
  96                 <td>Middle Button and drag</td>
  97                 <td>alt + Click<br>
  98                 and drag</td>
  99         </tr>
 100 </table>
 101 </p>
 102 <p><strong>Jalview Controls</strong>
 103 <p>The Jalview Chimera View window has up to five menus:
 104 <ul>
 105         <li><Strong>File<br>
 106         </strong>
 107         <ul>
 108                 <li><strong>View Mapping<br>
 109                 </strong><em> Opens a text window showing the alignment between the
 110                 residues corresponding to alpha-carbon atoms in the PDB structure and
 111                 the residues in the associated sequence.</em></li>
 112         </ul>
 113         </li>
 114         <li><strong>View</strong>
 115         <ul>
 116                 <li><strong>Show Chains<br>
 117                 </strong><em>Select which of the PDB file's chains (if more than one) are to be displayed.</em></li>
 118                 <li><strong>Colour by ..<br></strong><em>Submenu allowing specific alignment views to be selected for colouring associated chains in the structure display. This menu contains all the alignment views associated with the structure view, with those used to colour the view indicated by ticks. Addditionally, it contains the following menu entries:</em>
 119                 <ul><li><strong>Select many views<br></strong><em>When this option is enabled, selecting an alignment view adds it to the set used to colour the structures. Use this when colouring structures related to a number of alignments involving different domains or chains which are shown in the same structure view.</em>
 120                 </li>
 121     <li><strong>Select all views<br></strong><em>This is only enabled when </em><strong>Select many views</strong><em> is also enabled, and will add all associated views to the set used to colour the structure display.</em>
 122   </li>
 123     <li><strong>Invert selection<br></strong><em>This is only enabled when </em><strong>Select many views</strong><em> is also enabled, and will replace the current set of views with any remaining views not currently used to colour the structure display.</em>
 124   </li></ul></li></ul>
 125         <li><strong>Colours<br>
 126         </strong>
 127         <ul>
 128                 <li><strong>By Sequence<br>
 129                 </strong><em> Colours each residue in the structure with the colour of its
 130                 corresponding residue in the associated sequence as rendered in the
 131                 associated alignment views, including any Uniprot sequence features or
 132                 region colourings.<br/>Pick which of the associated alignment views are used to colour the structures using the <strong>View&#8594;Colour by ..</strong> sub menu.</em><br>
 133                 Residues which only exist in the PDB structure are coloured white if
 134                 they are insertions (relative to the associated sequence in the
 135                 alignment) and grey if they are N or C terminal flanks outside the
 136                 region mapped to the alignment window's sequence.</em></li>
 137                 <li><strong>By Chain<br>
 138                 </strong><em>Uses the Chimera 'rainbow chain' command to apply a different colour to each chain.</em></li>
 139                 <li><strong>Charge &amp; Cysteine<br>
 140                 </strong><em> Highlights cysteines in yellow, anionic (Aspartic Acid or
 141                 Glutamic Acid) residues in red, and cationic (Lysine or Arginine)
 142                 residues in blue.</em></li>
 143                 <li><strong>Colour with Chimera<br></strong><em>Defers any colouring operations to Chimera. Select this if you want to use the
 144                 Chimera scripting interface or menu to modify the view directly.</em></li>
 145                 <li><strong>Standard and User Defined Jalview
 146                 colourschemes.<br>
 147                 </strong><em>The remaining entries apply the colourschemes available from
 148                 the standard and user defined <a href="../colourSchemes/index.html">amino
 149                 acid colours</a>.</em></li>
 150         </ul>
 151         </li>
 152         <li><strong>Chimera<br>
 153         </strong><em>This pulldown menu is only displayed if there are multiple
 154         structures shown in the Chimera window, and Jalview can also locate at
 155         least two of the structures in the currently associated alignment view.</em>
 156         <ul>
 157                 <li><strong><a name="sAlign">Align</a> <br>
 158                 </strong><em> When selected, the associated alignment will be used to
 159                 superimpose all the structures in the view onto the first structure in
 160                 the alignment. The regions used to calculate the superposition will be
 161                 highlighted using the 'Cartoon' rendering style, and the remaining
 162                 data shown as a chain trace.<br></em></li>
 163         </ul>
 164         </li>
 165         <li><strong>Help<br>
 166         </strong>
 167         <ul>
 168                 <li><strong>Chimera Help<br>
 169                 </strong><em>Access the Chimera Help documentation in a new browser window.</em></li>
 170         </ul>
 171         </li>
 172 </ul>
 173 </p>
 174 </body>
 175 </html>