Welcome to CHEEREIO’s documentation!

Welcome to the CHEEREIO ReadTheDocs documentation! This site provides a manual for the installation, use, and modification of CHEEREIO for a variety of scientific applications.

The GEOS-Chem CHEmistry and Emissions REanalysis Interface with Observations (CHEEREIO) is a set of Python and shell scripts that support data assimilation and emissions inversions for arbitrary runs of the GEOS-Chem chemical transport model via an ensemble approach (i.e. without the model adjoint). CHEEREIO follows five design principles:

  1. Easy to customize: Assimilate anything, in any GEOS-Chem configuration or simulation.

  2. Easy to maintain: Science automatically aligned with latest model version.

  3. Easy to deploy: One configuration file controls installation and settings

  4. Easy to link observations: Object-oriented observation operator implementation allows the user to rapidly add new kinds of data with minimal programming required.

  5. Quick to run: Wall runtime should be no more than 2x longer than vanilla GEOS-Chem (4D-Var limit) assuming resources are available.

This manual assumes that you are familiar with the basics of setting up and running the GEOS-Chem chemical transport model. For more information, please see the GEOS-Chem Wiki.

I am more than happy to collaborate with you, however you choose to use CHEEREIO: just send an email to me at pendergrass [AT] g [DOT] harvard [DOT] edu. Questions of any kind are also more than welcome. This can be on anything from interpreting results to getting the ensemble installed on your machine. Bugs should be reported by opening an issue on Github, as this will allow all users to see the solution.