GEOS-Chem versions

This page contains links to wiki pages describing past GEOS-Chem model releases. For information about upcoming releases see the GEOS-Chem model development priorities wiki page.

GEOS-Chem development history

In the tables below, we list information about current and past GEOS-Chem releases.

Some notes for the tables below:

• Information about benchmarks can be found by following the links in the "Benchmarks" column
• GCC = GEOS-Chem "Classic" (uses OpenMP parallelization single node only)
• GCHP = GEOS-Chem High Performance (uses MPI parallelization across multiple nodes)
• DOI = digital object identifier, can be used to reference individual GEOS-Chem versions in publications
• AMI = Amazon Machine Image, which provides GEOS-Chem Classic on the AWS Cloud

Also see our GEOS-Chem version numbering system wiki page for information on how GEOS-Chem versions are labeled.

GEOS-Chem 13 release series

Manual pages for the GEOS-chem 13 release series:

• GEOS-Chem Classic: Read the Docs (in progress); Getting Started with GEOS-Chem
• GCHP: Read the Docs
• HEMCO: Read the Docs
• Using GEOS-Chem on the AWS cloud
• Getting Started with WRF-GC

13.4

Version	Released	Important features	Benchmarks	DOIs & AMIs
13.4.1	19 May 2022	See the GEOS-Chem 13.4.1 page for more information on these fixes: Bug fix for anthropogenic CH4 emissions over the US, Canada, and Mexico	N/A	GC Classic 13.4.1 DOI: 10.5281/zenodo.6564702 AMI: TBD GCHP 13.4.1 DOI: 10.5281/zenodo.6564711
13.4.0	02 May 2022	See the GEOS-Chem 13.4.0 page for a complete list of updates, including: Migrated sulfate chemistry to KPP Increased surface resistance for O3 drydep on ice/snow Benchmarks now use degassing-only volcano climatology Rn222 emissions from Zhang et al (2021) Updates for automated run-directory creation Updated Hg simulation via KPP Plus bug fixes for HCl uptake on seasalt and Henry's law computation in hetchem HEMCO has been updated to version 3.4.0	TBD	GC Classic 13.4.0 DOI: 10.5281/zenodo.6511970 AMI: TBD GCHP 13.4.0 DOI: 10.5281/zenodo.6512251 HEMCO 3.4.0 DOI: 10.5281/zenodo.6511930 GCPy 1.2.0 DOI: 10.5281/zenodo.6512027

13.3

Version	Released	Important features	Benchmarks	DOIs & AMIs
13.3.4	07 Dec 2021	See the GEOS-Chem 13.3.4 page for more information on these updates: Bug fix: Now use proper restart file path for dry-run data download Bug fix: Now check GEOS-Chem Classic History diagnostic subset regions properly	N/A	GC Classic 13.3.4 DOI: 10.5281/zenodo.5764874 AMI: ami-069af8bd933eefa4d GCHP 13.3.4 DOI: 10.5281/zenodo.5764877
13.3.3	02 Dec 2021	See the GEOS-Chem 13.3.3 page for more information on these updates: Upgrade to HEMCO version 3.2.2, which restores updating of manual diagnostics. (This had been inadvertently clobbered during a Git merge). Only affects CH4, Hg, and TOMAS simulations	N/A	GC Classic 13.3.3 See the GEOS-Chem 13.3.3 page for more information on these updates: DOI: 10.5281/zenodo.5748260 GCHP 13.3.3 DOI: 10.5281/zenodo.5750068 HEMCO 3.2.2 DOI: 10.5281/zenodo.5748078
13.3.2	18 Nov 2021	See the GEOS-Chem 13.3.2 page for more information on these updates: Fixed incorrect file path for OFFLINE_DUST emissions in ExtData.rc (zero-diff update)	N/A	GC Classic 13.3.2 DOI: 10.5281/zenodo.5711194 GCHP 13.3.2 DOI: 10.5281/zenodo.5711194
13.3.1	15 Nov 2021	See the GEOS-Chem 13.3.1 page for a complete list of updates, including: Nested grid simulations (except CH4) at 0.5° x 0.625° now use default timesteps of 600 s (transport) and 1200 s (chemistry) Diagnostic fixes GCHP fixes	N/A	GC Classic 13.3.1 DOI: 10.5281/zenodo.5703364 GCHP 13.3.1 DOI: 10.5281/zenodo.5703435 HEMCO 3.2.1 DOI: 10.5281/zenodo.5703341
13.3.0	15 Nov 2021	See the GEOS-Chem 13.3.0 page for a complete list of updates, including: Chemistry mechanism updates Heterogeneous chemistry updates Emissions updates (NEI2016 as an option) Diagnostic updates GCHP adjoint updates	1-month benchmarks 1-year full-chemistry benchmarks	GC Classic 13.3.0 DOI: 10.5281/zenodo.5703095 GCHP 13.3.0 DOI: 10.5281/zenodo.5703410 HEMCO 3.2.0 DOI: 10.5281/zenodo.5703120

13.2

Version	Released	Important features	Benchmarks	DOIs & AMIs
13.2.1	10 Sep 2021	See the GEOS-Chem 13.2.1 page for a complete list of updates, including: Retire tropchem simulation as an option Fixes for JvalO3O1D and JValO3O3P diagnostics Add WashU data server to GCHP data download script Bug fixes for planeflight diagnostic, nested-grid simulations, and Hg simulations	N/A	GC Classic 13.2.1 DOI: 10.5281/zenodo.5500717 AMI: ami-0983d1d6b06e4dd3f GCHP 13.2.1 DOI: 10.5281/zenodo.5500718 HEMCO 3.1.1 DOI: 10.5281/zenodo.5504133
13.2.0	07 Sep 2021	See the GEOS-Chem 13.2.0 page for a complete list of updates, including: CEDS v2 emissions Updated Yuan/BNU MODIS LAI Blowing snow emissions Luo et al 2020 wetdep (option) Trace metal simulation Several fixes for minor issues	1-month benchmarks 1-year full-chemistry benchmarks 1-year transport tracer benchmarks	GC Classic 13.2.0 DOI: 10.5281/zenodo.5500536 GCHP 13.2.0 DOI: 10.5281/zenodo.5500537 HEMCO 3.1.0 10.5281/zenodo.5504127

13.1

Version	Released	Important features	Benchmarks	DOIs and AMIs
13.1.2	06 Jul 2021	See the GEOS-Chem 13.1.2 page for a complete list of updates, including: Update dry-run download script download_data.py to fetch GCAP2 data from the U. Rochester server Zero-diff updates required for CESM2-GC* Add .zenodo.json file for auto-filling of DOI fields	N/A	GC Classic 13.1.2 DOI: 10.5281/zenodo.5075847 AMI: ami-0491da4eeba0fe986 GCHP 13.1.2 DOI: 10.5281/zenodo.5075912
13.1.1	22 Jun 2021	See the GEOS-Chem 13.1.1 page for a complete list of updates, including: Bug fix for PM2.5 diagnostic GEOS-Chem updates for GEOS Enable GCHP to compile with GNU Fortran 10 Expand support for GNU Fortran compilers to include version 10 Fix bug in regex used for linking to ESMF	N/A	GC Classic 13.1.1 DOI: 10.5281/zenodo.5014891 GCHP 13.1.1 DOI: 10.5281/zenodo.5014888
13.1.0	17 Jun 2021	See the GEOS-Chem 13.1.0 page for a complete list of updates, including: Distribute CEDS emissions vertically in the boundary layer Diurnal scale factors of power plants emissions in China Fix H2O boundary conditions at tropopause GCAP 2.0 Bug fix for nested grid simulations to read boundary conditions continuously Update GMAO submodules in GCHP Add monthly diagnostic capability to History for GCHP See also geoschem/geos-chem: Milestone 13.1.0	1-month benchmarks	GC Classic 13.1.0 DOI: 10.5281/zenodo.4984436 GCHP 13.1.0 DOI: 10.5281/zenodo.4984437 HEMCO 3.0.0 DOI: 10.5281/zenodo.4984639

13.0

Version	Released	Important features	Benchmarks	DOIs and AMIs
13.0.2	12 Apr 2021	See the GEOS-Chem 13.0.2 page for a complete list of updates, including: Fix for bug introduced in 13.0.1 where met fields were only being read on the first timestep	N/A	GC Classic 13.0.2 DOI: 10.5281/zenodo.4681204 AMI: ami-0c2e73f515de6386b GCHP 13.0.2 DOI: 10.5281/zenodo.4681742 HEMCO 3.0.0-rc.3 DOI: 10.5281/zenodo.4681191
13.0.1	23 Mar 2021	See the GEOS-Chem 13.0.1 page for a complete list of updates, including: Use online dust emissions (DustDead) by default Add several fixes for the GEOS-Chem Classic dry-run option Force GEOS-Chem Classic restart file to match simulation date Avoid "Is_Gas and Is_Aerosol are both false" error when adding new P/L species in KPP	N/A	GC Classic 13.0.1 DOI: 10.5281/zenodo.4632275 GCHP 13.0.1 DOI: 10.5281/zenodo.4632276 HEMCO 3.0.0-rc.2 DOI: 10.5281/zenodo.4632279
13.0.0	18 Mar 2021	See the GEOS-Chem 13.0.0 page for a complete list of updates, including: Replace GCHP with a new wrapper repository (GCHPctm) Create new wrapper repository GCClassic Separate HEMCO from GEOS-Chem to use as a git submodule in GCClassic and GCHP Retire the GEOS-Chem Unit Tester repository Retire the GNU Make and replace with CMake Enable a stretched grid capability in GCHP CEDS_GBD-MAPS emission inventory (1970 - 2017) Retire carbon-based units for VOCs Implement new tropchem simulation RRTMG updates (fix netCDF diagnostics; enable in GCHP) See also geoschem/geos-chem: Milestone 13.0.0	1-month benchmarks 1-year full-chemistry benchmarks 1-year transport tracers benchmarks 10-year stratospheric benchmarks	GC Classic 13.0.0 DOI: 10.5281/zenodo.4618180 GCHP 13.0.0 DOI 10.5281/zenodo.4618205

GEOS-Chem 12 release series

Manual pages for the GEOS-chem 12 release series:

• Getting Started with GEOS-Chem
• Getting Started with GCHP
• Using GEOS-Chem on the AWS cloud
• Getting Started with WRF-GC

12.9

Version	Released	Important features	Benchmarks	DOI
12.9.3	06 Aug 2020	Bug fixes for minor issues discovered after the 12.9.2 release: See also geoschem/geos-chem: Milestone 12.9.3		10.5281/zenodo.3974569
12.9.2	24 Jul 2020	Bug fixes for GEOS-Chem dryrun option, CO2 simulations, PARANOX, complexSOA_SVPOA: See also geoschem/geos-chem: Milestone 12.9.2		10.5281/zenodo.3959279
12.9.1	17 Jul 2020	Bug fixes for GEOS-Chem dryrun option, Luo wetdep, and RCP emissions: See also geoschem/geos-chem: Milestone 12.9.1		10.5281/zenodo.3950473
12.9.0	17 Jul 2020	Updated halogen chemistry Improved cloudwater pH Update offline lightning data through Dec 2019 Convert GEOS-Chem species database to YAML format, See also geoschem/geos-chem: Milestone 12.9.0	1-month GCC 1-month GCHP 1-year GCC	10.5281/zenodo.3950327

12.8

Version	Released	Important features	Benchmarks	DOI
12.8.2	27 May 2020	Bug fixes and updates for WRF-GC development See also geoschem/geos-chem: Milestone 12.8.2		10.5281/zenodo.3860693
12.8.1	21 May 2020	Fixes for several issues identified during 12.8.0 benchmarking (not affecting full-chemistry simulations): See also geoschem/geos-chem: Milestone 12.8.1		10.5281/zenodo.3837666
12.8.0	04 May 2020	Isoprene chemistry Wet deposition parameterization Ozone deposition to the ocean See also geoschem/geos-chem: Milestone 12.8.0	1-month GCC 1-month GCHP 1-year GCC 1-year transport	10.5281/zenodo.3784796

12.7

Version	Released	Important features	Benchmarks	DOI
12.7.2	09 Mar 2020	Contains several bug fixes: geoschem/geos-chem: Milestone 12.7.2		10.5281/zenodo.3701669
12.7.1	03 Feb 2020	Contains several bug fixes: geoschem/geos-chem: Milestone 12.7.1		10.5281/zenodo.3676008
12.7.0	03 Feb 2020	Contains several science updates and bug fixes: geoschem/geos-chem: Milestone 12.7.0	1-month GCC 1-month GCHP 1-year GCC transport	10.5281/zenodo.3634864

12.6

Version	Released	Important features	Benchmarks	DOI
12.6.3	25 Nov 2019	Contains GCHP bug fixes only: See: geoschem/gchp: Milestone 12.6.3		10.5281/zenodo.3552959
12.6.2	15 Nov 2019	Contains several bug fixes. See: geoschem/geos-chem: Milestone 12.6.2		10.5281/zenodo.3543702
12.6.1	28 Oct 2019	Contains several bug fixes. See: geoschem/geos-chem: Milestone 12.6.1		10.5281/zenodo.3520966
12.6.0	18 Oct 2019	Hetchem updates and subgrid cloud NOy chemistry HNO3 cold-temperature deposition Quick fix for aerosol pH calculation when dry Remove isoprene in VBS (leaving aqueous) Updated aerosol hygroscopicity and optics Various structural updates Subsetting in netCDF diagnostics Diagnostic for O3 at 10m (or other height) above surface	1-month GCC 1-month GCHP 1-year GCC	10.5281/zenodo.3507501

12.5

Version	Released	Important features	Benchmarks	DOI
12.5.0	09 Sep 2019	Retire obsolete emissions inventories Fixes and updates for offline biogenic VOC and volcano emissions Update GCHP to use MAPL v1.0.0 and ESMF v8.0.0 beta snapshot 28	1-month GCC 1-month GCHP	10.5281/zenodo.3403111

12.4

Version	Released	Important features	Benchmarks	DOI
12.4.0	05 Aug 2019	Grid-independent emissions FlexGrid Stage 2: define custom grids NOTE: Users should use 12.5.0 instead. That version contains bug fixes and updates for offline biogenic VOC and volcano emissions.	1-month GCC 1-month GCHP 1-year GCC	10.5281/zenodo.3360635

12.3

Version	Released	Important features	Benchmarks	DOI
12.3.2	02 May 2019	Remove inconsistency for H2402 between GCHP and GCC Bug fixes for FAST-JX Updates for HEMCO diagnostics Use the same Br2 seasalt emissions in both GCHP and GCC Updates for GCHP run directories	This is an unofficial benchmark and the first GCHP benchmark using GCPy 1-month GCC 1-month GCHP	10.5281/zenodo.2658178
12.3.1	08 Apr 2019	Fix for noontime J-values diagnostic Fix for planeflight diagnotic Don't allocate the MINIT array Declare State_Met%AREA_M2 as 2-D		10.5281/zenodo.2633278
12.3.0	01 Apr 2019	Update ISORROPIA from v2.0 to v2.2, in order to remove persistent noise in output Updated PFT file for MEGAN Bug fix for eruptive volcanic emissions Read in and regrid existing MODIS LAI and OLSON data via HEMCO Update from HEMCO version 2.1.011 to 2.1.012 Enable running time backwards in GCHP	This is the first benchmark to utilize GCPy 1-month GCC	10.5281/zenodo.2620535

12.2

Version	Released	Important features	Benchmarks	DOI
12.2.1	28 Feb 2019	Bug fix: netCDF diagnostic collections with frequency "End" now properly span leap year days Make polar bromine explosion the default option in Hg simulation Add biomass burning subgrid coagulation option Restore DST1, DST2, DST3, and DST4 in TOMAS Add RRTMG fluxes to netCDF diagnostics Fix for CO2 simulation chemical source Missing scaling factors for MERRA-2 simulations with GCHP Use online sea flux emissions by default in GCHP		10.5281/zenodo.2580198
12.2.0	19 Feb 2019	Transport Tracers simulation: a common set of tracers in GEOS-Chem and GEOS ObsPack diagnostic GFAS biomass burning emissions Update ESMF version in GCHP from v5.2.0rp2 to v7.1.0r	1st version to have the new Transport Tracer benchmark (replaces Rn-Pb-Be benchmark) 1-month GCC 1-year transport	10.5281/zenodo.2572887

12.1

Version	Released	Important features	Benchmarks	DOI
12.1.1	13 Dec 2018	Bug fix for tagged CO Skip planeflight observations outside a nested domain Always compile with BCPH_TPBC=y Fix compilation issues, see (1) & (2) GCHP transport fix		10.5281/zenodo.2249246
12.1.0	26 Nov 2018	Budget diagnostics Anthropogenic PM2.5 dust source GEOS-Chem restart file updates Updates and fixes for the CEDS anthropogenic emissions inventory HEMCO fixes Fix mass conservation in non-local PBL mixing FlexGrid Stage 1: Use HEMCO to read met fields Add support for continuous integration with TravisCI	1-month GCC	10.5281/zenodo.1553349

12.0

Version	Released	Important features	Benchmarks	DOI
12.0.3	16 Oct 2018	Fix incorrect run configuration for offline sea salt emissions in GCHP Fix bug in application of CFC surface mixing ratios in GCHP		10.5281/zenodo.1464210
12.0.2	10 Oct 2018	Bug fixes for ND51/ND51b diagnostics Bug fixes for TOMAS simulations Bug fix for CO2 simulations		10.5281/zenodo.1455215
12.0.1	24 Aug 2018	Bug fixes for mercury simulation Compatibility with IFORT 18 Compatibility with GNU Fortran 8.2.0		10.5281/zenodo.1403144
12.0.0* aka v11-02-final	10 Aug 2018	Bug fixes identified during the v11-02 release candidate period	Note change in GEOS-Chem version numbering system 1-month GCC 1-year GCC	10.5281/zenodo.1343547

GEOS-Chem 11 release series

Version	Date released	Important features	Benchmarks	Documentation
v11-02-rc	22 Jun 2018	GCHP option Halogen chemistry Updated isoprene & monoterpene chemistry Simple SOA scheme Updated PAN chemistry Several new and updated emissions inventories NetCDF diagnostic output	v11-02 benchmark history page	v11-02/12.0.0 manual
v11-01	20 Dec 2016 (provisional) 01 Feb 2017 (public)	FlexChem MERRA-2 Species Database Air moisture fixes and updates Compatibility with the GNU Fortran compiler Updated emissions NetCDF restart files	v11-01 benchmark history page	v11-01 manual

GEOS-Chem 10 release series

Version	Date released	Important features	Benchmarks	Documentation
v10-01	01 May 2015 (provisional) 17 Jun 2015 (public)	UCX chemistry mechanism HEMCO Online radiative transfer	v10-01 benchmark history page	v10-01 manual

GEOS-Chem 9 release series

Version	Date released	Important features	Benchmarks	Documentation
v9-02	17 Jan 2014 (provisional) 03 Mar 2014 (public)	Updated soil NOx emissions module POPs simulation Inorganic chemistry updates Methyl peroxy nitrate chemistry Adopt Paulot isoprene scheme as standard RCP emission scenarios AEIC aircraft emissions inventory GEOS-FP met fields	v9-02 benchmark history page	v9-02 manual
v9-01-03	14 Sep 2012	Updated acetone sources & sinks Improved sea salt emission & deposition Improved snow scavenging and washout parameterization Tropospheric bromine chemistry Stratospheric P and k (monthly climatological)	v9-01-03 benchmark history page	v9-01-03 manual
v9-01-02	28 Nov 2011	APM aerosol microphysics GFED3 biomass emissions RETRO Anthropogenic Emissions Various fixes to correct several identified issues	v9-01-02 benchmark history page	v9-01-02 manual
v9-01-01	07 Jun 2011	Compatibility with the GMAO MERRA met data product Updated lightning NOx; various fixes	v9-01-01 benchmark history page	v9-01-01 manual

GEOS-Chem 8 release series

Version	Date released	Important features	Benchmarks	Documentation
v8-03-02	07 Sep 2010	Updated Hg and CO2 simulations	Archived to storage; contact GCST	v8-03-02 manual
v8-03-01	04 May 2010	ISORROPIA II TOMAS microphysics option Updates to SOA and photolysis	Archived to storage; contact GCST	GC v8-03-01 manual
v8-02-04	24 Feb 2010	LINOZ strat chemistry NEI2005 anthro emissions MEGAN v2.1 biogenic emissions	Archived to storage; contact GCST	GC v8-02-04 manual
v8-02-03	Oct 2009	KPP solver ICOADS emissions Updated makefile structure	Archived to storage; contact GCST	GC v8-02-03 manual
v8-02-02	08 Jun 2009	Non-local PBL mixing scheme Updated Bond BC & OC emissions	Archived to storage; contact GCST	GC v8-02-02 manual
v8-02-01	26 May 2009	Updated chemistry & photolysis reactions Glyoxal chemistry mechanism	Archived to storage; contact GCST	GC v8-02-01 manual
v8-01-04	10 Mar 2009	Various emissions updates (regional & global inventories) GFED2 biomass emissions updates	Archived to storage; contact GCST	GC v8-01-04 manual
v8-01-03	Dec 2008	Installation of GMI TPCORE routine	Archived to storage; contact GCST	GC v8-01-03 manual
v8-01-02	Nov 2008	Nested grid simulations for 0.5° x 0.666°	Archived to storage; contact GCST	GC v8-01-02 manual
v8-01-01	May 2008	Capability to run with GEOS-5 met fields	Archived to storage; contact GCST	GC v8-01-01 manual

GEOS-Chem 7 release series

Version	Date released	Important features	Benchmarks	Documentation
v7-04-13	Nov 2007	H2/HD simulation Bug fixes in SMVGEAR, lightning, and dynamic tropopause	Archived to storage; contact GCST
v7-04-12	Oct 2007	Introduction of dynamic tropopause	Archived to storage; contact GCST
v7-04-11 and earlier	March 2006 and earlier		Archived to storage; contact GCST

NOTE: For information about 1-year benchmark simulations for GEOS-Chem v8-02-04 and earlier, see this website.

GEOS-Chem benchmarking information

GEOS-Chem Benchmarking Procedure

For a complete description about the the standard 1-month and 1-year benchmark simulations, please see our GEOS-Chem Benchmarking wiki page.

Mean OH from GEOS-Chem 1-year benchmark simulations

Please see our Evolution of mean OH in GEOS-Chem wiki page.

Global burden history

Please see our Global burden history wiki page to view the global burdens for several species from several recent GEOS-Chem 1-year benchmark simulations.

GEOS-Chem Benchmark Performance

For an overview of GEOS-Chem 1-month benchmark timing results, please see our GEOS-Chem 1-month benchmark timing results wiki page.