GEOS-Chem 13.4.0

From Geos-chem
Revision as of 23:39, 24 January 2022 by Bmy (Talk | contribs) (Benchmark assessment form)

Jump to: navigation, search

GEOS-Chem Versions Page

This page includes information about GEOS-Chem 13.4.0 (currently under development)

Version overview

The following items have been added to GEOS-Chem 13.4.0 since the last GEOS-Chem version GEOS-Chem 13.3.4. Also see the following Github pages:

Feature Contributor(s) Model scope Notes and references
Updates that will affect full-chemistry benchmark simulations
Migrating sulfate chemistry into KPP Mike Long (GCST)
Viral Shah (Harvard)
Bob Yantosca (GCST)
Chemistry &
Fix bug in Henry law CALC_HEFF routine in hetchem computations Viral Shah (Harvard) Chemistry
Bug fix: Remove double-counting of HCl uptake on acidic sea salt Viral Shah (Harvard) Chemistry
Update surface resistance for ozone deposition to ice/snow Ryan Pound (York)
Shuting Zhai (UW)
Use updated definition of PM2.5; Add PM10 diagnostic Bob Yantosca (GCST) Diagnostics &
Fix scale factors applied to VOC aircraft emissions in AEIC inventory Flavio Quadros (TU Delft)
Seb Eastham (GCST)
Emissions &
Bug Fix
HEMCO bug fix: restore archiving via manual diagnostics (which had been inadvertently disabled in a prior update) Melissa Sulprizio (GCST)
Bob Yantosca (GCST)
Use degassing-only volcano emissions in GEOS-Chem benchmark simulations Christoph Keller (GMAO)
Daniel Jacob (Harvard)
Emissions &
Add option for driving GEOS-Chem with native GEOS meteorological files Liam Bindle (GCST) Structural
Updates that will NOT affect full-chemistry benchmark simulations
Updated Hg chemistry in KPP Viral Shah (Harvard)
Colin Thackray (Harvard)
Mike Long (GCST)
Bob Yantosca (GCST)
Bug fix: Use REAL*8 precision in for CH3O2 + OH reaction definition in fullchem.eqn Bob Yantosca (GCST) Chemistry
Updated Global Inventory of Methane Emissions from Oil/Gas/Coal (GFEI v2) Tia Scarpelli (U. Edinburgh) Emissions
Anthropogenic Methane Emission Inventory for Canada Tia Scarpelli (U. Edinburgh) Emissions
Use EDGARv6 global anthro emissions for CH4 simulation Melissa Sulprizio (GCST) Emissions
Updated Rn-222 emissions for TransportTracers simulations Bo Zhang (NIA) Emissions
Retire HEMCO extension for CH4 wetland emissions Melissa Sulprizio (GCST) Emissions
Updates to enable automated run directory creation Liam Bindle (GCST)
Melissa Sulprizio (GCST)
Run directory
Bug fix: Allow GEOS-Chem Classic History to archive irregular intervals (e.g. a month and a day) Bob Yantosca (GCST) Diagnostics
Updates that will only affect GCHP
Add capability to use mass fluxes in advection Sebastian Eastham (MIT)
Liam Bindle (GCST)
Define a GCHP "Default" collection that will archive a small number of commonly-requested diagnostic fields Liam Bindle (GCST) Diagnostics
Add capability to read native meteorological data files Liam Bindle (GCST)
Bob Yantosca (GCST)

New data directories

The following data directories have been added or updated in this version. You will have to download the directories relevant to your simulation.

Inventory Needed for What was added? Directory
ZHANG_Rn222 TransportTracers simulations only Updated Rn222 emissions for TransportTracers simulations. See Bo Zhang et al (2021) HEMCO/ZHANG_Rn222/v2021-11
Updated Hg simulation restart file Hg simulations only Sample restart file for the updated Hg mechanism. See Viral Shah et al (2021) ExtData/GEOSCHEM_RESTARTS/v2021-12
Updated TOMAS simulation restart files TOMAS simulations only Added HSO3m and SO3mm species to TOMAS restart files ExtData/GEOSCHEM_RESTARTS/v2021-12

1-month benchmarks

Model setup for 1-month benchmarks

The following table describes the GEOS-Chem setup for both GEOS-Chem Classic and GCHP 1-month benchmark simulations.

Git tag(s):
Compared to previous benchmark: 13.3.0
Software environment: gcc 10.2.0
OpenMPI 4.1.0
netcdf-fortran 4.5.3
CMake 3.17.3
ESMF 8.0.1
Model resolution:
  • GEOS-Chem Classic: 4° x 5°
  • GCHP: c48
Meteorology fields: MERRA-2
  • GEOS-Chem Classic: 4° x 5°
  • GCHP: 0.5° x 0.625°
Initial conditions: July 1, 2019
  • NOTE: GCHP c48 restart file regridded from GEOS-Chem Classic 4° x 5°
Benchmark month: July 2019
Emissions setup: TBD
Chemistry mechanism: TBD
This version will impact:
(select all that apply with boldface)
  • Advection
  • BL Mixing
  • Convection
  • Meteorology Fields
  • Dry Deposition
  • Wet Deposition
  • Emissions
  • Photolysis
  • Chemistry
  • Other (please specify):
    • Diagnostics
    • CH4 simulation
    • TransportTracers simulation
    • Run directory creation

1-month fullchem: GEOS-Chem Classic 13.4.0-rc.0 vs 13.3.0


  • Enable PDF bookmarks in the file links to navigate between species. If you do not see bookmarks in your browser try using a different browser (not Safari) or installing an Adobe Acrobat plug-in.
  • See the species database for species definitions and details.
  • Species categories and lumped species are defined in YAML files within the GEOS-Chem post-processing software GCPy.


Benchmark assessment form

Performance GEOS-Chem Classic (rc.0) GCHP (rc.0)
Grid resolution: 4° x 5° C48
# CPUs, nodes: 48 CPUs
1 node (Intel Cascade Lake)
48 CPUs
2 nodes (Intel Cascade Lake)
Wall time: TBD TBD
CPU time / wall time: TBD TBD
% of ideal performance: TBD TBD
Memory: TBD TBD
Global mean OH:
(% change from previous version)
Methyl chloroform lifetime:
(% change from previous version)
Methane lifetime:
(% change from previous version)
Species, J-Values, and COLUMN AOD values that changed by 10% or more at the surface: TBD TBD
Species and J-Values that changed by 10% or more at 500 hPa: TBD TBD
Species and J-Values that changed by 10% or more in zonal mean: TBD TBD
Emissions that changed by 10% or more: TBD TBD
Below we summarize the notable changes caused by specific updates. Supplementary plots may be viewed at


The following updates introduced differences on the order of numerical noise:

The following were zero-difference updates (for the full-chemistry benchmarks):

  1. GCHP-specific updates:
  2. CH4 simulation updates:
  3. Hg simulation updates:
  4. TransportTracers simulation updates:
  5. Other updates:
Requires further investigation:
Approved by:
Date of approval: