GEOS-Chem 13

From Geos-chem
Jump to: navigation, search

GEOS-Chem Main Page | GCHP Main Page

Version history summary

Past releases Current release: GEOS-Chem 12.9.3 Future releases

The sections below describe each GEOS-Chem feature version and GEOS-Chem bug fix patch version belonging to the GEOS-Chem 13 series. Each feature version carries the tag 13.Y.0, which indicates that the version will be (or has been) validated with a 1-month benchmark simulation (and one or more 1-year benchmark simulations if necessary). Each patch version carries the tag 13.Y.Z, which denotes that the version preserves backwards-compatibility with the prior feature version 13.Y.0. For more information, please see our GEOS-Chem version numbering system wiki page.

Current versions in development

The GEOS-Chem versions listed below are currently under development.

NOTE: In GEOS-Chem 13.0.0 and later versions, the master branch will be renamed to main.


Feature Submitted by Type Notes and References
Updates that will affect full-chemistry simulations
CEDS_GBD-MAPS emission inventory (1970 - 2017) Erin McDuffie (Dalhousie) Science
Retire carbon-based units for VOCs GCST Science
Removal of HEMCO code from within the non-local PBL mixing modules Bob Yantosca (GCST) Structural
  • Introduces small numerical differences

Heterogeneous chem fixes, performance improvements, and clarification Chris Holmes (FSU) Bug fix
Fix handling of NOx coefficients in ucx_mod.F90 Sebastian Eastham (MIT) Bug fix
Prevent divide-by-zero errors in UCX routine UCX_NOX Bob Yantosca (GCST) Bug fix

Updates that will NOT affect full-chemistry simulations
Use GEOS-FP 5.22 data for Jan - May 2020 and store GEOS-FP 5.25 for April - May 2020 as option Jun Meng (GCST)
Melissa Sulprizio (GCST)
Update QFED emissions through July 2020 Christoph Keller (NASA GMAO) Science
ODIAC fossil fuel emissions for CO2 simulations Jenny Fisher (UOW)
Yi Cao (UOW)
Global Hg emissions from Streets et al. (2019) (as option) Colin Thackray (Harvard) Science
Global Hg emissions from EDGARv4.tox2 (as option) Amanda Giang (UBC) Science
Global Inventory of Methane Emissions from Fuel Exploitation Tia Scarpelli (Harvard) Science
Retire tropchem mechanism; implement new tropchem simulation using Standard mechanism below the tropopause and archived P/L rates above Melissa Sulprizio (GCST) Science
RRTMG fixes and updates Sebastian Eastham (MIT)
Lizzie Lundgren (GCST)
Bug fix
Add global mean OH and CH4 lifetime diagnostics Bob Yantosca (GCST) Structural
Retire the GNU Make build system in both GEOS-Chem Classic and GCHP and replace with CMake Liam Bindle (WashU)
Retire the GEOS-Chem Unit Tester repository and move GEOS-Chem run directory creation to the GEOS-Chem source code repository Melissa Sulprizio (GCST) Structural
Updates to GEOS-Chem and HEMCO interface for compatibility with CESM Haipeng Lin (Harvard)
Thibaud Fritz (MIT)
Lizzie Lundgren (GCST)
Dynamically allocate diagnostic arrays based on HISTORY.rc content to minimize memory footprint Bob Yantosca (GCST) Structural
Fixes for typos: GCST Bug fix
Features only affecting GCHP:
Retire the existing GCHP repository and replace with a new wrapper repository that uses ESMF as an external library and integrates GEOS-Chem and NASA/GMAO GEOS-ESM git repositories as git submodules Lizzie Lundgren (GCST) Structural
Separate HEMCO from GEOS-Chem to use as an ESMF gridded component in GCHP Lizzie Lundgren (GCST) Structural
Enable a stretched grid capability in GCHP to run global simulations at regional high resolution Liam Bindle (WashU) Structural
Update MAPL (v2.2.7) and GMAO library dependencies Lizzie Lundgren (GCST) Structural
Enable GCHP to be compiled with RRTMG Sebastian Eastham (MIT)
Lizzie Lundgren (GCST)

New data directories in 13.0.0

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

Inventory Type What was added? Directory
(full-chemistry simulations)
CEDS_GBD-MAPS emission inventory (1970 - 2017) HEMCO/CEDS/v2020-08/
QFED OPTIONAL Update QFED emissions through July 2020 HEMCO/QFED/v2018-07/
(CO2 simulations)
ODIAC fossil fuel emissions for CO2 simulations HEMCO/CO2/v2019-12/
(Hg simulations)
Updated Streets Hg emissions

Updated EDGAR 4.3 Hg emissions

(CH4 simulations)
Global Inventory of Methane Emissions from Fuel Exploitation

Updated wetland and seep CH4 emissions



Current stable version

The current stable version is GEOS-Chem 12.9.1.

NOTE: In GEOS-Chem 13.0.0 and later versions, the master branch will be renamed to main.

Previously released versions


Previous issues now resolved in GEOS-Chem 13

Bugs and/or technical issues have been resolved are listed on the following Github pages:

Outstanding issues not yet resolved in GEOS-Chem 13

Unresolved issues are listed on the following Github pages:

GEOS-Chem Main Page | GCHP Main Page