Editing MotiveValidator:Technical details (section)

== Output Description ==

=== General Structure ===
* '''[WorkingDirectory]''' - ''Working directory of the application.''
:* '''result''' - ''Contains the result of the computation.''
:: log.txt - ''Contains the console output of the application.''
:: status.json - ''Contains general information of the computation (running time, version, etc.).''

=== MotiveValidator Specific Structure ===
* '''result''' - ''Folder with computation result.''
:: result.zip - ''A zip archive with compressed result.''
::: result.csv - ''File that contains complete information about the result of validation of each motif in a compressed manner.''
::: result.json - ''File that contains complete information about the result of validation of each motif, as well as list of warnings and errors, list of general errors, number of validated motifs, validation type and MotiveValidator version.''
::: general_errors.csv - ''File that contains list of general errors.''
::* '''[3-letter residue code]''' - ''A folder for each input model.''
:::* '''matched''' - ''Folder that contains pairs of validated motif and aligned model, both in PDB format.''
:::* '''mols''' - ''Folder that contains validated motifs in mol format.''
:::* '''motifs''' - ''Folder that contains validated motifs in PDB format.''
:::* '''notanalyzed''' - ''Folder that contains motifs that were not validated.''
:::: errors.csv - ''File that contains list of errors.''
:::: pairing.csv - ''File that contains pairing matrix of motifs' atoms versus model's atoms.''
:::: summary.json - ''File that contains rich summary of each single validation run.''
:::: [3-letter residue code]_model.mol - ''Mol file that contains the model.''
:::: [3-letter residue code]_model.pdb - ''PDB file that contains the model.''
:::: warnings.csv - ''File that contains list of warnings.''

=== Specific File Descriptions ===
This section contains detailed descriptions of selected specific files.
==== <span id='index.csv_description'>index.csv</span> ====
Contains complete information about the result of validation of each motif in a compressed manner.

The CSV file contains these columns: 
* '''ModelName''' [ String ]
: ''Residue name of the model.''
* '''Id''' [ String ]
: ''Name of the validated motif without extension.''
* '''State''' [ String ]
: ''Validation state of the entry.''
* '''MainResidue''' [ String ]
: ''Name and number of main residue of validated motif''
* '''ResidueCount''' [ Number ]
: ''Number of residues present in validated motif file''
* '''Residues''' [ String ]
: ''List of residues present in this motif file. List entries are separated by ;.''
* '''MissingAtomCount''' [ Number ]
: ''Number of atoms that are lacking in validated motif.''
* '''MissingRingCount''' [ Number ]
: ''Number of rings (chemical cycles) that are lacking in validated motif.''
* '''NameMismatchCount''' [ Number ]
: ''Number of motif's atoms that are incorrectly named in the sense of alignment with the model.''
* '''ChiralityMismatchCount''' [ Number ]
: ''Number of chiral atoms in validated motif that have different ligand position from the model.''
* '''SubstitutionCount''' [ Number ]
: ''Number of atoms in validated motif that have been substituted with other element.''
* '''WrongBondCount''' [ Number ]
: ''Number of wrong bonds.''
* '''BondDiscrepancy''' [ Number ]
: ''Signals whether the matched motif bond(s) differ from the model ones.''
* '''MissingAtoms''' [ String ]
: ''List of atoms from validated motif that are considered missing. Each entry of this list consists of atom name, atom element and index of atom from the model that does not have its counterpart in this motif.''
* '''MissingRings''' [ String ]
: ''List of rings from validated motif that are considered missing. Each entry of this list consists of a sequence of atoms that comprise the missing ring and an integer that signifies number of missing rings of each composition (ex. CCCCO*1 means one missing ring of composition CCCCO).''
* '''NameMismatches''' [ String ]
: ''List of atoms from this validated motif which have been paired to a differently named atoms from the model. Each entry of this list consists of motif atom specifications (name, element and index), a separator (-&gt;) and paired model atom specifications (name, element and index).''
* '''ForeignAtoms''' [ String ]
: ''List of atoms in this validated motif that do not belong there. Each entry of this list consists of model atom specifications (name, element and index), a separator (-&gt;), paired motif atom specifications (name, element and index), separator (,) and specifications of the foreign atom (name, index and residue chain identifier).''
* '''Substitutions''' [ String ]
: ''List of atoms with different element symbols from the model structure (ie. O substituted by N).''
* '''ChiralityMismatches''' [ String ]
: ''List of chiral atoms from this validated motif that differ in spatial composition of connected atom(s) from paired chiral atoms of the model. Each entry of this list consists of model atom specifications (name, element and index), a separator (-&gt;) and paired motif atom specifications (name, element and index).''
* '''WrongBonds (ModelFrom-ModelTo:Motive:Exp/Got)''' [ String ]
: ''Wrong Bonds. Currently unused.''
* '''ModelRmsd''' [ Number ]
: ''Root mean square deviation of atomic positions (RMSD) value of the model-motif alignment.''

==== <span id='index.json_description'>index.json</span> ====
File that contains complete information about the result of validation of each motif, as well as list of warnings and errors, list of general errors, number of validated motifs, validation type and MotiveValidator version. This file is used to display the data in the web UI.

In .NET languages, the file can be parsed into the type <code>WebChemistry.MotiveValidator.DataModel.ValidationResult</code> from the library <code>WebChemistry.MotiveValidator.DataModel</code> using the <code>Newtonsoft.Json</code> or similar library. Other straightforward analysis tool for this file is JavaScript (for example in browser or using Node.js).