3 * Jalview - A Sequence Alignment Editor and Viewer (Version 2.8.1)
4 * Copyright (C) 2014 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 of the License, or (at your option) any later version.
12 * Jalview is distributed in the hope that it will be useful, but
13 * WITHOUT ANY WARRANTY; without even the implied warranty
14 * of MERCHANTABILITY or FITNESS FOR A PARTICULAR
15 * PURPOSE. See the GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License along with Jalview. If not, see <http://www.gnu.org/licenses/>.
18 * The Jalview Authors are detailed in the 'AUTHORS' file.
21 <title>Sequence Fetcher</title>
24 <p><strong>Sequence Fetcher</strong></p>
25 <p>Jalview can retrieve sequences from certain databases using either the
26 WSDBFetch service provided by the European Bioinformatics Institute, and, since Jalview 2.4, DAS servers capable of the <em>sequence</em> command (configured in <a href="dassettings.html">DAS settings</a>).</p>
27 <img src="seqfetcher.gif" align="center"
28 alt="The Jalview Sequence Fetcher Dialog Box">
29 <p>The Sequence Fetcher dialog box can be opened via the "File"
30 menu on the main desktop in order to retrieve sequences as a new
31 alignment, or opened via the "File" menu of an existing alignment
32 to import additional sequences. There may be a short delay when the sequence fetcher is first opened,
33 whilst Jalview compiles the list of available sequence datasources from the
34 currently defined DAS server registry.
36 <p>First, select the database you want to retrieve sequences from
37 by clicking the button labeled 'Select database retrieval source'. If
38 a database source is already selected, then the button's label will
39 change to show the currently selected database.</p>
40 <img src="selectfetchdb.gif" align="left" alt="Database selection dialog for fetching sequences (introduced in Jalview 2.8)">
41 <p>Since Jalview 2.8, the
42 available databases are shown as a tree in a popup dialog box. The
43 databases are ordered alphabetically, and if there are many sources
44 for the same type of sequence identifier, they will be grouped
45 together in a sub-branch branch labeled with the identifier.</p>
46 <p>Once you have selected the sequence database using the popup dialog box, enter
47 one or more accession ids (as a semi-colon separated list), or press the
48 "Example" button to paste the example accession for the currently selected database into the retrieval box.
49 Finally, press "OK" to initiate the retrieval.</p>
50 <p><strong>Specifying chains for PDB IDs</strong>
51 If you are retrieving sequences from the PDB, you can retrieve
52 specific chains by appending a colon and the chain id to the PDB
53 id. For example :<br/><pre> 1GAQ:A</pre>
56 <strong>Only retrieving part of a sequence</strong> DAS sources
57 (indicated by a "<em>(DAS)</em>") allow a range to be
58 specified in addition to a sequence ID. To retrieve 50 residues
59 starting at position 35 in UNIPROT sequence P73137 using the UNIPROT
60 DAS server, you would enter "'P73137:35,84'.<br/><em>Full support for DAS range queries was introduced in Jalview 2.8</em>
63 <p>If you use the WSDBFetch sequence fetcher services (EMBL, Uniprot, PDB, PFAM, and RFAM)
64 in work for publication, please cite:</p>
65 <p>Pillai S., Silventoinen V., Kallio K., Senger M., Sobhany S., Tate J., Velankar
66 S., Golovin A., Henrick K., Rice P., Stoehr P., Lopez R. <br>
67 SOAP-based services provided by the European Bioinformatics Institute.<br>
68 Nucleic Acids Res. 33(1):W25-W28 (2005) <br>