Jalview 2.6 source licence
[jalview.git] / help / html / calculations / treeviewer.html
index f2c7d3d..67a92c4 100755 (executable)
@@ -1,32 +1,39 @@
 <html>
+<!--
+ * Jalview - A Sequence Alignment Editor and Viewer (Version 2.6)
+ * 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>The Tree Viewing Window</title>
 </head>
 <body>
 <p><strong>The Tree Viewing Window</strong></p>
 <p>
-  When a tree has been calculated from an alignment, or imported via a
-  file or web service it is displayed by Jalview's tree viewing
-  window. Trees can be rearranged, used to select sequences and groups
-  in the associated alignment, saved in Newick format or exported as an
-  image or postscript file.</p>
+  The tree viewing window is opened when a tree has been <a href="tree.html">calculated 
+  from an alignment</a>, or imported via a file or web service. It includes <a href="#menus">menus</a> for 
+  controlling layout and file and figure creation, and enables 
+  various selection and colouring operations on the 
+  associated sequences in the alignment.</p>
 <p>
+<strong><em>Selecting Sequence Leaf Nodes</em></strong><br>
   Selecting sequence ids at the leaves of the tree selects the
   corresponding sequences in the original alignment. These selections
   are also reflected in any other analysis windows associated with the
   alignment, such as another tree viewer.</p>
-
-<p>Moving the mouse over an internal node of the tree will highlight
-  it. You can then : <ul>
-  <li>Click the highlighted node to select all the sequences in that branch.
-  <li>Double-click the highlighted node to rearrange the tree
-  diagram by inverting the branch ordering at that
-  node.
-  <li>Right-click to open the 'Select Sub-Tree Colour' dialog box, to
-  pick a new colour for the sub-tree and associated sequences.
-  </ul>
-</p>
-<p>
+<p><strong><em>Grouping sequences by partitioning the tree at a particular distanec</em></strong><br>
   Clicking anywhere along the extent of the tree (but not on a leaf or
   internal node) defines a tree 'partition', by cutting every branch
   of the tree spanning the depth where the mouse-click occurred. Groups
@@ -42,7 +49,20 @@ identifying specific patterns of conservation and mutation
 corresponding to the overall phylogenetic structure, when combined
 with the <a href="../colourSchemes/conservation.html">conservation
 based colour scheme</a>.</p>
-<p><strong>File Menu</strong></p>
+<p>
+<strong><em>Selecting Subtrees and changing the branch order and subtree group colour</em></strong><br>
+Moving the mouse over an internal node of the tree will highlight
+  it. You can then : <ul>
+  <li>Click the highlighted node to select all the sequences in that branch.
+  <li>Double-click the highlighted node to rearrange the tree
+  diagram by inverting the branch ordering at that
+  node.
+  <li>Right-click to open the 'Select Sub-Tree Colour' dialog box, to
+  pick a new colour for the sub-tree and associated sequences.
+  </ul>
+</p>
+<p><strong><a name="menus">
+File Menu</a></strong></p>
 <p>This menu allows the displayed tree to be saved as a Newick tree
 file (Save&#8594;Newick File), printed or exported as an image (PNG) or
 Postscript file. Finally, data used to calculate the tree can be