JAL-1620 version bump and release notes
[jalview.git] / help / html / calculations / sorting.html
1 <html>
2 <!--
3  * Jalview - A Sequence Alignment Editor and Viewer (Version 2.8.2b1)
4  * Copyright (C) 2014 The Jalview Authors
5  * 
6  * This file is part of Jalview.
7  * 
8  * Jalview is free software: you can redistribute it and/or
9  * modify it under the terms of the GNU General Public License 
10  * as published by the Free Software Foundation, either version 3
11  * of the License, or (at your option) any later version.
12  *  
13  * Jalview is distributed in the hope that it will be useful, but 
14  * WITHOUT ANY WARRANTY; without even the implied warranty 
15  * of MERCHANTABILITY or FITNESS FOR A PARTICULAR 
16  * PURPOSE.  See the GNU General Public License for more details.
17  * 
18  * You should have received a copy of the GNU General Public License
19  * along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
20  * The Jalview Authors are detailed in the 'AUTHORS' file.
21  -->
22 <head>
23 <title>Sorting Sequences</title>
24 </head>
25 <body>
26 <p><strong>Sorting Sequences</strong></p>
27 <p>Any group of selected sequences may be reordered by pressing the
28 up or down arrow keys. The whole alignment may also be reordered by
29 the use of the functions in the Sort menu (<strong>Calculate&#8594;Sort</strong>):
30 </p>
31 <ul>
32 <li><p><strong>Sort by ID</strong></p>
33 <p>Orders the sequences by the alphanumeric (0-9A-Za-z)
34 precedence of their names.</p><p>
35 </li>
36 <li><p><strong>Sort by Group</strong></p>
37 <p>Places sequences in the same group adjacent to each other.</p><p>
38 </li>
39 <li><p><strong>Sort by Pairwise Identity</strong></p>
40 <p>Places pairs of sequences together that align with the greatest
41 fraction of conserved residues.
42 </p><p>
43 </li>
44 <li><p><strong>Sort by Tree Order</strong></p>
45 <p>The leaf ordering of a particular phylogenetic tree is used to
46 order the sequences corresponding to those leaves in the
47 alignment.<br>
48 If a tree has been calculated from or associated with the current
49 alignment, its name will appear in the submenu <strong>Sort&#8594;By Tree Order</strong>.</p><p>
50 </li>
51 <li><p><strong>Sort by alignment ordering</strong></p>
52 <p>Multiple alignment methods often order the sequences in their
53 alignments by some measure of sequence identity.<br>
54 If the current alignment has been generated by one of Jalview's
55 alignment web services, the alignment ordering can be recovered by
56 its corresponding entry in the Sort menu.
57 </p>
58 </li>
59 <li><p><strong>Sort by Score</strong></p>
60 <p>This menu appears if the alignment contains any <a href="../features/annotationsFormat.html">sequence associated
61 alignment annotation</a> with associated score values. Each entry is the
62 label for a distinct group of sequence associated annotation
63 scores which can be used for sorting.</p>
64 </ul>
65 <p><strong>Reversing the Order</strong></p>
66 <p>Selecting any item from the Sort menu will sort sequences in an
67 ascending order according to the property defining the sort. If the
68 same sort is re-applied, the sequences will be sorted in the inverse
69 order. In the case of trees and alignment orderings, Jalview will
70 remember your last choice for sorting the alignment and only apply the
71 inverse ordering if you select the same tree or alignment ordering
72 item again.</p>
73
74 </body>
75 </html>