GEOS-Chem versions

From Geos-chem
Revision as of 19:17, 28 June 2024 by Melissa Payer (talk | contribs)
Jump to navigation Jump to 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 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.

GEOS-Chem 14 release series

14.4

Version Released Important features Benchmarks DOIs & AMIs
14.4.1 28 Jun 2024 See the GEOS-Chem 14.4.1 page for a complete list of updates, including:
  • Fix slowdown in 14.4.0 runs caused by reading met fields and nested-grid boundary conditions more frequently than necessary
  • Fixes for GEOS-Chem in CESM
  • GCHP run directory fixes and improvements
N/A

GCClassic 14.4.1

GCHP 14.4.1

GEOS-Chem 14.4.1 (science code)

HEMCO 3.9.1

14.4.0 31 May 2024 See the GEOS-Chem 14.4.0 page for a complete list of updates, including:
  • HETP aerosol thermodynamics
  • GCHP carbon simulation
  • Parameterized Reff for SNA and OM aerosols
  • Updated gravitational settling, diameters, hyg growth in aerosol drydep
  • Only convert units for species that require it

GCClassic 14.4.0

GCHP 14.4.0

GEOS-Chem 14.4.0 (science code)

HEMCO 3.9.0

14.3

Version Released Important features Benchmarks DOIs & AMIs
14.3.1 02 Apr 2024 See the GEOS-Chem 14.3.1 page for a complete list of updates, including:
  • Updating CH4 emissions from EDGARv7 to EDGARv8
  • Adding budget diagnostic option for fixed level vertical region
  • Fixes to restore proper handling of NEI 3D emissions
  • ObsPack bug fixes
  • Fixing bug in transport tracer pressure mask criteria affecting tracer st80_25
N/A

GCClassic 14.3.1

GCHP 14.3.1

GEOS-Chem 14.3.1 (science code)

HEMCO 3.8.1

14.3.0 09 Feb 2024 See the GEOS-Chem 14.3.0 page for a complete list of updates, including:
  • Update reactions with new JPL & IUPAC recommendations
  • Add capability for TOMAS simulations in GCHP
  • Use Cloud-J for computing photolysis rates as default
  • GEOS-IT meteorology

GC Classsic 14.3.0

GCHP 14.3.0

GEOS-Chem 14.3.0 (science code)

HEMCO 3.8.0

14.2

Version Released Important features Benchmarks DOIs & AMIs
14.2.3 01 Dec 2023 See the GEOS-Chem 14.2.3 page for a complete list of updates, including:
  • Now specify GCClassic restart file paths in a single location (used by rundir creation and dry-run data download)
  • Config file updates for CH4 and carbon simulations
  • Simplify turning off all emissions (including extensions)
  • Various fixes for bug and technical issues
N/A GCClassic 14.2.3

GCHP 14.2.3

GEOS-Chem 14.2.3 (science code)

HEMCO 3.7.2

14.2.2 23 Oct 2023 See the GEOS-Chem 14.2.2 page for a complete list of updates, including:
  • Update sample restart files for fullchem and TransportTracer simulations to output from the 14.2.0 1-year benchmarks
N/A GCClassic 14.2.2

GCHP 14.2.2

GEOS-Chem 14.2.2 (science code)

14.2.1 10 Oct 2023 See the GEOS-Chem 14.2.1 page for a complete list of updates, including:
  • Updated integration test scripts
  • Fixes for several bug and technical issues
  • Fixes for CH4, carbon, IMI simulations
  • Updates to interface GEOS-Chem with CESM and GEOS
N/A GCClassic 14.2.1

GCHP 14.2.1

GEOS-Chem 14.2.1 (science code)

HEMCO 3.7.1

14.2.0 05 Oct 2023 See the GEOS-Chem 14.2.0 page for a complete list of updates, including:
  • Nitrate photolysis
  • Update VOC fire emissions and adding lumped furan
  • Several fixes and updates in chemistry
  • Sea salt debromination on by default
  • Updated TransportTracer simulation
  • Climatology options for lightning NOx and GFED4
  • Updates and fixes for the CH4 simulation
  • Use dry pressure in GCHP advection
  • Fix error in pressure level edge construction

GC Classsic 14.2.0

GCHP 14.2.0

GEOS-Chem 14.2.0 (science code)

HEMCO 3.7.0

14.1

Version Released Important features Benchmarks DOIs & AMIs
14.1.1 03 Mar 2023 See the GEOS-Chem 14.1.1 page for a complete list of updates, including:
  • Fixes for several bugs and issues
  • Updated to HEMCO 3.6.2
  • Updated user registration
  • Updated GitHub issue templates
  • Updates for interfacing to external models (GEOS, CESM, WRF)
  • Updated integration tests
  • NOTE: This version has zero differences w/r/t the 14.1.0 benchmarks
N/A

GC Classic 14.1.1

GCHP 14.1.1

GEOS-Chem 14.1.1 (science code)

HEMCO 3.6.1

HEMCO 3.6.2

14.1.0 01 Feb 2023 See the GEOS-Chem 14.1.0 page for a complete list of updates, including:
  • Mechanisms rebuilt with KPP 3.0.0, with auto-reduction option
  • Carbon simulation using a KPP-generated mechanism
  • Improved Hg0 dry deposition and AMAP Hg emissions
  • Option to use HTAPv3 global emissions
  • Option to archive species concentrations in molec cm-3
  • NetCDF satellite timeseries diagnostics replacing binary ND51
  • Cleanup of memory leaks
  • Time-averaged file timestamps changed from midpoint to start
  • GCHP tagged O3 simulation
  • MAPL updated to version 2.26.0

GC Classic 14.1.0

GCHP 14.1.0

GEOS-Chem 14.1.0 (science code)

HEMCO 3.6.0

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
  • Update HEMCO to version 3.5.2
  • 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
  • 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 10.5281/zenodo.2658178
12.3.1 08 Apr 2019
  • Fix for noontime J-values diagnostic
  • Fix for planeflight diagnotic
  • 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 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
  • Fix 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) 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
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

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

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 (RRTMG)

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 from Hudman et al. 2012
  • 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-01-03 14 Sep 2012
  • Updated acetone sources & sinks
  • Improved sea salt emission and deposition
  • Improved snow scavenging and washout parameterization
  • Tropospheric bromine chemistry
  • Stratospheric P and k (monthly climatological)
v9-01-02 28 Nov 2011
  • APM aerosol microphysics
  • GFED3 biomass emissions
  • RETRO Anthropogenic Emissions
v9-01-01 07 Jun 2011
  • Compatibility with the GMAO MERRA met data product
  • Updated lightning NOx; various fixes

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