GEOS-Chem configuration files

From Geos-chem
Revision as of 19:53, 8 December 2020 by Bmy (Talk | contribs) (Photolysis mechanism)

Jump to: navigation, search

Previous | Next | Getting Started with GEOS-Chem

  1. Minimum system requirements
  2. Installing required software
  3. Configuring your computational environment
  4. Downloading source code
  5. Downloading data directories
  6. Creating run directories
  7. Configuring runs
  8. Compiling
  9. Running
  10. Output files
  11. Visualizing and processing output
  12. Coding and debugging
  13. 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 Also see
input.geos File containing all GEOS-Chem user options, such as:
  • 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. The HEMCO User's Guide
HEMCO_Diagn.rc Specifies diagnostic archival options for emissions and related quantities computed by HEMCO emissions component. The HEMCO User's Guide: Diagnostics.
HISTORY.rc Specifies which GEOS-Chem diagnostics will be archived to netCDF output (for both GEOS-Chem "Classic" and GCHP modes) Guide to GEOS-Chem History diagnostics

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

Photolysis mechanism

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

You do not need to modify any of these files unless you wish to change the default photolysis settings.

Chemical mechanism

Chemical mechanism configuration files (gckpp.kpp, fullchem.eqn) are located in this folder:

  • KPP/fullchem

If you are going to be modifying existing chemistry mechanisms or creating new chemistry mechanisms, then you can copy these configuration files to:

  • KPP/custom

and build your new mechanism there. For more information about building chemical mechanisms, please see our FlexChem wiki page.

Previous | Next | Getting Started with GEOS-Chem