2.2 documentation
authorjprocter <Jim Procter>
Mon, 27 Nov 2006 17:32:40 +0000 (17:32 +0000)
committerjprocter <Jim Procter>
Mon, 27 Nov 2006 17:32:40 +0000 (17:32 +0000)
21 files changed:
help/helpTOC.xml
help/html/calculations/pca.html
help/html/colourSchemes/textcolour.gif [new file with mode: 0644]
help/html/colourSchemes/textcolour.html
help/html/editing/index.html
help/html/features/creatinFeatures.html
help/html/features/das.gif [new file with mode: 0644]
help/html/features/das.jpg [deleted file]
help/html/features/dasfeatures.html
help/html/features/dassettings.html
help/html/features/featuresFormat.html
help/html/features/hiddenRegions.html
help/html/features/multipleViews.html
help/html/features/newkeystrokes.html
help/html/features/pdbviewer.html
help/html/io/index.html
help/html/menus/alignmentMenu.html
help/html/menus/alwfile.html
help/html/menus/index.html
help/html/menus/popupMenu.html
help/html/whatsNew.html

index 5252a30..c0c7f2c 100755 (executable)
@@ -21,7 +21,7 @@
        <tocitem text="Sequence Features" target="seqfeatures" expand="false">
           <tocitem text="Sequence Feature Settings" target="seqfeatures.settings"/>
           <tocitem text="Sequence Features File" target="features.fileformat"/>
        <tocitem text="Sequence Features" target="seqfeatures" expand="false">
           <tocitem text="Sequence Feature Settings" target="seqfeatures.settings"/>
           <tocitem text="Sequence Features File" target="features.fileformat"/>
-          <tocitem text="User Defined Sequence Features" target="search"/>
+          <tocitem text="User Defined Sequence Features" target="seqfeatcreat"/>
                  <tocitem text="Editing Sequence Features" target="seqfeatedit"/>
           <tocitem text="DAS Feature Retrieval" target="das.viewing"/>
          <tocitem text="DAS Feature Settings" target="das.settings"/>
                  <tocitem text="Editing Sequence Features" target="seqfeatedit"/>
           <tocitem text="DAS Feature Retrieval" target="das.viewing"/>
          <tocitem text="DAS Feature Settings" target="das.settings"/>
index 8cbf0ca..acf9665 100755 (executable)
@@ -50,7 +50,7 @@ sequence in the associated alignment window views. Rectangular region
 based selection is also possible, by holding the 'S' key whilst
 left-clicking and dragging the mouse over the display. By default,
 points are only associated with the alignment view from which the PCA
 based selection is also possible, by holding the 'S' key whilst
 left-clicking and dragging the mouse over the display. By default,
 points are only associated with the alignment view from which the PCA
-was calculated, but this may be changed via the <strong>Associate
+was calculated, but this may be changed via the <strong>View&#8594;Associate
 Nodes</strong> sub-menu.</p>
 <p>Initially, the display shows the first three components of the
 similarity space, but any eigenvector can be used by changing the
 Nodes</strong> sub-menu.</p>
 <p>Initially, the display shows the first three components of the
 similarity space, but any eigenvector can be used by changing the
diff --git a/help/html/colourSchemes/textcolour.gif b/help/html/colourSchemes/textcolour.gif
new file mode 100644 (file)
index 0000000..a659156
Binary files /dev/null and b/help/html/colourSchemes/textcolour.gif differ
index 586bb06..f40116a 100644 (file)
@@ -5,12 +5,16 @@ Background Dependent Text Colour
 <body>
 <strong>Background Dependent Text Colour</strong>
 <p>The <strong>Colour&#8594;Text Colour</strong> menu entry opens
 <body>
 <strong>Background Dependent Text Colour</strong>
 <p>The <strong>Colour&#8594;Text Colour</strong> menu entry opens
-the <strong>Text Colour</strong> dialog box. This contains a slider, and
-two colour icons showing the text colour for dark backgrounds (left hand
-end of slider), and light backgrounds (right hand end of slider). Drag
-the slider to change the threshold for transitioning between dark and
-light background colours, and select either of the colour boxes to open
-a colour chooser to select a different text colour.
+the <strong>&quot;Adjust Foreground Text Colour Threshold&quot;</strong>
+dialog box, allowing the colour of symbols rendered on dark or light
+backgrounds to be set for the current selection or the whole alignment.
 </p>
 </p>
+<p><img src="textcolour.gif"></p>
+<p>The dialog box contains a slider, and two colour icons showing
+the text colour for dark backgrounds (left hand end of slider), and
+light backgrounds (right hand end of slider). Drag the slider to change
+the threshold for transitioning between dark and light background
+colours, and select either of the colour boxes to open a colour chooser
+to select a different text colour.</p>
 </body>
 </html>
 </body>
 </html>
index b0e8103..f71271a 100755 (executable)
@@ -1,56 +1,56 @@
-<html>\r
-<head><title>Editing</title></head>\r
-<body>\r
-<p><strong>Editing</strong></p>\r
-<p>There are two major ways to edit alignments - in 'Normal mode',\r
-gaps are inserted and deleted at the mouse pointer in various ways by\r
-clicking the left mouse button and pressing a combination of either\r
-shift and control (or the apple key on Macs) and dragging the mouse. Pressing\r
-<em>F2</em> toggles the alternative <a href="../features/cursorMode.html">'Cursor\r
-mode'</a> keyboard editing facility, where the space bar and delete \r
-keys add and remove gaps at the current editing position. The key\r
-strokes for both these modes are summarised in the <a\r
-href="../keys.html">keystrokes table</a>.</p>\r
-<p><strong>Tip:</strong> For large alignments, deselect &quot;Calculate -&gt; \r
-  Autocalculate Consensus&quot; to prevent the alignment performing lengthy calculations \r
-  after every edit. </p>\r
-<p><em>Inserting / removing gaps</em> - hold down the\r
-  &quot;Shift&quot; key. Click on a residue with the mouse and drag it\r
-  to the left or right to insert gaps and remove gaps.<br>\r
-  If the current selection is a group over all sequences in the\r
-  alignment, or a group over some sequences or all columns in the\r
-  alignment, then hold down either &quot;Control&quot; \r
-  key and drag the residue left or right to edit all sequences in the defined \r
-  group at once.</p>\r
-<p><em>Copy/paste/cut/delete</em> - any sequences which are in the current selection\r
-  box (indicated in red) may be cut and / or copied to a new alignment or deleted.\r
-</p>\r
-<p><em>Undo / redo</em> - editing of sequences (insertion/removal of gaps, removal\r
-  of sequences, trimming sequences etc) may be undone or redone at any time using\r
-  the appropriate menu items from the edit menu. The undo history list only allows\r
-  a maximum of 10 actions.\r
-<p><em>Trimming alignment</em> - First select a column by clicking the scale indicator\r
-  (above the sequences) The alignment may then be trimmed to the left or right\r
-  of this column. If multiple columns are selected, the alignment is trimmed to\r
-  the right of the rightmost selected column (or to the left of the leftmost selected\r
-  column)</p>\r
-<p><em>Remove gapped columns</em> - Removes columns within the alignment which\r
-  contain only space characters (&quot;-&quot; or &quot;.&quot; or &quot; &quot;)</p>\r
-<p><em>Removing gaps</em> - Removes all gaps from the alignment. Gaps are &quot;-&quot;\r
-  or &quot;.&quot; or &quot; &quot;.</p>\r
-<p><em>Set gap character</em> - Switches the gap character between &quot;.&quot; \r
-  and &quot;-&quot;. If the &quot;Render Gaps&quot; option from the &quot;View&quot; \r
-  menu is unticked all gaps will appear as blank spaces.</p>\r
-<p>&nbsp;</p>\r
-<p><strong>Editing In Selection Areas</strong></p>\r
-<a href="index.html">Editing</a> can be restricted to the current selection area. \r
-This allows the user to &quot;Lock&quot; the alignment either side of the selection \r
-area. Any gap insertions or deletions will only affect the current selection area.\r
-<p><img src="editing.jpg" width="428" height="186" align="top"></p>\r
-<p>In this example, if Sequence IL2RA_MACMU has gaps removed from position 98-104, \r
-  the same number of gaps will be inserted at position 116, (between M and L). \r
-</p>\r
-<p><em>Locked selection area based editing was introduced in Jalview 2.08</em></p>\r
-<p>&nbsp;</p>\r
-</body>\r
-</html>\r
+<html>
+<head><title>Editing</title></head>
+<body>
+<p><strong>Editing</strong></p>
+<p>There are two major ways to edit alignments - in 'Normal mode',
+gaps are inserted and deleted at the mouse pointer in various ways by
+clicking the left mouse button and pressing a combination of either
+shift and control (or the apple key on Macs) and dragging the mouse. Pressing
+<em>F2</em> toggles the alternative <a href="../features/cursorMode.html">'Cursor
+mode'</a> keyboard editing facility, where the space bar and delete 
+keys add and remove gaps at the current editing position. The key
+strokes for both these modes are summarised in the <a
+href="../keys.html">keystrokes table</a>.</p>
+<p><strong>Tip:</strong> For large alignments, deselect &quot;Calculate -&gt; 
+  Autocalculate Consensus&quot; to prevent the alignment performing lengthy calculations 
+  after every edit. </p>
+<p><em>Inserting / removing gaps</em> - hold down the
+  &quot;Shift&quot; key. Click on a residue with the mouse and drag it
+  to the left or right to insert gaps and remove gaps.<br>
+  If the current selection is a group over all sequences in the
+  alignment, or a group over some sequences or all columns in the
+  alignment, then hold down either &quot;Control&quot; 
+  key and drag the residue left or right to edit all sequences in the defined 
+  group at once.</p>
+<p><em>Copy/paste/cut/delete</em> - any sequences which are in the current selection
+  box (indicated in red) may be cut and / or copied to a new alignment or deleted.
+</p>
+<p><em>Undo / redo</em> - editing of sequences (insertion/removal of gaps, removal
+  of sequences, trimming sequences etc) may be undone or redone at any time using
+  the appropriate menu items from the edit menu. The undo history list only allows
+  a maximum of 10 actions.
+<p><em>Trimming alignment</em> - First select a column by clicking the scale indicator
+  (above the sequences) The alignment may then be trimmed to the left or right
+  of this column. If multiple columns are selected, the alignment is trimmed to
+  the right of the rightmost selected column (or to the left of the leftmost selected
+  column)</p>
+<p><em>Remove gapped columns</em> - Removes columns within the alignment which
+  contain only space characters (&quot;-&quot; or &quot;.&quot; or &quot; &quot;)</p>
+<p><em>Removing gaps</em> - Removes all gaps from the alignment. Gaps are &quot;-&quot;
+  or &quot;.&quot; or &quot; &quot;.</p>
+<p><em>Set gap character</em> - Switches the gap character between &quot;.&quot; 
+  and &quot;-&quot;. If the &quot;Render Gaps&quot; option from the &quot;View&quot; 
+  menu is unticked all gaps will appear as blank spaces.</p>
+<p>&nbsp;</p>
+<p><strong>Editing In Selection Areas</strong></p>
+Editing can be restricted to the current selection area. 
+This allows the user to &quot;Lock&quot; the alignment either side of the selection 
+area. Any gap insertions or deletions will only affect the current selection area.
+<p><img src="editing.jpg" width="428" height="186" align="top"></p>
+<p>In this example, if Sequence IL2RA_MACMU has gaps removed from position 98-104, 
+  the same number of gaps will be inserted at position 116, (between M and L). 
+</p>
+<p><em>Locked selection area based editing was introduced in Jalview 2.08</em></p>
+<p>&nbsp;</p>
+</body>
+</html>
index 486b75b..0ebb52f 100644 (file)
@@ -7,10 +7,10 @@
 <p>Jalview can create sequence features from the matches of a <a
        href="search.html">regular expression search</a>, or from the currently
 selected area via the <strong>&quot;selection&#8594;Create
 <p>Jalview can create sequence features from the matches of a <a
        href="search.html">regular expression search</a>, or from the currently
 selected area via the <strong>&quot;selection&#8594;Create
-sequence feature&quot;</strong> entry in the selection area popup menu. In both
+sequence feature&quot;</strong> entry in the <a href="../menus/popupMenu.html">selection area popup menu</a>. In both
 cases, the <strong>Create Features</strong> dialog box will then be
 opened:</p>
 cases, the <strong>Create Features</strong> dialog box will then be
 opened:</p>
-<img src="crnewfeature.gif">
+<p><img src="crnewfeature.gif"></p>
 <p>Select or enter the attributes for the features being created,
 and then press OK to create the new features.</p>
 <p>Each attribute is described below:
 <p>Select or enter the attributes for the features being created,
 and then press OK to create the new features.</p>
 <p>Each attribute is described below:
diff --git a/help/html/features/das.gif b/help/html/features/das.gif
new file mode 100644 (file)
index 0000000..1f884cb
Binary files /dev/null and b/help/html/features/das.gif differ
diff --git a/help/html/features/das.jpg b/help/html/features/das.jpg
deleted file mode 100644 (file)
index 78e061b..0000000
Binary files a/help/html/features/das.jpg and /dev/null differ
index 5dc334e..c2b4d49 100644 (file)
@@ -1,51 +1,65 @@
-<html>\r
-\r
-<head><title>DAS Features</title></head>\r
-\r
-<body>\r
-<p><strong>DAS Sequence Feature Retrieval</strong></p>\r
-<p>Jalview 2.1 can be set up to retrieve sequence features using the <a href="http://www.biodas.org">Distributed \r
-  Annotation System</a></p>\r
-<ol>\r
-  <li>Open the Feature Settings panel by selecting &quot;View -&gt; Feature Settings...&quot;</li>\r
-  <li>Click on the &quot;<a href="dassettings.html">DAS Settings</a>&quot; tabbed \r
-    pane.</li>\r
-  <li>Select the sources to use for DAS feature retireval, then click the &quot;Fetch \r
-    DAS Features&quot; button.</li>\r
-</ol>\r
-<p>If your DAS source selection contains sources which use Uniprot accession ids, \r
-  you will be asked whether Jalview should find Uniprot Accession ids for the \r
-  given sequence names. It is important to realise that many DAS sources only \r
-  use Uniprot accession ids, not names of sequences. <br>\r
-  The method of Uniprot accession id discovery is the same method which earlier \r
-  Jalview versions used for sequence feature retrieval, ie WSDbFetch provided \r
-  by the EBI.</p>\r
-<p>The process is as described:</p>\r
-<p><strong>The Sequence Identification Process</strong> </p>\r
-<p>Jalview will attempt to retrieve sequence features from Uniprot files using \r
-  the EBI dbFetch web service using the given sequence names (or Uniprot ID, if \r
-  available). A 100% match with the Uniprot record is required for Uniprot features \r
-  to be view on a sequence.</p>\r
-<p>The first step in the procedure for matching uniprot IDs to sequences is to \r
-  use the ID (name) of each sequence to retrieve Uniprot records directly.</p>\r
-<p> If a uniprot record (or set of records) is found for a sequence, then the \r
-  sequence is aligned to the one in the Uniprot record to determine the correct \r
-  start and end residue positions (which are displayed when the 'Show Full Sequence \r
-  ID' option is set). </p>\r
-<p>If the alignment reveals differences between the sequence in the alignment \r
-  and the one in the record, then Jalview will assume that the aligned sequence \r
-  is not the one in the uniprot record. </p>\r
-<p> In some cases, the ID used to retrieve Uniprot records may be out of date \r
-  and you will be notified of that a 100% match between the sequence and a Uniprot \r
-  record was identified, but the sequence name must be manually changed (by right \r
-  clicking on the sequence ID and selecting <strong>Sequence&#8594;Edit Name</strong>), \r
-  before Jalview will show its sequence features. \r
-<ul>\r
-  <li>remember to save your alignment if you have updated any of the sequence \r
-    IDs! </li>\r
-</ul>\r
-<p>&nbsp; \r
-<p>\r
-<p>&nbsp; \r
-</body>\r
-</html>\r
+<html>
+
+<head>
+<title>DAS Features</title>
+</head>
+
+<body>
+<p><strong>DAS Sequence Feature Retrieval</strong></p>
+<p>Jalview includes a client for retrieving sequence features via
+the <a href="http://www.biodas.org">Distributed Annotation System</a>.</p>
+<ol>
+       <li>Open the Feature Settings panel by selecting &quot;View -&gt;
+       Feature Settings...&quot;</li>
+       <li>Click on the &quot;<a href="dassettings.html">DAS Settings</a>&quot;
+       tabbed pane.</li>
+       <li>Select the sources to use for DAS feature retireval, then
+       click the &quot;Fetch DAS Features&quot; button.
+       <ul>
+               <li>Cancelling Feature Retrieval<br>
+               Press the <strong>Cancel Fetch</strong> button to immediately stop
+               feature retrieval. This will not remove any features already added to
+               the alignment, but will halt any outstanding DAS requests.<em>The
+               cancel fetch button is of particular use when one or more DAS
+               annotation servers are not responding!</em>
+       </ul>
+       </li>
+</ol>
+<p>If your DAS source selection contains sources which use Uniprot
+accession ids, you will be asked whether Jalview should find Uniprot
+Accession ids for the given sequence names. It is important to realise
+that many DAS sources only use Uniprot accession ids, rather than
+Swissprot/Uniprot sequence names.<br>
+<p><strong>The Sequence Identification Process</strong></p>
+The method of Uniprot accession id discovery is the same method which
+earlier Jalview versions used for sequence feature retrieval, and is now
+also used for
+<a href="viewingpdbs.html">PDB ID discovery</a>
+. Essentially, Jalview will try to retrieve Uniprot records via the
+EBI's WSDbFetch interface using each sequence's ID string (or each
+string in the ID separated by the '&#8739;' symbol).
+</p>
+<p>If a uniprot record (or set of records) is found for a sequence,
+then the sequence is aligned to the one in the Uniprot record to
+determine the correct start and end residue positions (which are
+displayed when the 'Show Full Sequence ID' option is set).</p>
+<p>If the alignment reveals differences between the sequence in the
+alignment and the one in the record, then Jalview will assume that the
+aligned sequence is not the one in the uniprot record.</p>
+<p>In some cases, the ID used to retrieve Uniprot records may be out
+of date and a dialog box will be opened indicating that a 100% match
+between the sequence and a Uniprot record was identified, but the
+sequence name is different. In this case, the ID must be manually
+changed (by right clicking on the sequence ID and selecting <strong>Sequence&#8594;Edit
+Name</strong>), before Jalview will show its sequence features.
+<ul>
+       <li><em>Note</em><br>
+       Please remember to save your alignment if either the start/end
+       numbering, or the sequence IDs were updated during the Uniprot ID
+       retrieval process.</li>
+</ul>
+<p>&nbsp;
+<p><em>DAS support was introduced in Jalview Version 2.1.</em></p>
+<p>&nbsp;
+</body>
+</html>
index f3e325d..30b36b1 100644 (file)
@@ -1,32 +1,32 @@
-<html>\r
-\r
-<head><title>DAS Settings</title></head>\r
-\r
-<body>\r
-<p><strong>DAS Settings</strong></p>\r
-<p>Jalview can retrieve and visualize features from many <a href="http://biodas.org/">DAS</a> \r
-  sources at once. The DAS sources are discovered and selected <em>via</em> the DAS settings panel.</p>\r
-<p><img src="das.jpg" width="497" height="365">\r
-<p>The available sources are listed in the table using each source's\r
-Nickname as its identifier. Clicking on a source's entry in the table\r
-reveals more information about that service in the panel to the\r
-right. Select the tickbox in the &quot;Use Source&quot; column for a\r
-source to add it to the set Jalview queries for alignment and sequence\r
-features.\r
-</p>\r
-<p>You can filter the visible DAS sources by authority, type and &quot;label&quot;. \r
-  You should read the DAS documentation to understand more about these values.\r
-<p><strong>Updating the list of sources</strong></p>\r
-<p>When the DAS Settings panel is first opened, and when the <strong>'Refresh\r
-  source'</strong> buton is pressed, a list of DAS sources\r
-  is retrieved from the DAS registry URL (set by default to the DAS\r
-  registration server at\r
-  http://das.sanger.ac.uk/registry/das1/sources/).</p>\r
-<p><strong>Adding your own DAS Sources</strong></p>\r
-<p>You can add your own DAS source to the list by clicking the &quot;Add Local \r
-  Source&quot; button. Enter the URL and nickname of your additional service. \r
-  It should be noted that Jalview 2.1 will not query additional sources for more \r
-  information, but this will be implemented in future editions. \r
-<p>&nbsp;\r
-</body>\r
-</html>\r
+<html>
+
+<head><title>DAS Settings</title></head>
+
+<body>
+<p><strong>DAS Settings</strong></p>
+<p>Jalview can retrieve and visualize features from many <a href="http://biodas.org/">DAS</a> 
+  sources at once. The DAS sources are discovered and selected <em>via</em> the DAS settings panel.</p>
+<p><img src="das.gif">
+<p>The available sources are listed in the table using each source's
+Nickname as its identifier. Clicking on a source's entry in the table
+reveals more information about that service in the panel to the
+right. Select the tickbox in the &quot;Use Source&quot; column for a
+source to add it to the set Jalview queries for alignment and sequence
+features.
+</p>
+<p>You can filter the visible DAS sources by authority, type and &quot;label&quot;. 
+  You should read the DAS documentation to understand more about these values.
+<p><strong>Updating the list of sources</strong></p>
+<p>When the DAS Settings panel is first opened, and when the <strong>'Refresh
+  source'</strong> buton is pressed, a list of DAS sources
+  is retrieved from the DAS registry URL (set by default to the DAS
+  registration server at
+  http://das.sanger.ac.uk/registry/das1/sources/).</p>
+<p><strong>Adding your own DAS Sources</strong></p>
+<p>You can add your own DAS source to the list by clicking the &quot;Add Local 
+  Source&quot; button. Enter the URL and nickname of your additional service. 
+  It should be noted that Jalview 2.1 will not query additional sources for more 
+  information, but this will be implemented in future editions. 
+<p>&nbsp;
+</body>
+</html>
index 77d62a7..b11e96b 100755 (executable)
@@ -1,77 +1,85 @@
-<html>\r
-\r
-<head><title>Sequence Features File</title></head>\r
-\r
-<body>\r
-<p><strong>Sequence Features File</strong></p>\r
-<p>The Sequence features file (which used to be known as the &quot;Groups\r
-file&quot; prior to version 2.08) is a simple way of getting\r
-your own sequence annotations into Jalview. It was introduced to allow\r
-sequence features to be rendered in the Jalview applet, and so is\r
-intentionally lightweight and minimal because the applet is often used\r
-in situations where data file size must be kept to a minimum, and no\r
-XML parser is available.</p>\r
-<p>Features files are imported into Jalview in the following ways:<br>\r
-<ul>\r
-<li>from the command line<strong><pre>\r
- -features &lt;<em>Features filename</em>&gt;</pre></strong></li>\r
-<li>Dragging a features file onto an alignment window</li>\r
-<li>Via the &quot;Load Features / Annotations&quot; entry in the\r
-<strong>File</strong> menu of an alignment window.</li>\r
-</ul>\r
-</p>\r
-<p><strong>Sequence Features File Format</strong></p>\r
-<p>A features file is a simple ASCII text file, where each line\r
-contains tab separated text fields. <strong>No comments are\r
-allowed</strong>.</p>\r
-<p>The first set of lines contain type definitions:<strong>\r
-<pre><em>Feature label</em>&#9;<em>Feature Colour</em></pre>\r
-</strong>A feature type has a text label, and a colour (specified as a\r
-red,green,blue 24 bit triplet either in hexadecimal (eg. 00ff00) or as comma\r
-separated numbers (ranging from 0 to 255)).\r
-<p>The remaining lines in the file are the sequence annotation\r
-definitions, where the now defined features are attached to regions on\r
-particular sequences, optionally with some descriptive text (displayed\r
-in a tooltip when the mouse is near the feature on that sequence). There are two alternate ways of referring to a\r
-sequence, either by its text ID, or its index in an associated\r
-alignment.<pre>\r
-<em>description</em>&#9;<em>sequenceId</em>&#9;<em>sequenceIndex</em>&#9;<em>start</em>&#9;<em>end</em>&#9;<em>featureType</em></pre>Normally,\r
-sequence features are associated with sequences rather than\r
-alignments, and the sequenceIndex field is given as &quot;-1&quot;. In\r
-order to specify a sequence by its index in a particular alignment, the\r
-sequenceId should be given as &quot;ID_NOT_SPECIFIED&quot;, otherwise the\r
-sequenceId field will be used in preference to the sequenceIndex field.</p><p>\r
-Feature annotations can be collected into named groups by prefixing\r
-definitions with lines of the\r
-form:<strong><pre>startgroup&#9;groupname</pre></strong>.. and\r
-subsequently post-fixing the group\r
-with:<strong><pre>endgroup&#9;groupname</pre></strong>Feature grouping\r
-was introduced in version 2.08, and used to control whether a set of features\r
-are either hidden or shown together in the <a href="seqfeatures.html">sequence Feature settings\r
-dialog box</a>.</p>\r
-<p>A complete example is shown below :<pre>\r
-domain&#9;red\r
-metal ion-binding site&#9;00ff00\r
-transit peptide&#9;0,105,215\r
-chain&#9;225,105,0\r
-modified residue&#9;105,225,35\r
-signal peptide&#9;0,155,165\r
-helix&#9;ff0000\r
-strand&#9;00ff00\r
-coil&#9;cccccc\r
-Your Own description here&#9;FER_CAPAA&#9;-1&#9;3&#9;93&#9;domain\r
-Your Own description here&#9;FER_CAPAN&#9;-1&#9;48&#9;144&#9;chain\r
-Your Own description here&#9;FER_CAPAN&#9;-1&#9;50&#9;140&#9;domain\r
-Your Own description here&#9;FER_CAPAN&#9;-1&#9;136&#9;136&#9;modified residue\r
-Your Own description here&#9;FER1_LYCES&#9;-1&#9;1&#9;47&#9;transit peptide\r
-Your Own description here&#9;Q93XJ9_SOLTU&#9;-1&#9;1&#9;48&#9;signal peptide\r
-Your Own description here&#9;Q93XJ9_SOLTU&#9;-1&#9;49&#9;144&#9;chain\r
-startgroup&#9;secondarystucture\r
-PDB secondary structure annotation&#9;FER1_SPIOL&#9;-1&#9;52&#9;59&#9;strand\r
-PDB secondary structure annotation&#9;FER1_SPIOL&#9;-1&#9;74&#9;80&#9;helix\r
-endgroup&#9;secondarystructure\r
-</pre>\r
-</li>\r
-</p>\r
-</body>\r
-</html>\r
+<html>
+
+<head>
+<title>Sequence Features File</title>
+</head>
+
+<body>
+<p><strong>Sequence Features File</strong></p>
+<p>The Sequence features file (which used to be known as the
+&quot;Groups file&quot; prior to version 2.08) is a simple way of
+getting your own sequence annotations into Jalview. It was introduced to
+allow sequence features to be rendered in the Jalview applet, and so is
+intentionally lightweight and minimal because the applet is often used
+in situations where data file size must be kept to a minimum, and no XML
+parser is available.</p>
+<p>Features files are imported into Jalview in the following ways:<br>
+<ul>
+       <li>from the command line<strong><pre>
+ -features &lt;<em>Features filename</em>&gt;</pre></strong></li>
+       <li>Dragging a features file onto an alignment window</li>
+       <li>Via the &quot;Load Features / Annotations&quot; entry in the <strong>File</strong>
+       menu of an alignment window.</li>
+</ul>
+</p>
+<p><strong>Sequence Features File Format</strong></p>
+<p>A features file is a simple ASCII text file, where each line
+contains tab separated text fields. <strong>No comments are
+allowed</strong>.</p>
+<p>The first set of lines contain type definitions:<strong>
+<pre><em>Feature label</em>&#9;<em>Feature Colour</em></pre> </strong>A feature
+type has a text label, and a colour (specified as a red,green,blue 24
+bit triplet either in hexadecimal (eg. 00ff00) or as comma separated
+numbers (ranging from 0 to 255)). The text label may contain simple HTML
+document body tags if enclosed by &quot;&lt;html&gt;&lt;/html&gt;&quot;
+and will be rendered as formatted tooltips in the Jalview Application
+(the Jalview applet is not capable of rendering HTML tooltips, so all
+formatting tags will be removed.</p>
+<p>The remaining lines in the file are the sequence annotation
+definitions, where the now defined features are attached to regions on
+particular sequences, optionally with some descriptive text (displayed
+in a tooltip when the mouse is near the feature on that sequence). There
+are two alternate ways of referring to a sequence, either by its text
+ID, or its index in an associated alignment.
+<pre>
+<em>description</em>&#9;<em>sequenceId</em>&#9;<em>sequenceIndex</em>&#9;<em>start</em>&#9;<em>end</em>&#9;<em>featureType</em></pre>
+Normally, sequence features are associated with sequences rather than
+alignments, and the sequenceIndex field is given as &quot;-1&quot;. In
+order to specify a sequence by its index in a particular alignment, the
+sequenceId should be given as &quot;ID_NOT_SPECIFIED&quot;, otherwise
+the sequenceId field will be used in preference to the sequenceIndex
+field.
+</p>
+<p>Feature annotations can be collected into named groups by
+prefixing definitions with lines of the form:<strong><pre>startgroup&#9;groupname</pre></strong>..
+and subsequently post-fixing the group with:<strong><pre>endgroup&#9;groupname</pre></strong>Feature
+grouping was introduced in version 2.08, and used to control whether a
+set of features are either hidden or shown together in the <a
+       href="seqfeatures.html">sequence Feature settings dialog box</a>.</p>
+<p>A complete example is shown below :
+<pre>
+domain&#9;red
+metal ion-binding site&#9;00ff00
+transit peptide&#9;0,105,215
+chain&#9;225,105,0
+modified residue&#9;105,225,35
+signal peptide&#9;0,155,165
+helix&#9;ff0000
+strand&#9;00ff00
+coil&#9;cccccc
+Your Own description here&#9;FER_CAPAA&#9;-1&#9;3&#9;93&#9;domain
+Your Own description here&#9;FER_CAPAN&#9;-1&#9;48&#9;144&#9;chain
+Your Own description here&#9;FER_CAPAN&#9;-1&#9;50&#9;140&#9;domain
+Your Own description here&#9;FER_CAPAN&#9;-1&#9;136&#9;136&#9;modified residue
+Your Own description here&#9;FER1_LYCES&#9;-1&#9;1&#9;47&#9;transit peptide
+Your Own description here&#9;Q93XJ9_SOLTU&#9;-1&#9;1&#9;48&#9;signal peptide
+Your Own description here&#9;Q93XJ9_SOLTU&#9;-1&#9;49&#9;144&#9;chain
+startgroup&#9;secondarystucture
+PDB secondary structure annotation&#9;FER1_SPIOL&#9;-1&#9;52&#9;59&#9;strand
+PDB secondary structure annotation&#9;FER1_SPIOL&#9;-1&#9;74&#9;80&#9;helix
+endgroup&#9;secondarystructure
+</pre>
+</li>
+</p>
+</body>
+</html>
index c5266d7..66413d9 100644 (file)
@@ -1,51 +1,64 @@
 <html>
 <html>
-<head><title>Hidden Regions</title></head>
+<head>
+<title>Hidden Regions</title>
+</head>
 <body>
 <body>
-<p><strong>Hidden Regions</strong> </p>
-<p>Use the keyboard key &quot;H&quot; to hide / reveal selected columns and sequences. 
-  To hide / reveal only selected sequences, use &quot;Shift H&quot;, to hide / 
-  reveal only selected columns, use &quot;Control H&quot;.</p>
+<p><strong>Hidden Regions</strong></p>
+<p>Use the keyboard key &quot;H&quot; to hide / reveal selected
+columns and sequences. To hide / reveal only selected sequences, use
+&quot;Shift H&quot;, to hide / reveal only selected columns, use
+&quot;Control H&quot;.</p>
 <p><strong><em>Hiding Sequences</em></strong><br>
 <p><strong><em>Hiding Sequences</em></strong><br>
-To hide selected sequences in an alignment, use the <strong>&quot;View 
-  -&gt; Hide -&gt; Selected Sequences&quot;</strong> menu item or simply select <strong>&quot;Hide 
-  Sequences&quot;</strong> from the Popup menu after a right click on the sequence Ids. 
-</p>
-<p>Hidden sequences will not be used in any calculations, editing or web service 
-  alignments performed on visible sequences. </p>
+To hide selected sequences in an alignment, use the <strong>&quot;View
+-&gt; Hide -&gt; Selected Sequences&quot;</strong> menu item or simply select <strong>&quot;Hide
+Sequences&quot;</strong> from the Popup menu after a right click on the sequence
+Ids.</p>
+<p>Hidden sequences will not be used in any calculations, editing or
+web service alignments performed on visible sequences.</p>
 <p><strong><em>Hidden Sequences Representatives</em></strong><br>
 <p><strong><em>Hidden Sequences Representatives</em></strong><br>
-A more advanced hide involves a right-mouse click on a sequence, then selecting 
-  <strong>&quot;SequenceID -&gt; Represent Group with SequenceId&quot;</strong>. Using this method 
-  of hiding sequences, any edits performed on the visible group representative 
-  will be propogated to all the sequences in that group. <br>
-  The hidden representative sequences will not be used in any
-  calculations or web service alignments (<em>nb. this may change in
-  the future</em>)
-</p>
+A more advanced hide involves a right-mouse click on a sequence, then
+selecting <strong>&quot;SequenceID -&gt; Represent Group with
+SequenceId&quot;</strong>. Using this method of hiding sequences, any edits
+performed on the visible group representative will be propogated to all
+the sequences in that group. <br>
+The hidden representative sequences will not be used in any calculations
+or web service alignments (<em>nb. this may change in the future</em>).
+<br>
+<strong>Warning:</strong>The representative sequence groups feature is
+not fully implemented in the jalview 2.2 release, following the
+introduction of Multiple views.</p>
 <p><strong><em>Hiding Columns</em></strong><br>
 <p><strong><em>Hiding Columns</em></strong><br>
-To hide selected columns in an alignment, use the <strong>&quot;View 
-  -&gt; Hide -&gt; Selected Columns&quot;</strong> menu item, or right click within a region 
-  of selected columns in the scale above the alignment (only available in non 
-  wrapped mode) and select <strong>&quot;Hide Columns&quot;</strong>. </p>
-<p>When an alignment view contains hidden columns, certain constraints
-apply:<ul><li>Editing the alignment is bound by the hidden columns, <em>i.e.</em> you cannot move residues 
-  across a hidden column boundary.</li>
-<li><strong>Tree</strong>, <strong>pairwise alignment</strong> and <strong>PCA</strong> calculations will only be
-performed using the <em>visible</em> parts of the alignment.
-</li>
-<li><a
-  href="../webservices/msaclient.html">Multiple Sequence
-  Alignments</a> are performed locally on on each visible chunk of
-  the input, and concatenated with the hidden regions to form the
-  final result.</p>
-</li>
+To hide selected columns in an alignment, use the <strong>&quot;View
+-&gt; Hide -&gt; Selected Columns&quot;</strong> menu item, or right click within
+a region of selected columns in the scale above the alignment (only
+available in non wrapped mode) and select <strong>&quot;Hide
+Columns&quot;</strong>.</p>
+<p>When an alignment view contains hidden columns, certain
+constraints apply:
+<ul>
+       <li>Editing the alignment is bound by the hidden columns, <em>i.e.</em>
+       you cannot move residues across a hidden column boundary.</li>
+       <li><strong><a href="../calculations/tree.html">Tree</a></strong>,
+       <strong><a href="../calculations/pairwise.html">pairwise
+       alignment</a></strong> and <strong><a href="../calculations/pca.html">PCA</a></strong>
+       calculations will only be performed using the <em>visible</em> parts of
+       the alignment.</li>
+       <li><a href="../webservices/msaclient.html">Multiple Sequence
+       Alignments</a> are performed locally on on each visible chunk of the input,
+       and concatenated with the hidden regions to form the final result.
+       </p>
+       </li>
 </ul>
 </ul>
-<p><strong>Column Separability</strong><br>Calculations where hidden columns are
-  excluded, and a single analysis performed on the result, are termed <em>column-separable</em>.
-  The simple Tree and PCA calculations are column separable because essentially the same results
-  would be obtained if the excluded hidden columns were replaced by gaps as the input to the calculation.</p>
-  <p>Multiple Sequence alignment and secondary structure prediction are both non-column-separable, and 
-  so the exclusion of hidden regions leads to only 'locally optimal' results - sometimes 
-  different to that obtained when using the full alignment.</p>
+<p><strong>Column Separability</strong><br>
+Calculations where hidden columns are excluded, and a single analysis
+performed on the result, are termed <em>column-separable</em>. The
+simple Tree and PCA calculations are column separable because
+essentially the same results would be obtained if the excluded hidden
+columns were replaced by gaps as the input to the calculation.</p>
+<p>Multiple Sequence alignment and secondary structure prediction
+are both non-column-separable, and so the exclusion of hidden regions
+leads to only 'locally optimal' results - sometimes different to that
+obtained when using the full alignment.</p>
 <p>&nbsp;</p>
 <p>&nbsp;</p>
 <p>&nbsp;</p>
 <p>&nbsp;</p>
 <p>&nbsp;</p>
 <p>&nbsp;</p>
index c4929e5..36bda32 100644 (file)
@@ -4,14 +4,14 @@
 </head>
 <body>
 <p><strong>Multiple Alignment Views<strong></p>
 </head>
 <body>
 <p><strong>Multiple Alignment Views<strong></p>
-<p>Multiple alignment views allow's the same alignment to be viewed
-in many different ways, either as multiple alignment tabs, or
-simultaneously in linked alignment windows. A view is an independent
-visualization of the same alignment, so each may have a different
-ordering, colouring, row and column hiding and seuqence feature and
-annotation display setting, but alignment, feature and annotation edits
-are common to all, since this affects the underlying data.</p>
-<p>A new view is created using the <strong>&quot;View&#8594;New
+<p>Multiple alignment views allows the same alignment to be viewed
+independently in many different ways simultaneously. Each view is an
+independent visualization of the same alignment, so each may have a
+different ordering, colouring, row and column hiding and seuqence
+feature and annotation display setting, but alignment, feature and
+annotation edits are common to all, since this affects the underlying
+data.</p>
+<p>Create a new view using the <strong>&quot;View&#8594;New
 View&quot;</strong> menu item, or by pressing <strong>Control+T</strong>. A newly
 created view will be identical to the view it was created from, but any
 changes to the way the alignment is coloured or displayed will only
 View&quot;</strong> menu item, or by pressing <strong>Control+T</strong>. A newly
 created view will be identical to the view it was created from, but any
 changes to the way the alignment is coloured or displayed will only
@@ -29,15 +29,22 @@ to expand each view into its own linked alignment window. Expanded views
 are gathered back into into a single tabbed alignment window by pressing
 <strong>G</strong>, or by selecting <strong>&quot;View&#8594;Gather&quot;</strong>).
 </p>
 are gathered back into into a single tabbed alignment window by pressing
 <strong>G</strong>, or by selecting <strong>&quot;View&#8594;Gather&quot;</strong>).
 </p>
-<p><strong>Tree Viewers, PCA Viewers, and Multiple Views</strong></p>
+<p><strong>Structure and Analysis Viewers and Multiple
+Views</strong></p>
 <p>A tree calculated on a particular view, or loaded onto it, is by
 default associated with just that view. However, the <a
        href="../calculations/treeviewer.html">Tree Viewer's</a> <strong>&quot;View&#8594;Associate
 leaves&quot;</strong> submenu allows a tree's view association to be changed to
 to any or all other views.</p>
 <p>A tree calculated on a particular view, or loaded onto it, is by
 default associated with just that view. However, the <a
        href="../calculations/treeviewer.html">Tree Viewer's</a> <strong>&quot;View&#8594;Associate
 leaves&quot;</strong> submenu allows a tree's view association to be changed to
 to any or all other views.</p>
-<p>The results of a <a href="../calculations/pca.html">PCA calculation</a> on a particular view
-may also be associated with other views, using the <strong>&quot;Associate
+<p>The results of a <a href="../calculations/pca.html">PCA
+calculation</a> on a particular view may also be associated with other
+views, using the PCA Viewer's <strong>&quot;View&#8594;Associate
 Nodes&quot;</strong> submenu.</p>
 Nodes&quot;</strong> submenu.</p>
+<p>A <a href="pdbviewer.html">PDB Structure Viewer</a> opened on a
+structure associated with a sequence in a particular view will also, by
+default, only be associated with the sequence as it is displayed in that
+view. The &quot;View&#8594;Associate View&quot; submenu allows the
+association of alternative views.</p>
 <p><em>Multiple Views were introduced in Jalview 2.2</em></p>
 </body>
 </html>
 <p><em>Multiple Views were introduced in Jalview 2.2</em></p>
 </body>
 </html>
index 110e21c..8fd671e 100644 (file)
@@ -4,10 +4,11 @@
 <strong>New Key Strokes and Menus</strong>
 <p>Many new <a href="../keys.html">keyboard shortcuts</a> have been
 added in Jalview 2.2 to make editing, selecting and navigating an
 <strong>New Key Strokes and Menus</strong>
 <p>Many new <a href="../keys.html">keyboard shortcuts</a> have been
 added in Jalview 2.2 to make editing, selecting and navigating an
-alignment even easier. Some of the commands in the <strong>Edit</strong>
-and <strong>View</strong> menus present in earlier releases have also
-been moved into their own <strong>Select</strong> and <strong>Format</strong>
-menus. Some of the important new keystrokes are shown below :
+alignment even easier. The selection commands in the <strong>Edit</strong>
+menu, and the alignment formatting controls within the <strong>View</strong>
+menu have also been moved into their own respective <strong>Select</strong>
+and <strong>Format</strong> menus.</p>
+<p>Some of the most important new keystrokes are shown below :
 <ul>
        <li><strong>Page Up</strong> and <strong>Page Down</strong>
        scrolls through the alignment view.</li>
 <ul>
        <li><strong>Page Up</strong> and <strong>Page Down</strong>
        scrolls through the alignment view.</li>
index bd240ea..97471a2 100755 (executable)
-<html>\r
-<head><title>PDB Viewer</title></head>\r
-<body>\r
-<p><strong>The PDB Viewer Window</strong>\r
-<p>This interactive structure viewing window is opened by selecting the\r
-<strong>&quot;Sequence&#8594;View PDB\r
-entry:&quot;</strong> entry in the <a\r
-href="../menus/popupMenu.html">sequence id pop-up menu</a>. This can only be\r
-done for sequences which have an <a href="viewingpdbs.html">associated\r
-PDB structure</a>.</p>\r
-<p><strong>Controls</strong></p>\r
-<p>The structure is rendered as an alpha-carbon trace. \r
-Moving the mouse over the structure brings up tooltips with a\r
-residue name and PDB sequence position. If a mapping exists to a\r
-residue in the associated sequence, then this will be highlighted in\r
-the alignment window, and vice versa for viewing the coordinates\r
-associated with a particular residue in the sequence.</p>\r
-<p>Selecting a residue highlights its associated sequence residue and\r
-alpha carbon location.</p>\r
-<p><table>\r
-<tr><td><strong>Action</strong></td><td><strong>Windows</strong></td><td><strong>Unix</strong></td><td><strong>Mac/OSX</strong></td></tr>\r
-<tr><td>Select/<br>Deselect<br>Residue</td><td>Left Click</td><td>Left\r
-Click</td><td>Click</td></tr>\r
-<tr><td>Rotate View</td><td>Left Click and Drag</td><td>Left Click and\r
-Drag</td><td>Click and Drag</td></tr>\r
-<tr><td>Roll View</td><td>Right Click and drag</td><td>Right Click and\r
-Drag</td><td>TODO</td></tr>\r
-<tr><td>Move Origin</td><td>Middle-Button and\r
-Drag</td><td>Middle-Button and Drag</td><td>TODO</td></tr>\r
-<tr><td>Zoom In</td><td>Up Arrow</td><td>Up Arrow</td><td>Up\r
-Arrow</td></tr>\r
-<tr><td>Zoom Out</td><td>Down Arrow</td><td>Down Arrow</td><td>Down Arrow</td></tr>\r
-</table>\r
-</p>\r
-<p>There are three menus:\r
-<ul>\r
-<li><Strong>File<br></strong><ul>\r
-<li><strong>Save As<br></strong><em>Saves the current view as an EPS or PNG file.</em>\r
-</li>\r
-<li><strong>View Mapping<br></strong><em>\r
-Opens a text window showing the alignment between the residues\r
-corresponding to alpha-carbon atoms in the PDB structure and the\r
-residues in the associated sequence.</em>\r
-</li>\r
-</ul>\r
-</li>\r
-<li><strong>Colours<br></strong><ul>\r
-<li><strong>By Sequence<br></strong><em>\r
-Colours each residue in the structure with the colour of its\r
-corresponding residue in the associated sequence as rendered in the\r
-alignment window, including any Uniprot sequence features or region\r
-colourings.<br>Residues which only exist in the PDB structure are\r
-coloured white if they are insertions (relative to the associated\r
-sequence in the alignment) and grey if they are N or C terminal\r
-flanks outside the region mapped to the alignment window's sequence.</em></li>\r
-<li><strong>By Chain<br></strong><em>\r
-Assigns a random colour to each PDB chain.</em>\r
-<li><strong>Charge &amp; Cysteine<br></strong><em>\r
-Highlights cysteines in yellow, anionic (Aspartic Acid or Glutamic Acid) residues in red, and\r
-cationic (Lysine or Arginine) residues in blue.</em>\r
-</li>\r
-<li><strong><em>Standard and User Defined Jalview colourschemes.<br></em></strong>\r
-The remaining entries apply the colourschemes available from the\r
-standard and user defined <a href="../colourSchemes/index.html">amino acid colours</a>.</em>\r
-</li>\r
-</ul>\r
-</li>\r
-<li><strong>View<br></strong><em>\r
-These options can be turned off to improve performance when viewing\r
-large structures, some at the expense of visual clarity.</em><ul>\r
-<li><strong>Wireframe<br></strong><em>\r
-Draws thin lines rather than thick lines for the\r
-alpha-carbon trace.</em>\r
-</li><li><strong>Depthcue<br></strong><em>Shades the structure so parts of the structure near\r
-the front of the view are brighter than those further away.</em>\r
-</li><li><strong>Z Buffering<br></strong><em>\r
-Applies depth sorting to correctly render occluded regions of the\r
-backbone trace.</em>\r
-</li>\r
-<li><strong>Show All Chains<br></strong><em>\r
-When turned on, shows all chains in the PDB file, not just the one\r
-associated with a sequence in the alignment window.</em>\r
-</li>\r
-</ul>\r
-</li>\r
-</ul>\r
-</p>\r
-<p><strong>Notes for PDB Viewing in the Jalview Applet</strong>\r
-<p>The applet can only load PDB files by copying and pasting the text into \r
-  the popup window which appears when &quot;Show PDB Structure&quot; is selected \r
-  after right clicking on a sequence name.</p>\r
-</body>\r
-</html>\r
+<html>
+<head>
+<title>PDB Viewer</title>
+</head>
+<body>
+<p><strong>The PDB Viewer Window</strong>
+<p>This interactive structure viewing window is opened by selecting
+the <strong>&quot;Sequence&#8594;View PDB entry:&quot;</strong> entry in
+the <a href="../menus/popupMenu.html">sequence id pop-up menu</a>. This
+can only be done for sequences which have an <a href="viewingpdbs.html">associated
+PDB structure</a>.</p>
+<p><strong>Controls</strong></p>
+<p>The structure is rendered as an alpha-carbon trace. Moving the
+mouse over the structure brings up tooltips with a residue name and PDB
+sequence position. If a mapping exists to a residue in the associated
+sequence, then this will be highlighted in the associated view in its
+alignment window, and vice versa for viewing the coordinates associated
+with a particular residue in the sequence in a particular view on the
+alignment.</p>
+<p>Selecting a residue highlights its associated sequence residue
+and alpha carbon location.</p>
+<p>
+<table>
+       <tr>
+               <td><strong>Action</strong></td>
+               <td><strong>Windows</strong></td>
+               <td><strong>Unix</strong></td>
+               <td><strong>Mac/OSX</strong></td>
+       </tr>
+       <tr>
+               <td>Select/<br>
+               Deselect<br>
+               Residue</td>
+               <td>Left Click</td>
+               <td>Left Click</td>
+               <td>Click</td>
+       </tr>
+       <tr>
+               <td>Rotate View</td>
+               <td>Left Click and Drag</td>
+               <td>Left Click and Drag</td>
+               <td>Click and Drag</td>
+       </tr>
+       <tr>
+               <td>Roll View</td>
+               <td>Right Click and drag</td>
+               <td>Right Click and Drag</td>
+               <td>TODO</td>
+       </tr>
+       <tr>
+               <td>Move Origin</td>
+               <td>Middle-Button and Drag</td>
+               <td>Middle-Button and Drag</td>
+               <td>TODO</td>
+       </tr>
+       <tr>
+               <td>Zoom In</td>
+               <td>Up Arrow</td>
+               <td>Up Arrow</td>
+               <td>Up Arrow</td>
+       </tr>
+       <tr>
+               <td>Zoom Out</td>
+               <td>Down Arrow</td>
+               <td>Down Arrow</td>
+               <td>Down Arrow</td>
+       </tr>
+</table>
+</p>
+<p>There are three menus:
+<ul>
+       <li><Strong>File<br>
+       </strong>
+       <ul>
+               <li><strong>Save As<br>
+               </strong><em>Saves the current view as an EPS or PNG file.</em></li>
+               <li><strong>View Mapping<br>
+               </strong><em> Opens a text window showing the alignment between the
+               residues corresponding to alpha-carbon atoms in the PDB structure and
+               the residues in the associated sequence.</em></li>
+       </ul>
+       </li>
+       <li><strong>Colours<br>
+       </strong>
+       <ul>
+               <li><strong>By Sequence<br>
+               </strong><em> Colours each residue in the structure with the colour of its
+               corresponding residue in the associated sequence as rendered in the
+               associated alignment view, including any Uniprot sequence features or
+               region colourings.<br>
+               Residues which only exist in the PDB structure are coloured white if
+               they are insertions (relative to the associated sequence in the
+               alignment) and grey if they are N or C terminal flanks outside the
+               region mapped to the alignment window's sequence.</em></li>
+               <li><strong>By Chain<br>
+               </strong><em> Assigns a random colour to each PDB chain.</em>
+               <li><strong>Charge &amp; Cysteine<br>
+               </strong><em> Highlights cysteines in yellow, anionic (Aspartic Acid or
+               Glutamic Acid) residues in red, and cationic (Lysine or Arginine)
+               residues in blue.</em></li>
+               <li><strong><em>Standard and User Defined Jalview
+               colourschemes.<br>
+               </em></strong> The remaining entries apply the colourschemes available from the
+               standard and user defined <a href="../colourSchemes/index.html">amino
+               acid colours</a>.</em></li>
+       </ul>
+       </li>
+       <li><strong>View<br>
+       </strong><em> These options can be turned off to improve performance when
+       viewing large structures, some at the expense of visual clarity.</em>
+       <ul>
+               <li><strong>Wireframe<br>
+               </strong><em> Draws thin lines rather than thick lines for the
+               alpha-carbon trace.</em></li>
+               <li><strong>Depthcue<br>
+               </strong><em>Shades the structure so parts of the structure near the front
+               of the view are brighter than those further away.</em></li>
+               <li><strong>Z Buffering<br>
+               </strong><em> Applies depth sorting to correctly render occluded regions
+               of the backbone trace.</em></li>
+               <li><strong>Show All Chains<br>
+               </strong><em> When turned on, shows all chains in the PDB file, not just
+               the one associated with a sequence in the alignment window.</em></li>
+               <li><strong>Associate View</strong><br>
+               Change which view on the associated sequence's alignment is to be
+               associated with the PDB viewer.
+       </ul>
+       </li>
+</ul>
+</p>
+<p><strong>Notes for PDB Viewing in the Jalview Applet</strong>
+<p>The applet can only load PDB files by copying and pasting the
+text into the popup window which appears when &quot;Show PDB
+Structure&quot; is selected after right clicking on a sequence name.</p>
+</body>
+</html>
index d57de42..094fcbb 100755 (executable)
@@ -1,48 +1,57 @@
-<html>\r
-<head><title>Input/Output</title></head>\r
-<body>\r
-<p><strong>Input</strong></p>\r
-<p>Jalview can read alignment files in any of the following standard formats:</p>\r
-<p><em>Fasta (Pearson), GCG-MSF, ALN/ClustalW, AMPS Block file,\r
-NBRF/PIR (including MODELLER variant), Pfam/Stockholm</em></p>\r
-<p>The EBI has <a href="http://www.ebi.ac.uk/help/formats.html">examples</a> of\r
-  these file formats.</p>\r
-<p>Additionally, annotated whole sets of alignments and trees can be\r
-read from a <a href="../features/jalarchive.html">Jalview (jar)\r
-format</a> file using <strong>Desktop&#8594;Load\r
-Project</strong>. </p>\r
-<p>Use the <strong>Desktop&#8594;Input Alignment</strong> menu to read in files from:</p>\r
-<ul>\r
-  <li><strong>From File</strong>: the local file system</li>\r
-  <li><strong>From URL</strong>: the web (please use the full url)</li>\r
-  <li><strong>from Textbox</strong>: a copy and paste into the\r
-  &quot;Cut &amp; Paste&quot; text window</li>\r
-</ul>\r
-<p>Jalview will try to recognise the file type automatically (using\r
-some special <a href="fileformats.html">features</a>). If a\r
-file is of an unknown format or there is any other error reading the\r
-alignment file then you will be given an error message. If you think\r
-Jalview really should be able to read your file, then send an email\r
-containing the problem file to jalview@jalview.org.\r
-</p>\r
-<p>Jalview can also read jalview specific files for <a href="../features/featuresFormat.html">sequence features</a>\r
-and <a href="../features/annotationsFormat.html">alignment annotation</a>.</p>\r
-<p><strong>Output</strong> </p>\r
-<p>Each alignment, whether it is the original or an edited version may be saved\r
-  in the standard formats using <strong>File&#8594;Save As</strong></p>\r
-<p><em>Fasta (Pearson), GCG-MSF, ALN/ClustalW, AMPS Block file, NBRF/PIR, Pfam/Stockholm</em></p>\r
-Jalview will by default append the sequence start and end to each sequence name, \r
-in the format /start-end. If you do not want this behaviour for a particular file \r
-output, open the &quot;Output&quot; tab on the <a href="../features/preferences.html">Preferences</a> window where you can \r
-select which file formats you want to append the start and end sequence positions \r
-for. In the case of PIR format, the output tab also contains a switch\r
-for turning on the output of Modeller style structured description\r
-lines.\r
-<p>Quantitative and symbolic <a href="../features/annotation.html">alignment annotation</a> can be exported as a\r
-comma separated value file by right clicking on an annotation row\r
-under the alignment.</p>\r
-<p>You can also save the current set of alignments and their colours, annotations and\r
-trees in a Jalview archive file using <strong>Desktop&#8594;Save project</strong>. </p>\r
-<p>&nbsp;</p>\r
-</body>\r
-</html>\r
+<html>
+<head>
+<title>Input/Output</title>
+</head>
+<body>
+<p><strong>Input</strong></p>
+<p>Jalview can read alignment files in any of the following standard
+formats:</p>
+<p><em>Fasta (Pearson), GCG-MSF, ALN/ClustalW, AMPS Block file,
+NBRF/PIR (including MODELLER variant), Pfam/Stockholm</em></p>
+<p>The EBI has <a href="http://www.ebi.ac.uk/help/formats.html">examples</a>
+of these file formats.</p>
+<p>Additionally, whole sets of coloured and annotated alignments and
+trees can be read from a <a href="../features/jalarchive.html">Jalview
+(jar) format</a> file using <strong>Desktop&#8594;Load Project</strong>.</p>
+<p>Press &quot;Control O&quot; to open a file browser, or use
+the <strong>Desktop&#8594;Input Alignment</strong> menu to read in
+alignments from:</p>
+<ul>
+       <li><strong>From File</strong>: the local file system</li>
+       <li><strong>From URL</strong>: the web (please use the full url)</li>
+       <li><strong>from Textbox</strong>: a copy and paste into the
+       &quot;Cut &amp; Paste&quot; text window</li>
+</ul>
+<p>Jalview will try to recognise the file type automatically (using
+some special <a href="fileformats.html">features</a>). If a file is of
+an unknown format or there is any other error reading the alignment file
+then you will be given an error message. If you think Jalview really
+should be able to read your file, then send an email containing the
+problem file to jalview@jalview.org.</p>
+<p>Jalview can also read jalview specific files for <a
+       href="../features/featuresFormat.html">sequence features</a> and <a
+       href="../features/annotationsFormat.html">alignment annotation</a>.</p>
+<p><strong>Output</strong></p>
+<p>Each alignment, whether it is the original or an edited version
+may be saved in the standard formats using <strong>File&#8594;Save
+As</strong></p>
+<p><em>Fasta (Pearson), GCG-MSF, ALN/ClustalW, AMPS Block file,
+NBRF/PIR, Pfam/Stockholm</em></p>
+Jalview will by default append the sequence start and end to each
+sequence name, in the format /start-end. If you do not want this
+behaviour for a particular file output, open the &quot;Output&quot; tab
+on the
+<a href="../features/preferences.html">Preferences</a>
+window where you can select which file formats you want to append the
+start and end sequence positions for. In the case of PIR format, the
+output tab also contains a switch for turning on the output of Modeller
+style structured description lines.
+<p>Quantitative and symbolic <a href="../features/annotation.html">alignment
+annotation</a> can be exported as a comma separated value file by right
+clicking on an annotation row under the alignment.</p>
+<p>You can also save the current set of alignments and their
+colours, annotations and trees in a Jalview archive file using <strong>Desktop&#8594;Save
+project</strong>.</p>
+<p>&nbsp;</p>
+</body>
+</html>
index 376792f..0795189 100755 (executable)
                determine which <a href="../io/index.html">alignment format</a> to
                save as.</em></li>
                <li><strong>Output to Textbox<br>
                determine which <a href="../io/index.html">alignment format</a> to
                save as.</em></li>
                <li><strong>Output to Textbox<br>
-               </strong><em>The alignment will be displayed in plain text in a new window
-               which you can &quot;Copy and Paste&quot; using the pull down menu, or
-               your standard operating system copy and paste keys. <br>
+               </strong><em>The alignment will be displayed in plain text in a new
+               window, which you can &quot;Copy and Paste&quot; using the pull down
+               menu, or your standard operating system copy and paste keys. The
+               output window also has a <strong>&quot;New Window&quot;</strong>
+               button to import the (possibly edited) text as a new alignment.<br>
                Select the format of the text by selecting one of the following menu
                items.</em>
                <ul>
                Select the format of the text by selecting one of the following menu
                items.</em>
                <ul>
index eb45924..bf1fed5 100755 (executable)
        Add sequences to the visible alignment from file, URL, or cut &amp;
        paste window </em></li>
        <li><strong>Reload</strong><em><br>
        Add sequences to the visible alignment from file, URL, or cut &amp;
        paste window </em></li>
        <li><strong>Reload</strong><em><br>
-       Reloads the alignment from the original file, if available.<br><strong>Warning:
-       This will delete any edits, analyses and colourings applied since the
-       alignment was last saved, and cannot be undone.</strong></em></li>
+       Reloads the alignment from the original file, if available.<br>
+       <strong>Warning: This will delete any edits, analyses and
+       colourings applied since the alignment was last saved, and cannot be
+       undone.</strong></em></li>
        <li><strong>Save (Control S)</strong><em><br>
        Saves the alignment to the file it was loaded from (if available), in
        the same format, updating the original in place. </em></li>
        <li><strong>Save (Control S)</strong><em><br>
        Saves the alignment to the file it was loaded from (if available), in
        the same format, updating the original in place. </em></li>
        open, use the &quot;Files of type:&quot; selection box to determine
        which <a href="../io/index.html">alignment format</a> to save as.</em></li>
        <li><strong>Output to Textbox<br>
        open, use the &quot;Files of type:&quot; selection box to determine
        which <a href="../io/index.html">alignment format</a> to save as.</em></li>
        <li><strong>Output to Textbox<br>
-       </strong><em>The alignment will be displayed in plain text in a new window
+       </strong><em>The alignment will be displayed in plain text in a new window,
        which you can &quot;Copy and Paste&quot; using the pull down menu, or
        which you can &quot;Copy and Paste&quot; using the pull down menu, or
-       your standard operating system copy and paste keys. <br>
+       your standard operating system copy and paste keys. The output window
+       also has a <strong>&quot;New Window&quot;</strong> button to import the
+       (possibly edited) text as a new alignment.<br>
        Select the format of the text by selecting one of the following menu
        items.</em>
        <ul>
        Select the format of the text by selecting one of the following menu
        items.</em>
        <ul>
@@ -47,8 +50,8 @@
        the number of residues per line of your alignment will depend on the
        paper width or your alignment window width, whichever is the smaller. </em></li>
        <li><strong>Export Image</strong> <em><br>
        the number of residues per line of your alignment will depend on the
        paper width or your alignment window width, whichever is the smaller. </em></li>
        <li><strong>Export Image</strong> <em><br>
-       Creates an alignment graphic with the current view's annotation, alignment
-       background colours and group colours. If the alignment is <a
+       Creates an alignment graphic with the current view's annotation,
+       alignment background colours and group colours. If the alignment is <a
                href="../features/wrap.html">wrapped</a>, the output will also be
        wrapped and will have the same visible residue width as the open
        alignment. </em>
                href="../features/wrap.html">wrapped</a>, the output will also be
        wrapped and will have the same visible residue width as the open
        alignment. </em>
index 03d764a..cd1fd78 100755 (executable)
@@ -1,18 +1,22 @@
 <html>
 <html>
-<head><title>Menus</title></head>
+<head>
+<title>Jalview's Menus</title>
+</head>
 
 <body>
 
 <body>
-<p><strong>Menus</strong></p>
-<p>Menus are used in 3 places in Jalview - the &quot;Desktop Menu&quot;, the &quot;Alignment 
-  Menu&quot; and the &quot;Popup Menu&quot;.</p>
-<p>The <a href="desktopMenu.html">Desktop Menu</a> is always visible and is the 
-  starting point for loading new alignments.</p>
-<p>The <a href="alignmentMenu.html">Alignment Menu</a> is visible once and alignment 
-  has been opened.</p>
-<p>The <a href="popupMenu.html">Popup Menu</a> is made visible by clicking with 
-  the right mouse button on a sequence or the name of a sequence in an alignment 
-  window. </p>
-  <p>The <a href="alwannotations.html">Annotations Menu</a> is opened by right-clicking on an annotation row label.</p>
+<p><strong>Jalview's Menus</strong></p>
+<p>Menus are used in 3 places in Jalview - the &quot;Desktop
+Menu&quot;, the &quot;Alignment Menu&quot; and the &quot;Popup
+Menu&quot;.</p>
+<p>The <a href="desktopMenu.html">Desktop Menu</a> is always visible
+and is the starting point for loading new alignments.</p>
+<p>The <a href="alignmentMenu.html">Alignment Window Menus</a> are
+accessible once an alignment has been opened.</p>
+<p>The <a href="popupMenu.html">Popup Menus</a> are opened by
+clicking with the right mouse button in the alignment display area or on
+a sequence label in the alignment window.</p>
+<p>The <a href="alwannotations.html">Annotations Menu</a> is opened
+by right-clicking on an annotation row label or in an annotation row.</p>
 
 </body>
 </html>
 
 </body>
 </html>
index f885bd8..2c50c02 100755 (executable)
@@ -110,10 +110,7 @@ not be accessible when in 'Cursor Mode' (toggled with the F2 key).</em></p>
        </ul>
        </li>
        <li><strong>Hide Sequences</strong><br>
        </ul>
        </li>
        <li><strong>Hide Sequences</strong><br>
-       <em>This menu item lists all links which have been set up in the <a
-               href="../features/preferences.html">Preferences</a> Connections tab.
-       It is only displayed when you right click (Apple click) on a sequence
-       id. </em><strong><br>
+       <em>Hides the currently selected seuqences in this alignment view.</em><strong><br>
        <br>
        </strong></li>
 </ul>
        <br>
        </strong></li>
 </ul>
index 344c322..651292e 100755 (executable)
@@ -1,54 +1,50 @@
 <html>
 <html>
-<head><title>What's new ?</title></head>
+<head>
+<title>What's new ?</title>
+</head>
 <body>
 <body>
-<p><strong>What's new ?</strong> </p>
+<p><strong>What's new ?</strong></p>
 
 <p><strong>Jalview Version 2.2</strong></p>
 
 <p><strong>Jalview Version 2.2</strong></p>
-<p>Multiple views with different styles, colours, hidden regions for one alignment
-</p>
-<p>Easily add, amend and delete sequence features
-</p>
-<p>&quot;Reload&quot; alignment from File or URL to revert to original
-</p>
-<p>&quot;Save&quot; to current filename or &quot;Save As&quot; to new filename
-</p>
-<p>Set different text colour for dark or light background
-</p>
-<p>Right align sequence ids
-</p>
+<p>Multiple views with different styles, colours, hidden regions for
+one alignment</p>
+<p>Easily add, amend and delete sequence features</p>
+<p>&quot;Reload&quot; alignment from File or URL to revert to
+original</p>
+<p>&quot;Save&quot; to current filename or &quot;Save As&quot; to
+new filename</p>
+<p>New <strong>&quot;New Window&quot;</strong> button on the
+&quot;Output To Textbox&quot; opens output window for quick 'sequence
+editing'.</p>
+<p>Set different text colour for dark or light background</p>
+<p>Right align sequence ids</p>
 <p>Set colour of lower case residues in a user defined colour scheme
 </p>
 <p>Set colour of lower case residues in a user defined colour scheme
 </p>
-<p>Menu Rearrangements: New <strong>Format</strong> for alignment layout and <strong>Select</strong> for region selection.
-</p>
-</p><p>Menu item accelerator keys added
-</p>
-<p>Control-V pastes sequences to active window, Control-Shift-V pastes to a new window.
-</p>
-<p>Raise/Minimise alignment and all associated windows from desktop window's <strong>window</strong> menu
+<p>Menu Rearrangements: New <strong>Format</strong> for alignment
+layout and <strong>Select</strong> for region selection.</p>
 </p>
 </p>
+<p>Menu item accelerator keys added</p>
+<p>Control-V pastes sequences to active window, Control-Shift-V
+pastes to a new window.</p>
+<p>Raise/Minimise alignment and all associated windows from desktop
+window's <strong>window</strong> menu</p>
 <p>Select and colour whole branches of a tree</p>
 <p>'New Window' button on the 'Output to Text box' alignment output
 option to open a new alignment window after editing.</p>
 <p><strong>Issues Resolved</strong></p>
 </p>
 <p>Select and colour whole branches of a tree</p>
 <p>'New Window' button on the 'Output to Text box' alignment output
 option to open a new alignment window after editing.</p>
 <p><strong>Issues Resolved</strong></p>
 </p>
-<p>
-Optimisations for large alignments: faster multithreaded calculations and Undo/Redo system.
-</p>
+<p>Optimisations for large alignments: faster multithreaded
+calculations and Undo/Redo system.</p>
 <p>Remove empty columns - if empty columns exist at the end of the
 <p>Remove empty columns - if empty columns exist at the end of the
-alignment bug fixed.
-</p>
-<p>DAS feature fetching slowed down, doesn't overload DAS servers
-</p>
-<p>DAS feature fetching can be cancelled
-</p>
-<p>Correct display of &gt; and &lt; symbols for feature descriptions without explicit &lt;html&gt; tags.
-</p>
-<p>Zoom working in PCA viewer
-</p>
-<p>Sequence Descriptions retained after running a web service
-</p>
+alignment bug fixed.</p>
+<p>DAS feature fetching slowed down, doesn't overload DAS servers</p>
+<p>DAS feature fetching can be cancelled</p>
+<p>Correct display of &gt; and &lt; symbols for feature descriptions
+without explicit &lt;html&gt; tags.</p>
+<p>Zoom working in PCA viewer</p>
+<p>Sequence Descriptions retained after running a web service</p>
 <p>&nbsp;</p>
 <p>&nbsp;</p>
-<p>See the <a href="releases.html">Release History</a> page for details of all
-  new features and resolved issues. </p>
+<p>See the <a href="releases.html">Release History</a> page for
+details of all new features and resolved issues.</p>
 </body>
 </html>
 </body>
 </html>