Editing ValidatorDB:UI

=First dive to the ValidatorDB UI=

Below you can find a visual dictionary of all all the information you can squeeze out of '''ValidatorDB'''. Also consult the [[ValidatorDB|wiki]] and the [[MotiveValidator:Terminology | Terminology]].

=Introduction=
{| class="wikitable" border="1" style="margin: 1em auto 1em auto;"
 |-
 |<!--Col1-->[[File:VDB_intro.png| 750px]]
 |<!--Col2--><center>[[File:VDB_samples.png| 750px]]</center>
 |-
 |<!--Col1-->1 The '''Synopsis page''' contains a general description, and is organized in 6 tabs, namely ''Quick Help'', ''Samples'',  ''Overview'',<br/> ''Details by Molecule'',  ''Details by PDB Entry'' and ''Custom Search''. These tabs provide access to graphical and tabular overviews<br/> and statistical evaluation of validation results for the entire PDB, for each residue across all PDB IDs containing that residue,<br/> and for all analyzed residues in each PDB ID, respectively. Click on each tab to discover what type of overview can be accessed.<br/> Whenever you are unsure about the meaning of individual graphical elements either hover mouse over it or click the green<br/> '? Guide' button.
 |<!--Col2-->2. The '''Samples page''' contains several examples with a short description of validation results of both validated residues and<br/> PDB entries. 
 |-
 |<!--Col1-->[[File:VDB_overview.png| 750px]]
 |<!--Col2--><center></center>
 |-
 |<!--Col1-->3. The '''Overview tab''' contains a overall validation report for all the ligands in the PDB database. For the description of each<br/> category, please consult other [[ValidatorDB:Analysis_of_Results | wiki page]]. The validation report is also available for each validated residue or PDB entry. Note that<br/> a category is visible only if is populated with more than 0.5% of entries.

Note that this statistics can be downloaded in a *.csv format after clicking 'CSV' in the bottom right corner of the infographics.
 |<!--Col2-->
 |}

=Details by Molecule=
{| class="wikitable" border="1" style="margin: 1em auto 1em auto;"
 |-
 |<!--Col1-->[[File:VDB_Residues.PNG| 750px]]
 |<!--Col2--><center>[[File:VDB Model.png| 750px]]</center>
 |-
 |<!--Col1-->5. The '''Details by Molecule tab''': interactive table summarizing the results for each validated residue across the entire PDB.<br/> [[ValidatorDB:Analysis_of_Results |Validation results]] keep the color coding convention, and all results can be downloaded in .csv format. A filter allows to display<br/> results only for selected residues. Click on any residue name to access the '''ValidatorDB Specifics page''' with detailed validation<br/> results for that residue. Whenever you are unsure about the meaning of individual graphical elements either hover mouse over<br/> it or click the green '?' button.
 |<!--Col2-->6. The '''Overview''' tab summarizes the validation report for all validated residues  extracted from the PDB database. By clicking<br/> '''Summary''' tab you are navigated to the '''specifics page''' with more detailed information about errors and chirality issues of given model.

Note that this statistics can be downloaded in a *.csv format after clicking 'CSV' in the bottom right corner of the infographics.
 |-
 |<!--Col1-->[[File:Residue_summary.PNG| 750px]]
 |<!--Col2--><center>[[File:VDB_Residue_details.PNG| 750px]]</center>
 |-
 |<!--Col1-->7. The '''Specifics page''' contains validation results for specific residues of interest,which can be viewed in a few different tabs,<br/> which control the form and level of detail that the results will be presented in. The tabs Summary and Details, allow different levels<br/> of analysis, while the tab '''Overview''' presents a rough overview of the results in a graph similar to the '''Overview''' tab on the<br/> '''Synopsis page'''. An additional tab with '''Processing Warnings''' may appear if issues are detected in the input files.

Note that this statistics can be downloaded in a *.csv format after clicking 'CSV' in the bottom right corner of the infographics.
 |<!--Col2-->8. '''Details''' tab contains a list of all the validated residues, by clicking an individual entry, more [[#Result analysis | details]]  about the structure and it's<br/> issues are available.
 |}

=Details by PDB Entry=
{| class="wikitable" border="1" style="margin: 1em auto 1em auto;"
 |-
 |<!--Col1-->[[File:VDB_PDBEntries.PNG| 750px]]
 |<!--Col2--><center>[[File:VDB_Entry.PNG| 750px]]</center>
 |-
 |<!--Col1-->9.  The '''Details by PDB Entry''' tab: interactive table summarizing the results for all validated residues in each PDB entry.<br/> [[ValidatorDB:Analysis_of_Results |Validation results]] keep the color coding convention, and all results can be downloaded in .csv format. A filter allows to display<br/> results only for selected residues or selected PDB entries. Click on any PDB ID to access the '''ValidatorDB Specifics page'''<br/> with detailed validation results for all residues relevant for validation in that PDB entry.
 |<!--Col2-->10. The '''Overview''' tab summarizes the validation report for all the validated residues in selected PDB entry. By clicking<br/> '''Summary''' tab you are navigated to the '''specifics page''' with more detailed information about the individual residues.

Note that this statistics can be downloaded in a *.csv format after clicking 'CSV' in the bottom right corner of the infographics.
 |-
 |<!--Col1-->[[File:VDB_Entry_summary.PNG| 750px]]
 |<!--Col2--><center>[[File:VDB Entry summary details.PNG| 750px]]</center>
 |-
 |<!--Col1-->11. The '''ValidatorDB specifics page'''. The list of residues for which results are available is given at the top of the page. In the list,<br/> click on the residue of interest to get the summary of its validation. For each residue, the Summary tab provides an overview of the
validation results in tabular and graphical form. The issues reported are related to incomplete structure or incorrect chirality,<br/> as well as useful warnings. The color coding convention is maintained. Further, problematic atoms are highlighted, to better locate<br/> problems in the structures.

Note that this statistics can be downloaded in a *.csv format after clicking 'CSV' in the bottom right corner of the infographics.
 |<!--Col2-->12.  The '''Details''' allows to inspect the issues in selected groups of motifs, and further in each individual motif. A motif is a single<br/> instance (occurrence) of a validated residue, and is assigned a unique motif identifier based on the PDB ID of the PDB entry of<br/> origin, and the PDB atom identifier of the first atom in the motif. Each row in the table contains information regarding a single motif.<br/> In order to select which motifs will be displayed in the table, you may specify the residue name and type of issue in the drop down<br/> menus of the selection fields at the top of the table. Further, you may refine your selection using the Id Filter. The number and location<br/> of any issues identified in the structure of each motif is given, along with additional notes regarding which residues appear in the vicinity<br/> of the validated motif. You can open the 3D visualizer by clicking on a motif's Id in the '''Details''' tab.
 |}

=Result analysis=
{| class="wikitable" border="1"
 |-
 |<!--Col1-->[[File:VDB_Details_entry.PNG| 750px]]
 |-
 |<!--Col1-->13. You may manipulate (rotate in the 3D space) with the 3D representations of the validated motif and model residue, so as to better assess the position and relevance of the structural issues found during validation. A 2D model is provided for clarity, especially helpful when working with larger and complex residues. Basic information about the validated residue in question is also given, along with a complete report of the validation results.
 |}