GEOS-Chem versions

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

GEOS-Chem documentation

Please visit these links to view our GEOS-Chem manual pages:

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

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:

• GCC = GEOS-Chem "Classic" (uses OpenMP parallelization single node only)
• GCHP = GEOS-Chem High Performance (uses MPI parallelization across multiple nodes)
• Information about benchmarks can be found by following the links in the "Benchmarks" column

GEOS-Chem 12 release series

Version	Released	Important features	DOI	Benchmarks
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	10.5281/zenodo.3784796	1-month GCC 1-month GCHP 1-year GCC 1-year transport
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	10.5281/zenodo.3634864	1-month GCC 1-month GCHP 1-year GCC transport
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	10.5281/zenodo.3507501	1-month GCC 1-month GCHP 1-year GCC
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	10.5281/zenodo.3403111	1-month GCC 1-month GCHP
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.	10.5281/zenodo.3360635	1-month GCC 1-month GCHP 1-year GCC
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	10.5281/zenodo.2658178	This is an unofficial benchmark and the first GCHP benchmark using GCPy 1-month GCC 1-month GCHP
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	10.5281/zenodo.2620535	This is the first benchmark to utilize GCPy 1-month GCC
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	10.5281/zenodo.2572887	1st version to have the new Transport Tracer benchmark (replaces Rn-Pb-Be benchmark) 1-month GCC 1-year transport
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	10.5281/zenodo.1553349	1-month GCC
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	DOI: 10.5281/zenodo.1343547 GC 12 manual 1-month benchmark simulation 1-year benchmark simulation	Note change in GEOS-Chem version numbering system 1-month GCC 1-year GCC

GEOS-Chem 11 release series

Version	Date released	Important features	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	GC v11-02 manual GC v11-02 benchmark history
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	GC v11-01 manual GC v11-01 benchmark history

GEOS-Chem 10 release series

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

GEOS-Chem 9 release series

Version	Date released	Important features	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	GC v9-02 manual GC v9-02 benchmark history
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)	GC v9-01-03 manual GC v9-01-03 benchmark history
v9-01-02	28 Nov 2011	APM aerosol microphysics GFED3 biomass emissions RETRO Anthropogenic Emissions Various fixes to correct several identified issues	GC v9-01-02 manual GC v9-01-02 benchmark history
v9-01-01	07 Jun 2011	Compatibility with the GMAO MERRA met data product Updated lightning NOx; various fixes	GC v9-01-01 manual GC v9-01-01 benchmark history

GEOS-Chem 8 release series

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

GEOS-Chem 7 release series

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

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.

--Bob Yantosca (talk) 17:01, 21 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)