GEOS-Chem versions

Here we have posted links to a separate wiki page describing each GEOS-Chem model version.

GEOS-Chem development history

In the table below, we list information about current and past GEOS-Chem releases. For information about upcoming releases, please visit our GEOS-Chem model development priorities wiki page.

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

GEOS-Chem 13 release series

Manual pages for the GEOS-chem 13 release series:

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

Version	Released	Important features	Benchmarks	Additional Info
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	DOIs: GC Classic 13.0.2 10.5281/zenodo.4681204 GCHP 13.0.2 10.5281/zenodo.4681742 HEMCO 3.0.0-rc.3 10.5281/zenodo.4681191 AMI ID: TBD
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	DOIs: GC Classic 13.0.1 10.5281/zenodo.4632275 GCHP 13.0.1 10.5281/zenodo.4632276 HEMCO 3.0.0-rc.2 10.5281/zenodo.4632279 AMI ID: ami-0ebb738afafa614cf
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	Release candidate DOIs: GC Classic 13.0.0-rc.1 10.5281/zenodo.4437679 GC Classic 13.0.0-rc.0 10.5281/zenodo.4429178 GCHP 13.0.0-rc.0 10.5281/zenodo.4429194 AMI ID: ami-0ef2c8a2d3464485c

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

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.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.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.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.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.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.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.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.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.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.

--Melissa Sulprizio (talk) 16:02, 10 August 2018 (UTC)
--Bob Yantosca (talk) 15:11, 15 March 2019 (UTC)

Mean OH from GEOS-Chem 1-year benchmark simulations

Here is a plot of the mean OH concentration from GEOS-Chem 1-year benchmark simulations through version 12.8.0 (released 04 May 2020). The mean OH is an indicator how the chemistry mechanism is performing. Typical values are 10–12 x 10⁵ molecules cm^-1.

For more information, please see our Evolution of mean OH in GEOS-Chem wiki documentation.

--Bob Yantosca (talk) 15:41, 27 May 2020 (UTC)

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.

--Bob Y. (talk) 19:32, 9 November 2015 (UTC)

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.

--Bob Y. 15:47, 30 April 2015 (EDT)

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.

--Melissa Sulprizio (talk) 13:59, 20 September 2018 (UTC)