Skip to content

Latest commit

 

History

History
89 lines (60 loc) · 2.69 KB

phot-chem.rst

File metadata and controls

89 lines (60 loc) · 2.69 KB
Raw

Photolysis and chemistry configuration files

Note

You won't need to edit these configuration files unless you are changing the photolysis and/or chemistry mechanisms used in your GEOS-Chem Classic simulation.

Photolysis configuration files

These are found in the ExtData/CHEM_INPUTS/FAST_JX/ directory structure. Please see Input files for FAST-JX v7.0 for details.

Chemical mechanism configuration files

GEOS-Chem Classic simulations use source code generated by The Kinetic PreProcessor. If you need to update the default chemistry mechanism, you will need to do the following steps:

  1. Modify the relevant KPP configuration files (described below);
  2. Run KPP to generate updated source code for GEOS-Chem Classic;
  3. :ref:`Compile GEOS-Chem Classic <compile>` to create a new executable;
  4. Start your GEOS-Chem Classic simulation.

Chemical mechanism configuration files are located in these folders:

.. option:: KPP/fullchem

   Contains configuration files for the default "full-chemistry"
   mechanism (NOx + Ox + aerosols + Br + Cl + I).

   - :file:`fullchem.kpp`: Main configuration file for the
     **fullchem** mechanism.

   - :file:`fullchem.eqn`: List of species and reactions
     for the **fullchem** mechanism.


.. option:: KPP/carbon

   Contains configuration files for the carbon gases mechanism
   (CH4-CO2-CO-OCS):

   - :file:`carbon.kpp`: Main configuration file for the **carbon**
     mechanism.

   - :file:`carbon.eqn`: List of species and reactions for the **carbon**
     mechanism.


.. option:: KPP/custom

   Contains configuration files that you can edit if you need to
   create a custom mechanism.   We recommend that you create the
   custom in this folder and leave :file:`KPP/fullchem` and
   :file:`KPP/Hg` untouched.

   - :file:`custom.kpp`: Copy of :file:`fullchem.kpp`

   - :file:`custom.eqn`: Copy of :file:`fullchem.eqn`.


.. option:: KPP/Hg

   Contains configuration files for the mercury chemistry mechanism:

   - :file:`Hg.kpp`: Main configuration file for the **Hg**
     mechanism.

   - :file:`Hg.eqn`: List of species and reactions for the **Hg**
     mechanism.

Please see the following references for more information about KPP:

  1. The KPP user manual (kpp.readthedocs.io)
  2. Supplemental Guide: :ref:`kppguide`