Define a YAML specification for chemical mechanism input

[jeff-cohere]

As part of our work in establishing a chemistry capability for haero, we're developing a batch chemistry (0D) driver program that accepts input defining a "chemical mechanism" (a set of reactions, reactants, products, and all related rate/equilibrium information) that runs that mechanism from a time t1 to another time t2. Since we're already using (YAML)[https://yaml.org] for Haero's standalone driver, let's use it as the language in which the chemical mechanism is expressed.

This task is complete when we have a document that describes how a chemical mechanism is defined in a YAML text file. The chemistry "driver" may have other parameters, like t1 and t2, that affect its operation, but don't have to do with the chemical mechanism. These parameters should not be included in the description of the chemical mechanism.

For reference, here's the KPP web page (taste the rainbow!) And here's its user manual

[jeff-cohere]

Here's an example of a tool that validates input against a YAML schema, like James mentioned in our meeting yesterday. Just sticking it here for reference.

[overfelt]

There is also: [https://json-schema-everywhere.github.io/yaml] that has a list of YAML schema validaters. The JSON/YAML relationship is complicated. Most JASON parsers will parse YAML. And there are also two flavors of YAML, with indention or with curly braces, that look very different.