JAL-1551 spotlessApply
[jalview.git] / help / help / html / features / pdbsequencefetcher.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>The PDB Sequence Fetcher</title>
24 </head>
25 <body>
26
27   <strong>The PDB Sequence Fetcher</strong>
28   <p>
29     Jalview provides a specialised interface that allows fast and
30     efficient discovery and retrieval of data from the PDB database,
31     based on the EMBL-EBI's PDBe BioSOLR query interface. It allows
32     interactive querying of PDB metadata with free text and structured
33     queries, so structures can be located without prior knowledge of
34     their database accessions, or <em>via</em> manual cross-referencing
35     with other bioinformatics websites.
36   </p>
37   <p>
38     To open the PDB Sequence Fetcher, select PDB as the database from
39     any <a href="seqfetch.html">Sequence Fetcher</a> dialog (opened <em>via</em>
40     <strong>&quot;File &#8594;Fetch Sequences&quot;</strong>). 
41   </p>
42   <img src="pdbseqfetcher.png" align="left"
43     alt="PDB sequence fetcher (introduced in Jalview 2.9)" />
44
45   <p>
46     <a name="pdbfts"><strong>Searching the PDB Database</strong></a>
47   </p>
48   <p>To search the PDB, begin typing in the text box. If the
49     'autosearch' checkbox is enabled, then the results of your query
50     will be automatically updated and shown in the search results tab;
51     otherwise, press return to update the results. To access previous
52     searches, press the down-arrow or click the drop down menu icon at
53     the side of the search box. If you just want to paste in a list of
54     IDs, the 'Retrieve IDs' tab provides a batch-retrieval interface.</p>
55   <p>
56     You can sort results according to the displayed columns, and select
57     entries with the mouse and keyboard. Once you have selected one or
58     more entries, hit the <strong>OK</strong> button to retrieve and
59     view them in Jalview.
60   </p>
61   <p>
62   <ul>
63     <li><strong>Searching a specific PDB field</strong><br />If
64       you want to find structures based on a specific PDB metadata
65       field, you can select it from the drop-down menu.</li>
66     <li><strong>Retrieving a unique chain for a PDB entry</strong><br>To
67       retrieve a specific chain for a PDB entry, append the PDB ID with
68       a colon followed by the chain code in the search box.<br /> e.g
69       1xyz:A</li>
70
71     <li><strong>Bulk PDB retrieval</strong><br>Multiple PDB
72       IDs can be specified for retrieval via the 
73       <strong>Retrieve IDs</strong> tab.</li>
74
75     <li><strong>Wild card searching</strong><br>The following
76       wild cards are supported by the EMBL-EBI PDBe query service:
77       <ul>
78         <li><strong>?</strong> matches a single character<br />The
79           search string te?t would match both test and text.</li>
80         <li><strong>*</strong> matches multiple characters<br />The
81           search string: tes* - would match test, testing, and tester.</li>
82       </ul> <em>Note:</em> you can use wildcard characters anywhere in a
83       query string.<br />For example: te*t - would match test and text.
84       *est - would match pest and test.</li>
85     <li><strong>Structured queries</strong><br />The PDBe SOLR
86       interface supports boolean query syntax, allowing quoted search
87       strings to be combined with AND, OR, and NOT. Currently, no
88       special support for constructing these queries is provided in the
89       query dialog box.</li>
90   </ul>
91   <p>
92     <strong>Customising The PDB Sequence Fetcher</strong>
93   </p>
94   <p>
95     To change the displayed meta-data in the search result, click the
96     'Configure Displayed Columns' tab, and select the fields you'd like
97     displayed. These fields can also be configured <em>via</em> the
98     Structure tab of the <a href="preferences.html#structure">Jalview
99       Desktop Preferences</a>.
100   </p>
101   <p>
102     <em>The PDB Sequence Fetcher interface was introduced in
103       Jalview 2.9</em>
104   </p>
105 </body>
106 </html>