Difference between revisions of "GEOS-Chem configuration files"

From Geos-chem
Jump to: navigation, search
(Chemical mechanism)
(User-editable configuration files)
 
(12 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
__FORCETOC__
 
__FORCETOC__
 
'''''[[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]]'''''
#[[Minimum system requirements for GEOS-Chem|Minimum system requirements]]
+
#[[Minimum system requirements for GEOS-Chem|Minimum system requirements (and software installation)]]
#[[Installing required software]]
+
 
#[[Configuring your computational environment]]
 
#[[Configuring your computational environment]]
 
#[[Downloading GEOS-Chem source code|Downloading source code]]
 
#[[Downloading GEOS-Chem source code|Downloading source code]]
Line 15: Line 14:
 
#[[Running GEOS-Chem|Running]]
 
#[[Running GEOS-Chem|Running]]
 
#[[GEOS-Chem output files|Output files]]
 
#[[GEOS-Chem output files|Output files]]
#[[Guide_to_visualization_and_analysis_tools_for_GEOS-Chem|Visualizing and processing output]]
+
#[[Python tools for use with GEOS-Chem]]
 
#[[GEOS-Chem_coding_and_debugging|Coding and debugging]]
 
#[[GEOS-Chem_coding_and_debugging|Coding and debugging]]
 
#[[GEOS-Chem_overview#Further_reading|Further reading]]
 
#[[GEOS-Chem_overview#Further_reading|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 ==
 
== List of GEOS-Chem configuration files ==
  
Below is a table listing GEOS-Chem input files that reside in the run directory.
+
This page describes the configuration files that are read by GEOS-Chem.  Several configuration files are automaticaly added to a GEOS-Chem run directory when it is created. Other configuration files are located in the source code or in the GEOS-Chem data directories. 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.
  
=== User inputs ===
+
=== User-editable configuration files ===
  
Configuration files that specify user inputs are located in each GEOS-Chem run directory.   
+
These 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.
 
You can edit any of the default settings in these files to change the options that will be used in your GEOS-Chem simulation.
Line 36: Line 31:
 
{| border=1 cellspacing=0 cellpadding=5  
 
{| border=1 cellspacing=0 cellpadding=5  
 
|-valign="top" bgcolor="#CCCCCC"
 
|-valign="top" bgcolor="#CCCCCC"
!width="150px"|File
+
!width="175px"|File
!width="550px"|Description
+
!width="525px"|Description
 
!width="275px"|Also see
 
!width="275px"|Also see
  
Line 47: Line 42:
 
*Which processes (e.g. chemistry, transport, dry deposition, etc.) to turn on,
 
*Which processes (e.g. chemistry, transport, dry deposition, etc.) to turn on,
 
*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/geoschem-config.html <tt>geoschem_config.yml</tt>]
|Specifies emission inventories that you want to include in GEOS-Chem via the [[HEMCO|HEMCO emissions component]].
+
|Main GEOS-Chem configuration file (replacing <tt>input.geos</tt>) in [[GEOS-Chem 14.0.0]] and later versions
|''[[The HEMCO User's Guide]]''
+
|[https://geos-chem.readthedocs.io <tt>geos-chem.readthedocs.io</tt>]
  
 
|-valign="top"
 
|-valign="top"
|[[The HEMCO_Diagn.rc file|<tt>HEMCO_Diagn.rc</tt>]]
+
|[https://geos-chem.readthedocs.io/en/latest/gcc-guide/03-config/hemco-config.html <tt>HEMCO_Config.rc</tt>]
|Specifies diagnostic archival options for emissions and related quantities computed by [[HEMCO|HEMCO emissions component]].
+
|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#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/hemco-diagn.html <tt>HEMCO_Diagn.rc</tt>]
 +
|Specifies diagnostic archival options for emissions and related quantities computed by the [https://hemco.readthedocs.io Harmonized Emisions Component (HEMCO)].
 +
|[https://hemco.readthedocs.io <tt>hemco.readthedocs.io</tt>]
 +
 
 +
|-valign="top"
 +
|[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]]
  
 
|}
 
|}
  
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:20, 10 December 2019 (UTC)
+
=== Photolysis and chemistry mechanism configuration files ===
 
+
=== Photolysis mechanism ===
+
 
+
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.
+
 
+
You do not need to modify any of these files unless you wish to change the default photolysis settings.
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 18:54, 10 December 2019 (UTC)
+
 
+
=== Chemical mechanism ===
+
 
+
Chemical mechanism configuration files (<tt>gckpp.kpp</tt>, <tt>fullchem.eqn</tt>) are located in this folder:
+
 
+
*<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:
+
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>].
  
*<tt>KPP/custom</tt>
+
=== GEOS-Chem species database ===
  
and build your new mechanism there. For more information about building chemical mechanisms, please see [[FlexChem|our ''FlexChem'' wiki page]].
+
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>]
  
  
 
----
 
----
 
'''''[[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]]'''''

Latest revision as of 20:09, 4 August 2022

Previous | Next | Getting Started with GEOS-Chem

  1. Minimum system requirements (and software installation)
  2. Configuring your computational environment
  3. Downloading source code
  4. Downloading data directories
  5. Creating run directories
  6. Configuring runs
  7. Compiling
  8. Running
  9. Output files
  10. Python tools for use with GEOS-Chem
  11. Coding and debugging
  12. Further reading


List of GEOS-Chem configuration files

This page describes the configuration files that are read by GEOS-Chem. Several configuration files are automaticaly added to a GEOS-Chem run directory when it is created. Other configuration files are located in the source code or in the GEOS-Chem data directories. 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.

User-editable configuration files

These 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.
geoschem_config.yml Main GEOS-Chem configuration file (replacing input.geos) in GEOS-Chem 14.0.0 and later versions geos-chem.readthedocs.io
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). hemco.readthedocs.io
HEMCO_Diagn.rc Specifies diagnostic archival options for emissions and related quantities computed by the Harmonized Emisions Component (HEMCO). 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