GEOS-Chem configuration files

From Geos-chem
Revision as of 15:10, 4 August 2022 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. 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. Python tools for use with GEOS-Chem
  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.
  • NOTE: input.geos has been migrated to a YAML format configuration file named geoschem_config.yml in GEOS-Chem 14.0.0 and later versions.
HEMCO_Config.rc Specifies emission inventories (as well as other data sources) that you want to read into in GEOS-Chem via the [ Harmonized Emisions Component (HEMCO).
[T 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) Guide to GEOS-Chem History diagnostics

Photolysis and chemistry mechanism configuration files

This content has been migrated to the 'Photolysis and chemistry configuration files chapter of

GEOS-Chem species database

This content has been moved to the species_database.yml chapter of

Previous | Next | Getting Started with GEOS-Chem