X-Git-Url: http://source.jalview.org/gitweb/?a=blobdiff_plain;f=help%2Fhtml%2Ffeatures%2Fstructurechooser.html;h=daa1ac3cff20873daadc57bf0086030a4120bf0b;hb=8546ee20c998cd48567d324027d1885a771e688f;hp=7db8083ba30591691e85eb152a0c92a6314d3a10;hpb=354963d0c9d69f28fa5aa642c1f13627676ff4ae;p=jalview.git diff --git a/help/html/features/structurechooser.html b/help/html/features/structurechooser.html index 7db8083..daa1ac3 100644 --- a/help/html/features/structurechooser.html +++ b/help/html/features/structurechooser.html @@ -24,86 +24,98 @@
-- Structure Chooser -
++ Structure Chooser +
- The Structure Chooser interface provides a smart technique for - selecting PDB structures to view in Jalview by querying readily - available meta-data of structures. The Interface can be invoked by selecting - the - "3D Structure Data.." option from a sequence's - pop-up menu. Some of the main - features it provides are listed below: -+ The Structure Chooser interface allows you to interactively select + which PDB structures to view for the currently selected set of + sequences. It's opened by selecting the "3D + Structure Data.." option from the Sequence ID panel's pop-up menu. The dialog + provides: +
++ Automated discovery of structure data +
+After selecting "3D Structure Data ..", Jalview queries the PDB + via the PDBe SOLR Rest API provided by EMBL-EBI to discover PDB ids + associated with the sequence. It does this based on the sequence's + ID string, and any other associated database IDs.
++ Exploration of meta-data for available structures +
+Information on each structure available is displayed in columns + in the dialog box. By default, only the title, resolution and PDB + identifier are shown, but many more are provided by the PDBe. To + configure which ones are displayed, select the 'Configure Displayed + Columns' tab and tick the columns which you want to see.
++ Selection of the best structure for each sequence +
+Jalview can automatically select the best structures according + to meta-data provided by the PDB. By default, the 'Best Quality' + structure for each sequence will be selected, but clicking on the + drop down menu allows other criteria to be chosen, including + Resolution (only defined for X-Ray structures), Highest Protein + Chain etc. When 'Invert' is selected, structures are selected in + reverse order for the current criteria (e.g. worst quality rather + than best).
+
- Associating PDB files with Sequences
- Discovery/Association of PDB entries to a sequence now happens
- automatically during the initialisation of the Structure Chooser
- Interface. Jalview uses the sequence's ID to query the PDB Rest API
- provided by the EBI to discover PDB Ids associated with the sequence.
-
-
- Configuring displayed meta-data for Structures
- To configure the visible meta-data displayed for the discovered structures, click the 'Configure Displayed Columns' tab, then tick the options which you intend to make visible.
-
-
- Auto-selection of best Structures
-
Jalview can automatically filter and select the best structures using various metric categories avaialble from the meta-data
- of the structures. To perform this simply select any of the following options from the drop-down menu in the Structure
- Chooser interface: Best Uniprot coverage, Higest Resolution,
- Best Quality, Highest Protein Chain etc. When the 'Invert' option is selected, Jalview returns an inverse result for the current selected option in the drop-down menu.
-
-
-
-
The screenshot above shows the Structure Chooser interface
- along with the meta-data of auto-discovered structures for the sample
- alignment. Note however that if no structures were auto-discovered, a
- different interface for manual association will be invoked as seen in
- the screenshot below.
-
- -
- Manual selection/association of PDB files with Sequences -
-To manually associate PDB files with a sequence, select any of - the follwing options listed below from the drop-down menu in the - interface: -
+ +
+ Manual selection/association of PDB files with + Sequences +
+To manually associate PDB files with a sequence, select 'From + File', or 'Enter PDB Id' from the drop-down menu: +
+ Viewing existing structures for your sequences +
++ If you have previously associated structure data on the alignment, + selecting Cached PDB Entries from the drop down + menu allows you to select these structures for display. +
-- The Structure Chooser interface was introduced in Jalview 2.9. - -
++ The Structure Chooser interface was introduced in Jalview + 2.9. +