Difference between revisions of "GEOS-Chem versions"

From Geos-chem
Jump to: navigation, search
(New page: '''NOTE: The order in which various updates enter into the standard GEOS-Chem code may differ than what is listed here, depending on circumstances.''' == v8-01-04 ?? == Also adds: * [[wi...)
 
 
(543 intermediate revisions by 8 users not shown)
Line 1: Line 1:
'''NOTE: The order in which various updates enter into the standard GEOS-Chem code may differ than what is listed here, depending on circumstances.'''
+
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|GEOS-Chem model development priorities wiki page]].
  
== v8-01-04 ?? ==
+
== GEOS-Chem development history ==
Also adds:
+
  
* [[wiki:geos-chem:chem_forum|Hongyu Liu's fix: set random cloud overlap as the default option for FAST-J photolysis]]
+
In the tables below, we list information about current and past GEOS-Chem releases.
  
== v8-01-03 ?? ==
+
Some notes for the tables below:  
Also adds:
+
*Information about benchmarks can be found by following the links in the "Benchmarks" column
* [[wiki:geos-chem:anthro_forum#jan_2008|EPA/NEI99 California transport sector fix]]
+
*GCC = GEOS-Chem "Classic" (uses OpenMP parallelization single node only)
* [[wiki:geos-chem:biogenic_forum#sep_2007|Updated MEGAN annual emission factors for isoprene]]
+
*GCHP = GEOS-Chem High Performance (uses MPI parallelization across multiple nodes)
* PERHAPS -- Updated mercury simulation (cf. Noelle, Elsie, Chris, Sarah Strode, etc.)
+
*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
  
== v8-01-02 ?? ==
+
Also see our [[GEOS-Chem version numbering system]] wiki page for information on how GEOS-Chem versions are labeled.
Also adds:
+
* May Fu's updated chemistry mechanism
+
  
== v8-01-01 ==
+
== GEOS-Chem 14 release series ==
PUBLIC RELEASE scheduled for April 2008
+
  
Contains everything in v7-04-13, with the following additions:
+
=== 14.0 ===
* This is the first version to be compatible with the [[wiki:geos-chem:geos5_forum|GEOS-5 met fields]].
+
  
=== 1-Year Benchmarks ===
+
[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]].
  
==== Description ====
+
{| 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
  
* Results from v8-01-01 1-year benchmark simulation (w/ GEOS-5 met) are contained in the directory:
+
|-valign="top"
/as2/pub/ftp/pub/geos-chem/1yr_benchmarks/v7-04-12/geos5/2005/Run
+
|[[GEOS-Chem 14.0.0|14.0.0]]
* This benchmark uses the same input conditions and emissions as v7-04-13. The only difference is that this benchmark was done w/ GEOS-5 met and v7-04-13 was done w/ GEOS-4 met.
+
|TBA
 +
|See the [[GEOS-Chem 14.0.0]] page for more information on these fixes:
 +
*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
 +
|
 +
*[http://wiki.seas.harvard.edu/geos-chem/index.php/GEOS-Chem_14.0.0#1-month_full-chemistry_benchmarks 1-month benchmarks]
 +
*[http://wiki.seas.harvard.edu/geos-chem/index.php/GEOS-Chem_14.0.0#1-year_full-chemistry_benchmarks 1-year benchmarks]
 +
|GC Classic 14.0.0
 +
*DOI: TBA
 +
*AMI: TBA
 +
GCHP 14.0.0
 +
*DOI: TBA
  
The 3 models compared (and their colors on the plots) were:
+
|}
 +
 
 +
== GEOS-Chem 13 release series ==
 +
 
 +
Manual pages for the GEOS-chem 13 release series:
 +
 
 +
*GEOS-Chem Classic: Read the Docs (in progress); [[Getting Started with GEOS-Chem]]
 +
*GCHP: [https://gchp.readthedocs.io/en/latest/ Read the Docs]
 +
*HEMCO: [https://hemco.readthedocs.io/ Read the Docs]
 +
*[http://cloud.geos-chem.org Using GEOS-Chem on the AWS cloud]
 +
*[https://fugroup.org/index.php/WRF-GC#Getting_started Getting Started with WRF-GC]
 +
 
 +
=== 13.4 ===
 +
 
 +
{| 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 13.4.1|13.4.1]]
 +
|19 May 2022
 +
|See the [[GEOS-Chem 13.4.1]] page for more information on these fixes:
 +
*Bug fix for anthropogenic CH4 emissions over the US, Canada, and Mexico
 +
|N/A
 +
|GC Classic 13.4.1
 +
*DOI: [https://doi.org/10.5281/zenodo.6564702 10.5281/zenodo.6564702]
 +
*AMI: [https://aws.amazon.com/marketplace/pp/prodview-wu7jnvdqc5qnu?sr=0-1&ref_=beagle&applicationId=AWS-Marketplace-Console ami listing]
 +
GCHP 13.4.1
 +
*DOI: [https://doi.org/10.5281/zenodo.6564711 10.5281/zenodo.6564711]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 13.4.0|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 [https://doi.org/10.5194/acp-21-1861-2021 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
 +
|
 +
*[[GEOS-Chem_13.4.0#1-month_benchmarks|1-month benchmarks]]
 +
*[[GEOS-Chem_13.4.0#1-year_full-chemistry_benchmarks|1-year full-chemistry benchmarks]]
 +
*[[GEOS-Chem_13.4.0#1-year_transport_tracers_benchmarks|1-year transport tracer benchmarks]]
 +
|GC Classic 13.4.0
 +
*DOI: [https://doi.org/10.5281/zenodo.6511970 10.5281/zenodo.6511970]
 +
*AMI: TBD
 +
GCHP 13.4.0
 +
*DOI: [https://doi.org/10.5281/zenodo.6512251 10.5281/zenodo.6512251]
 +
HEMCO 3.4.0
 +
*DOI: [https://doi.org/10.5281/zenodo.6511930 10.5281/zenodo.6511930]
 +
GCPy 1.2.0
 +
*DOI: [https://doi.org/10.5281/zenodo.6512027 10.5281/zenodo.6512027]
  
{| border=1 cellspacing=0 cellpadding=5
 
! Color
 
! Quantity Plotted
 
! Met Type
 
! Lightning algorithm
 
|-
 
| Red 
 
| [[#Run2|v7-04-12 Run2]]
 
| GEOS-4 4x5
 
| [[wiki:geos-chem:lightning_forum#sep_2007|near-land w/ OTD-LIS regional scaling]]
 
|-                                   
 
| Green
 
| [[#v7-04-13|v7-04-13]] 
 
| GEOS-4 4x5
 
| updated non-near-land w/ OTD-LIS local scaling
 
|-
 
| Blue 
 
| This model version     
 
| GEOS-5 4x5
 
| updated non-near-land w/ OTD-LIS local scaling
 
|-
 
| Black
 
| Observations           
 
|           
 
|  
 
 
|}
 
|}
  
==== Results ====
+
=== 13.3 ===
  
==== Release Notes ====
+
{| border=1 cellspacing=0 cellpadding=5
* We have implemented the fix for the [[wiki:geos-chem:biomass_forum#sep_2007|last year of GFED2 biomass emissions, (which is now 2006)]] into v8-01-01.
+
|-valign="top" bgcolor="#cccccc"
 +
!width="75px"|Version
 +
!width="100px"|Released
 +
!width="360px"|Important features
 +
!width="200px"|Benchmarks
 +
!width="250px"|DOIs & AMIs
  
== v7-04-13 ==
+
|-valign="top"
BETA RELEASE November 2007
+
|[[GEOS-Chem 13.3.4|13.3.4]]
 +
|07 Dec 2021
 +
|
 +
See the [[GEOS-Chem 13.3.4]] page for more information on these updates:
 +
*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
 +
*DOI: [https://doi.org/10.5281/zenodo.5764874 10.5281/zenodo.5764874]
 +
*AMI: ami-069af8bd933eefa4d
 +
GCHP 13.3.4
 +
*DOI: [https://doi.org/10.5281/zenodo.5764877 10.5281/zenodo.5764877]
  
Contains everything in v7-04-12, with the following additions:
+
|-valign="top"
 +
|[[GEOS-Chem 13.3.3|13.3.3]]
 +
|02 Dec 2021
 +
|
 +
See the [[GEOS-Chem 13.3.3]] page for more information on these updates:
 +
*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 more information on these updates:
 +
*DOI: [https://doi.org/10.5281/zenodo.5748260 10.5281/zenodo.5748260]
 +
GCHP 13.3.3
 +
*DOI: [https://doi.org/10.5281/zenodo.5750068 10.5281/zenodo.5750068]
 +
HEMCO 3.2.2
 +
*DOI: [https://doi.org/10.5281/zenodo.5748078 10.5281/zenodo.5748078]
  
* Offline H2/HD simulation (cf. Lyatt Jaegle et al)
+
|-valign="top"
* Bug fix in "smvgear.f" -- due to a design flaw, you could have a situation where you could have negative or    zero tracer in a box even if the global & local error criteria were satisfied.  If this condition is encountered, we now revert to the concentrations at the end of the previous internal timestep, and then reduce the internal timestep and try again until we get convergence.
+
|[[GEOS-Chem 13.3.2|13.3.2]]
* [[wiki:geos-chem:lightning_forum|Bug fix -- replace GEMISNOX w/ module arrays to avoid common block errors in lightning & aircraft NOx emissions]]
+
|18 Nov 2021
* [[wiki:geos-chem:chem_forum#variable_tropopause|Bug fix -- cap variable tropopause at 200hPa for polar regions (90S-60S and 60N-90N)]]
+
|
* [[wiki:geos-chem:emissions#lightning_nox|Lee Murray's local lightning redistribution of lightning flashes]]
+
See the [[GEOS-Chem 13.3.2]] page for more information on these updates:
* Minor bug fixes for GCAP and diagnostics
+
*Fixed incorrect file path for OFFLINE_DUST emissions in ExtData.rc (zero-diff update)
 +
|N/A
 +
|GC Classic 13.3.2
 +
*DOI: [https://doi.org/10.5281/zenodo.5711194 10.5281/zenodo.5711194]
 +
GCHP 13.3.2
 +
*DOI: [https://doi.org/10.5281/zenodo.5711194 10.5281/zenodo.5711194]
  
=== 1-Year Benchmarks ===
+
|-valign="top"
 +
|[[GEOS-Chem 13.3.1|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
 +
*DOI: [https://doi.org/10.5281/zenodo.5703364 10.5281/zenodo.5703364]
 +
GCHP 13.3.1
 +
*DOI: [https://doi.org/10.5281/zenodo.5703435 10.5281/zenodo.5703435]
 +
HEMCO 3.2.1
 +
*DOI: [https://doi.org/10.5281/zenodo.5703341 10.5281/zenodo.5703341]
  
==== Description ====
+
|-valign="top"
* Results from 1-year benchmark simulation (w/ GEOS-4 met) are contained in the directory:
+
|[[GEOS-Chem 13.3.0|13.3.0]]
    /as2/pub/ftp/pub/geos-chem/1yr_benchmarks/v7-04-12/geos4/2005/Run
+
|15 Nov 2021
* This benchmark uses the same input conditions and emissions as v7-04-12-Run2, except for the updated lightning emissions as described above.
+
|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
 +
|
 +
*[[GEOS-Chem_13.3.0#1-month_benchmarks|1-month benchmarks]]
 +
*[[GEOS-Chem_13.3.0#1-year_full-chemistry_benchmarks|1-year full-chemistry benchmarks]]
 +
|GC Classic 13.3.0
 +
*DOI: [https://doi.org/10.5281/zenodo.5703095 10.5281/zenodo.5703095]
 +
GCHP 13.3.0
 +
*DOI: [https://doi.org/10.5281/zenodo.5703410 10.5281/zenodo.5703410]
 +
HEMCO 3.2.0
 +
*DOI: [https://doi.org/10.5281/zenodo.5703120 10.5281/zenodo.5703120]
  
The 3 models compared (and their colors on the plots) were:
+
|}
  
^ Color ^  Quantity Plotted      ^  Met Type  ^      Lightning algorithm                      ^
+
=== 13.2 ===
| Red  | [[#Run1|v7-04-12 Run1]] | GEOS-4 4x5 | ancient                                        |
+
| Green | [[#Run2|v7-04-12 Run2]] | GEOS-4 4x5 | [[wiki:geos-chem:lightning_forum#sep_2007|near-land w/ OTD-LIS regional scaling]] |
+
| Blue  | This model version      | GEOS-4 4x5 | updated non-near-land w/ OTD-LIS local scaling |
+
| Black | Observations            |            |                                                |
+
  
=== Results ===
+
{| 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
  
==== Release Notes ====
+
|-valign="top"
  * [[wiki:geos-chem:biomass_forum#jan_2008|The maximum year for GFED2 emissions in this version is 2005.]] If you want to use the 2006 emissions you will have to edit the source code module "gfed2_biomass_mod.f".
+
|[[GEOS-Chem 13.2.1|13.2.1]]
 +
|10 Sep 2021
 +
|See the [[GEOS-Chem 13.2.1]] page for a complete list of updates, including:
 +
*[https://github.com/geoschem/geos-chem/issues/839 Retire tropchem simulation as an option]
 +
*[https://github.com/geoschem/geos-chem/issues/810 Fixes for JvalO3O1D and JValO3O3P diagnostics]
 +
*[https://github.com/geoschem/geos-chem/issues/832 Add WashU data server to GCHP data download script]
 +
*Bug fixes for planeflight diagnostic, nested-grid simulations, and Hg simulations
 +
|N/A
 +
|GC Classic 13.2.1
 +
*DOI: [https://doi.org/10.5281/zenodo.5500717 10.5281/zenodo.5500717]
 +
*AMI: ami-0983d1d6b06e4dd3f
 +
GCHP 13.2.1
 +
*DOI: [https://doi.org/10.5281/zenodo.5500718 10.5281/zenodo.5500718]
 +
HEMCO 3.1.1
 +
*DOI: [https://doi.org/10.5281/zenodo.5504133 10.5281/zenodo.5504133]
  
===== v7-04-12 =====
+
|-valign="top"
INTERNAL RELEASE October 2007
+
|[[GEOS-Chem 13.2.0|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
 +
|
 +
*[[GEOS-Chem_13.2.0#1-month_benchmarks|1-month benchmarks]]
 +
*[[GEOS-Chem_13.2.0#1-year_full-chemistry_benchmarks|1-year full-chemistry benchmarks]]
 +
*[[GEOS-Chem_13.2.0#1-year_transport_tracers_benchmarks|1-year transport tracer benchmarks]]
 +
|GC Classic 13.2.0
 +
*DOI: [https://doi.org/10.5281/zenodo.5500536 10.5281/zenodo.5500536]
 +
GCHP 13.2.0
 +
*DOI: [https://doi.org/10.5281/zenodo.5500537 10.5281/zenodo.5500537]
 +
HEMCO 3.1.0
 +
*[https://doi.org/10.5281/zenodo.5504127 10.5281/zenodo.5504127]
  
We have already done the following 1-year benchmark simulations:
+
|}
  
 +
=== 13.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 and AMIs
  
==== 1-Year Benchmarks ====
+
|-valign="top"
 +
|[[GEOS-Chem 13.1.2|13.1.2]]
 +
|06 Jul 2021
 +
|See the [[GEOS-Chem 13.1.2]] page for a complete list of updates, including:
 +
*[https://github.com/geoschem/geos-chem/pull/764 Update dry-run download script download_data.py to fetch GCAP2 data from the U. Rochester server]
 +
*[https://github.com/geoschem/geos-chem/pull/728 Zero-diff updates required for CESM2-GC]*
 +
*Add .zenodo.json file for auto-filling of DOI fields
 +
|N/A
 +
|GC Classic 13.1.2
 +
*DOI: [https://doi.org/10.5281/zenodo.5075847 10.5281/zenodo.5075847]
 +
*AMI: ami-0491da4eeba0fe986
 +
GCHP 13.1.2
 +
*DOI: [https://doi.org/10.5281/zenodo.5075912 10.5281/zenodo.5075912]
  
=== Run0 ===
+
|-valign="top"
In directory: /as2/pub/ftp/pub/geos-chem/1yr_benchmarks/v7-04-12/geos4/2001/Run0
+
|[[GEOS-Chem 13.1.1|13.1.1]]
 +
|22 Jun 2021
 +
|See the [[GEOS-Chem 13.1.1]] page for a complete list of updates, including:
 +
*[https://github.com/geoschem/geos-chem/issues/685#issuecomment-861726437 Bug fix for PM2.5 diagnostic]
 +
*[https://github.com/geoschem/geos-chem/pull/749 GEOS-Chem updates for GEOS]
 +
*[https://github.com/geoschem/GCHP/issues/109 Enable GCHP to compile with GNU Fortran 10]
 +
*[https://github.com/geoschem/GCHP/issues/109 Expand support for GNU Fortran compilers to include version 10]
 +
*[https://github.com/geoschem/GCHP/issues/110 Fix bug in regex used for linking to ESMF]
 +
|N/A
 +
|GC Classic 13.1.1
 +
*DOI: [https://doi.org/10.5281/zenodo.5014891 10.5281/zenodo.5014891]
 +
GCHP 13.1.1
 +
*DOI: [https://doi.org/10.5281/zenodo.5014888 10.5281/zenodo.5014888]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 13.1.0|13.1.0]]
 +
|17 Jun 2021
 +
|See the [[GEOS-Chem 13.1.0]] page for a complete list of updates, including:
 +
*[https://github.com/geoschem/HEMCO/issues/46 Distribute CEDS emissions vertically in the boundary layer]
 +
*[https://pubs.acs.org/doi/10.1021/acs.est.8b07241 Diurnal scale factors of power plants emissions in China]
 +
*[https://github.com/geoschem/geos-chem/pull/689 Fix H2O boundary conditions at tropopause]
 +
*[https://gmd.copernicus.org/preprints/gmd-2021-144/ GCAP 2.0]
 +
*[https://github.com/geoschem/geos-chem/issues/700 Bug fix for nested grid simulations to read boundary conditions continuously]
 +
*[https://github.com/geoschem/GCHP/issues/55 Update GMAO submodules in GCHP]
 +
*[https://github.com/geoschem/MAPL/pull/9 Add monthly diagnostic capability to History for GCHP]
 +
*See also [https://github.com/geoschem/geos-chem/milestone/17?closed=1 geoschem/geos-chem: Milestone 13.1.0]
 +
|
 +
*[[GEOS-Chem_13.1.0#1-month_benchmarks|1-month benchmarks]]
 +
|GC Classic 13.1.0
 +
*DOI: [https://doi.org/10.5281/zenodo.4984436 10.5281/zenodo.4984436]
 +
GCHP 13.1.0
 +
*DOI: [https://doi.org/10.5281/zenodo.4984437 10.5281/zenodo.4984437]
 +
HEMCO 3.0.0
 +
*DOI: [https://doi.org/10.5281/zenodo.4984639 10.5281/zenodo.4984639]
 +
 
 +
|}
 +
 
 +
=== 13.0 ===
 +
 
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top" bgcolor="#cccccc"
 +
!width="75px"|Version
 +
!width="100px"|Released
 +
!width="360px"|Important features
 +
!width="200x"|Benchmarks
 +
!width="250px"|DOIs and AMIs
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 13.0.2|13.0.2]]
 +
|12 Apr 2021
 +
|See the [[GEOS-Chem 13.0.2]] page for a complete list of updates, including:
 +
*[https://github.com/geoschem/geos-chem/issues/686 Fix for bug introduced in 13.0.1 where met fields were only being read on the first timestep]
 +
|N/A
 +
|GC Classic 13.0.2
 +
*DOI: [https://doi.org/10.5281/zenodo.4681204 10.5281/zenodo.4681204]
 +
*AMI: ami-0c2e73f515de6386b
 +
GCHP 13.0.2
 +
*DOI: [https://doi.org/10.5281/zenodo.4681742 10.5281/zenodo.4681742]
 +
HEMCO 3.0.0-rc.3
 +
*DOI: [https://doi.org/10.5281/zenodo.4681191 10.5281/zenodo.4681191]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 13.0.1|13.0.1]]
 +
|23 Mar 2021
 +
|See the [[GEOS-Chem 13.0.1]] page for a complete list of updates, including:
 +
*[https://github.com/geoschem/geos-chem/issues/665 Use online dust emissions (DustDead) by default]
 +
*[https://github.com/geoschem/geos-chem/pull/661 Add several fixes for the GEOS-Chem Classic dry-run option]
 +
*[https://github.com/geoschem/geos-chem/issues/667 Force GEOS-Chem Classic restart file to match simulation date]
 +
*[https://github.com/geoschem/geos-chem/issues/669 Avoid "Is_Gas and Is_Aerosol are both false" error when adding new P/L species in KPP]
 +
|N/A
 +
|GC Classic 13.0.1
 +
*DOI: [https://doi.org/10.5281/zenodo.4632275 10.5281/zenodo.4632275]
 +
GCHP 13.0.1
 +
*DOI: [https://doi.org/10.5281/zenodo.4632276 10.5281/zenodo.4632276]
 +
HEMCO 3.0.0-rc.2
 +
*DOI: [https://doi.org/10.5281/zenodo.4632279 10.5281/zenodo.4632279]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 13.0.0|13.0.0]]
 +
|18 Mar 2021
 +
|See the [[GEOS-Chem 13.0.0]] page for a complete list of updates, including:
 +
*[https://github.com/geoschem/gchp/issues/63 Replace GCHP with a new wrapper repository (GCHPctm)]
 +
*[https://github.com/gcclassic Create new wrapper repository GCClassic]
 +
*[https://github.com/geoschem/geos-chem/pull/246 Separate HEMCO from GEOS-Chem to use as a git submodule in GCClassic and GCHP]
 +
*[https://github.com/geoschem/geos-chem/issues/283 Retire the GEOS-Chem Unit Tester repository]
 +
*[http://wiki.seas.harvard.edu/geos-chem/index.php/Compiling_with_CMake Retire the GNU Make and replace with CMake]
 +
*[https://gchp.readthedocs.io/en/latest/stretched-grid.html Enable a stretched grid capability in GCHP ]
 +
*[https://github.com/geoschem/geos-chem/issues/447 CEDS_GBD-MAPS emission inventory (1970 - 2017)]
 +
*[https://github.com/geoschem/geos-chem/issues/309 Retire carbon-based units for VOCs]
 +
*[https://github.com/geoschem/geos-chem/issues/332 Implement new tropchem simulation]
 +
*RRTMG updates (fix netCDF diagnostics; enable in GCHP)
 +
*See also [https://github.com/geoschem/geos-chem/milestone/8 geoschem/geos-chem: Milestone 13.0.0]
 +
|
 +
*[[GEOS-Chem_13.0.0#1-month_benchmarks|1-month benchmarks]]
 +
*[[GEOS-Chem_13.0.0#1-year_full-chemistry_benchmarks|1-year full-chemistry benchmarks]]
 +
*[[GEOS-Chem_13.0.0#1-year_transport_tracers_benchmarks|1-year transport tracers benchmarks]]
 +
*[[GEOS-Chem_13.0.0#10-year_stratospheric_benchmarks|10-year stratospheric benchmarks]]
 +
|GC Classic 13.0.0
 +
*DOI: [https://doi.org/10.5281/zenodo.4618180 10.5281/zenodo.4618180]
 +
GCHP 13.0.0
 +
*DOI [https://doi.org/10.5281/zenodo.4618205 10.5281/zenodo.4618205]
 +
|}
 +
 
 +
== GEOS-Chem 12 release series ==
 +
 
 +
Manual pages for the GEOS-chem 12 release series:
 +
 
 +
*[[Getting Started with GEOS-Chem]]
 +
*[[Getting Started with GCHP]]
 +
*[http://cloud.geos-chem.org Using GEOS-Chem on the AWS cloud]
 +
*[https://fugroup.org/index.php/WRF-GC#Getting_started Getting Started with WRF-GC]
 +
 
 +
=== 12.9 ===
 +
 
 +
{| 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"|DOI
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.9.3|12.9.3]]
 +
|06 Aug 2020
 +
|Bug fixes for minor issues discovered after the 12.9.2 release:
 +
*See also [https://github.com/geoschem/geos-chem/milestone/16?closed=1 geoschem/geos-chem: Milestone 12.9.3]
 +
|
 +
|[https://doi.org/10.5281/zenodo.3974569 10.5281/zenodo.3974569]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.9.2|12.9.2]]
 +
|24 Jul 2020
 +
|Bug fixes for GEOS-Chem dryrun option, CO2 simulations, PARANOX, complexSOA_SVPOA:
 +
*See also [https://github.com/geoschem/geos-chem/milestone/15?closed=1 geoschem/geos-chem: Milestone 12.9.2]
 +
|
 +
|[https://doi.org/10.5281/zenodo.3959279 10.5281/zenodo.3959279]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.9.1|12.9.1]]
 +
|17 Jul 2020
 +
|Bug fixes for GEOS-Chem dryrun option, Luo wetdep, and RCP emissions:
 +
*See also [https://github.com/geoschem/geos-chem/milestone/14?closed=1 geoschem/geos-chem: Milestone 12.9.1]
 +
|
 +
|[https://doi.org/10.5281/zenodo.3950473 10.5281/zenodo.3950473]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.9.0|12.9.0]]
 +
|17 Jul 2020
 +
|
 +
*[https://www.atmos-chem-phys.net/19/3981/2019/ Updated halogen chemistry]
 +
*[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]
 +
*Convert GEOS-Chem species database to YAML format,
 +
*See also [https://github.com/geoschem/geos-chem/milestone/10?closed=1 geoschem/geos-chem: Milestone 12.9.0]
 +
|
 +
*[[Benchmark/GEOS-Chem_12.9.0#GEOS-Chem_Classic_1-month_benchmark|1-month GCC]]
 +
*[[Benchmark/GEOS-Chem_12.9.0#GCHP_1-month_benchmark|1-month GCHP]]
 +
*[[Benchmark/GEOS-Chem_12.9.0#GEOS-Chem_Classic_1-year_benchmark|1-year GCC]]
 +
|[https://doi.org/10.5281/zenodo.3950327 10.5281/zenodo.3950327]
 +
 
 +
|}
 +
 
 +
=== 12.8 ===
 +
 
 +
{| 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"|DOI
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.8.2|12.8.2]]
 +
|27 May 2020
 +
|Bug fixes and updates for WRF-GC development
 +
*See also [https://github.com/geoschem/geos-chem/milestone/13?closed=1 geoschem/geos-chem: Milestone 12.8.2]
 +
|
 +
|[https://doi.org/10.5281/zenodo.3860693 10.5281/zenodo.3860693]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.8.1|12.8.1]]
 +
|21 May 2020
 +
|Fixes for several issues identified during 12.8.0 benchmarking (not affecting full-chemistry simulations):
 +
*See also [https://github.com/geoschem/geos-chem/milestone/12?closed=1 geoschem/geos-chem: Milestone 12.8.1]
 +
|
 +
|[https://doi.org/10.5281/zenodo.3837666 10.5281/zenodo.3837666]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.8.0|12.8.0]]
 +
|04 May 2020
 +
|
 +
*[https://www.atmos-chem-phys.net/19/9613/2019/ Isoprene chemistry]
 +
*[https://agupubs.onlinelibrary.wiley.com/doi/full/10.1002/2017GL075270 Wet deposition parameterization]
 +
*[https://www.atmos-chem-phys.net/20/4227/2020/ Ozone deposition to the ocean]
 +
*See also [https://github.com/geoschem/geos-chem/milestone/11?closed=1 geoschem/geos-chem: Milestone 12.8.0]
 +
|
 +
*[[Benchmark/GEOS-Chem_12.8.0#GEOS-Chem_Classic_1-month_benchmark|1-month GCC]]
 +
*[[Benchmark/GEOS-Chem_12.8.0#GCHP_1-month_benchmark|1-month GCHP]]
 +
*[[Benchmark/GEOS-Chem_12.8.0#GEOS-Chem_Classic_1-year_benchmark|1-year GCC]]
 +
*[[Benchmark/GEOS-Chem_12.8.0#1-year_Transport_Tracers_benchmarks|1-year transport]]
 +
|[https://doi.org/10.5281/zenodo.3784796 10.5281/zenodo.3784796]
 +
 
 +
|}
 +
 
 +
=== 12.7 ===
 +
 
 +
{| 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"|DOI
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.7.2|12.7.2]]
 +
|09 Mar 2020
 +
|Contains several bug fixes:
 +
*[https://github.com/geoschem/geos-chem/milestone/11?closed=1 geoschem/geos-chem: Milestone 12.7.2]
 +
|
 +
|[https://doi.org/10.5281/zenodo.3701669 10.5281/zenodo.3701669]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.7.1|12.7.1]]
 +
|03 Feb 2020
 +
|Contains several bug fixes:
 +
*[https://github.com/geoschem/geos-chem/milestone/9?closed=1 geoschem/geos-chem: Milestone 12.7.1]
 +
|
 +
|[https://doi.org/10.5281/zenodo.3676008 10.5281/zenodo.3676008]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.7.0|12.7.0]]
 +
|03 Feb 2020
 +
|Contains several science updates and bug fixes:
 +
*[https://github.com/geoschem/geos-chem/milestone/4?closed=1 geoschem/geos-chem: Milestone 12.7.0]
 +
|
 +
*[[Benchmark/GEOS-Chem_12.7.0#GEOS-Chem_Classic_1-month_benchmark|1-month GCC]]
 +
*[[Benchmark/GEOS-Chem_12.7.0#GCHP_1-month_benchmark|1-month GCHP]]
 +
*[[Benchmark/GEOS-Chem_12.7.0#1-year_Transport_Tracers_benchmarks|1-year GCC transport]]
 +
|[https://doi.org/10.5281/zenodo.3634864 10.5281/zenodo.3634864]
 +
 
 +
|}
 +
 
 +
=== 12.6 ===
 +
 
 +
{| 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"|DOI
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.6.3|12.6.3]]
 +
|25 Nov 2019
 +
|Contains GCHP bug fixes only: See:
 +
*[https://github.com/geoschem/gchp/milestone/2?closed=1 geoschem/gchp: Milestone 12.6.3]
 +
|
 +
|[https://doi.org/10.5281/zenodo.3552959 10.5281/zenodo.3552959]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.6.2|12.6.2]]
 +
|15 Nov 2019
 +
|Contains several bug fixes.  See:
 +
*[https://github.com/geoschem/geos-chem/milestone/6?closed=1 geoschem/geos-chem: Milestone 12.6.2]
 +
|
 +
|[https://doi.org/10.5281/zenodo.3543702 10.5281/zenodo.3543702]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.6.1|12.6.1]]
 +
|28 Oct 2019
 +
|Contains several bug fixes.  See:
 +
*[https://github.com/geoschem/geos-chem/milestone/5?closed=1 geoschem/geos-chem: Milestone 12.6.1]
 +
|
 +
|[https://doi.org/10.5281/zenodo.3520966 10.5281/zenodo.3520966]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.6.0|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
 +
|
 +
*[[Benchmark/GEOS-Chem_12.6.0#GEOS-Chem_Classic_1-month_benchmark|1-month GCC]]
 +
*[[Benchmark/GEOS-Chem_12.6.0#GCHP_1-month_benchmark|1-month GCHP]]
 +
*[[Benchmark/GEOS-Chem_12.6.0#GEOS-Chem_Classic_1-year_benchmark|1-year GCC]]
 +
|[https://doi.org/10.5281/zenodo.3507501 10.5281/zenodo.3507501]
 +
 
 +
|}
 +
 
 +
=== 12.5 ===
 +
 
 +
{| 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"|DOI
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.5.0|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
 +
|
 +
*[[Benchmark/GEOS-Chem_12.5.0#GEOS-Chem_Classic_1-month_benchmark|1-month GCC]]
 +
*[[Benchmark/GEOS-Chem_12.5.0#GCHP_1-month_benchmark|1-month GCHP]]
 +
|[https://doi.org/10.5281/zenodo.3403111 10.5281/zenodo.3403111]
 +
 
 +
|}
 +
 
 +
=== 12.4 ===
 +
 
 +
{| 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"|DOI
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.4.0|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.'''''
 +
|
 +
*[[Benchmark/GEOS-Chem_12.4.0#GEOS-Chem_Classic_1-month_benchmark|1-month GCC]]
 +
*[[Benchmark/GEOS-Chem_12.4.0#GCHP_1-month_benchmark|1-month GCHP]]
 +
*[[Benchmark/GEOS-Chem_12.4.0#GEOS-Chem_Classic_1-year_benchmark|1-year GCC]]
 +
|[https://doi.org/10.5281/zenodo.3360635 10.5281/zenodo.3360635]
 +
 
 +
|}
 +
 
 +
=== 12.3 ===
 +
 
 +
{| 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"|DOI
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.3.2|12.3.2]]
 +
|02 May 2019
 +
|
 +
*[[#Inconsistency in H2402 concentrations in GCHP vs GEOS-Chem Classic|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 [https://github.com/geoschem/gcpy GCPy]
 +
*[[Benchmark/GEOS-Chem_12.3.2#GEOS-Chem_Classic_1-month_benchmark|1-month GCC]]
 +
*[[Benchmark/GEOS-Chem_12.3.2#GCHP_1-month_benchmark|1-month GCHP]]
 +
|[https://doi.org/10.5281/zenodo.2658178 10.5281/zenodo.2658178]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.3.1|12.3.1]]
 +
|08 Apr 2019
 +
|
 +
*[[List_of_diagnostics_archived_to_netCDF_format#The_JValuesLocalNoon_collection|Fix for noontime J-values diagnostic]]
 +
*[[Planeflight_diagnostic#Planeflight_diagnostic_now_writes_out_data_for_the_last_timestep_of_the_day|Fix for planeflight diagnotic]]
 +
*[[Stratospheric_chemistry#Do not allocate memory to array MINIT in strat_chem_mod.F90|Don't allocate the MINIT array]]
 +
*[[GEOS-Chem 12#Declare State_Met%AREA_M2 as 2-dimensional, not 3-dimensional|Declare State_Met%AREA_M2 as 2-D]]
 +
|
 +
|[https://doi.org/10.5281/zenodo.2633278 10.5281/zenodo.2633278]
 +
 
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.3.0|12.3.0]]
 +
|01 Apr 2019
 +
|
 +
*[[ISORROPIA_II#Investigating_persistent_noise_observed_in_ISORROPIA_output|Update ISORROPIA from v2.0 to v2.2, in order to remove persistent noise in output]]
 +
*[[MEGAN_v2.1_plus_Guenther_2012_biogenic_emissions#Updated_PFT_file|Updated PFT file for MEGAN]]
 +
*[[Volcanic_SO2_emissions#Bug_fix_for_eruptive_volcanic_emissions|Bug fix for eruptive volcanic emissions]]
 +
*Read in and regrid existing MODIS LAI and OLSON data via HEMCO
 +
*Update from [[HEMCO_versions#HEMCO_development_history|HEMCO version]] 2.1.011 to 2.1.012
 +
*[[#GCHP_adjoint_development_requires_time_to_run_backwards_in_GCHP|Enable running time backwards in GCHP]]
 +
|This is the first benchmark to utilize [https://github.com/geoschem/gcpy GCPy]
 +
*[[Benchmark/GEOS-Chem_12.3.0|1-month GCC]]
 +
|[https://doi.org/10.5281/zenodo.2620535 10.5281/zenodo.2620535]
 +
 
 +
|}
 +
 
 +
=== 12.2 ===
 +
 
 +
{| 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"|DOI
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.2.1|12.2.1]]
 +
|28 Feb 2019
 +
|
 +
*[[#Bug fix: netCDF diagnostic collections with frequency "End" now properly span leap year days|Bug fix: netCDF diagnostic collections with frequency "End" now properly span leap year days]]
 +
*[[Mercury#Polar_bromine_explosion_default_option|Make polar bromine explosion the default option in Hg simulation]]
 +
*[[TOMAS_aerosol_microphysics#Biomass_burning_subgrid_coagulation_switch|Add biomass burning subgrid coagulation option]]
 +
*[[TOMAS_aerosol_microphysics#Restore_DST1.2C_DST2.2C_DST3.2C_and_DST4_in_TOMAS_simulations|Restore DST1, DST2, DST3, and DST4 in TOMAS]]
 +
*[[List_of_diagnostics_archived_to_netCDF_format|Add RRTMG fluxes to netCDF diagnostics]]
 +
*[[CO2_simulation#Prevent_double-counting_in_CO2_chemical_source|Fix for CO2 simulation chemical source]]
 +
*[[GEOS-Chem_12#Missing_scaling_factors_for_MERRA-2_simulations_with_GCHP|Missing scaling factors for MERRA-2 simulations with GCHP]]
 +
*[[GEOS-Chem_12#Use_online_sea_flux_emissions_by_default_in_GCHP|Use online sea flux emissions by default in GCHP]]
 +
|
 +
|[https://doi.org/10.5281/zenodo.2580198 10.5281/zenodo.2580198]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.2.0|12.2.0]]
 +
|19 Feb 2019
 +
|
 +
*[[Transport_Working_Group#Transport_Tracers_simulation|Transport Tracers simulation: a common set of tracers in GEOS-Chem and GEOS]]
 +
*[[ObsPack diagnostic]]
 +
*[[GFAS biomass burning emissions]]
 +
*[[GEOS-Chem_12#ESMF_version_update_required_for_MAPL_upgrade|Update ESMF version  in GCHP from v5.2.0rp2 to v7.1.0r]]
 +
|1st version to have the new [[Transport_Working_Group#Transport_Tracers_simulation|Transport Tracer benchmark]] (replaces Rn-Pb-Be benchmark)
 +
*[[GEOS-Chem_12_benchmark_history#12.2.0|1-month GCC]]
 +
*[[GEOS-Chem_12_benchmark_history#12.2.0-TransportTracers|1-year transport]]
 +
|[https://doi.org/10.5281/zenodo.2572887 10.5281/zenodo.2572887]
 +
 
 +
|}
 +
 
 +
=== 12.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"|DOI
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.1.1|12.1.1]]
 +
|13 Dec 2018
 +
|
 +
*[[Tagged CO simulation#Do not multiply emission timestep by 60|Bug fix for tagged CO]]
 +
*[[GEOS-Chem_12#Skip_planeflight_observations_outside_a_nested_domain|Skip planeflight observations outside a nested domain]]
 +
*[[GEOS-Chem_12#Always_enable_BCPH_TPBC_to_allow_saving_out_BC_files_in_global_simulations|Always compile with BCPH_TPBC=y]]
 +
*Fix compilation issues, see [https://github.com/geoschem/geos-chem/commit/096ad29d02afbdba64a5dd138df0c976ddee3140 (1)] & [https://github.com/geoschem/geos-chem/commit/f9b2f19593afeaa396ff3ee3d315148d5a6f8600 (2)]
 +
*[[GEOS-Chem_12#GCHP_transport_fix_to_prevent_instant_propagation_from_troposphere_to_stratosphere|GCHP transport fix]]
 +
|
 +
|[https://doi.org/10.5281/zenodo.2249246 10.5281/zenodo.2249246]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.1.0|12.1.0]]
 +
|26 Nov 2018
 +
|
 +
*[[List_of_diagnostics_archived_to_netCDF_format#The_Budget_collection|Budget diagnostics]]
 +
*[[Mineral_dust_aerosols#Anthropogenic_PM2.5_dust_source_in_GEOS-Chem|Anthropogenic PM2.5 dust source]]
 +
*[[GEOS-Chem_Output_Files#GEOS-Chem_12|GEOS-Chem restart file updates]]
 +
*[[CEDS_anthropogenic_emissions|Updates and fixes for the CEDS anthropogenic emissions inventory]]
 +
*[[Implementation_of_HEMCO_in_GEOS-Chem#Features_added_in_12.1.0|HEMCO fixes]]
 +
*[[Boundary_layer_mixing#Mass_is_not_conserved_when_using_non-local_PBL_mixing|Fix mass conservation in non-local PBL mixing]]
 +
*[[FlexGrid|FlexGrid Stage 1: Use HEMCO to read met fields]]
 +
*[[GEOS-Chem 12#Add support for continuous integration with TravisCI|Add support for continuous integration with TravisCI]]
 +
|
 +
*[[GEOS-Chem_12_benchmark_history#12.1.0|1-month GCC]]
 +
|[https://doi.org/10.5281/zenodo.1553349 10.5281/zenodo.1553349]
 +
 
 +
|}
 +
 
 +
=== 12.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"|DOI
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.0.3|12.0.3]]
 +
|16 Oct 2018
 +
|
 +
*[[#Fix_incorrect_run_configuration_for_offline_sea_salt_emissions_in_GCHP|Fix incorrect run configuration for offline sea salt emissions in GCHP]]
 +
*[[#Fix_bug_in_application_of_CFC_surface_mixing_ratios_in_GCHP|Fix bug in application of CFC surface mixing ratios in GCHP]]
 +
|
 +
|[https://doi.org/10.5281/zenodo.1464210 10.5281/zenodo.1464210]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.0.2|12.0.2]]
 +
|10 Oct 2018
 +
|
 +
*[[GEOS-Chem 12#Fixed_local-time_averaging_in_ND51_and_ND51b_satellite_timeseries_diagnostics|Bug fixes for ND51/ND51b diagnostics]]
 +
*[[TOMAS_aerosol_microphysics#Fixes_for_missing_biomass_emissions_and_incorrect_aerosol_dry_deposition|Bug fixes for TOMAS simulations]]
 +
*[[CO2_simulation#CO2_emissions_are_double_counted|Bug fix for CO2 simulations]]
 +
|
 +
|[https://doi.org/10.5281/zenodo.1455215 10.5281/zenodo.1455215]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.0.1|12.0.1]]
 +
|24 Aug 2018
 +
|
 +
*[[Mercury#Restore_biomass_emissions_and_do_not_double_count_anthropogenic_emissions|Bug fixes for mercury simulation]]
 +
*[[Intel_Fortran_Compiler#Compilation_issues_with_Intel_Fortran_18|Compatibility with IFORT 18]]
 +
*[[GNU_Fortran_compiler#Compiliation_issues_with_GNU_Fortran_8.2.0|Compatibility with GNU Fortran 8.2.0]]
 +
|
 +
|[https://doi.org/10.5281/zenodo.1403144 10.5281/zenodo.1403144]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.0.0|12.0.0]]*<br>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]]
 +
*[[GEOS-Chem_12_benchmark_history#12.0.0|1-month GCC]]
 +
*[[GEOS-Chem_12_benchmark_history#12.0.0-Run0|1-year GCC]]
 +
|[https://doi.org/10.5281/zenodo.1343547 10.5281/zenodo.1343547]
 +
 
 +
|}
 +
 
 +
== GEOS-Chem 11 release series ==
 +
 
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top" bgcolor="#cccccc"
 +
!width="75px"|Version
 +
!width="100px"|Date released
 +
!width="360px"|Important features
 +
!width="200px"|Benchmarks
 +
!width="250px"|Documentation
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v11-02|v11-02-rc]]
 +
|22 Jun 2018
 +
|
 +
*[[GEOS-Chem_HP|GCHP option]]
 +
*[[Halogen_chemistry_mechanism|Halogen chemistry]]
 +
*[[GEOS-Chem_chemistry_mechanisms#Updated_isoprene_and_monoterpene_chemistry|Updated isoprene & monoterpene chemistry]]
 +
*[[Secondary_organic_aerosols#Simple_SOA_scheme|Simple SOA scheme]]
 +
*[[PAN|Updated PAN chemistry]]
 +
*[[GEOS-Chem_v11-02#v11-02f|Several new and updated emissions inventories]]
 +
*[[GEOS-Chem_Output_Files#NetCDF_File_Format|NetCDF diagnostic output]]
 +
|
 +
*[[GEOS-Chem v11-02 benchmark history|v11-02 benchmark history page]]
 +
|
 +
*[https://geoschem.github.io/gcclassic-manpage-archive/man.GC_12/index.html v11-02/12.0.0 manual]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v11-01|v11-01]]
 +
|20 Dec 2016 (provisional)<br>01 Feb 2017 (public)
 +
|
 +
*[[FlexChem]]
 +
*[[MERRA-2]]
 +
*[[GEOS-Chem_species_database|Species Database]]
 +
*[[Moisture_Updates_in_v11-01|Air moisture fixes and updates]]
 +
*[[GNU_Fortran_compiler|Compatibility with the GNU Fortran compiler]]
 +
*[[GEOS-Chem_v11-01#New_data_directories|Updated emissions]]
 +
*[[GEOS-Chem_Output_Files#NetCDF_File_Format|NetCDF restart files]]
 +
|
 +
*[[GEOS-Chem v11-01 benchmark history|v11-01 benchmark history page]]
 +
|
 +
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v11-01/index.html v11-01 manual]
 +
 
 +
|}
 +
 
 +
== GEOS-Chem 10 release series ==
 +
 
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top" bgcolor="#cccccc"
 +
!width="75x"|Version
 +
!width="100px"|Date released
 +
!width="360px"|Important features
 +
!width="200px"|Benchmarks
 +
!width="250px"|Documentation
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v10-01|v10-01]]
 +
|01 May 2015 (provisional)<br>17 Jun 2015 (public)
 +
|
 +
*[[UCX chemistry mechanism]]
 +
*[[HEMCO]]
 +
*[[Coupling_GEOS-Chem_with_RRTMG|Online radiative transfer]]
 +
|
 +
*[[GEOS-Chem v10-01 benchmark history|v10-01 benchmark history page]]
 +
|
 +
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v10-01/index.html v10-01 manual]
 +
 
 +
|}
 +
 
 +
== GEOS-Chem 9 release series ==
 +
 
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top" bgcolor="#cccccc"
 +
!width="75px"|Version
 +
!width="100px"|Date released
 +
!width="360px"|Important features
 +
!width="200px"|Benchmarks
 +
!width="250px"|Documentation
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v9-02|v9-02]]
 +
|17 Jan 2014 (provisional)<br>03 Mar 2014 (public)
 +
|
 +
*[[Hudman et al 2012 soil NOx emissions algorithm|Updated soil NOx emissions module]]
 +
*[[POPs simulation]]
 +
*[[Updating standard chemistry with JPL_10-6|Inorganic chemistry updates]]
 +
*[[Methyl peroxy nitrate chemistry]]
 +
*[[New isoprene scheme|Adopt Paulot isoprene scheme as standard]]
 +
*[[Historical and Future Emissions#RCP future emission scenarios|RCP emission scenarios]]
 +
*[[Aircraft_emissions#MIT_aviation_emissions_inventory|AEIC aircraft emissions inventory]]
 +
*[[GEOS-FP|GEOS-FP met fields]]
 +
|
 +
*[[GEOS-Chem v9-02 benchmark history|v9-02 benchmark history page]]
 +
|
 +
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v9-02/index.html v9-02 manual]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v9-01-03|v9-01-03]]
 +
|14 Sep 2012
 +
|
 +
*[[Acetone|Updated acetone sources & sinks]]
 +
*Improved sea salt [[Sea salt aerosols#SST dependent sea salt emissions|emission]] & [[Sea salt aerosols#Updates to sea salt dry deposition|deposition]]
 +
*Improved [[Wet_deposition#Add_scavenging_by_snow|snow scavenging]] and [[Wet deposition#Updates for aerosol scavenging efficiency|washout parameterization]]
 +
*[[Bromine chemistry mechanism|Tropospheric bromine chemistry]]
 +
*[[Stratospheric chemistry|Stratospheric P and k (monthly climatological)]]
 +
|
 +
*[[GEOS-Chem v9-01-03 benchmark history|v9-01-03 benchmark history page]]
 +
|
 +
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v9-01-03/index.html v9-01-03 manual]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v9-01-02|v9-01-02]]
 +
|28 Nov 2011
 +
|
 +
*[[APM aerosol microphysics]]
 +
*[[Biomass burning emissions#GFED3|GFED3 biomass emissions]]
 +
*[[Implementation of RETRO Anthropogenic Emissions|RETRO Anthropogenic Emissions]]
 +
*[[GEOS-Chem v9-01-02#Previous issues now resolved in v9-01-02|Various fixes to correct several identified issues]]
 +
|
 +
*[[GEOS-Chem v9-01-02 benchmark history|v9-01-02 benchmark history page]]
 +
|
 +
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v9-01-02/index.html v9-01-02 manual]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v9-01-01|v9-01-01]]
 +
|07 Jun 2011
 +
|
 +
*Compatibility with the GMAO [[MERRA|MERRA met data product]]
 +
*Updated lightning NOx; various fixes
 +
|
 +
*[[GEOS-Chem v9-01-01 benchmark history|v9-01-01 benchmark history page]]
 +
|
 +
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v9-01-01/index.html v9-01-01 manual]
 +
 
 +
|}
 +
 
 +
== GEOS-Chem 8 release series ==
 +
 
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top" bgcolor="#cccccc"
 +
!width="75px"|Version
 +
!width="100px"|Date released
 +
!width="360px"|Important features
 +
!width="200px"|Benchmarks
 +
!width="250px"|Documentation
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v8-03-02|v8-03-02]]
 +
|07 Sep 2010
 +
|Updated Hg and CO2 simulations
 +
|
 +
*Archived to storage; contact [[GCST]]
 +
|
 +
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-03-02/index.html v8-03-02 manual]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v8-03-01|v8-03-01]]
 +
|04 May 2010
 +
|
 +
*ISORROPIA II
 +
*TOMAS microphysics option
 +
*Updates to SOA and photolysis
 +
|
 +
*Archived to storage; contact [[GCST]]
 +
|
 +
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-03-01/index.html GC v8-03-01 manual]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v8-02-04|v8-02-04]]
 +
|24 Feb 2010
 +
|
 +
*LINOZ strat chemistry
 +
*NEI2005 anthro emissions
 +
*MEGAN v2.1 biogenic emissions
 +
|
 +
*Archived to storage; contact [[GCST]]
 +
|
 +
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-02-01/index.html GC v8-02-04 manual]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v8-02-03|v8-02-03]]
 +
|Oct 2009
 +
|
 +
*KPP solver
 +
*ICOADS emissions
 +
*Updated makefile structure
 +
|
 +
*Archived to storage; contact [[GCST]]
 +
|
 +
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-02-01/index.html GC v8-02-03 manual]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v8-02-02|v8-02-02]]
 +
|08 Jun 2009
 +
|
 +
*Non-local PBL mixing scheme
 +
*Updated Bond BC & OC emissions
 +
|
 +
*Archived to storage; contact [[GCST]]
 +
|
 +
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-02-01/index.html GC v8-02-02 manual]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v8-02-01|v8-02-01]]
 +
|26 May 2009
 +
|
 +
*Updated chemistry & photolysis reactions
 +
*Glyoxal chemistry mechanism
 +
|
 +
*Archived to storage; contact [[GCST]]
 +
|
 +
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-02-01/index.html GC v8-02-01 manual]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v8-01-04|v8-01-04]]
 +
|10 Mar 2009
 +
|
 +
*Various emissions updates (regional & global inventories)
 +
*GFED2 biomass emissions updates
 +
|
 +
*Archived to storage; contact [[GCST]]
 +
|
 +
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-01-04/index.html GC v8-01-04 manual]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v8-01-03|v8-01-03]]
 +
|Dec 2008
 +
|
 +
*Installation of GMI TPCORE routine
 +
|
 +
*Archived to storage; contact [[GCST]]
 +
|
 +
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-01-04/index.html GC v8-01-03 manual]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v8-01-02|v8-01-02]]
 +
|Nov 2008
 +
|
 +
*Nested grid simulations for 0.5&deg; x 0.666&deg;
 +
|
 +
*Archived to storage; contact [[GCST]]
 +
|
 +
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-01-04/index.html GC v8-01-02 manual]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v8-01-01|v8-01-01]]
 +
|May 2008
 +
|
 +
*Capability to run with GEOS-5 met fields
 +
|
 +
*Archived to storage; contact [[GCST]]
 +
|
 +
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-01-04/index.html GC v8-01-01 manual]
 +
 
 +
|}
 +
 
 +
== GEOS-Chem 7 release series ==
 +
 
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top" bgcolor="#cccccc"
 +
!width="75px"|Version
 +
!width="100px"|Date released
 +
!width="360px"|Important features
 +
!width="200px"|Benchmarks
 +
!width="250px"|Documentation
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v7-04-13|v7-04-13]]
 +
|Nov 2007
 +
|
 +
*H2/HD simulation
 +
*Bug fixes in SMVGEAR, lightning, and dynamic tropopause
 +
|
 +
*Archived to storage; contact [[GCST]]
 +
|
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v7-04-12|v7-04-12]]
 +
|Oct 2007
 +
|
 +
*Introduction of dynamic tropopause
 +
|
 +
*Archived to storage; contact [[GCST]]
 +
|
 +
 
 +
|-valign="top"
 +
|v7-04-11 and earlier
 +
|March 2006 and earlier
 +
|
 +
|
 +
*Archived to storage; contact [[GCST]]
 +
|
 +
 
 +
|}
  
  * Run w/ 4x5 GEOS-4 for met field year 2001 (spun up thru 2000 & 1999)
+
== GEOS-Chem benchmarking information ==
  * with G-C "old" fossil fuel (GEIA + EPA/NEI99)
+
  * with G-C "default" climatological biomass burning
+
  * with old lightning parameterization
+
  * with MEGAN biogenic emissions
+
  * with SMVGEAR chemistry up to dynamic tropopause
+
  * with new dust emissions (w/ GOCART source function)
+
  * with new TOMS/SBUV ozone columns for FAST-J photolysis
+
  * with variable tropopause on
+
  
=== Run1 ===
+
=== GEOS-Chem Benchmarking Procedure ===
In directory: /as2/pub/ftp/pub/geos-chem/1yr_benchmarks/v7-04-12/geos4/2005/Run1
+
  
  * Run w/ 4x5 GEOS-4 for met field year 2005 (spun up thru 2003 & 2004)
+
For a complete description about the the standard 1-month and 1-year benchmark simulations, please see our [[GEOS-Chem_benchmarking|''GEOS-Chem Benchmarking'' wiki page]].
  * with G-C "old" fossil fuel (GEIA + EPA/NEI99)
+
  * with G-C "default" climatological biomass burning
+
  * with old lightning parameterization
+
  * with MEGAN biogenic emissions
+
  * with SMVGEAR chemistry up to dynamic tropopause
+
  * with new dust emissions (w/ GOCART source function)
+
  * with new TOMS/SBUV ozone columns for FAST-J photolysis
+
  * with variable tropopause on
+
 
+
=== Run2 ===
+
In directory: /as2/pub/ftp/pub/geos-chem/1yr_benchmarks/v7-04-12/geos4/2005/Run2
+
  
  * Run w/ GEOS-4 for met field year 2005 (spun up thru 2003 & 2004)
+
=== Mean OH from GEOS-Chem 1-year benchmark simulations ===
  * with G-C "old" fossil fuel (GEIA + EPA/NEI99)
+
  * with G-C "default" climatological biomass burning
+
  * with new lightning parameterization (with OTD/LIS v2 regional redistribution of flashes)
+
  * with MEGAN biogenic emissions
+
  * with SMVGEAR chemistry up to dynamic tropopause
+
  * with new dust emissions (w/ GOCART source function)
+
  * with new TOMS/SBUV ozone columns for FAST-J photolysis
+
  * with variable tropopause on
+
  
=== Results ===
+
Please see [[Mean_OH_concentration#Evolution_of_mean_OH_in_GEOS-Chem|our ''Evolution of mean OH in GEOS-Chem'' wiki page]].
  
==== Release Notes ====
+
=== Global burden history ===
1. [[wiki:geos-chem:dev_forum|Variable tropopause]] has bug fix from v7-04-11 but not 200 hPa cap at polar latitudes
+
  
2. NOTE: There is a bug in this version when [[wiki:geos-chem:lightning_forum|lightning emissions are turned off]].  The bug will be fixed in [[wiki:geos-chem:dev_forum#v7-04-13|v7-04-13]].  For the time being, if you must turn lighting emissions off in v7-04-12, please do this by setting FLASHRATE = 0 in the lightning_nox_nl_mod.f.
+
Please see [[Global_Burden_History|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 ===
  
===== Return to Menu =====
+
For an overview of GEOS-Chem 1-month benchmark timing results, please see our [[GEOS-Chem 1-month benchmark timing results|''GEOS-Chem 1-month benchmark timing results'' wiki page]].
  * [[:start|Go to Harvard Atmospheric Sciences Wiki Home]]
+
  * [[wiki:basics|Go to "The Basics" Menu]]
+
  * [[wiki:idl|Go to IDL Menu]]
+
  * [[wiki:geos-chem|Go to GEOS-Chem Menu]]
+
  * [[wiki:computer_and_network_info|Go to Network Resources Menu]]
+

Latest revision as of 20:04, 20 September 2022

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

14.0

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.

Version Released Important features Benchmarks DOIs & AMIs
14.0.0 TBA See the GEOS-Chem 14.0.0 page for more information on these fixes:
  • 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
  • DOI: TBA
  • AMI: TBA

GCHP 14.0.0

  • DOI: TBA

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 more information on these fixes:
  • 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 more information on these updates:

  • 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 more information on these updates:

  • 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 more information on these updates:

GCHP 13.3.3

HEMCO 3.2.2

13.3.2 18 Nov 2021

See the GEOS-Chem 13.3.2 page for more information on these updates:

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