-<html>\r
-<head><title>PDB Viewing</title></head>\r
-<body>\r
-<p><strong>Viewing PDB Structures</strong></p>\r
-<p>Jalview has a simple <a href="pdbviewer.html">3D structure viewer</a> which can visualize polypeptide backbone\r
- structures associated with a sequence in an alignment. It is\r
- accessed via the <strong>"Sequence→View PDB\r
- entry:"</strong> entry from the sequence's <a\r
- href="../menus/popupMenu.html">pop-up menu</a>.</p>\r
-<p>There are two ways to associate PDB files with sequences:</p>\r
-<ul>\r
- <li>Select "<a href="seqfeatures.html">Sequence Features</a>" from\r
- the "View" menu, which retrieves any uniprot sequence\r
- records associated with the sequences in the alignment. If, for a\r
- particular sequence's uniprot record there\r
- are any cross-references to PDB structures, then these will be\r
- added to its list of associated database ids.</li>\r
- <li>Retrieve sequences from the PDB using the <a\r
- href="seqfetch.html">Sequence Fetcher</a>. Any sequences retrieved\r
- with this service are automatically associated with their source\r
- database entry. For PDB sequences, simply select PDB as the database\r
- and enter your known PDB id (appended with ':' and a chain code, if\r
- desired).</li>\r
-</ul>\r
-For help on viewing and colouring structures see the <a\r
-href="pdbviewer.html">PDB Viewer</a> help page.\r
-</p>\r
-</body>\r
-</html>\r
+<html>
+<!--
+ * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
+ * Copyright (C) $$Year-Rel$$ The Jalview Authors
+ *
+ * This file is part of Jalview.
+ *
+ * Jalview is free software: you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation, either version 3
+ * of the License, or (at your option) any later version.
+ *
+ * Jalview is distributed in the hope that it will be useful, but
+ * WITHOUT ANY WARRANTY; without even the implied warranty
+ * of MERCHANTABILITY or FITNESS FOR A PARTICULAR
+ * PURPOSE. See the GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with Jalview. If not, see <http://www.gnu.org/licenses/>.
+ * The Jalview Authors are detailed in the 'AUTHORS' file.
+ -->
+<head>
+<title>PDB Viewing</title>
+</head>
+<body>
+ <p>
+ <strong>Viewing PDB Structures</strong>
+ </p>
+ Jalview can be used to view protein structures by following the steps below:
+ <ol>
+ <li>Select the <strong>"View Structure"</strong> option from a
+ sequence's <a href="../menus/popupMenu.html">pop-up menu</a> to invoke the <a href="structurechooser.html">Structure Chooser</a> interface.
+ <ul>
+ <li>If one or more structures exists for the given sequence, the <a href="structurechooser.html">Structure Chooser</a>
+ dialogue is opened with a list of the found structures meta-data.</li>
+ <li>However, if no structure was found, the <a href="structurechooser.html">Structure Chooser</a> interface is opened with options for manual association of PDB structures.</li>
+ </ul>
+ </li>
+ <li>Choose the structure to view from the discovered list. This can be done either manually by clicking directly
+ on the desired structure(s) in the list, or automatically by
+ using the drop-down menu on the interface to filter and auto-select the best structure based on certain
+ criteria like quality, resolution, etc.</li>
+ <li>When the desired structure(s) have been selected, they can be
+ viewed by clicking the <strong>"View"</strong> button below the summary list.
+ </li>
+
+ </ol>
+
+ The
+ <a href="jmol.html">Jmol viewer</a> has been included since Jalview
+ 2.3. Jalview 2.8.2 included support for <a href="chimera.html">Chimera</a>, provided it is
+ installed and can be launched by Jalview. The default viewer can be
+ configured in the
+ <a href="preferences.html#structure">Structure tab</a> in the
+ <strong>Tools→Preferences</strong> dialog box.
+ <p>
+ Structure data imported into Jalview can also be processed to display
+ secondary structure and temperature factor annotation. See the <a
+ href="xsspannotation.html">Annotation from Structure</a> page for
+ more information.
+ </p>
+ <!--
+ <p>The following menu entries are provided for viewing structure data
+ <ul>
+ <li>The <strong>"Structure→View
+ Structure→</strong> submenu allows a single PDB structure to be chosen
+ for display from the available structures for a sequence.
+ </li>
+ <li>The <strong>"Structure→View all <em>N</em>
+ structures
+ </strong> option will open a new window containing all structures associated
+ with the current selection, superposed according to the currently selected region of the alignment.<br/><em>This
+ capability was added in Jalview 2.7</em>
+ </li>
+ <li>The <strong>"Structure→View all <em>N</em>
+ representative structures
+ </strong> option will open a new window containing exactly one structure per
+ currently selected sequence.<br />
+ <em>The View representative structures option was introduced in
+ Jalview 2.8.1</em></li>
+ </ul>
+</p> -->
+
+<p>If a <strong>single</strong> pdb
+structure is selected, one of the following will happen:</p>
+
+<ul>
+ <li>If no structures are open, then an interactive display of the
+ structure will be opened in a new window.</li>
+
+ <li>If another structure is already shown for the current
+ alignment, then you will be asked if you want to add and <a
+ href="jmol.html#align">align this structure</a> to the structure in
+ the existing view. (<em>new feature in Jalview 2.6</em>).</li>
+
+ <li>If the structure is already shown, then you will be prompted
+ to associate the sequence with an existing view of the selected
+ structure. This is useful when working with multi-domain or multi-chain PDB files.</li>
+
+ <li style="list-style: none">See the <a href="jmol.html">Jmol
+ </a> and <a href="chimera.html">Chimera</a> PDB viewer help pages for more information about the display.</li>
+</ul>
+
+
+<p><strong>Importing PDB Entries or files in PDB format</strong><br>
+You can retrieve sequences from the PDB using the <a
+ href="seqfetch.html">Sequence Fetcher</a>. Any sequences retrieved with
+this service are automatically associated with their source database
+entry. For PDB sequences, simply select PDB as the database and enter
+your known PDB id (appended with ':' and a chain code, if desired).<br>
+Jalview will also read PDB files directly. Simply load in the file as
+you would an alignment file. The sequences of any peptide chains will be
+extracted from the file and viewed in the alignment window.</p>
+
+<p>
+<strong>Associating a large number of PDB files to sequences
+in an alignment</strong><br /> It is often the case when working with
+structure alignments that you will have a directory of PDB files, and
+an alignment involving one or more of the structures. If you drag a
+number of PDB files onto an alignment in the Jalview desktop, Jalview
+will give you the option of associating PDB files with sequences that
+have the same filename. This means, for example, you can automatically
+associate PDB files with names like '1gaq.pdb' with sequences that
+have an ID like '1gaq'.
+<br/><em>Note: This feature was added in Jalview 2.7</em>
+</p>
+<p><em>Note for Jalview applet users:<br>
+Due to the applet security constraints, PDB Files can currently only be
+imported by cut and paste of the PDB file text into the text box opened
+by the 'From File' entry of the structure menu.</em></p>
+
+<p><strong>Viewing the PDB Residue Numbering</strong><br>
+Sequences which have PDB entry or PDB file associations are annotated
+with sequence features from a group named with the associated PDB
+accession number or file name. Each feature gives the corresponding PDB
+Residue Number for each mapped residue in the sequence. The display of
+these features is controlled through the <strong>"View→Sequence
+Features"</strong> menu item and the <a href="featuresettings.html">Feature
+Settings dialog box</a>.</p>
+
+<p><em><strong>Outstanding problem with cut'n'pasted
+files in Jalview 2.6 and Jalview 2.7</strong><br>
+Structures imported via the cut'n'paste dialog box will not be correctly
+highlighted or coloured when they are displayed in structure views,
+especially if they contain more than one PDB structure. See the bug
+report at http://issues.jalview.org/browse/JAL-623 for news on this problem.</em></p>
+</body>
+</html>
+