Difference between revisions of "GEOS-Chem configuration files"

From Geos-chem
Jump to: navigation, search
(Chemical mechanism files ship with the GEOS-Chem source code)
(GEOS-Chem user input files)
Line 28: Line 28:
 
=== GEOS-Chem user input files ===
 
=== GEOS-Chem user input files ===
  
These files are found in the GEOS_Chem run directory.  You can edit any of these files to change the options that will be used in your GEOS-Chem simulation.
+
These files are found in the GEOS-Chem run directory.  You can edit any of these files to change the options that will be used in your GEOS-Chem simulation.
  
 
{| border=1 cellspacing=0 cellpadding=5  
 
{| border=1 cellspacing=0 cellpadding=5  

Revision as of 17:45, 10 December 2019

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


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.

GEOS-Chem user input files

These files are found in the GEOS-Chem run directory. You can edit any of 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
  • Names of the input and output files
  • Which diagnostics to save to disk
  • 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)
Planeflight.dat Specifies flight tracks for which you want to save out specific tracers, chemical species, or met field quantities.

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

GEOS-Chem photolysis mechanism files

These are found in the ExtData/CHEM_INPUTS/FAST_JX/ directory structure. You do not need to modify any of these files unless you are changing any of the photolysis properties in your chemistry mechanism.

File Description
FJX_spec.dat Contains cross-section and quantum yields for FAST-JX photolysis species.
FJX_j2j.dat Links "GEOS-Chem species" to "FAST-JX" species. FAST-JX photolysis species are defined in the data file FJX_spec.dat, GEOS-Chem species in globchem.spc. See this post for more information.
jv_spec_mie.dat Contains aerosol optical properties at 5 wavelengths.
dust.dat Contains aerosol optical properties for dust at multiple wavelengths for use in Fast-JX and the RRTMG radiatiaive transfer model (if enabled).
org.dat Contains aerosol optical properties for organic carbon at multiple wavelengths for use in Fast-JX and the RRTMG radiatiaive transfer model (if enabled).
so4.dat Contains aerosol optical properties for sulfate at multiple wavelengths for use in Fast-JX and the RRTMG radiatiaive transfer model (if enabled).
soot.dat Contains aerosol optical properties for black carbon at multiple wavelengths for use in Fast-JX and the RRTMG radiatiaive transfer model (if enabled).
ssa.dat Contains aerosol optical properties for accumulation mode sea salt aerosol at multiple wavelengths for use in Fast-JX and the RRTMG radiatiaive transfer model (if enabled).
ssc.dat Contains aerosol optical properties for coarse mode sea salt aerosol at multiple wavelengths for use in Fast-JX and the RRTMG radiatiaive transfer model (if enabled).

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

Chemical mechanism files

The configuration files for the chemical mechanisms that ship with GEOS-Chem are stored in these 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.



Previous | Next | Getting Started with GEOS-Chem