GEOS-Chem configuration files

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
   • Editing input.geos
   • Editing HEMCO_Config.rc
   • Editing HEMCO_Diagn.rc
   • Editing HISTORY.rc and other configuration files
8. Compiling
9. Running
10. Output files
11. Python tools for use with GEOS-Chem
12. Coding and debugging
13. Further reading

Overview

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 [https://hemco.readthedocs.io Harmonized Emisions Component (HEMCO).	hemco.readthedocs.io
[Thttps://geos-chem.readthedocs.io/en/latest/gcc-guide/03-config/hemco-diagn.html HEMCO_Diagn.rc]	Specifies diagnostic archival options for emissions and related quantities computed by HEMCO emissions component.	hemco.readthedocs.io
[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.readthedocs.io.

GEOS-Chem species database

This content has been moved to the species_database.yml chapter of geos-chem.readthedocs.io

---

Previous | Next | Getting Started with GEOS-Chem