pycif.plugins.chemistries.iconart — API reference

pycif.plugins.chemistries.iconart — API reference#

Configuration reference: iconart plugin

pycif.plugins.chemistries.iconart.make_chemistry.create_chemicalscheme(self)[source]#

Build ICON-ART tracer metadata from the chemistry YAML configuration.

Populates self.dict_tracers, an ordered dict mapping tracer ID to its tracers.xml attribute dictionary, by iterating over active species and their OEM emission categories. For each reference species, the following entries are added:

  • {spec_ref}_BG — passive background tracer.

  • {spec_ref} — optimised tracer with OEM emission configuration.

  • One per-emission-category monitoring tracer ({emi_spec}).

For ensemble runs (species names containing __sample#), additional _POST and _BG_POST tracers are inserted.

Also sets:

  • emis_species — sorted unique list of all OEM emission categories.

  • mapping_emi2active — reverse mapping from OEM category to active species.

  • ref_acspecies / ref_emis_species — base names (without ensemble suffix).

  • oem_categories / oem_tracers — ordered lists used when writing tracers.xml.

Parameters:

self – ICON-ART chemistry plugin instance with acspecies and mapping_active2emi / mapping_active2emi_ref set.