Difference between revisions of "GEOS-Chem versions"

From Geos-chem
Jump to: navigation, search
(14.0)
(14.1)
(42 intermediate revisions by 3 users not shown)
Line 16: Line 16:
 
== GEOS-Chem 14 release series ==
 
== GEOS-Chem 14 release series ==
  
=== 14.0 ===
+
[https://geos-chem.readthedocs.io/en/latest/geos-chem-shared-docs/supplemental-guides/related-docs.html Visit this link] to view a list of manual pages for GEOS-Chem 14 and related software.  Also see our list of [[Software maintained by GEOS-Chem community members|software tools maintained by GEOS-Chem users]].
  
[https://geos-chem.readthedocs.io/en/latest/geos-chem-shared-docs/supplemental-guides/related-docs.html Visit this link] to view a list of manual pages for GEOS-Chem 14 and related software.
+
=== 14.2 ===
  
 
{| border=1 cellspacing=0 cellpadding=5
 
{| border=1 cellspacing=0 cellpadding=5
Line 27: Line 27:
 
!width="200px"|Benchmarks
 
!width="200px"|Benchmarks
 
!width="250px"|DOIs & AMIs
 
!width="250px"|DOIs & AMIs
 +
 +
|-valign="top"
 +
|[[GEOS-Chem 14.2.0|14.2.0]]
 +
|TBD
 +
|TBD
 +
|TBD
 +
|TBD
 +
 +
|}
 +
 +
=== 14.1 ===
 +
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top" bgcolor="#cccccc"
 +
!width="75px"|Version
 +
!width="100px"|Released
 +
!width="360px"|Important features
 +
!width="200px"|Benchmarks
 +
!width="250px"|DOIs & AMIs
 +
 +
|-valign="top"
 +
|[[GEOS-Chem 14.1.1|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
 +
*DOI: [https://doi.org/10.5281/zenodo.7696651 10.5281/zenodo.7696651]
 +
GCHP 14.1.1
 +
*DOI: [https://doi.org/10.5281/zenodo.7696683 10.5281/zenodo.7696683]
 +
GEOS-Chem 14.1.1 (science code)
 +
*DOI: [https://doi.org/10.5281/zenodo.7696632 10.5281/zenodo.7696632]
 +
HEMCO 3.6.1
 +
*DOI: [https://doi.org/10.5281/zenodo.7692950 10.5281/zenodo.7689762]
 +
HEMCO 3.6.2
 +
*DOI: [https://doi.org/10.5281/zenodo.7692950 10.5281/zenodo.7692950]
 +
 +
|-valign="top"
 +
|[[GEOS-Chem 14.1.0|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
 +
|
 +
*[[GEOS-Chem_14.1.0#1-month_full-chemistry_benchmarks|1-month benchmarks]]
 +
|
 +
GC Classic 14.1.0
 +
*DOI: [https://doi.org/10.5281/zenodo.7600579 10.5281/zenodo.7600579]
 +
GCHP 14.1.0
 +
*DOI: [https://doi.org/10.5281/zenodo.7600586 10.5281/zenodo.7600586]
 +
GEOS-Chem 14.1.0 (science code)
 +
*DOI: [https://doi.org/10.5281/zenodo.7600404 10.5281/zenodo.7600404]
 +
HEMCO 3.6.0
 +
*DOI: [https://doi.org/10.5281/zenodo.7600424 10.5281/zenodo.7600424]
 +
 +
|}
 +
 +
=== 14.0 ===
 +
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top" bgcolor="#cccccc"
 +
!width="75px"|Version
 +
!width="100px"|Released
 +
!width="360px"|Important features
 +
!width="200px"|Benchmarks
 +
!width="250px"|DOIs & AMIs
 +
 +
|-valign="top"
 +
|[[GEOS-Chem 14.0.2|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
 +
*DOI: [https://doi.org/10.5281/zenodo.7383492 10.5281/zenodo.7383492]
 +
GCHP 14.0.2
 +
*DOI: [https://doi.org/10.5281/zenodo.7383532 10.5281/zenodo.7383532]
 +
GEOS-Chem 14.0.2 (science code)
 +
*DOI: [https://doi.org/10.5281/zenodo.7383132 10.5281/zenodo.7383132]
 +
HEMCO 3.5.2
 +
*DOI: [https://doi.org/10.5281/zenodo.7383390 10.5281/zenodo.7383390]
  
 
|-valign="top"
 
|-valign="top"
 
|[[GEOS-Chem 14.0.1|14.0.1]]
 
|[[GEOS-Chem 14.0.1|14.0.1]]
|19 May 2022
+
|31 Oct 2022
|See the [[GEOS-Chem 14.0.1]] page for more information on these fixes:
+
|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
 
|N/A
 
|GC Classic 14.0.1
 
|GC Classic 14.0.1
*DOI: TBA
+
*DOI: [https://doi.org/10.5281/zenodo.7271974 10.5281/zenodo.7271974]
*AMI: TBA
+
*AMI: ami-08cd37668e1158330
 
GCHP 14.0.1
 
GCHP 14.0.1
*DOI: TBA
+
*DOI: [https://doi.org/10.5281/zenodo.7271982 10.5281/zenodo.7271982]
 +
GEOS-Chem 14.0.1 (science code)
 +
*DOI: [https://doi.org/10.5281/zenodo.7271960 10.5281/zenodo.7271960]
  
 
|-valign="top"
 
|-valign="top"
 
|[[GEOS-Chem 14.0.0|14.0.0]]
 
|[[GEOS-Chem 14.0.0|14.0.0]]
|19 May 2022
+
|25 Oct 2022
|See the [[GEOS-Chem 14.0.0]] page for more information on these fixes:
+
|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
 
|
 
|
* 1-month benchmarks
+
*[http://wiki.seas.harvard.edu/geos-chem/index.php/GEOS-Chem_14.0.0#1-month_full-chemistry_benchmarks 1-month benchmarks]
* 1-year benchmarks
+
*[http://wiki.seas.harvard.edu/geos-chem/index.php/GEOS-Chem_14.0.0#1-year_full-chemistry_benchmarks 1-year benchmarks]
 +
*[http://wiki.seas.harvard.edu/geos-chem/index.php/GEOS-Chem_14.0.0#10-year_full-chemistry_benchmarks 10-year benchmarks]
 
|GC Classic 14.0.0
 
|GC Classic 14.0.0
*DOI: TBA
+
*DOI: [https://doi.org/10.5281/zenodo.7254984 10.5281/zenodo.7254984]
*AMI: TBA
+
 
GCHP 14.0.0
 
GCHP 14.0.0
*DOI: TBA
+
*DOI: [https://doi.org/10.5281/zenodo.7254990 10.5281/zenodo.7254990]
 +
GEOS-Chem 14.0.0 (science code)
 +
*DOI: [https://doi.org/10.5281/zenodo.7254288 10.5281/zenodo.7254288]
 +
HEMCO 3.5.0
 +
*DOI: [https://doi.org/10.5281/zenodo.7254056 10.5281/zenodo.7254056]
  
 
|}
 
|}
Line 80: Line 212:
 
|[[GEOS-Chem 13.4.1|13.4.1]]
 
|[[GEOS-Chem 13.4.1|13.4.1]]
 
|19 May 2022
 
|19 May 2022
|See the [[GEOS-Chem 13.4.1]] page for more information on these fixes:
+
|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
 
*Bug fix for anthropogenic CH4 emissions over the US, Canada, and Mexico
 
|N/A
 
|N/A
Line 131: Line 263:
 
|07 Dec 2021
 
|07 Dec 2021
 
|
 
|
See the [[GEOS-Chem 13.3.4]] page for more information on these updates:
+
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 use proper restart file path for dry-run data download
 
*Bug fix: Now check GEOS-Chem Classic History diagnostic subset regions properly
 
*Bug fix: Now check GEOS-Chem Classic History diagnostic subset regions properly
Line 145: Line 277:
 
|02 Dec 2021
 
|02 Dec 2021
 
|
 
|
See the [[GEOS-Chem 13.3.3]] page for more information on these updates:
+
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).
 
*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
 
*Only affects CH4, Hg, and TOMAS simulations
 
|N/A
 
|N/A
 
|GC Classic 13.3.3
 
|GC Classic 13.3.3
See the [[GEOS-Chem 13.3.3]] page for more information on these updates:
+
See the [[GEOS-Chem 13.3.3]] page for a complete list of updates, including:
 
*DOI: [https://doi.org/10.5281/zenodo.5748260 10.5281/zenodo.5748260]
 
*DOI: [https://doi.org/10.5281/zenodo.5748260 10.5281/zenodo.5748260]
 
GCHP 13.3.3
 
GCHP 13.3.3
Line 161: Line 293:
 
|18 Nov 2021
 
|18 Nov 2021
 
|
 
|
See the [[GEOS-Chem 13.3.2]] page for more information on these updates:
+
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)
 
*Fixed incorrect file path for OFFLINE_DUST emissions in ExtData.rc (zero-diff update)
 
|N/A
 
|N/A
Line 431: Line 563:
 
|
 
|
 
*[https://www.atmos-chem-phys.net/19/3981/2019/ Updated halogen chemistry]
 
*[https://www.atmos-chem-phys.net/19/3981/2019/ Updated halogen chemistry]
*[http://acmg.seas.harvard.edu/publications/2020/Shah_2020.pdf Improved cloudwater pH]
+
*[https://acp.copernicus.org/articles/20/12223/2020/ Improved cloudwater pH]
 
*[https://github.com/geoschem/geos-chem-unittest/pull/20 Update offline lightning data through Dec 2019]
 
*[https://github.com/geoschem/geos-chem-unittest/pull/20 Update offline lightning data through Dec 2019]
 
*Convert GEOS-Chem species database to YAML format,
 
*Convert GEOS-Chem species database to YAML format,
Line 835: Line 967:
 
*[[GEOS-Chem v11-02 benchmark history|v11-02 benchmark history page]]
 
*[[GEOS-Chem v11-02 benchmark history|v11-02 benchmark history page]]
 
|
 
|
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.GC_12/index.html v11-02/12.0.0 manual]
+
*[https://geoschem.github.io/gcclassic-manpage-archive/man.GC_12/index.html v11-02/12.0.0 manual]
  
 
|-valign="top"
 
|-valign="top"
Line 851: Line 983:
 
*[[GEOS-Chem v11-01 benchmark history|v11-01 benchmark history page]]
 
*[[GEOS-Chem v11-01 benchmark history|v11-01 benchmark history page]]
 
|
 
|
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v11-01/index.html v11-01 manual]
+
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v11-01/index.html v11-01 manual]
  
 
|}
 
|}
Line 875: Line 1,007:
 
*[[GEOS-Chem v10-01 benchmark history|v10-01 benchmark history page]]
 
*[[GEOS-Chem v10-01 benchmark history|v10-01 benchmark history page]]
 
|
 
|
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v10-01/index.html v10-01 manual]
+
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v10-01/index.html v10-01 manual]
  
 
|}
 
|}
Line 904: Line 1,036:
 
*[[GEOS-Chem v9-02 benchmark history|v9-02 benchmark history page]]
 
*[[GEOS-Chem v9-02 benchmark history|v9-02 benchmark history page]]
 
|
 
|
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v9-02/index.html v9-02 manual]
+
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v9-02/index.html v9-02 manual]
  
 
|-valign="top"
 
|-valign="top"
Line 918: Line 1,050:
 
*[[GEOS-Chem v9-01-03 benchmark history|v9-01-03 benchmark history page]]
 
*[[GEOS-Chem v9-01-03 benchmark history|v9-01-03 benchmark history page]]
 
|
 
|
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v9-01-03/index.html v9-01-03 manual]
+
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v9-01-03/index.html v9-01-03 manual]
  
 
|-valign="top"
 
|-valign="top"
Line 931: Line 1,063:
 
*[[GEOS-Chem v9-01-02 benchmark history|v9-01-02 benchmark history page]]
 
*[[GEOS-Chem v9-01-02 benchmark history|v9-01-02 benchmark history page]]
 
|
 
|
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v9-01-02/index.html v9-01-02 manual]
+
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v9-01-02/index.html v9-01-02 manual]
  
 
|-valign="top"
 
|-valign="top"
Line 942: Line 1,074:
 
*[[GEOS-Chem v9-01-01 benchmark history|v9-01-01 benchmark history page]]
 
*[[GEOS-Chem v9-01-01 benchmark history|v9-01-01 benchmark history page]]
 
|
 
|
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v9-01-01/index.html v9-01-01 manual]
+
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v9-01-01/index.html v9-01-01 manual]
  
 
|}
 
|}
Line 963: Line 1,095:
 
*Archived to storage; contact [[GCST]]
 
*Archived to storage; contact [[GCST]]
 
|
 
|
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v8-03-02/index.html v8-03-02 manual]
+
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-03-02/index.html v8-03-02 manual]
  
 
|-valign="top"
 
|-valign="top"
Line 975: Line 1,107:
 
*Archived to storage; contact [[GCST]]
 
*Archived to storage; contact [[GCST]]
 
|
 
|
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v8-03-01/index.html GC v8-03-01 manual]
+
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-03-01/index.html GC v8-03-01 manual]
  
 
|-valign="top"
 
|-valign="top"
Line 987: Line 1,119:
 
*Archived to storage; contact [[GCST]]
 
*Archived to storage; contact [[GCST]]
 
|
 
|
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v8-02-01/index.html GC v8-02-04 manual]
+
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-02-01/index.html GC v8-02-04 manual]
  
 
|-valign="top"
 
|-valign="top"
Line 999: Line 1,131:
 
*Archived to storage; contact [[GCST]]
 
*Archived to storage; contact [[GCST]]
 
|
 
|
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v8-02-01/index.html GC v8-02-03 manual]
+
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-02-01/index.html GC v8-02-03 manual]
  
 
|-valign="top"
 
|-valign="top"
Line 1,010: Line 1,142:
 
*Archived to storage; contact [[GCST]]
 
*Archived to storage; contact [[GCST]]
 
|
 
|
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v8-02-01/index.html GC v8-02-02 manual]
+
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-02-01/index.html GC v8-02-02 manual]
  
 
|-valign="top"
 
|-valign="top"
Line 1,021: Line 1,153:
 
*Archived to storage; contact [[GCST]]
 
*Archived to storage; contact [[GCST]]
 
|
 
|
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v8-02-01/index.html GC v8-02-01 manual]
+
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-02-01/index.html GC v8-02-01 manual]
  
 
|-valign="top"
 
|-valign="top"
Line 1,032: Line 1,164:
 
*Archived to storage; contact [[GCST]]
 
*Archived to storage; contact [[GCST]]
 
|
 
|
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v8-01-04/index.html GC v8-01-04 manual]
+
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-01-04/index.html GC v8-01-04 manual]
  
 
|-valign="top"
 
|-valign="top"
Line 1,042: Line 1,174:
 
*Archived to storage; contact [[GCST]]
 
*Archived to storage; contact [[GCST]]
 
|
 
|
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v8-01-04/index.html GC v8-01-03 manual]
+
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-01-04/index.html GC v8-01-03 manual]
  
 
|-valign="top"
 
|-valign="top"
Line 1,052: Line 1,184:
 
*Archived to storage; contact [[GCST]]
 
*Archived to storage; contact [[GCST]]
 
|
 
|
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v8-01-04/index.html GC v8-01-02 manual]
+
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-01-04/index.html GC v8-01-02 manual]
  
 
|-valign="top"
 
|-valign="top"
Line 1,062: Line 1,194:
 
*Archived to storage; contact [[GCST]]
 
*Archived to storage; contact [[GCST]]
 
|
 
|
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v8-01-04/index.html GC v8-01-01 manual]
+
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-01-04/index.html GC v8-01-01 manual]
  
 
|}
 
|}
Line 1,096: Line 1,228:
  
 
|-valign="top"
 
|-valign="top"
|[http://acmg.seas.harvard.edu/geos/geos_versions.html v7-04-11 and earlier]
+
|v7-04-11 and earlier
 
|March 2006 and earlier
 
|March 2006 and earlier
 
|
 
|
Line 1,104: Line 1,236:
  
 
|}
 
|}
 
NOTE: For information about 1-year benchmark simulations for GEOS-Chem v8-02-04 and earlier, see [http://acmg.seas.harvard.edu/geos/geos_1yr_plots.html this website].
 
  
 
== GEOS-Chem benchmarking information ==
 
== GEOS-Chem benchmarking information ==

Revision as of 20:12, 3 March 2023

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

Version Released Important features Benchmarks DOIs & AMIs
14.2.0 TBD TBD TBD TBD

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