3 * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
4 * Copyright (C) $$Year-Rel$$ The Jalview Authors
6 * This file is part of Jalview.
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.
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.
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.
23 <title>Reference Sequences</title>
27 <strong>Reference Sequence Alignment Views</strong>
29 <p>Many alignment analysis tasks concern a query, or reference
30 sequence. For instance, when searching for sequences from other
31 organisms that are similar to a newly sequenced gene, or when
32 searching for structurally similar sequences for use in homology
35 <strong>What happens when a reference sequence is defined ?</strong>
37 <p>The reference sequence for an alignment is indicated by its ID
38 being shown in bold. In addition:</p>
40 <li><strong>Reference sequence numbering</strong>. Instead of
41 column numbers, the alignment ruler shows the reference sequence
42 positions at each column. At each tick mark, either the reference
43 sequence symbol and position is given, or the column number when a
44 gap is present at that position in the reference sequence.</li>
45 <li><strong>Format→Show unconserved</strong> highlights
46 mutations with respect to the reference sequence, rather than the
47 alignment's consensus sequence.</li>
50 <strong>Defining the reference sequence</strong>
52 <p>Each alignment view can have its own reference sequence.</p>
54 <li><strong>Manually assigning a reference sequence</strong><br />
55 A sequence can be marked as the reference sequence by
56 right-clicking on its ID to open the popup menu, and selecting the
57 "<strong>(Sequence ID)→Mark as Reference</strong>" entry.</li>
58 <li><strong>Defining a reference when importing
59 annotation</strong><br />Jalview automatically assigns a reference
60 sequence when importing analysis results, such as those returned
61 from <a href="../webServices/jnet.html">JPred4</a> . A reference
62 sequence can also be assigned via the <a
63 href="../features/annotationsFormat.html#refsandviews">SET_REF</a>
64 command in an alignment annotation file.</li>
67 <em>Reference sequence based alignment visualisation was
68 introduced in Jalview 2.9, and support for storage and retrieval
69 of reference sequence views in 2.10.</em>