<commit_before># QC_JSON_Schema
A JSON Schema for Quantum Chemistry

The purpose of this schema is to provide API like access to pre-existing quantum
chemistry packages to enable more complex workflows.  The core of this is to
avoid parsing ASCII-based output files and place output variables, vectors,
matrices in a consistent format that can be easily parsed.

## High Level Aspirations
In order to help define the overall scope and direction of the specification several high level goals will be pursued: 

- Ability to connect to visualizers and GUI's
- Connect to existing Workflows tools
- Transfer data between QM programs (Orbitals, Densities, etc)
- Provide a rigorous record of computation for large scale QM databases
- Provide a framework for QM API access

A concrete list of requirements for this schema can be found [here](Requirements.md).

## Example
The following is an example Python version. Note that the specification
is likely to change heavily, especially with regard to units. However, this is
an example of the common input and output structures:

```
>>> json_molecule = {}
>>> json_molecule["geometry"] = [0, 0, 0, 0, 0, 1]
>>> json_molecule["atoms"] = ["He", "He"]

>>> json_input = {}
>>> json_input["molecule"] = json_molecule
>>> json_input["driver"] = "energy"
>>> json_input["method"] = {"expression": "SCF",
                            "basis":     "sto-3g"}
```

A discussion of each top level component can be found [here](Spec_Components.md).
Details can also be found on [variable names](Variables.md) and the [technical specifications](Technical_Specifications.md).

## Partners
The following is a list of programs that have agreed to implement this JSON
specification once a stable version has been released. If do not see your code
here and would like to be part of the project, get in touch!
 
  
### Organizations
 - [The Molecular Sciences Software Institute](http://www.molssi.org)
 
### Visualizers
 - [Avogadro](https://avogadro.cc)
 - [Molecular Design Toolkit](https://github.com/Autodesk/molecular-design-toolkit)
 - [VTK](http://www.vtk.org)
 
### Quantum Chemistry Engines
 - [MPQC](https://github.com/ValeevGroup/mpqc)
 - [NWChem](http://www.nwchem-sw.org/index.php/Main_Page)
 - [Psi4](https://github.com/psi4/psi4)
 
### Translators
 - [cclib](http://cclib.github.io)
 
## Governance
This project is currently managed by the following members:

 - <NAME> - [Kitware](http://www.openchemistry.org)
 - <NAME> - [LBNL](https://crd.lbl.gov/departments/computational-science/ccmc/staff/staff-members/bert-de-jong/)
 - <NAME> - [MolSSI](molssi.org)
 - <NAME>  - [Autodesk](https://bionano.autodesk.com)

This management group will serve as a nexus for writing the schema and facilitate communication with the community. 

## Existing JSON Efforts
The following is a list of efforts that are very similar to the current
proposed spec. The idea is to pull from this diverse group and coalesce into a
single specification to prevent duplication of effort.

 - [Autodesk JSON](https://github.com/Autodesk/molecular-design-toolkit/wiki/Molecular-JSON-Draft-Spec#molecule)
 - [BAGEL JSON](https://github.com/nubakery/bagel/blob/master/test/benzene_sto3g_pml.json)
 - [Chemical JSON](https://github.com/OpenChemistry/chemicaljson)
 - [MPQC JSON](https://gist.github.com/dgasmith/28ce209867afd272d361a00322960160)
 - [NWChem JSON](https://github.com/wadejong/NWChemOutputToJson)
 - [Psi4 JSON](https://github.com/psi4/psi4/blob/master/psi4/driver/json_wrapper.py#L55)
 - [PyQC Schema](https://github.com/PyQC/json_schema)
 - [Molpro Database XML](https://www.molpro.net/info/2015.1/doc/manual/node814.html)
 - Chemical Markup Language - http://www.xml-cml.org
 <commit_msg>Removes duplicate docs data from the README to prevent confusion<commit_after># QC_JSON_Schema
A JSON Schema for Quantum Chemistry

The purpose of this schema is to provide API like access to pre-existing quantum
chemistry packages to enable more complex workflows.  The core of this is to
avoid parsing ASCII-based output files and place output variables, vectors,
matrices in a consistent format that can be easily parsed.

Please see the [website](http://molssi-qc-schema.readthedocs.io/en/latest/index.html#) for the current specification. 

{'fraction_non_alphanumeric': 0.10868544600938967, 'fraction_numerical': 0.011737089201877934, 'mean_word_length': 4.4558258642765685, 'pattern_counts': {'":': 2, '<': 7, '<?xml version=': 0, '>': 28, 'https://': 14, 'lorem ipsum': 0, 'www.': 6, 'xml': 1}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2574047', 'n_tokens_mistral': 1360, 'n_tokens_neox': 1247, 'n_words': 436}