X-Git-Url: http://source.jalview.org/gitweb/?a=blobdiff_plain;f=help%2Fhtml%2Ffeatures%2Fviewingpdbs.html;h=e62b2a78d9c274731156e6259f17473a57e3e165;hb=3f12f4932226512316ec113e600695150431fd0a;hp=6419525bb243963645a87cde9cf28d36ab2909fc;hpb=de255c8c87707a2cd2a2a15f5ad04ed10fe5846d;p=jalview.git diff --git a/help/html/features/viewingpdbs.html b/help/html/features/viewingpdbs.html index 6419525..e62b2a7 100755 --- a/help/html/features/viewingpdbs.html +++ b/help/html/features/viewingpdbs.html @@ -23,25 +23,35 @@ PDB Viewing -

- Viewing PDB Structures -

- Jalview can be used to view protein structures 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. - -
  2. -
  3. Selecting Structures
    If structures - have been discovered, then some will already be selected according - to predefined selection criteria, such as structures with the - highest resolution. Use the drop down menu to select structures - according to different criteria, or, alternatively, choose - structures manually by selecting with the keyboard and mouse. +

    + 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 to 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 you have previously downloaded structures for your sequences, they @@ -54,83 +64,118 @@
    - 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. -

    + 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. +

    -

    If a single PDB -structure is selected, one of the following will happen:

    +

    + If a single PDB structure is selected, one of the + following will happen: +

    - +

    + Retrieving sequences from the PDB
    You can + retrieve sequences from the PDB using the Sequence Fetcher. The sequences + retrieved with this service are derived directly from the PDB 3D + structure data, which can be viewed in the same way above. Secondary + structure and temperature factor annotation can also be added.
    +

    +

    + Retrieving sequences from the PDB
    Jalview + will also read PDB files directly - either in PDB format, or mmCIF. Simply load in the file as you would + an alignment file. The sequences of any protein or nucleotide chains + will be extracted from the file and viewed in the alignment window. +

    -

    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 protein or nucleotide 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. +
    +

    -

    -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. +

    +
    +
    +

    + 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:
    + DEFAULT_STRUCTURE_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. +

    -

    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.
    +

    -

    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.