2.08, not 2.07
[jalview.git] / help / html / features / seqfeatures.html
1 <html>\r
2 <head><title>Sequence Features</title></head>\r
3 <body>\r
4 <p><strong>Sequence Features</strong></p>\r
5 <p>Jalview can colour parts of a sequence based on the presence of\r
6 sequence features - which may be retrieved from database records (such\r
7 as Uniprot), the result of <a href="search.html">sequence motif\r
8 searches</a> or simply read from a <a\r
9 href="featuresFormat.html">sequence features file</a>.</p>\r
10 <p><strong>Sequence Feature Groups</strong></p>\r
11 <p>Since Jalview 2.08, sequence features assigned to a sequence can be\r
12 organised into groups, which may indicate that the features were all retrieved\r
13 from the same database (such as Uniprot features), or generated by the\r
14 same analysis process (as might be specified in a <a\r
15 href="featuresFormat.html">sequence features file</a>).</p>\r
16 <p><strong>Sequence Feature Inheritance</strong></p>\r
17 <p>Since Jalview 2.08, sequence features are <em>global</em> to a set of\r
18 sequences appearing (independently or together) in many different\r
19 alignments. Practically, this means features loaded onto one alignment\r
20 can be viewed in any alignments involving the same sequences. The same\r
21 sequence appears in different alignments when a new alignment is\r
22 generated by submitting an existing set of sequences to one of the\r
23 alignment or prediction web services, and when sequences are copied\r
24 and pasted into other alignment windows.</p>\r
25 <p><strong>View&#8594;Show Sequence Features</strong></p>\r
26 <p>Toggle the display of sequence features in this alignment. If\r
27 feature retrieval has not already been carried out, then Jalview will\r
28 automatically try to fetch sequence features (as described below).</p>\r
29 <p><strong>View&#8594;Sequence Feature Settings...</strong>\r
30 <p>Once sequence features have been loaded, their display can be fully\r
31   controlled using the alignment window's <a\r
32   href="featuresettings.html">Sequence Feature Settings</a> dialog\r
33   box. Feature colour schemes and display parameters are unique to a\r
34   particular alignment, so it is possible to colour the same sequence\r
35   features differently in different alignment views.</p>\r
36 <p><strong>View&#8594;Fetch Sequence Features</strong></p>\r
37 <p>When this option is selected, sequence features extracted from the\r
38   <a href="http://www.ebi.uniprot.org/index.html">Uniprot (http://www.ebi.unprot.org/index.html)</a>\r
39   record for each sequence are displayed on the alignment.</p>\r
40 <p>Jalview will attempt to retrieve sequence features from Uniprot files using\r
41   the EBI dbFetch web service using the given sequence names (or\r
42   Uniprot ID, if available). A 100% match with\r
43   the Uniprot record is required for Uniprot features to be view on a sequence.</p>\r
44 <p>More information about the feature is given in a tooltip, which is viewed by\r
45   moving the mouse pointer over a sequence feature. The description associated\r
46   with the feature will then be displayed in a small label near the pointer.</p>\r
47 <p><strong>The Sequence Identification Process</strong>\r
48 \r
49   </p>\r
50 <p>The first step in the procedure for matching uniprot IDs to\r
51   sequences is to use the ID (name) of\r
52   each sequence to retrieve Uniprot records directly.</p>\r
53 <p>\r
54   If a uniprot record (or set of records) is found for a sequence,\r
55   then the sequence is aligned to the one in the Uniprot record\r
56   to determine the correct start and end residue positions (which are\r
57   displayed when the 'Show Full Sequence ID' option is set).\r
58 </p>\r
59 \r
60 <p>If the alignment reveals differences between the sequence in the\r
61   alignment and the one in the record, then Jalview will assume that\r
62   the aligned sequence is not the one in the uniprot record.\r
63 \r
64   </p>\r
65 \r
66   <p>\r
67   In some cases, the ID used to retrieve Uniprot records may be out of\r
68   date and you will be notified of that a 100% match between the\r
69   sequence and a Uniprot record was identified, but the sequence name\r
70   must be manually changed (by right clicking on the sequence ID and selecting\r
71   <strong>Sequence&#8594;Edit Name</strong>), before Jalview will show its sequence\r
72   features.\r
73 <ul>\r
74   <li>remember to save your alignment if you have updated any of the sequence\r
75     IDs! </li>\r
76 </ul>\r
77 <p>Precalculated Sequence Features may be added to an alignment from the command\r
78   line, drag and drop, or from the &quot;File-&gt;Load Features / Annotations&quot;\r
79   menu item. See the <a href="featuresFormat.html">Features File Format</a> for\r
80   more details.</p>\r
81 </body>\r
82 </html>\r