Chemistries chemistry

Chemistries chemistry#

Chemistry plugins for pyCIF.

A chemistry plugin describes the chemical species and (optionally) the reaction scheme used by a transport model. It is responsible for:

  1. Declaring lists of active, emitted, prescribed, and output species.

  2. Writing model-specific chemical-scheme input files (e.g. ACTIVE_SPECIES, CHEMISTRY, REACTIONS, tracers.xml) to the CIF working directory.

  3. Providing the model plugin with species counts and related metadata.

Each chemistry plugin exposes two main functions:

  • read_chemicalscheme(self, **kwargs) — reads a pre-existing scheme from files in {workdir}/chemical_scheme/{schemeid}/ and populates species attributes on self.

  • create_chemicalscheme(self) — generates scheme files from the YAML configuration (used when no pre-computed files are available).

Available plugins#

  • CHIMERE/gasJtab — CHIMERE gas-phase chemistry with tabulated photolysis rates.

  • ICON-ART/std — ICON-ART tracer scheme (tracers.xml-based).

  • LMDZ/SACS — LMDZ chemistry with the SACS scheme format.

  • TM5/SINK-TIPP — TM5 chemistry using TIPP kinetics and SINK files.

Available Chemistries chemistry#

The following chemistries are implemented in pyCIF so far: