Difference between revisions of "GEOS-Chem configuration files"

From Geos-chem
Jump to: navigation, search
(List of GEOS-Chem configuration files)
Line 48: Line 48:
 
*etc.
 
*etc.
 
|
 
|
 +
*NOTE: <tt>input.geos</tt> has been migrated to a YAML format configuration file named [https://geos-chem.readthedocs.io/en/latest/gcc-guide/03-config/geoschem-config.html <tt>geoschem_config.yml</tt>] in GEOS-Chem 14.0.0 and later versions.
  
 
|-valign="top"
 
|-valign="top"
|[[The HEMCO_Config.rc file|<tt>HEMCO_Config.rc</tt>]]
+
|[https://geos-chem.readthedocs.io/en/latest/gcc-guide/03-config/hemco-config.html <tt>HEMCO_Config.rc</tt>]
|Specifies emission inventories (as well as other data sources) that you want to read into in GEOS-Chem via the [[HEMCO|Harmonized emissions component (HEMCO)]].
+
|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).
|''[[The HEMCO User's Guide]]''
+
|[https://hemco.readthedocs.io <tt>hemco.readthedocs.io</tt>]
  
 
|-valign="top"
 
|-valign="top"
|[[The HEMCO_Diagn.rc file|<tt>HEMCO_Diagn.rc</tt>]]
+
|[Thttps://geos-chem.readthedocs.io/en/latest/gcc-guide/03-config/hemco-diagn.html <tt>HEMCO_Diagn.rc</tt>]
 
|Specifies diagnostic archival options for emissions and related quantities computed by [[HEMCO|HEMCO emissions component]].
 
|Specifies diagnostic archival options for emissions and related quantities computed by [[HEMCO|HEMCO emissions component]].
|[[The HEMCO User's Guide#Diagnostics|''The HEMCO User's Guide: Diagnostics'']].
+
|[https://hemco.readthedocs.io <tt>hemco.readthedocs.io</tt>]
  
 
|-valign="top"
 
|-valign="top"
|[[HISTORY.rc and other configuration files|<tt>HISTORY.rc</tt>]]
+
|[[https://geos-chem.readthedocs.io/en/latest/gcc-guide/03-config/history.html|<tt>HISTORY.rc</tt>]]
 
|Specifies which GEOS-Chem diagnostics will be archived to netCDF output (for both GEOS-Chem "Classic" and GCHP modes)
 
|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]]''
+
|[[Guide to GEOS-Chem History diagnostics]]
  
 
|}
 
|}
  
=== Photolysis mechanism ===
+
=== Photolysis and chemistry mechanism configuration files ===
  
These are found in the <tt>ExtData/CHEM_INPUTS/FAST_JX/</tt> directory structure.  Please see [[FAST-JX_v7.0_photolysis_mechanism#Input_files_for_FAST-JX_v7.0|''Input files for FAST-JX v7.0'']] for details.
+
This content has been migrated to the [https://geos-chem.readthedocs.io/en/latest/gcc-guide/03-config/phot-chem.html '''Photolysis and chemistry configuration files'' chapter of <tt>geos-chem.readthedocs.io</tt>].
  
You do not need to modify any of these files unless you wish to change the default photolysis settings.
 
  
=== Chemical mechanism ===
+
=== GEOS-Chem species database ===
  
Chemical mechanism configuration files (<tt>gckpp.kpp</tt>, <tt>fullchem.eqn</tt>) are located in this folder:
+
This content has been moved to the [https://geos-chem.readthedocs.io/en/latest/gcc-guide/03-config/spec-db.html '''species_database.yml''' chapter of <tt>geos-chem.readthedocs.io</tt>]
 
+
*<tt>KPP/fullchem</tt>
+
 
+
If you are going to be modifying existing chemistry mechanisms or creating new chemistry mechanisms, then you can copy these configuration files to:
+
 
+
*<tt>KPP/custom</tt>
+
 
+
and build your new mechanism there. For more information about building chemical mechanisms, please see [[FlexChem|our ''FlexChem'' wiki page]].
+
  
  
 
----
 
----
 
'''''[[Creating GEOS-Chem run directories|Previous]] | [[The input.geos file|Next]] | [[Getting Started with GEOS-Chem]]'''''
 
'''''[[Creating GEOS-Chem run directories|Previous]] | [[The input.geos file|Next]] | [[Getting Started with GEOS-Chem]]'''''

Revision as of 15:10, 4 August 2022

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


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