JAL-345 JAL-1738 menu item, AlignFrame action listener and documentation for Select...
[jalview.git] / help / html / menus / alignmentMenu.html
1 <html>
2 <!--
3  * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
4  * Copyright (C) $$Year-Rel$$ 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>Alignment Window Menus</title>
24 </head>
25
26 <body>
27   <!-- NOTE: THIS PAGE COLLECTS TOGETHER THE INDIVIDUAL ALIGNMENT WINDOW MENU PAGES - DON"T EDIT INDIVIDUAL ENTRIES HERE!  -->
28   <p>
29     <strong>Alignment Window Menus</strong>
30   </p>
31   <ul>
32     <li><strong>File</strong>
33       <ul>
34         <li><strong>Fetch Sequence</strong><br> <em>Shows
35             a dialog window in which you can retrieve known ids from
36             UniProt, EMBL, EMBLCDS, PFAM, Rfam, or PDB database using
37             Web Services provided by the European Bioinformatics
38             Institute. See <a href="../features/seqfetch.html">Sequence
39               Fetcher</a>
40         </em>.</li>
41         <li><strong>Add Sequences</strong><em><br> Add
42             sequences to the visible alignment from file, URL, or cut
43             &amp; paste window </em></li>
44         <li><strong>Reload</strong><em><br> Reloads the
45             alignment from the original file, if available.<br> <strong>Warning:
46               This will delete any edits, analyses and colourings
47               applied since the alignment was last saved, and cannot be
48               undone.</strong> </em></li>
49         <li><strong>Save (Control S)</strong><em><br>
50             Saves the alignment to the file it was loaded from (if
51             available), in the same format, updating the original in
52             place. </em></li>
53         <li><strong>Save As (Control Shift S)<br>
54         </strong><em>Save the alignment to local file. A file selection
55             window will open, use the &quot;Files of type:&quot;
56             selection box to determine which <a href="../io/index.html">alignment
57               format</a> to save as.
58         </em></li>
59         <li><strong>Output to Textbox<br>
60         </strong><em>The alignment will be displayed in plain text in a new
61             window, which you can &quot;Copy and Paste&quot; using the
62             pull down menu, or your standard operating system copy and
63             paste keys. The output window also has a <strong>&quot;New
64               Window&quot;</strong> button to import the (possibly edited) text
65             as a new alignment.<br> Select the format of the text
66             by selecting one of the following menu items.
67         </em>
68           <ul>
69             <li><strong>FASTA</strong></li>
70             <li><strong>MSF</strong></li>
71             <li><strong>CLUSTAL</strong></li>
72             <li><strong>BLC</strong></li>
73             <li><strong>PIR</strong></li>
74             <li><strong>PFAM</strong></li>
75             <li><strong>PileUp</strong></li>
76             <li><strong>AMSA</strong></li>
77             <li><strong>STH</strong></li>
78             <li><strong>Phylip</strong></li>
79             <li><strong>JSON</strong></li>
80           </ul></li>
81         <li><strong>Page Setup ...</strong><br> <em>Open
82             the printing system's Page Setup dialog box, to control page
83             size, layout and orientation.</em></li>
84         <li><strong>Print (Control P)<br>
85         </strong><em>Jalview will print the alignment using the current
86             fonts and colours of your alignment. If the alignment has
87             annotations visible, these will be printed below the
88             alignment. If the alignment is wrapped the number of
89             residues per line of your alignment will depend on the paper
90             width or your alignment window width, whichever is the
91             smaller. </em></li>
92         <li><strong>Export Image</strong> <em><br>
93             Creates an alignment graphic with the current view's
94             annotation, alignment background colours and group colours.
95             If the alignment is <a href="../features/wrap.html">wrapped</a>,
96             the output will also be wrapped and will have the same
97             visible residue width as the open alignment. </em>
98           <ul>
99             <li><strong>HTML<br>
100             </strong><em>Create a <a href="../io/export.html">web page</a>
101                 from your alignment.
102             </em></li>
103             <li><strong>EPS<br>
104             </strong><em>Create an <a href="../io/export.html">Encapsulated
105                   Postscript</a> file from your alignment.
106             </em></li>
107             <li><strong>PNG<br>
108             </strong><em>Create a <a href="../io/export.html">Portable
109                   Network Graphics</a> file from your alignment.
110             </em></li>
111             <li><strong>SVG<br>
112             </strong><em>Create a <a href="../io/export.html">Scalable
113                   Vector Graphics</a> file from your alignment for embedding
114                 in web pages.
115             </em></li>
116             <li><strong>BioJS<br>
117             </strong><em>Create a <a href="../io/export.html">BioJS MSA
118                   Viewer HTML </a> file from your alignment.
119             </em></li>
120           </ul></li>
121         <li><strong>Export Features</strong><em><br> All
122             features visible on the alignment can be saved to file or
123             displayed in a textbox in either Jalview or GFF format</em></li>
124         <li><strong>Export Annotations</strong><em><br>
125             All annotations visible on the alignment can be saved to
126             file or displayed in a textbox in Jalview annotations
127             format. </em></li>
128         <li><strong>Load Associated Tree<br>
129         </strong><em>Jalview can <a href="../calculations/treeviewer.html">view
130               trees</a> stored in the Newick file format, and associate them
131             with the alignment. Note: the ids of the tree file and your
132             alignment MUST be the same.
133         </em></li>
134         <li><strong>Load Features / Annotations<br>
135         </strong><em>Load files describing precalculated <a
136             href="../features/featuresFormat.html">sequence
137               features</a> or <a href="../features/annotationsFormat.html">alignment
138               annotations</a>.
139         </em></li>
140         <li><strong>Close (Control W)</strong><br> <em>Close
141             the alignment window. Make sure you have saved your
142             alignment before you close - either from the Desktop's <strong>Save
143               Project</strong> File menu option, or by using the <strong>Save
144               As</strong> menu.
145         </em></li>
146       </ul></li>
147     <li><strong>Edit</strong>
148       <ul>
149         <li><strong>Undo (Control Z)</strong><em><br>
150             This will undo any edits you make to the alignment. This
151             applies to insertion or deletion of gaps, cutting residues
152             or sequences from the alignment or pasting sequences to the
153             current alignment or sorting the alignment. <strong>NOTE:</strong>
154             It DOES NOT undo colour changes, adjustments to group sizes,
155             or changes to the annotation panel. </em></li>
156         <li><strong>Redo (Control Y)<br>
157         </strong><em>Any actions which you undo can be redone using redo. </em></li>
158         <li><strong>Cut (Control X)<br>
159         </strong><em>This will make a copy of the currently selected
160             residues before removing them from your alignment. Click on
161             a sequence name if you wish to select a whole sequence. <br>
162             Use &lt;CTRL&gt; and X (&lt;APPLE&gt; and X on MacOSX) to
163             cut.
164         </em></li>
165         <li><strong>Copy (Control C)</strong><br> <em>Copies
166             the currently selected residues to the system clipboard -
167             you can also do this by pressing &lt;CTRL&gt; and C
168             (&lt;APPLE&gt; and C on MacOSX). <br> If you try to
169             paste the clipboard contents to a text editor, you will see
170             the format of the copied residues FASTA.
171         </em></li>
172         <li><strong>Paste </strong>
173           <ul>
174             <li><strong>To New Alignment (Control Shift V)<br>
175             </strong><em>A new alignment window will be created from
176                 sequences previously copied or cut to the system
177                 clipboard. <br> Use &lt;CTRL&gt; and &lt;SHIFT&gt;
178                 and V(&lt;APPLE&gt; and &lt;SHIFT;&gt; and and V on
179                 MacOSX) to paste.
180             </em></li>
181             <li><strong>Add To This Alignment (Control V)<br>
182             </strong><em>Copied sequences from another alignment window can
183                 be added to the current Jalview alignment. </em></li>
184           </ul></li>
185         <li><strong>Delete (Backspace)<br>
186         </strong><em>This will delete the currently selected residues
187             without copying them to the clipboard. Like the other edit
188             operations, this can be undone with <strong>Undo</strong>.
189         </em></li>
190         <li><strong>Remove Left (Control L)<br>
191         </strong><em>If the alignment has marked columns, the alignment will
192             be trimmed to the left of the leftmost marked column. To
193             mark a column, mouse click the scale bar above the
194             alignment. Click again to unmark a column, or select
195             &quot;Deselect All&quot; to deselect all columns.</em></li>
196         <li><strong>Remove Right (Control R)<br>
197         </strong><em>If the alignment has marked columns, the alignment will
198             be trimmed to the right of the rightmost marked column. To
199             mark a column, mouse click the scale bar above the
200             alignment. Click again to unmark a column, or select
201             &quot;Deselect All&quot; to deselect all columns.</em></li>
202         <li><strong>Remove Empty Columns (Control E)<br>
203         </strong><em>All columns which only contain gap characters
204             (&quot;-&quot;, &quot;.&quot;) will be deleted.<br> You
205             may set the default gap character in <a
206             href="../features/preferences.html">preferences</a>.
207         </em></li>
208         <li><strong>Remove All Gaps (Control Shift E)</strong><br>
209           <em>Gap characters (&quot;-&quot;, &quot;.&quot;) will be
210             deleted from the selected area of the alignment. If no
211             selection is made, ALL the gaps in the alignment will be
212             removed.<br> You may set the default gap character in <a
213             href="../features/preferences.html">preferences</a>.
214         </em></li>
215         <li><strong>Remove Redundancy (Control D)<br>
216         </strong><em>Selecting this option brings up a window asking you to
217             select a threshold. If the percentage identity between any
218             two sequences (under the current alignment) exceeds this
219             value then one of the sequences (the shorter) is discarded.
220             Press the &quot;Apply&quot; button to remove redundant
221             sequences. The &quot;Undo&quot; button will undo the last
222             redundancy deletion.</em></li>
223         <li><strong>Pad Gaps<br>
224         </strong><em>When selected, the alignment will be kept at minimal
225             width (so there are no empty columns before or after the
226             first or last aligned residue) and all sequences will be
227             padded with gap characters before and after their
228             terminating residues.<br> This switch is useful when
229             making a tree using unaligned sequences and when working
230             with alignment analysis programs which require 'properly
231             aligned sequences' to be all the same length.<br> You
232             may set the default for <strong>Pad Gaps</strong> in the <a
233             href="../features/preferences.html">preferences</a>.
234         </em></li>
235       </ul></li>
236     <li><strong>Select</strong>
237       <ul>
238         <li><a href="../features/search.html"><strong>Find...
239               (Control F)</strong></a><br> <em>Opens the Find dialog box to
240             search for residues, sequence name or residue position
241             within the alignment and create new sequence features from
242             the queries. </em>
243         <li><strong>Select All (Control A)</strong><strong><br>
244         </strong><em>Selects all the sequences and residues in the
245             alignment. <br> Use &lt;CTRL&gt; and A (&lt;APPLE&gt;
246             and A on a MacOSX) to select all.
247         </em></em></li>
248         <li><strong>Deselect All (Escape)<br>
249         </strong><em>Removes the current selection box (red dashed box) from
250             the alignment window. All selected sequences, residues and
251             marked columns will be deselected. </em><em> <br> Use
252             &lt;ESCAPE&gt; to deselect all.
253         </em></li>
254         <li><strong>Invert Sequence Selection (Control I)<br>
255         </strong><em>Any sequence ids currently not selected will replace
256             the current selection. </em></li>
257         <li><strong>Invert Column Selection (Control Alt
258             I)<br>
259         </strong><em>Any columns currently not selected will replace the
260             current column selection. </em></li>
261         <li><strong>Create Group (Control G)<br></strong> <em>Create
262             a group containing the currently selected sequences.</em></li>
263         <li><strong>Remove Group (Shift Control G)<br></strong>
264           <em>Ungroup the currently selected sequence group.</em></li>
265         <li><strong>Make Groups for selection<br /></strong> <em>The
266             currently selected groups of the alignment will be
267             subdivided according to the contents of the currently
268             selected region. <br />Use this to subdivide an alignment
269             based on the different combinations of residues at marked
270             columns.
271         </em></li>
272         <li><strong>Undefine Groups (Control U)<br>
273         </strong><em>The alignment will be reset with no defined groups.<br>
274             <strong>WARNING</strong>: This cannot be undone.
275         </em></li>
276         <li><strong><a
277             href="../features/columnFilterByAnnotation.html">Select/Hide
278               Columns by Annotation</a></strong> <br /> <em>Select or Hide
279             columns in the alignment according to secondary structure,
280             labels and values shown in alignment annotation rows. </em></li>
281         <li><strong>Select Highlighted Columns</strong> <br /> <em>Selects
282             the columns currently highlighted as a result of a find, mouse
283             over, or selection event from a linked structure viewer or other
284             application. Modifiers will work on some platforms: SHIFT will
285             add columns to selection, ALT will invert the highlighted set
286             before selection, and CTRL (or META) will toggle the selection.
287         </em></li>
288       </ul></li>
289     <li><strong>View</strong>
290       <ul>
291         <li><strong>New View (Control T)</strong><em><br>
292             Creates a new view from the current alignment view. </em></li>
293         <li><strong>Expand Views (X)</strong><em><br>
294             Display each view associated with the alignment in its own
295             alignment window, allowing several views to be displayed
296             simultaneously. </em></li>
297         <li><strong>Gather Views (G)</strong><em><br>
298             Each view associated with the alignment will be displayed
299             within its own tab on the current alignment window. </em></li>
300         <li><strong>Show&#8594;(all Columns / Sequences /
301             Sequences and Columns)</strong><em><br> All hidden Columns
302             / Sequences / Sequences and Columns will be revealed. </em></li>
303         <li><strong>Hide&#8594;(all Columns / Sequences /
304             Selected Region / All but Selected Region )</strong><em><br>
305             Hides the all the currently selected Columns / Sequences /
306             Region or everything but the selected Region.</em></li>
307         <li><strong>Automatic Scrolling<br>
308         </strong><em>When selected, the view will automatically scroll to
309             display the highlighted sequence position corresponding to
310             the position under the mouse pointer in a linked alignment
311             or structure view.</em></li>
312         <li><strong>Show Sequence Features</strong><br> <em>Show
313             or hide sequence features on this alignment.</em></li>
314         <li><strong><a
315             href="../features/featuresettings.html">Sequence
316               Feature Settings...</a> </strong><em><br> <em>Opens the
317               Sequence Feature Settings dialog box to control the colour
318               and display of sequence features on the alignment, and
319               configure and retrieve features from DAS annotation
320               servers.</em></li>
321         <li><strong>Sequence ID Tooltip</strong><em>
322             (application only) <br>This submenu's options allow the
323             inclusion or exclusion of non-positional sequence features
324             or database cross references from the tooltip shown when the
325             mouse hovers over the sequence ID panel.
326         </em></li>
327         <li><strong>Alignment Properties...<br />
328         </strong><em>Displays some simple statistics computed for the
329             current alignment view and any named properties defined on
330             the whole alignment.</em></li>
331         <li><strong><a href="../features/overview.html">Overview
332               Window</a><br> </strong><em>A scaled version of the alignment
333             will be displayed in a small window. A red box will indicate
334             the currently visible area of the alignment. Move the
335             visible region using the mouse. </em></li>
336       </ul></li>
337     <li><strong>Annotations</strong><em> (Since Jalview 2.8.2)</em>
338       <ul>
339         <li><strong>Show Annotations<br>
340         </strong><em>If this is selected the &quot;Annotation Panel&quot;
341             will be displayed below the alignment. The default setting
342             is to display the conservation calculation, quality
343             calculation and consensus values as bar charts. </em></li>
344         <li><strong>Show Alignment Related</strong><em><br>
345             Show all annotations that are for the alignment as a whole
346             (for example, Consensus, or secondary structure prediction
347             from alignment).</em></li>
348         <li><strong>Hide Alignment Related</strong><em><br>
349             Hide all annotations that are for the alignment as a whole.</em></li>
350         <li><strong>Show Sequence Related</strong><em><br>
351             Show all annotations that are for individual sequences.</em></li>
352         <li><strong>Hide Sequence Related</strong><em><br>
353             Hide all annotations that are for individual sequences.</em></li>
354         <li><em>You can also selectively show or hide
355             annotations from the <a href="./popupMenu.html">Popup</a> or
356             <a href="../features/annotation.html">Annotation</a> menus.
357         </em></li>
358         <li><strong>Sort by Sequence</strong><em><br>Sort
359             sequence-specific annotations by sequence order in the
360             alignment (and within that, by label).</em></li>
361         <li><strong>Sort by Label</strong><em><br>Sort
362             sequence-specific annotations by label (and within that, by
363             sequence order). If neither sort order is selected, no
364             sorting is applied, allowing you to make a manual ordering
365             of the annotations.</em></li>
366         <li><strong>Autocalculated Annotation<br>
367         </strong><em>Settings for the display of autocalculated annotation.</em>
368           <ul>
369             <li><strong>Show first<br></strong><em> Show
370                 autocalculated annotations above sequence-specific
371                 annotations. Note this also applies to other annotations
372                 for the alignment, for example secondary structure
373                 prediction from alignment.</em></li>
374             <li><strong>Show last<br></strong><em> Show
375                 autocalculated / alignment annotations below
376                 sequence-specific annotations.</em></li>
377             <li><strong>Apply to all groups<br>
378             </strong><em> When ticked, any modification to the current
379                 settings will be applied to all autocalculated
380                 annotation.</em></li>
381             <li><strong>Show Consensus Histogram<br>
382             </strong><em> Enable or disable the display of the histogram
383                 above the consensus sequence.</em></li>
384             <li><strong>Show Consensus Logo<br>
385             </strong><em> Enable or disable the display of the Consensus
386                 Logo above the consensus sequence.</em></li>
387             <li><strong>Normalise Consensus Logo<br>
388             </strong><em>When enabled, scales all logo stacks to the same
389                 height, making it easier to compare symbol diversity in
390                 highly variable regions.</em></li>
391             <li><strong>Group Conservation<br>
392             </strong><em> When ticked, display a conservation row for all
393                 groups (only available for protein alignments).</em></li>
394             <li><strong>Group Consensus<br>
395             </strong><em> When ticked, display a consensus row for all
396                 groups.</em></li>
397           </ul></li>
398       </ul></li>
399     <li><strong>Alignment Window Format Menu</strong>
400       <ul>
401         <li><strong>Font...<br>
402         </strong><em>Opens the &quot;Choose Font&quot; dialog box, in order
403             to change the font of the display and enable or disable
404             'smooth fonts' (anti-aliasing) for faster alignment
405             rendering. </em></li>
406         <li><strong>Wrap<br>
407         </strong><em>When ticked, the alignment display is &quot;<a
408             href="../features/wrap.html">wrapped</a>&quot; to
409             the width of the alignment window. This is useful if your
410             alignment has only a few sequences to view its full width at
411             once.
412         </em><br> Additional options for display of sequence numbering
413           and scales are also visible in wrapped layout mode:<br>
414           <ul>
415             <li><strong>Scale Above</strong><br> <em>
416                 Show the alignment column position scale.</em></li>
417             <li><strong>Scale Left</strong><br> <em> Show
418                 the sequence position for the first aligned residue in
419                 each row in the left column of the alignment.</em></li>
420             <li><strong>Scale Right</strong><br> <em>
421                 Show the sequence position for the last aligned residue
422                 in each row in the right-most column of the alignment.</em></li>
423             <li><strong>Show Sequence Limits<br>
424             </strong><em>If this box is selected the sequence name will have
425                 the start and end position of the sequence appended to
426                 the name, in the format NAME/START-END</em></li>
427             <li><strong>Right Align Sequence ID<br>
428             </strong><em>If this box is selected then the sequence names
429                 displayed in the sequence label area will be aligned
430                 against the left-hand edge of the alignment display,
431                 rather than the left-hand edge of the alignment window.
432             </li>
433             <li><strong>Show Hidden Markers<br>
434             </strong><em>When this box is selected, positions in the
435                 alignment where rows and columns are hidden will be
436                 marked by blue arrows. </li>
437             <li><strong>Boxes</strong><em><br> If this is
438                 selected the background of a residue will be coloured
439                 using the selected background colour. Useful if used in
440                 conjunction with &quot;Colour Text.&quot; </em></li>
441             <li><strong>Text<br>
442             </strong><em>If this is selected the residues will be displayed
443                 using the standard 1 character amino acid alphabet.</em></li>
444             <li><strong>Colour Text<br>
445             </strong><em>If this is selected the residues will be coloured
446                 according to the background colour associated with that
447                 residue. The colour is slightly darker than background
448                 so the amino acid symbol remains visible. </em></li>
449             <li><strong>Show Gaps<br>
450             </strong><em>When this is selected, gap characters will be
451                 displayed as &quot;.&quot; or &quot;-&quot;. If
452                 unselected, then gap characters will appear as blank
453                 spaces. <br> You may set the default gap character
454                 in <a href="../features/preferences.html">preferences</a>.
455             </em></li>
456             <li><strong>Centre Annotation Labels<br>
457             </strong><em>Select this to center labels along an annotation
458                 row relative to their associated column (default is off,
459                 i.e. left-justified).</em></li>
460             <li><strong>Show Unconserved<br>
461             </strong><em>When this is selected, all consensus sequence
462                 symbols will be rendered as a '.', highlighting
463                 mutations in highly conserved alignments. </em></li>
464
465           </ul></li>
466       </ul></li>
467
468   </ul>
469   </li>
470
471   <li><strong>Colour</strong>
472     <ul>
473       <li><strong>Apply Colour To All Groups<br>
474       </strong><em>If this is selected, any changes made to the background
475           colour will be applied to all currently defined groups.<br>
476       </em></li>
477       <li><strong><a
478           href="../colourSchemes/textcolour.html">Colour
479             Text...</a> </strong><em><br> Opens the Colour Text dialog box
480           to set a different text colour for light and dark background,
481           and the intensity threshold for transition between them. </em></li>
482       <li>Colour Scheme options: <strong>None, ClustalX,
483           Blosum62 Score, Percentage Identity, Zappo, Taylor,
484           Hydrophobicity, Helix Propensity, Strand Propensity, Turn
485           Propensity, Buried Index, Nucleotide, Purine/Pyrimidine, User
486           Defined<br>
487       </strong> <em>See <a href="../colourSchemes/index.html">colours</a>
488           for a description of all colour schemes.
489       </em><br></li>
490       <li><strong>By Conservation<br>
491       </strong><em>See <a href="../colourSchemes/conservation.html">Colouring
492             by Conservation</a>.
493       </em><br></li>
494       <li><strong>Modify Conservation Threshold<br>
495       </strong><em>Use this to display the conservation threshold slider
496           window. Useful if the window has been closed, or if the 'by
497           conservation' option appears to be doing nothing!</em><br></li>
498       <li><strong>Above Identity Threshold<br>
499       </strong><em>See <a href="../colourSchemes/abovePID.html">Above
500             Percentage Identity</a>
501       </em><strong>.<br>
502       </strong></li>
503       <li><strong>Modify Identity Threshold<br>
504       </strong><em>Use this to set the threshold value for colouring above
505           Identity. Useful if the window has been closed.<br>
506       </em></li>
507       <li><strong>By Annotation</strong><br> <em>Colours
508           the alignment on a per-column value from a specified
509           annotation. See <a
510           href="../colourSchemes/annotationColouring.html">Annotation
511             Colouring</a>.
512       </em><br></li>
513       <li><strong>By RNA Helices</strong><br> <em>Colours
514           the helices of an RNA alignment loaded from a Stockholm file.
515           See <a href="../colourSchemes/rnahelicesColouring.html">RNA
516             Helices Colouring</a>.
517       </em><br></li>
518     </ul></li>
519   <li><strong>Calculate</strong>
520     <ul>
521       <li><strong>Sort </strong>
522         <ul>
523           <li><strong>by ID</strong><em><br> This will
524               sort the sequences according to sequence name. If the sort
525               is repeated, the order of the sorted sequences will be
526               inverted. </em></li>
527           <li><strong>by Length</strong><em><br> This
528               will sort the sequences according to their length
529               (excluding gap characters). If the sort is repeated, the
530               order of the sorted sequences will be inverted. </em></li>
531           <li><strong>by Group</strong><strong><br> </strong><em>This
532               will sort the sequences according to sequence name. If the
533               sort is repeated, the order of the sorted sequences will
534               be inverted. </em><strong></strong></li>
535           <li><strong>by Pairwise Identity<br>
536           </strong><em>This will sort the selected sequences by their
537               percentage identity to the consensus sequence. The most
538               similar sequence is put at the top. </em></li>
539           <li><em>The <a href="../calculations/sorting.html">Sort
540                 menu</a> will have some additional options if you have just
541               done a multiple alignment calculation, or opened a tree
542               viewer window.
543           </em><br></li>
544         </ul></li>
545       <li><strong>Calculate Tree </strong> <br> <em>Functions
546           for calculating trees on the alignment or the currently
547           selected region. See <a href="../calculations/tree.html">calculating
548             trees</a>.
549       </em>
550         <ul>
551           <li><strong>Neighbour Joining Using PAM250 </strong></li>
552           <li><strong>Neighbour Joining Using Sequence
553               Feature Similarity</strong></li>
554           <li><strong>Neighbour Joining Using Blosum62 </strong></li>
555           <li><strong>Neighbour Joining Using % Identity</strong></li>
556           <li><strong>Average Distance Using PAM250 </strong></li>
557           <li><strong>Average Distance Using Sequence
558               Feature Similarity</strong></li>
559           <li><strong>Average Distance Using Blosum62</strong></li>
560           <li><strong>Average Distance Using % Identity</strong></li>
561         </ul> <strong>Note: Since Version 2.8.1, a number of
562           additional similarity measures for tree calculation are
563           provided in this menu.</strong></li>
564       <li><strong>Pairwise Alignments</strong><br> <em>Applies
565           Smith and Waterman algorithm to selected sequences. See <a
566           href="../calculations/pairwise.html">pairwise
567             alignments</a>.
568       </em><br></li>
569       <li><strong>Principal Component Analysis</strong><br> <em>Shows
570           a spatial clustering of the sequences based on similarity
571           scores calculated with the alignment. See <a
572           href="../calculations/pca.html">Principal
573             Component Analysis</a>.
574       </em> <br></li>
575       <li><strong>Extract Scores ... (optional)</strong><br> <em>This
576           option is only visible if Jalview detects one or more
577           white-space separated values in the description line of the
578           alignment sequences.<br> When selected, these numbers are
579           parsed into sequence associated annotation which can then be
580           used to sort the alignment via the Sort by&#8594;Score menu.
581       </em> <br></li>
582       <li><strong>Autocalculate Consensus</strong><br> <em>For
583           large alignments it can be useful to deselect
584           &quot;Autocalculate Consensus&quot; when editing. This
585           prevents the sometimes lengthy calculations performed after
586           each sequence edit.</em> <br></li>
587       <li><strong>Sort With New Tree</strong><br> <em>When
588           enabled, Jalview will automatically sort the alignment when a
589           new tree is calculated or loaded onto it.</em> <br></li>
590       <li><strong>Show Flanking Regions</strong><br> <em>Opens
591           a new alignment window showing any additional sequence data
592           either side of the current alignment. Useful in conjunction
593           with 'Fetch Database References' when the 'Trim Retrieved
594           Sequences' option is disabled to retrieve full length
595           sequences for a set of aligned peptides. </em></li>
596     </ul></li>
597
598   <li><strong>Web Service Menu</strong><br /> <em>This menu
599       is dynamic, and may contain user-defined web service entries in
600       addition to any of the following ones:</em>
601     <ul>
602       <li><strong>Fetch DB References</strong><br> <em>This
603           submenu contains options for accessing any of the database
604           services that Jalview is aware of (e.g. DAS sequence servers
605           and the WSDBFetch service provided by the EBI) to verify
606           sequence start/end positions and retrieve all database cross
607           references and PDB ids associated with all or just the
608           selected sequences in the alignment.
609           <ul>
610             <li>'Trim Retrieved Sequences' - when checked, Jalview
611               will discard any additional sequence data for accessions
612               associated with sequences in the alignment. <br> <strong>Note:
613                 Disabling this could cause out of memory errors when
614                 working with genomic sequence records !</strong><br> <strong>Added
615                 in Jalview 2.8.1</strong>
616             </li>
617             <li>'Standard Databases' will check sequences against
618               the EBI databases plus any active DAS sequence sources<</li>
619           </ul> Other sub-menus allow you to pick a specific source to query
620           - sources are listed alphabetically according to their
621           nickname.
622       </em><br></li>
623     </ul>
624     <p>Selecting items from the following submenus will start a
625       remote service on compute facilities at the University of Dundee,
626       or elsewhere. You need a continuous network connection in order to
627       use these services through Jalview.</p>
628     <ul>
629       <li><strong>Alignment</strong><br /> <em> Align the
630           currently selected sequences or all sequences in the
631           alignment, or re-align unaligned sequences to the aligned
632           sequences. Entries in this menu provide access to the various
633           alignment programs supported by <a
634           href="../webServices/JABAWS.html">JABAWS</a>. See the
635           <a href="../webServices/msaclient.html">Multiple Sequence
636             Alignment webservice client</a> entry for more information.
637       </em></li>
638       <li><strong>Secondary Structure Prediction</strong>
639         <ul>
640           <li><strong>JPred Secondary Structure Prediction</strong><br>
641             <em>Secondary structure prediction by network
642               consensus. See the <a href="../webServices/jnet.html">Jpred3</a>
643               client entry for more information. The behaviour of this
644               calculation depends on the current selection:
645               <ul>
646                 <li>If nothing is selected, and the displayed
647                   sequences appear to be aligned, then a JNet prediction
648                   will be run for the first sequence in the alignment,
649                   using the current alignment. Otherwise the first
650                   sequence will be submitted for prediction.</li>
651                 <li>If just one sequence (or a region on one
652                   sequence) has been selected, it will be submitted to
653                   the automatic JNet prediction server for homolog
654                   detection and prediction.</li>
655                 <li>If a set of sequences are selected, and they
656                   appear to be aligned, then the alignment will be used
657                   for a Jnet prediction on the <strong>first</strong>
658                   sequence in the set (that is, the one that appears
659                   first in the alignment window).
660                 </li>
661               </ul>
662           </em>
663         </ul></li>
664       <li><strong>Analysis</strong><br />
665         <ul>
666           <li><strong>Multi-Harmony</strong><br> <em>Performs
667               functional residue analysis on a protein family alignment
668               with sub-families defined on it. See the <a
669               href="../webServices/shmr.html">Multi-Harmony
670                 service</a> entry for more information.
671           </em></li>
672         </ul></li>
673     </ul></li>
674   </ul>
675
676 </body>
677 </html>