JAL-1517 update copyright to version 2.8.2
[jalview.git] / help / html / menus / alignmentMenu.html
index eb51c62..b1f7a06 100755 (executable)
@@ -1,20 +1,21 @@
 <html>
 <!--
- * Jalview - A Sequence Alignment Editor and Viewer (Version 2.7)
- * Copyright (C) 2011 J Procter, AM Waterhouse, J Engelhardt, LM Lui, G Barton, M Clamp, S Searle
+ * Jalview - A Sequence Alignment Editor and Viewer (Version 2.8.2)
+ * Copyright (C) 2014 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>Alignment Window Menus</title>
                                </strong><em>Any columns currently not selected will replace the current
                                                column selection. </em>
                                </li>
-                               <li><strong>Undefine Groups (Control U)<br> </strong><em>The
-                                               alignment will be reset with no defined groups.<br> <strong>WARNING</strong>:
-                                               This cannot be undone.</em>
-                               </li>
-                               <li><strong>Make Groups<br /> </strong> <em>The currently
+                                 <li><strong>Create Group (Control G)<br></strong>
+  <em>Create a group containing the currently selected sequences.</em></li>
+  <li><strong>Remove Group (Shift Control G)<br></strong>
+  <em>Ungroup the currently selected sequence group. (Create/Remove group new in Jalview 2.8.1)</em></li>
+                       <li><strong>Make Groups for selection<br /> </strong> <em>The currently
                                                selected groups of the alignment will be subdivided according to
                                                the contents of the currently selected region. <br />Use this to
                                                subdivide an alignment based on the different combinations of
                                                residues observed at specific positions. (new in jalview 2.5)</em>
                                </li>
-                       </ul></li>
+       <li><strong>Undefine Groups (Control U)<br> </strong><em>The
+            alignment will be reset with no defined groups.<br> <strong>WARNING</strong>:
+            This cannot be undone.</em>
+        </li>
+               </ul></li>
                <li><strong>View</strong>
                        <ul>
                                <li><strong>New View (Control T)</strong><em><br>
                                                <li><strong>Neighbour Joining Using Blosum62<br>
                                                </strong></li>
                                        </ul>
+                                       <strong>Note: Since Version 2.8.1, a number of additional similarity measures for tree calculation are provided in this menu.</strong>
                                </li>
                                <li><strong>Pairwise Alignments</strong><br> <em>Applies
                                                Smith and Waterman algorithm to selected sequences. See <a
                                                href="../calculations/pairwise.html">pairwise alignments</a>.</em><br>
                                </li>
                                <li><strong>Principal Component Analysis</strong><br> <em>Shows
-                                               a spatial clustering of the sequences based on the BLOSUM62 scores
-                                               in the alignment. See <a href="../calculations/pca.html">Principal
+                                               a spatial clustering of the sequences based on similarity scores calculated with
+                                               the alignment. See <a href="../calculations/pca.html">Principal
                                                        Component Analysis</a>.</em> <br>
                                </li>
                                <li><strong>Extract Scores ... (optional)</strong><br> <em>This
                                <li><strong>Sort With New Tree</strong><br> <em>When
                                                enabled, Jalview will automatically sort the alignment when a new
                                                tree is calculated or loaded onto it.</em> <br></li>
-                       </ul></li>
+                       <li><strong>Show Flanking Regions</strong><br> <em>Opens
+                                       a new alignment window showing any additional sequence data either
+                                       side of the current alignment. Useful in conjunction with 'Fetch
+                                       Database References' when the 'Trim Retrieved Sequences' option is
+                                       disabled to retrieve full length sequences for a set of aligned
+                                       peptides. </em></li>
+               </ul></li>
 
                <li><strong>Web Service Menu</strong><br /> <em>This menu
                                is dynamic, and may contain user-defined web service entries in
                                addition to any of the following ones:</em>
                        <ul>
                                <li><strong>Fetch DB References</strong><br> <em>This
-                                               will use any of the database services that Jalview is aware of
-                                               (e.g. DAS sequence servers and the WSDBFetch service provided by
-                                               the EBI) to verify the sequence and retrieve all database cross
-                                               references and PDB ids associated with all or just the selected
-                                               sequences in the alignment. <br />'Standard Databases' will check
-                                               sequences against the EBI databases plus any active DAS sequence
-                                               sources, or you can verify against a specific source from one of
-                                               the sub-menus.</em><br></li>
-                               <li><strong>Envision2 Services</strong><br /><em> Submits one or
-                                       more sequences, sequence IDs or database references to analysis
-                                       workflows provided by the <a
-                                       href="http://www.ebi.ac.uk/enfin-srv/envision2">EnVision2 web
-                                               application</a>. This allows Jalview users to easily access the EnCore
-                                       network of databases and analysis services developed by members of
-                                       <a href="http://www.enfin.org">ENFIN</a></em>.</li>
+        submenu contains options for accessing any of the database services
+        that Jalview is aware of (e.g. DAS sequence servers and the
+        WSDBFetch service provided by the EBI) to verify sequence start/end
+        positions and retrieve all database cross references and PDB ids
+        associated with all or just the selected sequences in the alignment.
+        <ul>
+          <li>'Trim Retrieved Sequences' - when checked, Jalview will
+            discard any additional sequence data for accessions associated with
+            sequences in the alignment. <br> <strong>Note: Disabling this
+              could cause out of memory errors when working with genomic
+              sequence records !</strong><br> <strong>Added in Jalview 2.8.1</strong>
+        </li>
+          <li>'Standard Databases' will check sequences against the EBI
+            databases plus any active DAS sequence sources<</li>
+        </ul> Other sub-menus allow you to pick a specific source to query -
+        sources are listed alphabetically according to their nickname.
+    </em><br></li>
                        </ul>
                        <p>Selecting items from the following submenus will start a
                                remote service on compute facilities at the University of Dundee, or