GEOS-Chem versions

From Geos-chem
Revision as of 18:52, 30 November 2022 by Melissa Payer (Talk | contribs) (13.4)

Jump to: navigation, search

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 14 release series

Visit this link to view a list of manual pages for GEOS-Chem 14 and related software. Also see our list of software tools maintained by GEOS-Chem users.

14.1

Version Released Important features Benchmarks DOIs & AMIs
14.1.0 TBA TBA TBA TBA

14.0

Version Released Important features Benchmarks DOIs & AMIs
14.0.2 29 Nov 2022 See the GEOS-Chem 14.0.2 page for a complete list of updates, including:
  • Update sample full-chemistry restart files to 10-year benchmark output for 14.0.0
  • Add several fixes to CH4 simulation
  • Flush GEOS-Chem restart files to disk immediately after writing
  • Remove memory leaks from GEOS-Chem and HEMCO
  • Improve HEMCO error messages
  • Add sanitize compile option to HEMCO
N/A GC Classic 14.0.2

GCHP 14.0.2

GEOS-Chem 14.0.2 (science code)

HEMCO 3.5.2

14.0.1 31 Oct 2022 See the GEOS-Chem 14.0.1 page for a complete list of updates, including:
  • Fix typo for AEIC2019 emissions in aerosol-only simulations
  • Fix units metadata for PHIS and AirNumDen
  • Add fix for activating ND51 satellite diagnostic
  • Point species concentration array pointers to GCHP internal state
  • Fix incorrect non-species data in GCHP mid-run checkpoint files
  • Document and cleanup GCHP run script operational examples
N/A GC Classic 14.0.1

GCHP 14.0.1

GEOS-Chem 14.0.1 (science code)

14.0.0 25 Oct 2022 See the GEOS-Chem 14.0.0 page for a complete list of updates, including:
  • Converted input.geos to geoschem_config.yml
  • Fixed bugs causing differences when splitting up simulations in time
  • Remove unnecessary met-fields from GCClassic restart file
  • Updated offline emissions
  • Rebuilt mechanisms with KPP 2.5.0
  • Changed 4D State_Chm%Species array to vector of 3D arrays
  • Boundary conditions are now saved on first timestep
  • Updated HEMCO to version 3.5.0
  • Updated GMAO libraries for GCHP
  • Added option to use native GEOS-FP winds for GCHP
  • Fixed bug in GCHP vertical mass flux diagnostic
  • Fix compilation errors for custom mechanism
  • Bug fixes for the Hg simulation
  • Updates for GEOS from GMAO
  • Updates for GEOS-Chem and HEMCO in CESM
  • Updates for GEOS-Chem in WRF-GC
  • Use newest CEDS data in CO2 simulation
  • Fix typo in HEMCO_Config.rc for GCHP
  • Bug fix in rundir creation for GCAP2
  • GEOS-Chem user registration
GC Classic 14.0.0

GCHP 14.0.0

GEOS-Chem 14.0.0 (science code)

HEMCO 3.5.0

GEOS-Chem 13 release series

Manual pages for the GEOS-chem 13 release series:

13.4

Version Released Important features Benchmarks DOIs & AMIs


13.4.1 19 May 2022 See the GEOS-Chem 13.4.1 page for a complete list of updates, including:
  • Bug fix for anthropogenic CH4 emissions over the US, Canada, and Mexico
N/A GC Classic 13.4.1

GCHP 13.4.1

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
GC Classic 13.4.0

GCHP 13.4.0

HEMCO 3.4.0

GCPy 1.2.0

13.3

Version Released Important features Benchmarks DOIs & AMIs
13.3.4 07 Dec 2021

See the GEOS-Chem 13.3.4 page for a complete list of updates, including:

  • 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

GCHP 13.3.4

13.3.3 02 Dec 2021

See the GEOS-Chem 13.3.3 page for a complete list of updates, including:

  • 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 a complete list of updates, including:

GCHP 13.3.3

HEMCO 3.2.2

13.3.2 18 Nov 2021

See the GEOS-Chem 13.3.2 page for a complete list of updates, including:

  • Fixed incorrect file path for OFFLINE_DUST emissions in ExtData.rc (zero-diff update)
N/A GC Classic 13.3.2

GCHP 13.3.2

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

GCHP 13.3.1

HEMCO 3.2.1

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
GC Classic 13.3.0

GCHP 13.3.0

HEMCO 3.2.0

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: N/A GC Classic 13.2.1

GCHP 13.2.1

HEMCO 3.1.1

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
GC Classic 13.2.0

GCHP 13.2.0

HEMCO 3.1.0

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: N/A GC Classic 13.1.2

GCHP 13.1.2

13.1.1 22 Jun 2021 See the GEOS-Chem 13.1.1 page for a complete list of updates, including: N/A GC Classic 13.1.1

GCHP 13.1.1

13.1.0 17 Jun 2021 See the GEOS-Chem 13.1.0 page for a complete list of updates, including: GC Classic 13.1.0

GCHP 13.1.0

HEMCO 3.0.0

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: N/A GC Classic 13.0.2

GCHP 13.0.2

HEMCO 3.0.0-rc.3

13.0.1 23 Mar 2021 See the GEOS-Chem 13.0.1 page for a complete list of updates, including: N/A GC Classic 13.0.1

GCHP 13.0.1

HEMCO 3.0.0-rc.2

13.0.0 18 Mar 2021 See the GEOS-Chem 13.0.0 page for a complete list of updates, including: GC Classic 13.0.0

GCHP 13.0.0

GEOS-Chem 12 release series

Manual pages for the GEOS-chem 12 release series:

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: 10.5281/zenodo.3974569
12.9.2 24 Jul 2020 Bug fixes for GEOS-Chem dryrun option, CO2 simulations, PARANOX, complexSOA_SVPOA: 10.5281/zenodo.3959279
12.9.1 17 Jul 2020 Bug fixes for GEOS-Chem dryrun option, Luo wetdep, and RCP emissions: 10.5281/zenodo.3950473
12.9.0 17 Jul 2020 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 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): 10.5281/zenodo.3837666
12.8.0 04 May 2020 10.5281/zenodo.3784796

12.7

Version Released Important features Benchmarks DOI
12.7.2 09 Mar 2020 Contains several bug fixes: 10.5281/zenodo.3701669
12.7.1 03 Feb 2020 Contains several bug fixes: 10.5281/zenodo.3676008
12.7.0 03 Feb 2020 Contains several science updates and bug fixes: 10.5281/zenodo.3634864

12.6

Version Released Important features Benchmarks DOI
12.6.3 25 Nov 2019 Contains GCHP bug fixes only: See: 10.5281/zenodo.3552959
12.6.2 15 Nov 2019 Contains several bug fixes. See: 10.5281/zenodo.3543702
12.6.1 28 Oct 2019 Contains several bug fixes. See: 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

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

10.5281/zenodo.3360635

12.3

Version Released Important features Benchmarks DOI
12.3.2 02 May 2019 This is an unofficial benchmark and the first GCHP benchmark using GCPy 10.5281/zenodo.2658178
12.3.1 08 Apr 2019 10.5281/zenodo.2633278


12.3.0 01 Apr 2019 This is the first benchmark to utilize GCPy 10.5281/zenodo.2620535

12.2

Version Released Important features Benchmarks DOI
12.2.1 28 Feb 2019 10.5281/zenodo.2580198
12.2.0 19 Feb 2019 1st version to have the new Transport Tracer benchmark (replaces Rn-Pb-Be benchmark) 10.5281/zenodo.2572887

12.1

Version Released Important features Benchmarks DOI
12.1.1 13 Dec 2018 10.5281/zenodo.2249246
12.1.0 26 Nov 2018 10.5281/zenodo.1553349

12.0

Version Released Important features Benchmarks DOI
12.0.3 16 Oct 2018 10.5281/zenodo.1464210
12.0.2 10 Oct 2018 10.5281/zenodo.1455215
12.0.1 24 Aug 2018 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 10.5281/zenodo.1343547

GEOS-Chem 11 release series

Version Date released Important features Benchmarks Documentation
v11-02-rc 22 Jun 2018
v11-01 20 Dec 2016 (provisional)
01 Feb 2017 (public)

GEOS-Chem 10 release series

Version Date released Important features Benchmarks Documentation
v10-01 01 May 2015 (provisional)
17 Jun 2015 (public)

GEOS-Chem 9 release series

Version Date released Important features Benchmarks Documentation
v9-02 17 Jan 2014 (provisional)
03 Mar 2014 (public)
v9-01-03 14 Sep 2012
v9-01-02 28 Nov 2011
v9-01-01 07 Jun 2011

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

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

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.