0a4c7fa60febc77c0e1f9dabbae9b6bb8b42d359
[jalview.git] / help / html / io / index.html
1 <html>
2 <!--
3  * Jalview - A Sequence Alignment Editor and Viewer (Version 2.8.2)
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>Input/Output</title>
24 </head>
25 <body>
26 <p><strong>Input</strong></p>
27 <p>Jalview can read alignment files in any of the following standard
28 formats:</p>
29 <p><em>Fasta (Pearson), GCG-MSF, ALN/ClustalW, AMPS Block file,
30 NBRF/PIR (including MODELLER variant), Pfam/Stockholm</em></p>
31 <p>The EBI has <a href="http://www.ebi.ac.uk/help/formats.html">examples</a>
32 of these file formats.</p>
33 <p>Additionally, whole sets of coloured and annotated alignments and
34 trees can be read from a <a href="../features/jalarchive.html">Jalview
35 (jar) format</a> file using <strong>Desktop&#8594;Load Project</strong>.</p>
36 <p>Press &quot;Control O&quot; to open a file browser, or use
37 the <strong>Desktop&#8594;Input Alignment</strong> menu to read in
38 alignments from:</p>
39 <ul>
40         <li><strong>From File</strong>: the local file system</li>
41         <li><strong>From URL</strong>: the web (please use the full url)</li>
42         <li><strong>from Textbox</strong>: a copy and paste into the
43         &quot;Cut &amp; Paste&quot; text window</li>
44 </ul>
45 <p>Jalview will try to recognise the file type automatically (using
46 some special <a href="fileformats.html">features</a>). If a file is of
47 an unknown format or there is any other error reading the alignment file
48 then you will be given an error message. If you think Jalview really
49 should be able to read your file, then send an email containing the
50 problem file to help@jalview.org.</p>
51 <p>Jalview can also read jalview specific files for <a
52         href="../features/featuresFormat.html">sequence features</a> and <a
53         href="../features/annotationsFormat.html">alignment annotation</a>.</p>
54 <p><strong>Output</strong></p>
55 <p>Each alignment, whether it is the original or an edited version
56 may be saved in the standard formats using <strong>File&#8594;Save
57 As</strong></p>
58 <p><em>Fasta (Pearson), GCG-MSF, ALN/ClustalW, AMPS Block file,
59 NBRF/PIR, Pfam/Stockholm</em></p>
60 Jalview will by default append the sequence start and end to each
61 sequence name, in the format /start-end. If you do not want this
62 behaviour for a particular file output, open the &quot;Output&quot; tab
63 on the
64 <a href="../features/preferences.html">Preferences</a>
65 window where you can select which file formats you want to append the
66 start and end sequence positions for. In the case of PIR format, the
67 output tab also contains a switch for turning on the output of Modeller
68 style structured description lines.
69 <p>Quantitative and symbolic <a href="../features/annotation.html">alignment
70 annotation</a> can be exported as a comma separated value file by right
71 clicking on an annotation row under the alignment.</p>
72 <p>You can also save the current set of alignments and their
73 colours, annotations and trees in a Jalview archive file using <strong>Desktop&#8594;Save
74 project</strong>.</p>
75 <p>&nbsp;</p>
76 </body>
77 </html>