Difference between revisions of "GEOS-Chem chemistry mechanisms"

From Geos-chem
Jump to: navigation, search
(List of specialty simulations)
 
(179 intermediate revisions by 6 users not shown)
Line 1: Line 1:
On this page, we provide an overview of the chemistry mechanisms used in GEOS-Chem.
+
__FORCETOC__
 +
'''''[[Guide to GEOS-Chem simulations|Previous]] | [[Aerosol-only simulation|Next]] | [[Guide to GEOS-Chem simulations]]'''''
 +
#<span style="color:blue">'''Simulations using KPP-built mechanisms'''</span>
 +
#[[Aerosol-only simulation]]
 +
#[[CH4 simulation]]
 +
#[[CO2 simulation]]
 +
#[[Mercury|Hg simulation]]
 +
#[[POPs simulation]]
 +
#[[Tagged CO simulation]]
 +
#[[Tagged O3 simulation]]
 +
#[[TransportTracers simulation]]
 +
 
 +
On this page, we provide information about GEOS-Chem simulations that use chemistry mechanism solver code built by the [https://kpp.readthedocs.io Kinetic PreProcessor (KPP)].
  
 
== Overview ==
 
== Overview ==
  
GEOS-Chem can perform many different types of chemical simulations, including:
+
The following table provides links to information about the available full-chemistry mechanisms in GEOS-Chem.  
 
+
*Several detailed ozone chemistry mechanisms
+
*Specialty simulations for tracers with simpler chemistry, including
+
**Radon-Lead-Beryllium
+
**Carbon gases (CO, CO2)
+
**Mercury
+
**Methane
+
**etc.
+
 
+
You may find more information about each of these mechanisms in the subsections below.
+
 
+
--[[User:Bmy|Bob Y.]] 10:08, 1 October 2013 (EDT)
+
 
+
== NOx-Ox-hydrocarbon-aerosol chemistry and variants ==
+
 
+
The NOx-Ox-hydrocarbon-aerosol (aka "full-chemistry") simulations have undergone several updates in recent GEOS-Chem versions. We provide a summary of these updates in this section.
+
 
+
=== Mechanisms in GEOS-Chem v9-01-03 and prior versions ===
+
 
+
In GEOS-Chem v9-01-03, users could select from one of four pre-defined chemistry mechanisms:
+
 
+
 
{| border=1 cellspacing=0 cellpadding=5  
 
{| border=1 cellspacing=0 cellpadding=5  
 
|-bgcolor="#CCCCCC"
 
|-bgcolor="#CCCCCC"
 
!width="100px"|Mechanism
 
!width="100px"|Mechanism
!width="500x"|Description
+
!width="300px"|Description
!width="175px"|Nickname
+
!width="250px"|Mechanism file
!width="150px"|Solvers
+
!width="175px"|Extra options
  
 
|-valign="top"
 
|-valign="top"
|[[NOx-Ox-HC-aerosol|standard]]
+
|fullchem
 +
|NOx + Ox + Br + Cl + I + aerosols chemistry in the [[Tropospheric_chemistry_mechanism|troposphere]] and [[UCX_chemistry_mechanism|stratosphere]]
 +
|[https://github.com/geoschem/geos-chem/blob/main/KPP/fullchem/fullchem.eqn <tt>KPP/fullchem/fullchem.eqn</tt>]
 
|
 
|
*NOx-Ox-hydrocarbon-aerosol species
+
*[[GEOS-Chem_benchmarking|benchmark]]
*PLUS [[Bromine chemistry mechanism|bromine species]]
+
*complex SOA
|Full-chemistry,<br>fullchem
+
*complex SOA + SVPOA
|
+
*[[#TOMAS|TOMAS]]
*SMVGEAR
+
*[[#APM|APM]]
*[[KPP solvers FAQ|KPP]]
+
*[[Coupling_GEOS-Chem_with_RRTMG|RRTMG]]
 +
*Aciduptake
 +
*Marine POA
  
 
|-valign="top"
 
|-valign="top"
|[[Secondary organic aerosols|SOA]]
+
|Hg
 +
|[[Mercury|Mercury chemistry]]
 +
*Introduced in [[GEOS-Chem 13.4.0|13.4.0]] as a KPP mechanism
 +
|[https://github.com/geoschem/geos-chem/blob/main/KPP/fullchem/fullchem.eqn <tt>KPP/Hg/Hg.eqn</tt>]
 
|
 
|
*NOx-Ox-hydrocarbon-aerosol species
 
*PLUS secondary organic aerosol species
 
|SOA
 
|
 
*SMVGEAR
 
*[[KPP solvers FAQ|KPP]]
 
  
 
|-valign="top"
 
|-valign="top"
|[[Dicarbonyls simulation|Dicarbonyls]]
+
|carboncycle
 +
|[https://github.com/geoschem/geos-chem/blob/main/KPP/carboncycle/carboncycle.eqn <tt>KPP/carboncycle/carboncycle.eqn</tt>]
 +
*Will debut in [[GEOS-Chem 14.1.0|14.1.0]] as a KPP mechanism
 
|
 
|
*NOx-Ox-hydrocarbon-aerosol species
 
*PLUS dicarbonyl species
 
|Dicarbonyls
 
 
|
 
|
*SMVGEAR only
 
  
|-valign="top"
 
|[[New isoprene scheme|isoprene]]
 
|
 
*NOx-Ox-hydrocarbon-aerosol species
 
*PLUS isoprene oxidation products
 
|Caltech isoprene scheme,<br>Paulot isoprene scheme
 
|
 
*SMVGEAR
 
*[[KPP solvers FAQ|KPP]]
 
 
|}
 
|}
  
The [[Bromine chemistry mechanism|bromine tracers and species]] were added to the standard mechanism just prior to the release of [[GEOS-Chem v9-01-03]].
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 14:22, 20 September 2022 (UTC)
 
+
-[[User:Bmy|Bob Y.]] 17:00, 30 September 2013 (EDT)
+
 
+
=== Mechanisms in GEOS-Chem v9-02 and later versions ===
+
 
+
Several modifications were made to the [[#Mechanisms in GEOS-Chem v9-01-03 and prior versions|above-mentioned chemistry mechanisms]] in [[GEOS-Chem v9-02]], as listed below:
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-bgcolor="#CCCCCC"
+
!width="100px"|Mechanism
+
!width="500px"|Description
+
!width="175px"|Nickname
+
!width="150px"|Solvers
+
 
+
|-valign="top"
+
|[[NOx-Ox-HC-aerosol|standard]]
+
|
+
*[[NOx-Ox-HC-aerosol|NOx-Ox-hydrocarbon-aerosol]] species
+
*PLUS [[Bromine chemistry mechanism|bromine species]]
+
*PLUS [[Updating_standard_chemistry_with_JPL_10-6|Updates to inorganic chemistry reactions (cf. JPL 10-6)]]
+
*PLUS [[Methyl peroxy nitrate chemistry]]
+
*PLUS [[New isoprene scheme|Isoprene oxidation species chemistry (aka "Caltech isoprene scheme")]]
+
*PLUS [[New_isoprene_scheme#Update_One_-_RO2.2BHO2_Reaction_Rate|Fix RO2+HO2 rate constant]]
+
*PLUS [[New_isoprene_scheme#NO3_aerosol_reactive_uptake_coefficient|Increase of NO3 uptake by aerosol]]
+
*PLUS [[NOx-Ox-HC-aerosol#Removal_of_NOx_and_Ox_partitioning|Removal of NOx and Ox partitioning]]
+
*PLUS [[ChemTelecon20111202|Inhibition of N2O5 uptake by nitrate aerosol]]
+
*PLUS [[NOx-Ox-HC-aerosol#Improved_HO2_uptake|Improved HO2 uptake by aerosol]]
+
|Full-chemistry,<br>fullchem
+
|
+
*SMVGEAR
+
*[[KPP solvers FAQ|KPP]]
+
 
+
|-valign="top"
+
|[[Secondary organic aerosols|SOA]]
+
|
+
*Everything in the "standard" simulation listed above
+
*PLUS Updated SOA species
+
*PLUS [[Secondary_organic_aerosols#SOA_simulation_with_semi-volatile_POA|Semi-volatile primary organic aerosol (OPTIONAL)]]
+
|SOA
+
|
+
*SMVGEAR
+
*[[KPP solvers FAQ|KPP]]
+
 
+
|-valign="top"
+
|[[Dicarbonyls simulation|Dicarbonyls]]
+
|
+
*NOx-Ox-hydrocarbon-aerosol species
+
*PLUS dicarbonyl species
+
|Dicarbonyls
+
|
+
*SMVGEAR only
+
 
+
|}
+
 
+
Starting with v9-02, family tracers (NOx, Ox) have now been removed from all GEOS-Chem mechanisms.  The individual family members (NO, NO2, O3, etc.) are now carried as individual advected tracers and chemical species.  Also, the isoprene mechanism from v9-01-03 now has been folded into the standard mechanism.
+
 
+
--[[User:Bmy|Bob Y.]] 09:56, 1 October 2013 (EDT)
+
 
+
=== Mechanisms in GEOS-Chem v10 ===
+
 
+
We propose adding the [[UCX chemistry mechanism|'''Unified tropospheric-stratospheric Chemistry eXtension''' (UCX) mechanism]] into the release following [[GEOS-Chem v9-02]].  UCX, which was developed by Steven Barrett's group (the [http://lae.mit.edu MIT Laboratory for Aviation and the Environment]), combines the existing GEOS-Chem [[NOx-Ox-HC-aerosol|"standard" mechanism]] (based on [[GEOS-Chem v9-01-03|v9-01-03]]) with several new stratospheric species and reactions.
+
 
+
Because UCX will be a major update to GEOS-Chem, we propose naming the version in which it ships to GEOS-Chem v10-01.  This will make it easier to denote versions that contain UCX from versions that do not.
+
 
+
--[[User:Bmy|Bob Y.]] 10:04, 1 October 2013 (EDT)
+
 
+
=== Flexchem ===
+
 
+
We also propose to add a cleaner implementation of KPP into GEOS-Chem.  This implementation, which we have named Flexchem, will allow users to customize the chemical mechanism according to their research interests.  Flexchem will remove the existing SMVGEAR and KPP infrastructure, and all related input files (i.e. <tt>globchem.dat</tt>, <tt>mglob.dat</tt>, etc.)
+
 
+
As of this writing (Oct 2013), Flexchem is still under development.  We hope to have it installed in a version of GEOS-Chem sometime in 2014.
+
 
+
--[[User:Bmy|Bob Y.]] 10:17, 1 October 2013 (EDT)
+
 
+
== Specialty simulations ==
+
 
+
GEOS-Chem can also perform "specialty simulations" (aka "offline simulations").  These are simulations for species having simpler chemistry mechanisms that do not require the use of the full chemical solver.  Many of these simulations rely on oxidant fields (O3, OH) saved out from a "full-chemistry" simulation.
+
 
+
=== List of specialty simulations ===
+
 
+
The following table provides links to information about the available specialty simulations in GEOS-Chem.  Please note that some of these simulations are out of date and will require some work in order to be brought back to the state of the science.  Contact the relevant [http://acmg.seas.harvard.edu/geos/geos_working_groups.html GEOS-Chem Working Groups] for more information.
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-bgcolor="#CCCCCC"
+
!width="125px"|Category
+
!width="400px"|Simulation
+
!width="125px"|Status
+
!width="250px"|Contact
+
 
+
|-valign="top"
+
|Aerosols
+
|[[Aerosol-only simulation]]<br>(can be customized to include only the aerosol species you want)
+
|Up-to-date
+
|[[Aerosols Working Group]]
+
 
+
|-valign="top"
+
|Carbon Gases
+
|C2H6 simulation
+
|Needs attention
+
|[[Carbon Cycle Working Group]]
+
 
+
|-valign="top"
+
|Carbon Gases
+
|CH3I simulation
+
|Needs attention
+
|[[Carbon Cycle Working Group]]
+
 
+
|-valign="top"
+
|Carbon Gases
+
|[[CH4 simulation]]
+
|Up-to-date
+
|[[Carbon Cycle Working Group]]
+
 
+
|-valign="top"
+
|Carbon Gases
+
|[[Tagged CO simulation]]
+
|Up-to-date
+
|[[Carbon Cycle Working Group]]
+
 
+
|-valign="top"
+
|Carbon Gases
+
|[[CO2 simulation]]
+
|Up-to-date
+
|[[Carbon Cycle Working Group]]
+
 
+
|-valign="top"
+
|Carbon Gases
+
|OCS simulation
+
|Under development
+
|[[Carbon Cycle Working Group]]
+
 
+
|-valign="top"
+
|Hg and POPs
+
|[[Mercury|Hg simulations]]
+
#Total Hg tracers: Hg0, Hg2, HgP
+
#Tagged Hg tracers
+
#Hg simulation + [[Global Terrestrial Mercury Model]]
+
|Up-to-date
+
|[[Hg and POPs Working Group]]
+
 
+
|-valign="top"
+
|Hg and POPs
+
|[[POPs_simulation|Persistent Organic Pollutants (POPs) simulation]]
+
|Up-to-date
+
|[[Hg and POPs Working Group]]
+
 
+
|-valign="top"
+
|Radionuclides
+
|[[Rn-Pb-Be simulation]]
+
|Up-to-date
+
|[[Transport Working Group]]
+
 
+
|-valign="top"
+
|Radionuclides
+
|H2-HD isotope simulation
+
|Needs attention
+
|[[Transport Working Group]]
+
 
+
|}
+
 
+
=== Note to developers ===
+
 
+
The [[GEOS-Chem Support Team]] will be happy to assist you with technical issues (i.e. debugging, or answering questions about coding) pertaining to specialty simulations.  However, we expect the [http://acmg.seas.harvard.edu/geos/geos_people.html GEOS-Chem user community] to be responsible for the scientific content and validation of offline simulations, and shall:
+
 
+
# Provide the appropriate code, data, and documentation for offline simulations to the GEOS-Chem Support Team
+
# Benchmark and evaluate GEOS-Chem offline simulations
+
# Notify the GEOS-Chem support team of any bugs or technical issues.
+
  
--[[User:Bmy|Bob Y.]] 10:59, 1 October 2013 (EDT)
+
----
 +
'''''[[Guide to GEOS-Chem simulations|Previous]] | [[Aerosol-only simulation|Next]] | [[Guide to GEOS-Chem simulations]]'''''

Latest revision as of 14:38, 18 October 2023

Previous | Next | Guide to GEOS-Chem simulations

  1. Simulations using KPP-built mechanisms
  2. Aerosol-only simulation
  3. CH4 simulation
  4. CO2 simulation
  5. Hg simulation
  6. POPs simulation
  7. Tagged CO simulation
  8. Tagged O3 simulation
  9. TransportTracers simulation

On this page, we provide information about GEOS-Chem simulations that use chemistry mechanism solver code built by the Kinetic PreProcessor (KPP).

Contents

Overview

The following table provides links to information about the available full-chemistry mechanisms in GEOS-Chem.

Mechanism Description Mechanism file Extra options
fullchem NOx + Ox + Br + Cl + I + aerosols chemistry in the troposphere and stratosphere KPP/fullchem/fullchem.eqn
Hg Mercury chemistry
  • Introduced in 13.4.0 as a KPP mechanism
KPP/Hg/Hg.eqn
carboncycle KPP/carboncycle/carboncycle.eqn
  • Will debut in 14.1.0 as a KPP mechanism

--Bob Yantosca (talk) 14:22, 20 September 2022 (UTC)


Previous | Next | Guide to GEOS-Chem simulations