GEOS-Chem configuration files

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
   • input.geos
   • HEMCO_Config.rc
   • HEMCO_Diagn.rc
   • HISTORY.rc and other configuration files
6. Compiling
7. Running
8. Output files
9. Visualizing and processing output
10. Coding and debugging
11. 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
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. For more information, please see The Diagnostics section of The HEMCO User's Guide.
HISTORY.rc	Specifies which GEOS-Chem diagnostics will be archived to netCDF output (for both GEOS-Chem "Classic" and GCHP modes) For more information, please see our Guide to GEOS-Chem History diagnostics.

--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
• KPP/SOA_SVPOA

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