help/html/features/viewingpdbs.html

   1 <html>
   2 <!--
   3  * Jalview - A Sequence Alignment Editor and Viewer (Version 2.7)
   4  * Copyright (C) 2011 J Procter, AM Waterhouse, J Engelhardt, LM Lui, G Barton, M Clamp, S Searle
   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 of the License, or (at your option) any later version.
  11  *
  12  * Jalview is distributed in the hope that it will be useful, but
  13  * WITHOUT ANY WARRANTY; without even the implied warranty
  14  * of MERCHANTABILITY or FITNESS FOR A PARTICULAR
  15  * PURPOSE.  See the GNU General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
  18 -->
  19 <head>
  20 <title>PDB Viewing</title>
  21 </head>
  22 <body>
  23 <p><strong>Viewing PDB Structures</strong></p>
  24
  25 <p>Jalview can view protein structures associated with a sequence
  26 via the <strong>"Structure&rarr;View PDB entry:"</strong> entries from a
  27 sequence's <a href="../menus/popupMenu.html">pop-up menu</a>. Once a pdb
  28 structure is selected, one of the following will happen:</p>
  29
  30 <ul>
  31         <li>If no structures are open, then an interactive display of the
  32         structure will be opened in a new window</li>
  33
  34         <li>If another structure is already shown for the current
  35         alignment, then you will be asked if you want to add and <a
  36                 href="jmol.html#align">align this structure</a> to the structure in
  37         the existing view. (<em>new feature in Jalview 2.6</em>)</li>
  38
  39         <li>If the structure is already shown, then you will be prompted
  40         to associate the sequence with an existing view of the selected
  41         structure. This is useful when working with multi-domain or multi-chain PDB files.</li>
  42
  43         <li style="list-style: none">See the <a href="jmol.html">Jmol
  44         PDB viewer</a> help page for more information about the display.</li>
  45 </ul>
  46         <p>
  47                 <em>Opening structures associated with the current selection</em><br />
  48                 If one or more of the sequences in the alignment are selected, then
  49                 the Structure submenu of the <a href="../menus/popupMenu.html">Sequence
  50                         ID popup menu</a> will contain will include either a 'View all <em>X</em>
  51                 structures' entry in the submenu or a 'View structure for <em>Sequence</em>'
  52                 entry. Both these options will open a new Jmol view containing one, or
  53                 all the structures available for all selected sequences, superimposed
  54                 using the currently selected region of the alignment. (<em>This
  55                         capability was added in Jalview 2.7</em>)
  56         </p>
  57         <p><strong>Associating PDB files with Sequences</strong></p>
  58         <p>To associate PDB files with a sequence, right click on a sequence
  59 ID and select "Structure<strong>&rarr;</strong> Associate Structure with
  60 Sequence", and one of the submenus:</p>
  61
  62 <ul>
  63         <li>From File - You can load a PDB file from the local machine or
  64         network and associate it with the selected sequence. PDB files
  65         associated in this way will also be saved in the <a
  66                 href="jalarchive.html">Jalview Archive file</a>.<br>
  67         </li>
  68
  69         <li>Enter PDB Id - Jalview will use WSDBFetch, provided by the
  70         EBI, to fetch the PDB file with the entered Id.<br>
  71         </li>
  72
  73         <li>Discover PDB Ids - Jalview uses the sequence's ID to query WSDBFetch, provided by the
  74         EBI, and any enabled DAS servers, to discover PDB ids associated with the sequence.</li>
  75 </ul>
  76
  77 <p><strong>Importing PDB Entries or files in PDB format</strong><br>
  78 You can retrieve sequences from the PDB using the <a
  79         href="seqfetch.html">Sequence Fetcher</a>. Any sequences retrieved with
  80 this service are automatically associated with their source database
  81 entry. For PDB sequences, simply select PDB as the database and enter
  82 your known PDB id (appended with ':' and a chain code, if desired).<br>
  83 Jalview will also read PDB files directly. Simply load in the file as
  84 you would an alignment file. The sequences of any peptide chains will be
  85 extracted from the file and viewed in the alignment window.</p>
  86
  87 <p>
  88 <strong>Associating a large number of PDB files to sequences
  89 in an alignment</strong><br /> It is often the case when working with
  90 structure alignments that you will have a directory of PDB files, and
  91 an alignment involving one or more of the structures. If you drag a
  92 number of PDB files onto an alignment in the Jalview desktop, Jalview
  93 will give you the option of associating PDB files with sequences that
  94 have the same filename. This means, for example, you can automatically
  95 associate PDB files with names like '1gaq.pdb' with sequences that
  96 have an ID like '1gaq'.
  97 <br/><em>Note: This feature was added in Jalview 2.7</em>
  98 </p>
  99 <p><em>Note for jalview applet users:<br>
 100 Due to the applet security constraints, PDB Files can currently only be
 101 imported by cut and paste of the PDB file text into the text box opened
 102 by the 'From File' entry of the structure menu.</em></p>
 103
 104 <p><strong>Viewing the PDB Residue Numbering</strong><br>
 105 Sequences which have PDB entry or PDB file associations are annotated
 106 with sequence features from a group named with the associated PDB
 107 accession number or file name. Each feature gives the corresponding PDB
 108 Residue Number for each mapped residue in the sequence. The display of
 109 these features is controlled through the <strong>"View&rarr;Sequence
 110 Features"</strong> menu item and the <a href="featuresettings.html">Feature
 111 Settings dialog box</a>.</p>
 112
 113 <p><em><strong>Outstanding problem with cut'n'pasted
 114 files in Jalview 2.6 and Jalview 2.7</strong><br>
 115 Structures imported via the cut'n'paste dialog box will not be correctly
 116 highlighted or coloured when they are displayed in structure views,
 117 especially if they contain more than one PDB structure. See the bug
 118 report at http://issues.jalview.org/browse/JAL-623 for news on this problem.</em></p>
 119 </body>
 120 </html>
 121