Fix and documentation for JAL-657
[jalview.git] / help / html / features / seqfetch.html
index d8415c7..c4d671a 100755 (executable)
  * 
  * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
 -->
-<head><title>Sequence Fetcher</title></head>
+<head>
+<title>Sequence Fetcher</title>
+</head>
 <body>
 <p><strong>Sequence Fetcher</strong></p>
-<p>Jalview can retrieve sequences from certain databases using either the
-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>
-<img src="seqfetcher.gif" align="center" alt="The Jalview Sequence Fetcher Dialog Box">
-<p>The Sequence Fetcher dialog box can be opened via the &quot;File&quot; 
-  menu on the main desktop in order to retrieve sequences as a new
-  alignment, or opened via the &quot;File&quot; menu of an existing alignment
-  to import additional sequences. Please note, there will be a short delay when the sequence fetcher is first opened, 
-  whilst Jalview compiles the list of available sequence datasources from the 
-  currently defined DAS server registry.</strong>
+<p>Jalview can retrieve sequences from certain databases using
+either the 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>
+<img src="seqfetcher.gif" align="center"
+       alt="The Jalview Sequence Fetcher Dialog Box">
+<p>The Sequence Fetcher dialog box can be opened via the
+&quot;File&quot; menu on the main desktop in order to retrieve sequences
+as a new alignment, or opened via the &quot;File&quot; menu of an
+existing alignment to import additional sequences. Please note, there
+will be a short delay when the sequence fetcher is first opened, whilst
+Jalview compiles the list of available sequence datasources from the
+currently defined DAS server registry.</strong></p>
+<p>First, select the database you want to retrieve sequences from.
+Then, enter one or more accession ids (as a semi-colon separated list),
+or press the &quot;Example&quot; button to paste the example accession
+for the currently selected database into the retrieval box. Finally,
+press &quot;OK&quot; to initiate the retrieval.</p>
+<p><em>Fetching Individual PDB Chains</em><br>
+If you are retrieving sequences from the PDB, you can retrieve specific
+chains by appending a colon and the chain id to the PDB id. For example
+:<br>
+<pre> 1GAQ:A</pre>
+<br>
+When retrieving from DAS sequence sources, coordinate range arguments
+can be passed to the server using the standard DAS sequence command
+format (
+<strong>:&lt;start&gt;,&lt;end&gt;</strong>
+)
+</p>
+<p><em>Retrieving parts of large sequence records</em><br>
+Some sequence sources allow a range query to be appended to the sequence
+ID - e.g. 'Mito:1,85779'. If you know a source understands this type of
+query format, then you should untick the checkbox for 'replace commas
+with semi-colons' so the range query can be passed to the server
+(otherwise the query will be split up into two 'Mito:1' and '85779'). In
+some cases, a source that supports range queries usually include a range
+qualification in its example query. In this case, Jalview will
+automatically disable the 'replace commas with semi-colons' option.<br>
+<em>Support for range queries was added in Jalview 2.6</em></p>
+<p>If you use the WSDBFetch sequence fetcher services (EMBL,
+Uniprot, PDB and PFAM) in work for publication, please cite:</p>
+<p>Pillai S., Silventoinen V., Kallio K., Senger M., Sobhany S.,
+Tate J., Velankar S., Golovin A., Henrick K., Rice P., Stoehr P., Lopez
+R. <br>
+SOAP-based services provided by the European Bioinformatics Institute.<br>
+Nucleic Acids Res. 33(1):W25-W28 (2005) <br>
+<br>
 </p>
-<p>First, select the database you want to retrieve sequences from. Then, enter
-  one or more accession ids (as a semi-colon separated list), or press the 
-  &quot;Example&quot; button to paste the example accession for the currently selected database into the retrieval box.
-   Finally, press &quot;OK&quot; to initiate the retrieval.</p>
-<p>
-  If you are retrieving sequences from the PDB, you can retrieve
-  specific chains by appending a colon and the chain id to the PDB
-  id. For example :<br><pre> 1GAQ:A</pre><br>When retrieving from DAS sequence sources,
-  coordinate range arguments can be passed to the server using the standard DAS 
-  sequence command format (<strong>:&lt;start&gt;,&lt;end&gt;</strong>)</p>
-<p>If you use the WSDBFetch sequence fetcher services (EMBL, Uniprot, PDB and PFAM)
-   in work for publication, please cite:</p>
-<p>Pillai S., Silventoinen V., Kallio K., Senger M., Sobhany S., Tate J., Velankar 
-  S., Golovin A., Henrick K., Rice P., Stoehr P., Lopez R. <br>
-  SOAP-based services provided by the European Bioinformatics Institute.<br>
-  Nucleic Acids Res. 33(1):W25-W28 (2005) <br>
-  <br>
-  </p>
 </body>
 </html>