GEOS-Chem configuration files

From Geos-chem
Revision as of 20:16, 10 December 2019 by Bmy (Talk | contribs) (List of GEOS-Chem configuration files)

Jump to: navigation, search

Previous | Next | Getting Started with GEOS-Chem

  1. Minimum system requirements
  2. Downloading source code
  3. Downloading data directories
  4. Creating run directories
  5. Configuring runs
  6. Compiling
  7. Running
  8. Output files
  9. Visualizing and processing output
  10. Coding and debugging
  11. Further reading


This page describes the configuration files that are read by GEOS-Chem. Configuration files are automaticaly added to a GEOS-Chem run directory when it is created. The configuration files contain "out-of-the-box" default settings for each type of GEOS-Chem simulation. But you can edit these files to customize your GEOS-Chem simulation with different options.

List of GEOS-Chem configuration files

Below is a table listing GEOS-Chem input files that reside in the run directory.

User inputs

Configuration files that specify user inputs are located in each GEOS-Chem run directory.

You can edit any of the default settings in these files to change the options that will be used in your GEOS-Chem simulation.

File Description
input.geos File containing all GEOS-Chem user options. In this file, you may specify the following options:
  • Start & end time of the simulation
  • Grid definitions
  • Which processes (e.g. chemistry, transport, dry deposition, etc.) to turn on, etc.
HEMCO_Config.rc Specifies emission inventories that you want to include in GEOS-Chem via the HEMCO emissions component.
HEMCO_Diagn.rc Specifies diagnostic archival options for emissions and related quantities computed by HEMCO emissions component.
HISTORY.rc Specifies which GEOS-Chem diagnostics will be archived to netCDF output (for both GEOS-Chem "Classic" and GCHP modes)

--Bob Yantosca (talk) 17:40, 10 December 2019 (UTC)

Photolysis mechanism

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

You do not need to modify any of these files unless you are changing any of the photolysis properties in your chemistry mechanism.

--Bob Yantosca (talk) 18:54, 10 December 2019 (UTC)

Chemical mechanism

Configuration files for the predefined GEOS-Chem chemical mechanisms are located in the subfolders of the GEOS-Chem source code directory:

  • KPP/Standard
  • KPP/Tropchem

You should not need to modify these unless you wish to change any of the default chemical mechanism settings.

If you need to add new species or reactions, you can modify these globchem.* files and then rebuild the KPP code. It is recommended that you place any custom modifications to the GEOS-Chem chemistry mechanisms into this folder:

  • KPP/Custom

You can ask the GEOS-Chem Support Team for assistance with this.

Please also see our FlexChem wiki page, which describes how to create and update GEOS-Chem mechanisms.

--Bob Yantosca (talk) 19:19, 10 December 2019 (UTC)

Previous | Next | Getting Started with GEOS-Chem