GEOS-Chem versions

From Geos-chem
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

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-hem "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.6

Version / Date Important features Benchmarks DOIs
14.6.0
TBD 		TBD TBD TBD

14.5

Version / Date Important features Benchmarks DOIs
14.5.1
TBD 		TBD TBD TBD
14.5.0
08 Nov 2024 		See the GEOS-Chem 14.5.0 page for a complete list of updates, including:
  • Chemistry for RCOOH, ANs, PNs (and corresponding emissions updates)
  • PPN photolysis
  • Cloud-J 8.0.1 (with UV H2O absorption)

14.4

Version / Date Important features Benchmarks DOIs
14.4.3
24 Jul 2024 		See the GEOS-Chem 14.4.3 page for a complete list of updates, including:
  • Fix a significant performance bottleneck in Cloud-J
  • Other minor bug fixes
 N/A
14.4.2
24 Jul 2024 		See the GEOS-Chem 14.4.2 page for a complete list of updates, including:
  • Updates for GEOS-Chem in CESM
  • Other minor bug fixes
 N/A
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
  • Updates for GEOS-Chem in CESM
  • GCHP run directory fixes and improvements
 N/A
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

14.3

Version / Date Important features Benchmarks DOIs
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
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

14.2

Version / Date Important features Benchmarks DOIs
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
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
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
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

14.1

Version / Date Important features Benchmarks DOIs
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
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

14.0

Version / Date Important features Benchmarks DOIs
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
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
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

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
Retrieved from "https://wiki.seas.harvard.edu/geos-chem/index.php?title=GEOS-Chem_versions&oldid=54493"