get the html header comment right!
[jalview.git] / help / html / features / viewingpdbs.html
index ef222b1..d979254 100755 (executable)
@@ -1,32 +1,68 @@
-<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>&quot;Sequence&#8594;View PDB\r
-  entry:&quot;</strong> entry from the sequence's <a\r
-  href="../menus/popupMenu.html">pop-up menu</a>.</p>\r
-<p>To associate PDB files with a sequence, right click on a sequence ID and select \r
-  &quot;Associate Structure with Sequence&quot;, and one of the submenus:</p>\r
-<ul>\r
-  <li>From File - You can load a PDB file from the local machine or network and \r
-    associate it with the selected sequence. PDB files associated in this way \r
-    can be saved in the Jalview Archive file. <br>\r
-  </li>\r
-  <li>Enter PDB Id - Jalview will use WSDBFetch, provided by the EBI, to fetch \r
-    the PDB file with the entered Id.<br>\r
-  </li>\r
-  <li>Discover PDB Ids - Jalview uses WSDBFetch, provided by the EBI, to discover \r
-    PDB ids for all the sequences in the alignment which have valid Uniprot names \r
-    / accession ids. </li>\r
-</ul>\r
-<p><strong>Note:</strong> You can retrieve sequences from the PDB using the <a\r
-  href="seqfetch.html">Sequence Fetcher</a>. Any sequences retrieved with this \r
-  service are automatically associated with their source database entry. For PDB \r
-  sequences, simply select PDB as the database and enter your known PDB id (appended \r
-  with ':' and a chain code, if desired).</p>\r
-<p>For help on viewing and colouring structures see the <a\r
-href="pdbviewer.html">PDB Viewer</a> help page. </p> </p>\r
-</body>\r
-</html>\r
+<html>
+<!--
+ * Jalview - A Sequence Alignment Editor and Viewer (Version 2.5)
+ * Copyright (C) 2010 J Procter, AM Waterhouse, G Barton, M Clamp, S Searle
+ * 
+ * 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/>.
+-->
+<head><title>PDB Viewing</title></head>
+<body>
+<p><strong>Viewing PDB Structures</strong></p>
+<p>Jalview can view protein structures associated with a sequence via the <strong>&quot;Structure&#8594;View 
+  PDB entry:&quot;</strong> entries from a sequence's <a
+  href="../menus/popupMenu.html">pop-up menu</a>. This will open an
+  interactive display of the structure in a new window, or prompt you
+  to associate the sequence with an existing view of the selected
+  structure. See the <a href="jmol.html">Jmol PDB viewer</a> help page
+  for more information about the display.
+</p>
+<p>To associate PDB files with a sequence, right click on a sequence ID and select 
+  &quot;Structure<strong>&#8594;</strong> Associate Structure with Sequence&quot;, 
+  and one of the submenus:</p>
+<ul>
+  <li>From File - You can load a PDB file from the local machine or network and 
+    associate it with the selected sequence. PDB files associated in this way 
+    will also be saved in the <a href="jalarchive.html">Jalview Archive file</a>. <br>
+  </li>
+  <li>Enter PDB Id - Jalview will use WSDBFetch, provided by the EBI, to fetch 
+    the PDB file with the entered Id.<br>
+  </li>
+  <li>Discover PDB Ids - Jalview uses WSDBFetch, provided by the EBI, to discover 
+    PDB ids for all the sequences in the alignment which have valid Uniprot names 
+    / accession ids. </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.
+<br><em>Note for jalview applet users: 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.</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 seuqence. The
+display of these features is controlled through the
+<strong>&quot;View&#8594;Sequence Features&quot;</strong> menu item
+and the <a href="featuresettings.html">Feature Settings dialog
+box</a>.</p> 
+</body>
+</html>