X-Git-Url: http://source.jalview.org/gitweb/?a=blobdiff_plain;f=help%2Fhtml%2Ffeatures%2Fviewingpdbs.html;h=b1ad4bae86c77cc534a3285c370a2a3e864cb54e;hb=383fd91269f510b189450fbe174e9c051103c7eb;hp=4904856d1fd311df7aa55befe18eeedad3c17fb6;hpb=59d682209891099d46b960509907c79e3fb276fe;p=jalview.git diff --git a/help/html/features/viewingpdbs.html b/help/html/features/viewingpdbs.html index 4904856..b1ad4ba 100755 --- a/help/html/features/viewingpdbs.html +++ b/help/html/features/viewingpdbs.html @@ -1,121 +1,190 @@ + * You should have received a copy of the GNU General Public License + * along with Jalview. If not, see . + * The Jalview Authors are detailed in the 'AUTHORS' file. + --> PDB Viewing -

Viewing PDB Structures

+

+ Discovering and Viewing PDB Structures +

+ Jalview can be used to explore the 3D structures of sequences in an + alignment by following the steps below: +
    +
  1. Select the "3D Structure Data..." option + from a sequence's pop-up + menu to open the Structure + Chooser dialog box. +
      +
    • If one or more structures exists for the given + sequence, the Structure + Chooser dialog will open with them listed in the results + pane. +
    • +
    • However, if no structure was found, the Structure Chooser interface + will present options for manual association of PDB structures. +
    • +
    +
  2. +
  3. Selecting Structures
    You can select + the structures that you want to open and view by selecting them + with the mouse and keyboard.
    By default, if structures were + discovered, then some will already be selected according to the + criteria shown in the drop-down menu. The default criteria is + 'highest resolution', simply choose another to pick structures in + a different way.
    +
      +
    • Viewing Cached Structures
      If + previously downloaded structures are available for your + sequences, the structure chooser will automatically offer them + via the Cached Structures view. If you wish + to download new structures, select one of the PDBe selection + criteria from the drop-down menu.
    • +
  4. +
  5. To view selected structures, click the "View" + button. +
    +
      +
    • Additional structure data will be downloaded with the + EMBL-EBI's dbfetch service
    • +
    • SIFTS records will also + be downloaded for mapping UniProt protein sequence data to PDB + coordinates.
    • +
    • A new structure viewer will open, or you will be + prompted to add structures to existing viewers (see below for details). +
    • +
  6. +
+

+ Structure Viewers in the Jalview Desktop
The + Jmol viewer has been included since Jalview + 2.3. Jalview 2.8.2 included support for Chimera, + provided it is installed and can be launched by Jalview. The default + viewer can be configured in the Structure + tab in the Tools→Preferences dialog box. + +

+ Structure data imported into Jalview can also be processed to + display secondary structure and temperature factor annotation. See + the Annotation from Structure page + for more information. +

+

+
Controlling where the new structures + will be shown +
The Structure Chooser offers several options + for viewing a structure.
New View will open a new + structure viewer for the selected structures, but if there are views + already open, you can select which one to use, and press the Add + button. Jalview can automatically superimpose new structures based + on the linked alignments - but if this is not desirable, simple + un-tick the Superpose Structures checkbox. -

Jalview can view protein structures associated with a sequence -via the "Structure→View PDB entry:" entries from a -sequence's pop-up menu. Once a pdb -structure is selected, one of the following will happen:

+

+

+ Superposing structures
Jalview superposes structures using + the visible portions of any associated sequence alignments. A + message in the structure viewer's status bar will be shown if not + enough aligned columns were available to perform a superposition. +

+

+ See the Jmol + and Chimera help pages for + more information about their capabilities.

+ - -

- Opening structures associated with the current selection
- If one or more of the sequences in the alignment are selected, then - the Structure submenu of the Sequence - ID popup menu will contain will include either a 'View all X - structures' entry in the submenu or a 'View structure for Sequence' - entry. Both these options will open a new Jmol view containing one, or - all the structures available for all selected sequences, superimposed - using the currently selected region of the alignment. (This - capability was added in Jalview 2.7) -

-

Associating PDB files with Sequences

-

To associate PDB files with a sequence, right click on a sequence -ID and select "Structure Associate Structure with -Sequence", and one of the submenus:

+

+ Viewing the PDB Residue Numbering
+ Sequences which have PDB entry or PDB file associations are + annotated with sequence features from a group named with the + associated PDB accession number or file name. Each feature gives the + corresponding PDB Residue Number for each mapped residue in the + sequence. The display of these features is controlled through the "View→Sequence + Features" menu item and the Feature + Settings dialog box. +

+
+
+

+ Switching between mmCIF and PDB format for + downloading files from the PDB
Jalview now employs the mmCIF format for importing 3D structure data + from flat file and EMBL-PDBe web-service, as recommended by the + wwwPDB. If you prefer (for any reason) to download data as PDB files + instead, then first close Jalview, and add the following line to + your .jalview_properties file:
+ PDB_DOWNLOAD_FORMAT=PDB +
When this setting is configured, Jalview will only request + PDB format files from EMBL-EBI's PDBe.
mmCIF format + file support was added in Jalview 2.10. +

- - -

Importing PDB Entries or files in PDB format
-You can retrieve sequences from the PDB using the Sequence Fetcher. Any sequences retrieved with -this service are automatically associated with their source database -entry. For PDB sequences, simply select PDB as the database and enter -your known PDB id (appended with ':' and a chain code, if desired).
-Jalview will also read PDB files directly. Simply load in the file as -you would an alignment file. The sequences of any peptide chains will be -extracted from the file and viewed in the alignment window.

- -

-Associating a large number of PDB files to sequences -in an alignment
It is often the case when working with -structure alignments that you will have a directory of PDB files, and -an alignment involving one or more of the structures. If you drag a -number of PDB files onto an alignment in the Jalview desktop, Jalview -will give you the option of associating PDB files with sequences that -have the same filename. This means, for example, you can automatically -associate PDB files with names like '1gaq.pdb' with sequences that -have an ID like '1gaq'. -
Note: This feature was added in Jalview 2.7 -

-

Note for jalview applet users:
-Due to the applet security constraints, PDB Files can currently only be -imported by cut and paste of the PDB file text into the text box opened -by the 'From File' entry of the structure menu.

- -

Viewing the PDB Residue Numbering
-Sequences which have PDB entry or PDB file associations are annotated -with sequence features from a group named with the associated PDB -accession number or file name. Each feature gives the corresponding PDB -Residue Number for each mapped residue in the sequence. The display of -these features is controlled through the "View→Sequence -Features" menu item and the Feature -Settings dialog box.

- -

Outstanding problem with cut'n'pasted -files in Jalview 2.6 and Jalview 2.7
-Structures imported via the cut'n'paste dialog box will not be correctly -highlighted or coloured when they are displayed in structure views, -especially if they contain more than one PDB structure. See the bug -report at http://issues.jalview.org/browse/JAL-623 for news on this problem.