help/html/features/seqfetch.html

   1 <html>
   2 <!--
   3  * Jalview - A Sequence Alignment Editor and Viewer (Version 2.5)
   4  * Copyright (C) 2010 J Procter, AM Waterhouse, G Barton, M Clamp, S Searle
   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 of the License, or (at your option) any later version.
  11  *
  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.
  16  *
  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 -->
  19 <head>
  20 <title>Sequence Fetcher</title>
  21 </head>
  22 <body>
  23 <p><strong>Sequence Fetcher</strong></p>
  24 <p>Jalview can retrieve sequences from certain databases using
  25 either the WSDBFetch service provided by the European Bioinformatics
  26 Institute, and, since Jalview 2.4, DAS servers capable of the <em>sequence</em>
  27 command (configured in <a href="dassettings.html">DAS settings</a>).</p>
  28 <img src="seqfetcher.gif" align="center"
  29         alt="The Jalview Sequence Fetcher Dialog Box">
  30 <p>The Sequence Fetcher dialog box can be opened via the
  31 &quot;File&quot; menu on the main desktop in order to retrieve sequences
  32 as a new alignment, or opened via the &quot;File&quot; menu of an
  33 existing alignment to import additional sequences. Please note, there
  34 will be a short delay when the sequence fetcher is first opened, whilst
  35 Jalview compiles the list of available sequence datasources from the
  36 currently defined DAS server registry.</strong></p>
  37 <p>First, select the database you want to retrieve sequences from.
  38 Then, enter one or more accession ids (as a semi-colon separated list),
  39 or press the &quot;Example&quot; button to paste the example accession
  40 for the currently selected database into the retrieval box. Finally,
  41 press &quot;OK&quot; to initiate the retrieval.</p>
  42 <p><em>Fetching Individual PDB Chains</em><br>
  43 If you are retrieving sequences from the PDB, you can retrieve specific
  44 chains by appending a colon and the chain id to the PDB id. For example
  45 :<br>
  46 <pre> 1GAQ:A</pre>
  47 <br>
  48 When retrieving from DAS sequence sources, coordinate range arguments
  49 can be passed to the server using the standard DAS sequence command
  50 format (
  51 <strong>:&lt;start&gt;,&lt;end&gt;</strong>
  52 )
  53 </p>
  54 <p><em>Retrieving parts of large sequence records</em><br>
  55 Some sequence sources allow a range query to be appended to the sequence
  56 ID - e.g. 'Mito:1,85779'. If you know a source understands this type of
  57 query format, then you should untick the checkbox for 'replace commas
  58 with semi-colons' so the range query can be passed to the server
  59 (otherwise the query will be split up into two 'Mito:1' and '85779'). In
  60 some cases, a source that supports range queries usually include a range
  61 qualification in its example query. In this case, Jalview will
  62 automatically disable the 'replace commas with semi-colons' option.<br>
  63 <em>Support for range queries was added in Jalview 2.6</em></p>
  64 <p>If you use the WSDBFetch sequence fetcher services (EMBL,
  65 Uniprot, PDB and PFAM) in work for publication, please cite:</p>
  66 <p>Pillai S., Silventoinen V., Kallio K., Senger M., Sobhany S.,
  67 Tate J., Velankar S., Golovin A., Henrick K., Rice P., Stoehr P., Lopez
  68 R. <br>
  69 SOAP-based services provided by the European Bioinformatics Institute.<br>
  70 Nucleic Acids Res. 33(1):W25-W28 (2005) <br>
  71 <br>
  72 </p>
  73 </body>
  74 </html>