Rearranged 'What's new' and debugged/verified the sequence fetcher and
[jalview.git] / help / html / features / pdbviewer.html
1 <html>\r
2 <head><title>PDB Viewer</title></head>\r
3 <body>\r
4 <p><strong>The PDB Viewer Window</strong>\r
5 <p>This interactive structure viewing window is opened by selecting the\r
6 <strong>&quot;Sequence&#8594;View PDB\r
7 entry:&quot;</strong> entry in the <a\r
8 href="../menus/popupMenu.html">sequence id pop-up menu</a>. This can only be\r
9 done for sequences which have an <a href="viewingpdbs.html">associated\r
10 PDB structure</a>.</p>\r
11 <p><strong>Controls</strong></p>\r
12 <p>The structure is rendered as an alpha-carbon trace. \r
13 Moving the mouse over the structure brings up tooltips with a\r
14 residue name and PDB sequence position. If a mapping exists to a\r
15 residue in the associated sequence, then this will be highlighted in\r
16 the alignment window, and vice versa for viewing the coordinates\r
17 associated with a particular residue in the sequence.</p>\r
18 <p>Selecting a residue highlights its associated sequence residue and\r
19 alpha carbon location.</p>\r
20 <p><table>\r
21 <tr><td><strong>Action</strong></td><td><strong>Windows</strong></td><td><strong>Unix</strong></td><td><strong>Mac/OSX</strong></td></tr>\r
22 <tr><td>Select/<br>Deselect<br>Residue</td><td>Left Click</td><td>Left\r
23 Click</td><td>Click</td></tr>\r
24 <tr><td>Rotate View</td><td>Left Click and Drag</td><td>Left Click and\r
25 Drag</td><td>Click and Drag</td></tr>\r
26 <tr><td>Roll View</td><td>Right Click and drag</td><td>Right Click and\r
27 Drag</td><td>TODO</td></tr>\r
28 <tr><td>Move Origin</td><td>Middle-Button and\r
29 Drag</td><td>Middle-Button and Drag</td><td>TODO</td></tr>\r
30 <tr><td>Zoom In</td><td>Up Arrow</td><td>Up Arrow</td><td>Up\r
31 Arrow</td></tr>\r
32 <tr><td>Zoom Out</td><td>Down Arrow</td><td>Down Arrow</td><td>Down Arrow</td></tr>\r
33 </table>\r
34 </p>\r
35 <p>There are three menus:\r
36 <ul>\r
37 <li><Strong>File<br></strong><ul>\r
38 <li><strong>Save As<br></strong><em>Saves the current view as an EPS or PNG file.</em>\r
39 </li>\r
40 <li><strong>View Mapping<br></strong><em>\r
41 Opens a text window showing the alignment between the residues\r
42 corresponding to alpha-carbon atoms in the PDB structure and the\r
43 residues in the associated sequence.</em>\r
44 </li>\r
45 </ul>\r
46 </li>\r
47 <li><strong>Colours<br></strong><ul>\r
48 <li><strong>By Sequence<br></strong><em>\r
49 Colours each residue in the structure with the colour of its\r
50 corresponding residue in the associated sequence as rendered in the\r
51 alignment window, including any Uniprot sequence features or region\r
52 colourings.<br>Residues which only exist in the PDB structure are\r
53 coloured white if they are insertions (relative to the associated\r
54 sequence in the alignment) and grey if they are N or C terminal\r
55 flanks outside the region mapped to the alignment window's sequence.</em></li>\r
56 <li><strong>By Chain<br></strong><em>\r
57 Assigns a random colour to each PDB chain.</em>\r
58 <li><strong>Charge &amp; Cysteine<br></strong><em>\r
59 Highlights cysteines in yellow, anionic (Aspartic Acid or Glutamic Acid) residues in red, and\r
60 cationic (Lysine or Arginine) residues in blue.</em>\r
61 </li>\r
62 <li><strong><em>Standard and User Defined Jalview colourschemes.<br></em></strong>\r
63 The remaining entries apply the colourschemes available from the\r
64 standard and user defined <a href="../colourSchemes/index.html">amino acid colours</a>.</em>\r
65 </li>\r
66 </ul>\r
67 </li>\r
68 <li><strong>View<br></strong><em>\r
69 These options can be turned off to improve performance when viewing\r
70 large structures, some at the expense of visual clarity.</em><ul>\r
71 <li><strong>Wireframe<br></strong><em>\r
72 Draws thin lines rather than thick lines for the\r
73 alpha-carbon trace.</em>\r
74 </li><li><strong>Depthcue<br></strong><em>Shades the structure so parts of the structure near\r
75 the front of the view are brighter than those further away.</em>\r
76 </li><li><strong>Z Buffering<br></strong><em>\r
77 Applies depth sorting to correctly render occluded regions of the\r
78 backbone trace.</em>\r
79 </li>\r
80 <li><strong>Show All Chains<br></strong><em>\r
81 When turned on, shows all chains in the PDB file, not just the one\r
82 associated with a sequence in the alignment window.</em>\r
83 </li>\r
84 </ul>\r
85 </li>\r
86 </ul>\r
87 </p>\r
88 <p><strong>Notes for PDB Viewing in the Jalview Applet</strong>\r
89 <p>The applet can only load PDB files by copying and pasting the text into \r
90   the popup window which appears when &quot;Show PDB Structure&quot; is selected \r
91   after right clicking on a sequence name.</p>\r
92 </body>\r
93 </html>\r