GEOS-Chem versions: Difference between revisions

From Geos-chem
Jump to navigation Jump to search
No edit summary
 
(573 intermediate revisions by 8 users not shown)
Line 1: Line 1:
'''NOTE: Information subject to change.  Please check back here often for the latest information.'''
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-02-01 ==
== GEOS-Chem development history ==
CHEMISTRY RELEASE date TBD


Will contain everything in [[#v8-01-04|v8-01-04]] plus the following:
In the tables below, we list information about current and past GEOS-Chem releases.


#Glyoxal chemistry (May Fu)
Some notes for the tables below:
#Updated J(O1D) cross sections (Lin Zhang)
*Information about benchmarks can be found by following the links in the "Benchmarks" column
#Updated reaction rates (Jingqiu Mao)
*GCC = GEOS-hem "Classic" (uses OpenMP parallelization single node only)
#HO2 uptake (Lyatt Jaegle)
*GCHP = GEOS-Chem High Performance (uses MPI parallelization across multiple nodes)
#Updated dust single scattering albedo (Randall Martin)
*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-04 ==
Also see our [[GEOS-Chem version numbering system]] wiki page for information on how GEOS-Chem versions are labeled.
EMISSIONS RELEASE date TBD


Will contain everything in [[#v8-01-03|v8-01-03]] plus the following updates:
== GEOS-Chem benchmarking information ==


# Annual scale factors for NOx-CO-SOx from, applied to ALL inventory if needed (Aaron)
=== GEOS-Chem Benchmarking Procedure ===
# Daily NOx variability from EDGAR applied to all others anthro NOx inventories
# Several emissions updates
#* Streets 2006, with monthly variability
#* EMEP 1990-2005 w/ ship emissions separated
#* Canadian CAC,
#* EPA fixes = CA transport + Rynda scaling,
#* VISTAS/ARP for NOx in the USA
#* MEGAN2
# new EPA mask (Overlap Bravo/Epa and CAC/Epa)
# ship NOx emitted as HNO3 + 10*O3
# pre-Arctas SO2 ship emissions from Streets
# GFED2 biomass options:
#* Monthly mean (as was in the code previously)
#* 8-day mean
#* 3-hourly mean (selected months only)
#* 3-hourly synoptic (selected months only)


=== 1-year benchmarks ===
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]].


==== Run0 - v8-01-04 ====
=== Mean OH from GEOS-Chem 1-year benchmark simulations ===


The 3 models compared (and their colors on the plots) were:
Please see [[Mean_OH_concentration#Evolution_of_mean_OH_in_GEOS-Chem|our ''Evolution of mean OH in GEOS-Chem'' wiki page]].
 
=== Global burden history ===
 
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 ===
 
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]].
 
== GEOS-Chem 14 release series ==
 
* Please see our [[GEOS-Chem no-diff-to-benchmark]] wiki page for information about updates that can be merged at any time. 
* [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. 
* See our list of [[Software maintained by GEOS-Chem community members|software tools maintained by GEOS-Chem users]].
 
=== 14.6 ===
 
{| border=1 cellspacing=0 cellpadding=5
|-valign="top" bgcolor="#cccccc"
!width="100px"|Version / Date
!width="350px"|Important features
!width="150px"|Benchmarks
!width="375px"|DOIs
 
|-valign="top"
|[[GEOS-Chem 14.6.0|'''14.6.0''']]<br>TBD
|TBD
|TBD
|TBD


{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#CCCCCC"
! Color
! Quantity Plotted
! Met Field Type
! A.T.E. algorithm
! Anthro Emissions
! Advection
|-align="center"
| Red 
| [[#Run0|v8-01-01 Run1]]
| GEOS-5 4x5
| [[Aerosol_thermodynamical_equilibrium#ISORROPIA|ISORROPIA]]
| GEIA/Piccot (scale year 1998)<br>EPA/NEI99 w/o ICARTT fix<br>EDGAR ship emissions
| "old" tpcore
|-align="center"                                   
| Green
| [[#v8-01-01|v8-01-01 Run1]] 
| GEOS-5 4x5
| [[Aerosol_thermodynamical_equilibrium#RPMARES|RPMARES]]
| GEIA/Piccot (scale year 1998)<br>EPA/NEI99 w/o ICARTT fix<br>EDGAR ship emissions
| "old" tpcore
|-align="center"
| Blue 
| [[#Run0 - v8-01-04|v8-01-04-Run0]]   
| GEOS-5 4x5
| [[Aerosol_thermodynamical_equilibrium#RPMARES|RPMARES]]
| GEIA/Piccot (scale year 1998)<br>EPA/NEI99 w/o ICARTT fix<br>EDGAR ship emissions
| "new" tpcore
|-align="center"
| Black
| Observations           
| &nbsp;         
| &nbsp;
| &nbsp;
| &nbsp;
|}
|}


NOTES for Run0:
=== 14.5 ===
# This benchmark uses the same input conditions v8-01-01.  
 
# All runs use the same biomass (GFED2 monthly), biofuel, biogenic (MEGAN), lightning, and aircraft emissions.
{| border=1 cellspacing=0 cellpadding=5
|-valign="top" bgcolor="#cccccc"
!width="100px"|Version / Date
!width="350px"|Important features
!width="150px"|Benchmarks
!width="375px"|DOIs
 
|-valign="top"
|[[GEOS-Chem 14.5.1|'''14.5.1''']]<br>TBD
|TBD
|TBD
|TBD
 
|-valign="top"
|[[GEOS-Chem 14.5.0|'''14.5.0''']]<br>08 Nov 2024
|See the [[GEOS-Chem 14.5.0]] page for a complete list of updates, including:
* Chemistry for RCOOH, ANs, PNs (and corresponding emissions updates)
* PPN photolysis
* Cloud-J 8.0.1 (with UV H2O absorption)
|
* [[GEOS-Chem_14.5.0#1-month_full-chemistry_benchmarks|1-month fullchem]]
* [[GEOS-Chem_14.5.0#1-year_full-chemistry_benchmarks|1-year fullchem]]
|
* GCClassic 14.5.0 ([https://doi.org/10.5281/zenodo.14057421 10.5281/zenodo.14057421])
* GCHP 14.5.0 ([https://doi.org/10.5281/zenodo.14058309 10.5281/zenodo.14058309])
* GEOS-Chem 14.5.0 ([https://doi.org/10.5281/zenodo.14057314 10.5281/zenodo.14057314])
* HEMCO 3.10.0 ([https://doi.org/10.5281/zenodo.14057188 10.5281/zenodo.14057188])
* Cloud-J 8.0.1 ([https://doi.org/10.5281/zenodo.13862693 10.5281/zenodo.13862693])
 
|}
 
=== 14.4 ===
 
{| border=1 cellspacing=0 cellpadding=5
|-valign="top" bgcolor="#cccccc"
!width="100px"|Version / Date
!width="350px"|Important features
!width="150px"|Benchmarks
!width="375px"|DOIs
 
|-valign="top"
|[[GEOS-Chem 14.4.3|'''14.4.3''']]<br>24 Jul 2024
|See the [[GEOS-Chem 14.4.3]] page for a complete list of updates, including:
* Fix a significant performance bottleneck in Cloud-J
* Other minor bug fixes
|N/A
|
* GCClassic 14.4.3 ([https://doi.org/10.5281/zenodo.12809895 10.5281/zenodo.12809895])
* GCHP 14.4.3 ([https://doi.org/10.5281/zenodo.4428926 10.5281/zenodo.4428926])
* GEOS-Chem 14.4.3 ([https://doi.org/10.5281/zenodo.12807579 10.5281/zenodo.12807579])
* HEMCO 3.9.3 ([https://doi.org/10.5281/zenodo.12807295 10.5281/zenodo.12807295])
* Cloud-J 7.7.3 ([https://doi.org/10.5281/zenodo.13308354 10.5281/zenodo.13308354])
 
|-valign="top"
|[[GEOS-Chem 14.4.2|'''14.4.2''']]<br>24 Jul 2024
|See the [[GEOS-Chem 14.4.2]] page for a complete list of updates, including:
* Updates for GEOS-Chem in CESM
* Other minor bug fixes
|N/A
|
*GCClassic 14.4.2 ([https://doi.org/10.5281/zenodo.12809895 10.5281/zenodo.12809895])
*GCHP 14.4.2 ([https://doi.org/10.5281/zenodo.4428926 10.5281/zenodo.4428926])
*GEOS-Chem 14.4.2 ([https://doi.org/10.5281/zenodo.12807579 10.5281/zenodo.12807579])
*HEMCO 3.9.2 ([https://doi.org/10.5281/zenodo.12807295 10.5281/zenodo.12807295])
*Cloud-J 7.7.2 ([https://doi.org/10.5281/zenodo.12734993 10.5281/zenodo.12734993])


==== Run1 - v8-01-04 ====
|-valign="top"
|[[GEOS-Chem 14.4.1|'''14.4.1''']]<br>28 Jun 2024
|See the [[GEOS-Chem 14.4.1]] page for a complete list of updates, including:
*Fix slowdown in 14.4.0 runs caused by reading met fields and nested-grid boundary conditions more frequently than necessary
*Updates for GEOS-Chem in CESM
*GCHP run directory fixes and improvements
|N/A
|
*GCClassic 14.4.1 ([https://doi.org/10.5281/zenodo.12584192 10.5281/zenodo.12584192])
*GCHP 14.4.1 ([https://doi.org/10.5281/zenodo.12584305 10.5281/zenodo.12584305])
*GEOS-Chem 14.4.1 ([https://doi.org/10.5281/zenodo.12583924 10.5281/zenodo.12583924])
*HEMCO 3.9.1 ([https://doi.org/10.5281/zenodo.12583796 10.5281/zenodo.12583796])


The 3 models compared (and their colors on the plots) were:
|-valign="top"
|[[GEOS-Chem 14.4.0|'''14.4.0''']]<br>31 May 2024
|See the [[GEOS-Chem 14.4.0]] page for a complete list of updates, including:
*HETP aerosol thermodynamics
*GCHP carbon simulation
*Parameterized Reff for SNA and OM aerosols
*Updated gravitational settling, diameters, hyg growth in aerosol drydep
*Only convert units for species that require it
|
*[[GEOS-Chem_14.4.0#1-month_full-chemistry_benchmarks|1-month fullchem]]
*[[GEOS-Chem_14.4.0#1-year_full-chemistry_benchmarks|1-year fullchem]]
|
*GCClassic 14.4.0 ([https://doi.org/10.5281/zenodo.11403303 10.5281/zenodo.11403303])
*GCHP 14.4.0 ([https://doi.org/10.5281/zenodo.11403806 10.5281/zenodo.11403806])
*GEOS-Chem 14.4.0 ([https://doi.org/10.5281/zenodo.11397786 10.5281/zenodo.11397786])
*HEMCO 3.9.0 ([https://doi.org/10.5281/zenodo.11397565 10.5281/zenodo.11397565])


{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#CCCCCC"
! Color
! Quantity Plotted
! Met Field Type
! A.T.E. algorithm
! Anthro Emissions
! Advection
|-align="center"                                   
| Red
| [[#v8-01-01|v8-01-01 Run1]] 
| GEOS-5 4x5
| [[Aerosol_thermodynamical_equilibrium#RPMARES|RPMARES]]
| GEIA/Piccot (scale year 1998)<br>EPA/NEI99 w/o ICARTT fix<br>EDGAR ship emissions
| "old" tpcore
|-align="center"
| Green 
| [[#Run0.2|v8-01-04 Run0]]
| GEOS-5 4x5
| [[Aerosol_thermodynamical_equilibrium#RPMARES|RPMARES]]
| GEIA/Piccot (scale year 1998)<br>EPA/NEI99 w/o ICARTT fix<br>EDGAR ship emissions
| "new" tpcore
|-align="center"
| Blue
| [[#Run0|v8-01-04 Run1]]
| GEOS-5 4x5
| [[Aerosol_thermodynamical_equilibrium#RPMARES|RPMARES]]
| GEIA/Piccot<br>EDGAR emissions<br>EMEP European emissions<br>BRAVO Mexican emissions<br>David Streets 2006 emissions<br>CAC Canadian emissions<br>EPA/NEI99 with ICARTT fix<br>EDGAR ship emissions<br>ARCTAS ship SO2 emissions<br>Anthro scale year 2005
| "new" tpcore
|-align="center"
| Black
| Observations           
| &nbsp;         
| &nbsp;
| &nbsp;
| &nbsp;
|}
|}


NOTES for Run0:
=== 14.3 ===
# This benchmark uses the same input conditions v8-01-01.
# All runs use the same biomass (GFED2 monthly), biofuel, biogenic (MEGAN), lightning, and aircraft emissions.


== v8-01-03 ==
{| border=1 cellspacing=0 cellpadding=5
BETA RELEASE December 2008
|-valign="top" bgcolor="#cccccc"
!width="100px"|Version / Date
!width="350px"|Important features
!width="150px"|Benchmarks
!width="375px"|DOIs


Contains everything in [[#v8-01-02|v8-01-02]] plus the following updates:
|-valign="top"
|[[GEOS-Chem 14.3.1|'''14.3.1''']]<br>02 Apr 2024
|See the [[GEOS-Chem 14.3.1]] page for a complete list of updates, including:
*Updating CH4 emissions from EDGARv7 to EDGARv8
*Adding budget diagnostic option for fixed level vertical region
*Fixes to restore proper handling of NEI 3D emissions
*ObsPack bug fixes
*Fixing bug in transport tracer pressure mask criteria affecting tracer st80_25


* [[Previous issues now resolved in v8-01-03#TPCORE replaced with version based on GMI model|Installation of new version of TPCORE (based on GMI model) to fix polar overshoot in stratosphere]]
|N/A
* [[Previous issues now resolved in v8-01-03#Output of ND51 does not match output in the ctm.bpch file|Minor bug fix for ND51 diagnostic]]
|
* [[Previous issues now resolved in v8-01-03#Bug fixes in diag3.f|Minor bug fixes in diag3.f]]
* GCClassic 14.3.1 ([https://doi.org/10.5281/zenodo.10909023 10.5281/zenodo.10909023])
* [[Previous_issues_now_resolved_in_v8-01-03#Change_of_location_of_calls_to_diagnostics_in_main.f|Minor diagnostic fixes in main.f]]
* GCHP 14.3.1 ([https://doi.org/10.5281/zenodo.10909030 10.5281/zenodo.10909030])
* GEOS-Chem 14.3.1 ([https://doi.org/10.5281/zenodo.10908999 10.5281/zenodo.10908999])
* HEMCO 3.8.1 ([https://doi.org/10.5281/zenodo.10909004 10.5281/zenodo.10909004])


== v8-01-02 ==
|-valign="top"
BETA RELEASE November 2008
|[[GEOS-Chem 14.3.0|'''14.3.0''']]<br>09 Feb 2024
|See the [[GEOS-Chem 14.3.0]] page for a complete list of updates, including:
*Update reactions with new JPL & IUPAC recommendations
*Add capability for TOMAS simulations in GCHP
*Use Cloud-J for computing photolysis rates as default
*GEOS-IT meteorology
|
*[[GEOS-Chem_14.3.0#1-month_full-chemistry_benchmarks|1-month fullchem]]
*[[GEOS-Chem_14.3.0#1-year_full-chemistry_benchmarks|1-year fullchem]]
|
*GCClasssic 14.3.0 ([https://doi.org/10.5281/zenodo.10640536 10.5281/zenodo.10640536])
*GCHP 14.3.0 ([https://doi.org/10.5281/zenodo.10640559 10.5281/zenodo.10640559])
*GEOS-Chem 14.3.0 ([https://doi.org/10.5281/zenodo.10640383 10.5281/zenodo.10640383])
*HEMCO 3.8.0 ([https://doi.org/10.5281/zenodo.10640447 10.5281/zenodo.10640447])


Contains everything in [[#v8-01-01|v8-01-01]], with the following additions:
|}


* GEOS-5 0.5 x 0.666 degree nested-grid simulation for China/SE Asia
=== 14.2 ===
* Improvements to the GEOS-3 1x1 nested-grid simulation for N. America
* Modifications for using reprocessed GEOS-5 met fields (i.e. w/ corrected optical depths)
* [[Previous issues now resolved in v8-01-02|Several bug fixes and improvements for robustness, scientific algorithms, and diagnostics]]


== v8-01-01 ==
{| border=1 cellspacing=0 cellpadding=5
PUBLIC RELEASE May 2008
|-valign="top" bgcolor="#cccccc"
!width="100px"|Version / Date
!width="350px"|Important features
!width="150px"|Benchmarks
!width="375px"|DOIs


Contains everything in [[#v7-04-13|v7-04-13]], with the following additions:
|-valign="top"
# Compatibility for [[GEOS-5 issues|GEOS-5]] met fields.
|[[GEOS-Chem 14.2.3|'''14.2.3''']]<br>01 Dec 2023
# Now uses [[Aerosol thermodynamical equilibrium#RPMARES|RPMARES]] instead of [[Aerosol thermodynamical equilibrium#ISORROPIA|ISORROPIA]]
|See the [[GEOS-Chem 14.2.3]] page for a complete list of updates, including:
# Implements [[Floating point math issues|floating point error traps]] (e.g. to prevent division by zero) in a few critical places
* Now specify GCClassic restart file paths in a single location (used by rundir creation and dry-run data download)
* Config file updates for CH4 and carbon simulations
* Simplify turning off all emissions (including extensions)
* Various fixes for bug and technical issues
|N/A
|
* GCClassic 14.2.3 ([https://doi.org/10.5281/zenodo.10246625 10.5281/zenodo.10246625])
* GCHP 14.2.3 ([https://doi.org/10.5281/zenodo.10246639 10.5281/zenodo.10246639])
* GEOS-Chem 14.2.3 ([https://doi.org/10.5281/zenodo.10246546 10.5281/zenodo.10246546])
* HEMCO 3.7.2 ([https://doi.org/10.5281/zenodo.10246347 10.5281/zenodo.10246347])


Also note that we have implemented the fix for the [[Biomass_burning_emissions#25-Sep-2007|Last year of GFED2 biomass emissions, (which is now 2006)]] into v8-01-01.
|-valign="top"
|[[GEOS-Chem 14.2.2|'''14.2.2''']]<br>23 Oct 2023
|See the [[GEOS-Chem 14.2.2]] page for a complete list of updates, including:
* Update sample restart files for fullchem and TransportTracer simulations to output from the 14.2.0 1-year benchmarks
|N/A
|
* GCClassic 14.2.2 ([https://doi.org/10.5281/zenodo.10034814 10.5281/zenodo10034814])
* GCHP 14.2.2 ([https://doi.org/10.5281/zenodo.10040942 10.5281/zenodo.10040942])
* GEOS-Chem 14.2.2 ([https://doi.org/10.5281/zenodo.10034733 10.5281/zenodo.10034733])


=== 1-Year Benchmarks ===
|-valign="top"
|[[GEOS-Chem 14.2.1|'''14.2.1''']]<br>10 Oct 2023
|See the [[GEOS-Chem 14.2.1]] page for a complete list of updates, including:
* Updated integration test scripts
* Fixes for several bug and technical issues
* Fixes for CH4, carbon, IMI simulations
* Updates to interface GEOS-Chem with CESM and GEOS
|N/A
|
* GCClassic 14.2.1 ([https://doi.org/10.5281/zenodo.8427641 10.5281/zenodo.8427641])
* GCHP 14.2.1 ([https://doi.org10.5281/zenodo.8427735 10.5281/zenodo.8427735])
* GEOS-Chem 14.2.1 ([https://doi.org/10.5281/zenodo.8427562 10.5281/zenodo.8427562])
* HEMCO 3.7.1 ([https://doi.org/10.5281/zenodo.8427520 10.5281/zenodo.8427520])


We have done two 1-year benchmarks for GEOS-Chem v8-01-01:
|-valign="top"
|[[GEOS-Chem 14.2.0|'''14.2.0''']]<br>05 Oct 2023
|See the [[GEOS-Chem 14.2.0]] page for a complete list of updates, including:
*Nitrate photolysis
*Update VOC fire emissions and adding lumped furan
*Several fixes and updates in chemistry
*Sea salt debromination on by default
*Updated TransportTracer simulation
*Climatology options for lightning NOx and GFED4
*Updates and fixes for the CH4 simulation
*Use dry pressure in GCHP advection
*Fix error in pressure level edge construction
|
*[[GEOS-Chem_14.2.0#1-month_full-chemistry_benchmarks|1-month fullchem]]
*[[GEOS-Chem_14.2.0#1-year_full-chemistry_benchmarks|1-year fullchem]]
*[[GEOS-Chem_14.2.0#1-year_transport_tracers_benchmarks|1-year TransportTracers]]
|
* GCClasssic 14.2.0 ([https://doi.org/10.5281/zenodo.8411496 10.5281/zenodo.8411496])
* GCHP 14.2.0 ([https://doi.org/10.5281/zenodo.8411829 10.5281/zenodo.8411829])
* GEOS-Chem 14.2.0 ([https://doi.org/10.5281/zenodo.8411433 10.5281/zenodo.8411433])
* HEMCO 3.7.0 ([https://doi.org/10.5281/zenodo.8411445 10.5281/zenodo.8411445])


==== Run0 ====
|}


The 3 models compared (and their colors on the plots) were:
=== 14.1 ===
 
{| border=1 cellspacing=0 cellpadding=5
|-valign="top" bgcolor="#cccccc"
!width="100px"|Version / Date
!width="350px"|Important features
!width="150px"|Benchmarks
!width="375px"|DOIs
 
|-valign="top"
|[[GEOS-Chem 14.1.1|'''14.1.1''']]<br>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
|
* GCClassic 14.1.1 ([https://doi.org/10.5281/zenodo.7696651 10.5281/zenodo.7696651])
* GCHP 14.1.1 ([https://doi.org/10.5281/zenodo.7696683 10.5281/zenodo.7696683])
* GEOS-Chem 14.1.1 ([https://doi.org/10.5281/zenodo.7696632 10.5281/zenodo.7696632])
* HEMCO 3.6.1 ([https://doi.org/10.5281/zenodo.7692950 10.5281/zenodo.7689762])
* HEMCO 3.6.2 ([https://doi.org/10.5281/zenodo.7692950 10.5281/zenodo.7692950])
 
|-valign="top"
|[[GEOS-Chem 14.1.0|'''14.1.0''']]<br>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 fullchem]]
|
*GCClassic 14.1.0 ([https://doi.org/10.5281/zenodo.7600579 10.5281/zenodo.7600579])
*GCHP 14.1.0 ([https://doi.org/10.5281/zenodo.7600586 10.5281/zenodo.7600586])
*GEOS-Chem 14.1.0 ([https://doi.org/10.5281/zenodo.7600404 10.5281/zenodo.7600404])
*HEMCO 3.6.0 ([https://doi.org/10.5281/zenodo.7600424 10.5281/zenodo.7600424])


{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#CCCCCC"
! Color
! Quantity Plotted
! Met Field Type
! Lightning algorithm
! A.T.E. algorithm
|-align="center"
| Red 
| [[#Run2|v7-04-12 Run2]]
| GEOS-4 4x5
| [[Lightning_NOx_emissions#24-Sep-2007|near-land w/ OTD-LIS regional scaling]]
| [[Aerosol_thermodynamical_equilibrium#ISORROPIA|ISORROPIA]]
|-align="center"                                   
| Green
| [[#v7-04-13|v7-04-13]] 
| GEOS-4 4x5
| updated non-near-land w/ OTD-LIS local scaling
| [[Aerosol_thermodynamical_equilibrium#ISORROPIA|ISORROPIA]]
|-align="center"
| Blue 
| v8-01-01   
| GEOS-5 4x5
| updated non-near-land w/ OTD-LIS local scaling
| [[Aerosol_thermodynamical_equilibrium#ISORROPIA|ISORROPIA]]
|-align="center"
| Black
| Observations           
| &nbsp;         
| &nbsp;
| &nbsp;
|}
|}


NOTES for Run0:
=== 14.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.
# Use Run0 if you need to make a clean comparison between the GEOS-4 and GEOS-5 met fields.
# Results from Run0 may be viewed on the web [http://www.as.harvard.edu/ctm/geos/G/v8-01-01/geos5/2005/Run0/output/pdf/ HERE.]


==== Run1 ====
{| border=1 cellspacing=0 cellpadding=5
|-valign="top" bgcolor="#cccccc"
!width="100px"|Version / Date
!width="350px"|Important features
!width="150px"|Benchmarks
!width="375px"|DOIs


The 3 models compared (and their colors on the plots) were:
|-valign="top"
|[[GEOS-Chem 14.0.2|'''14.0.2''']]<br>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 ([https://doi.org/10.5281/zenodo.7383492 10.5281/zenodo.7383492])
*GCHP 14.0.2 ([https://doi.org/10.5281/zenodo.7383532 10.5281/zenodo.7383532])
*GEOS-Chem 14.0.2 ([https://doi.org/10.5281/zenodo.7383132 10.5281/zenodo.7383132])
*HEMCO 3.5.2 ([https://doi.org/10.5281/zenodo.7383390 10.5281/zenodo.7383390])
 
|-valign="top"
|[[GEOS-Chem 14.0.1|'''14.0.1''']]<br>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 ([https://doi.org/10.5281/zenodo.7271974 10.5281/zenodo.7271974])
*GCHP 14.0.1 ([https://doi.org/10.5281/zenodo.7271982 10.5281/zenodo.7271982])
*GEOS-Chem 14.0.1 ([https://doi.org/10.5281/zenodo.7271960 10.5281/zenodo.7271960])
 
|-valign="top"
|[[GEOS-Chem 14.0.0|'''14.0.0''']]<br>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
|
*[http://wiki.seas.harvard.edu/geos-chem/index.php/GEOS-Chem_14.0.0#1-month_full-chemistry_benchmarks 1-month fullchem]
*[http://wiki.seas.harvard.edu/geos-chem/index.php/GEOS-Chem_14.0.0#1-year_full-chemistry_benchmarks 1-year fullchem]
*[http://wiki.seas.harvard.edu/geos-chem/index.php/GEOS-Chem_14.0.0#10-year_full-chemistry_benchmarks 10-year fullchem]
|
*GC Classic 14.0.0 ([https://doi.org/10.5281/zenodo.7254984 10.5281/zenodo.7254984])
*GCHP 14.0.0 ([https://doi.org/10.5281/zenodo.7254990 10.5281/zenodo.7254990])
*GEOS-Chem 14.0.0 ([https://doi.org/10.5281/zenodo.7254288 10.5281/zenodo.7254288])
*HEMCO 3.5.0 ([https://doi.org/10.5281/zenodo.7254056 10.5281/zenodo.7254056])


{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#CCCCCC"
! Color
! Quantity Plotted
! Met Field Type
! Lightning algorithm
! A.T.E. algorithm
|-align="center"                                   
| Red
| [[#v7-04-13|v7-04-13]] 
| GEOS-4 4x5
| updated non-near-land w/ OTD-LIS local scaling
| [[Aerosol_thermodynamical_equilibrium#ISORROPIA|ISORROPIA]]
|-align="center"
| Green 
| v8-01-01   
| GEOS-5 4x5
| updated non-near-land w/ OTD-LIS local scaling
| [[Aerosol_thermodynamical_equilibrium#ISORROPIA|ISORROPIA]]
|-align="center"
| Blue
| v8-01-01   
| GEOS-5 4x5
| updated non-near-land w/ OTD-LIS local scaling
| [[Aerosol_thermodynamical_equilibrium#RPMARES|RPMARES]]
|-align="center"
| Black
| Observations           
| &nbsp;         
| &nbsp;
| &nbsp;
|}
|}


NOTES for Run1:
== GEOS-Chem 13 release series ==
# The only difference between Run0 and Run1 is that Run0 uses ISORROPIA and Run1 uses RPMARES to compute the aerosol thermodynamical equilibrium.  We recently learned that [[Aerosol_thermodynamical_equilibrium#ISORROPIA|ISORROPIA can return incorrect values at low RH.]]
 
#* Use Run0 if you need to make a clean comparison between ISORROPIA and RPMARES.
Manual pages for the GEOS-chem 13 release series:
# Results from Run0 may be viewed on the web [http://www.as.harvard.edu/ctm/geos/G/v8-01-01/geos5/2005/Run1/output/pdf/ HERE.]
 
*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]


=== Post-release patches ===  
=== 13.4 ===


After the release of v8–01–01, some minor bugs and issues were discovered. Most of these involve numerical errors (i.e. computations that result in NaN's or underflow conditions). Other minor bugs are only relevant to a particular type of offline simulation. In any case, most of these issues have simple fixes.
{| 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


Please see the following GEOS–Chem wiki pages for information about the following issues, and how to resolve them.


'''''NOTE: As of November 2008, these post-release patches are now part of the [[#v8-01-02|standard GEOS-Chem v8-01-02]] source code.'''''
|-valign="top"
|[[GEOS-Chem 13.4.1|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
*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]


==== Fixes for the full-chemistry simulation ====
|-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]


*[[Bugs_and_fixes#Too_many_levels_in_photolysis_code|"Too many levels" error in the photolysis routine OPMIE.f]]
|}
*[[Previous_issues_now_resolved_in_v8-01-02#Corrected_labeling_of_SOA_quantities_in_carbon_mod.f|Confusing comments corrected in routine SOA_PARA in carbon_mod.f]]
*[[Previous_issues_now_resolved_in_v8-01-02#Numerical_noise_bug_in_upbdflx_mod.f|Numerical noise error in upbdflx_mod.f]]
*[[Previous_issues_now_resolved_in_v8-01-02#Problem_w.2F_ND65_diagnostic_and_dynamic_tropopause|Problem w/ ND65 diagnostic and the dynamic tropopause]]
*[[Common_GEOS-Chem_error_messages#Negative_tracer_found_in_WETDEP|Negative tracer found in WETDEP]]
*[[GEOS-5_issues#Small_negative_RH_value_in_20060206.a6.2x25_file|Negative relative humidity from met fields causing negative tracer]]
*[[Aerosol_thermodynamical_equilibrium#Run_dies_in_RPMARES_unexpectedly|Run dies in RPMARES unexpectedly]]
*[[Aerosol_thermodynamical_equilibrium#RPMARES|Error in sulfate_mod.f caused by switching from ISORROPIA to RPMARES]]


==== Fixes for offline simulations ====
=== 13.3 ===


*[[Previous_issues_now_resolved_in_v8-01-02#Out_of_bounds_error_for_tagged_co_mod.f|Array-out-of-bounds error in tagged_co_mod.f]]
{| border=1 cellspacing=0 cellpadding=5
*[[Outstanding_issues_yet_to_be_resolved#Wrong_MERGE.O3_filename_specified_in_v8-01-01|Wrong MERGE.O3 filename specified (this is an issue for offline Hg chemistry)]]
|-valign="top" bgcolor="#cccccc"
!width="75px"|Version
!width="100px"|Released
!width="360px"|Important features
!width="200px"|Benchmarks
!width="250px"|DOIs & AMIs


=== Lines of code ===
|-valign="top"
|[[GEOS-Chem 13.3.4|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
*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]


For those of you who are curious as to how many lines of code are in this version of GEOS-Chem, here is a counting of code lines, comment lines, and blank lines. ''NOTE: These totals also accounts for the [[#Post-release patches|v8-01-01 post-release patches]], while excluding many lines of obsolete code that had been commented out and slated for deletion.''
|-valign="top"
|[[GEOS-Chem 13.3.3|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:
*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]


Total number of files    :          217
|-valign="top"
Number of files searched :          217
|[[GEOS-Chem 13.3.2|13.3.2]]
Number of files skipped  :           0
|18 Nov 2021
|
Number of lines searched :      174177
See the [[GEOS-Chem 13.3.2]] page for a complete list of updates, including:
Number of comment lines  :        77788
*Fixed incorrect file path for OFFLINE_DUST emissions in ExtData.rc (zero-diff update)
Number of blank lines    :       25981
|N/A
Number of code lines    :       70408
|GC Classic 13.3.2
*DOI: [https://doi.org/10.5281/zenodo.5711194 10.5281/zenodo.5711194]
Ratio: Comments/Code    :        1.1048176
GCHP 13.3.2
*DOI: [https://doi.org/10.5281/zenodo.5711194 10.5281/zenodo.5711194]


Results were generated with IDL program <tt>linecount.pro</tt> by Bob Yantosca,
|-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&deg; x 0.625&deg; 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]


--[[User:Bmy|Bob Y.]] 14:27, 8 August 2008 (EDT)
|-valign="top"
|[[GEOS-Chem 13.3.0|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
|
*[[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]


== v7-04-13 ==
|}
BETA RELEASE November 2007


Contains everything in v7-04-12, with the following additions:
=== 13.2 ===


# Offline H2/HD simulation (cf. Lyatt Jaegle et al)
{| border=1 cellspacing=0 cellpadding=5
# [[Bugs_and_fixes#smvgear.f|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.
|-valign="top" bgcolor="#cccccc"
# [[Lightning_NOx_emissions#2The common block bug fix|Bug fix -- replace GEMISNOX w/ module arrays to avoid common block errors in lightning & aircraft NOx emissions]]
!width="75px"|Version
# [[NOx-Ox-HC-aerosol#variable_tropopause|Bug fix -- cap variable tropopause at 200hPa for polar regions (90S-60S and 60N-90N)]]
!width="100px"|Released
# [[Lightning_NOx_emissions#24-Sep-2007|Lee Murray's local lightning redistribution of lightning flashes]]
!width="360px"|Important features
# Minor bug fixes for GCAP and diagnostics
!width="200px"|Benchmarks
!width="250px"|DOIs & AMIs


Also note that the [[Biomass_burning_emissions#25-Sep-2007|Last year of GFED2 biomass emissions]] is still 2005 in this version. If you want to use the 2006 emissions you will have to edit the source code module "gfed2_biomass_mod.f".
|-valign="top"
|[[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]


=== 1-Year Benchmarks ===
|-valign="top"
|[[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]


==== Run ====
|}


The 3 models compared (and their colors on the plots) were:
=== 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
 
|-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]
 
|-valign="top"
|[[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]


{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#CCCCCC"
! Color 
! Quantity Plotted
! Met Type
! Lightning algorithm
|-
| Red 
| [[#Run1|v7-04-12 Run1]]
| GEOS-4 4x5
| ancient
|-                                      |
| Green
| [[#Run2|v7-04-12 Run2]]
| GEOS-4 4x5
| [[Lightning_NOx_emissions#24-Sep-2007|near-land w/ OTD-LIS regional scaling]]
|-
| Blue 
| v7-04-13     
| GEOS-4 4x5
| updated non-near-land w/ OTD-LIS local scaling
|-
| Black
| Observations           
| &nbsp;
| &nbsp;
|}
|}


NOTES:
=== 13.0 ===
# Results from v7-04-13-Run can be downloaded from FTP directory
 
#* pub/geos/1yr_benchmarks/v7-04-13/geos4/2005/Run/output/pdf
{| border=1 cellspacing=0 cellpadding=5
# Output plots from v7-04-13-Run can be viewed on the web [http://www.as.harvard.edu/ctm/geos/G/v7-04-13/geos4/2005/Run/output/pdf/ HERE.]
|-valign="top" bgcolor="#cccccc"
# v7-04-13-Run uses the same input conditions and emissions as v7-04-12-Run2, except for the updated lightning emissions as described above.
!width="75px"|Version
!width="100px"|Released
!width="360px"|Important features
!width="200x"|Benchmarks
!width="250px"|DOIs and AMIs


== v7-04-12 ==
|-valign="top"
BETA RELEASE October 2007
|[[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]


# [[NOx-Ox-HC-aerosol#Variable_Tropopause|Variable tropopause]] has bug fix from v7-04-11 but not 200 hPa cap at polar latitudes
|-valign="top"
# NOTE: There is a bug in this version when [[Lightning_NOx_emissions#The common block bug fix|lightning emissions are turned off]]. The bug will be fixed in [[GEOS-Chem_versions_under_development#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.
|[[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]


=== 1-Year Benchmarks ===
|-valign="top"
We have already done the following 1-year benchmark simulations:
|[[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]
|}


==== Run1 ====
== GEOS-Chem 12 release series ==
In FTP directory: <tt>/as2/pub/ftp/pub/geos-chem/1yr_benchmarks/v7-04-12/geos4/2005/Run1</tt>


View output plots via the web [http://www.as.harvard.edu:16080/ctm/geos/G/v7-04-12/geos4/2005/Run1/output/pdf/ HERE.]
Manual pages for the GEOS-chem 12 release series:


* Run w/ 4x5 GEOS-4 for met field year 2005 (spun up thru 2003 & 2004)
*[https://geoschem.github.io/gcclassic-manpage-archive/man.GC_12/index.html Getting Started with GEOS-Chem]
* with G-C "old" fossil fuel (GEIA + EPA/NEI99)
*[http://cloud.geos-chem.org Using GEOS-Chem on the AWS cloud]
* with G-C "default" climatological biomass burning
*[https://fugroup.org/index.php/WRF-GC#Getting_started Getting Started with WRF-GC]
* 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 [[Photolysis mechanism|FAST-J photolysis]]
* with variable tropopause on


==== Run2 ====
=== 12.9 ===
In FTP directory: <tt>/pub/geos-chem/1yr_benchmarks/v7-04-12/geos4/2005/Run2</tt>


View output plots via the web [http://www.as.harvard.edu:16080/ctm/geos/G/v7-04-12/geos4/2005/Run2/output/pdf/ HERE.]
{| 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


* Run w/ GEOS-4 for met field year 2005 (spun up thru 2003 & 2004)
|-valign="top"
* with G-C "old" fossil fuel (GEIA + EPA/NEI99)
|[[GEOS-Chem 12#12.9.3|12.9.3]]
* with G-C "default" climatological biomass burning
|06 Aug 2020
* with new lightning parameterization (with OTD/LIS v2 regional redistribution of flashes)
|Bug fixes for minor issues discovered after the 12.9.2 release:
* with MEGAN biogenic emissions
*See also [https://github.com/geoschem/geos-chem/milestone/16?closed=1 geoschem/geos-chem: Milestone 12.9.3]
* with SMVGEAR chemistry up to dynamic tropopause
|
* with new dust emissions (w/ GOCART source function)
|[https://doi.org/10.5281/zenodo.3974569 10.5281/zenodo.3974569]
* with new TOMS/SBUV ozone columns for [[Photolysis mechanism|FAST-J photolysis]]
 
* with variable tropopause on
|-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
|
*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
|
*Fix for noontime J-values diagnostic
*Fix for planeflight diagnotic
*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
|
*Update ISORROPIA from v2.0 to v2.2, in order to remove persistent noise in output
*Updated PFT file for MEGAN
*Bug fix for eruptive volcanic emissions
*Read in and regrid existing MODIS LAI and OLSON data via HEMCO
*Update from HEMCO version 2.1.011 to 2.1.012
*Enable running time backwards in GCHP
|This is the first benchmark to utilize [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
*Make polar bromine explosion the default option in Hg simulation
*Add biomass burning subgrid coagulation option
*Restore DST1, DST2, DST3, and DST4 in TOMAS
*Add RRTMG fluxes to netCDF diagnostics
*Fix for CO2 simulation chemical source
*Fix missing scaling factors for MERRA-2 simulations with GCHP
*Use online sea flux emissions by default in GCHP
|
|[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 Tracers simulation: a common set of tracers in GEOS-Chem and GEOS
*ObsPack diagnostic
*GFAS biomass burning emissions
*Update ESMF version  in GCHP from v5.2.0rp2 to v7.1.0r
|1st version to have the new [[TransportTracers_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
|
*Bug fix for tagged CO
*Skip planeflight observations outside a nested domain
*Always compile with BCPH_TPBC=y
*Fix compilation issues
|
|[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
|
*Budget diagnostics
*Anthropogenic PM2.5 dust source
*GEOS-Chem restart file updates
*Updates and fixes for the CEDS anthropogenic emissions inventory
*HEMCO fixes
*Fix mass conservation in non-local PBL mixing
*FlexGrid Stage 1: Use HEMCO to read met fields
*Add support for continuous integration with TravisCI
|
*[[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 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
|
*Bug fixes for ND51/ND51b diagnostics
*Bug fixes for TOMAS simulations
*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
|
*Bug fixes for mercury simulation
*Compatibility with IFORT 18
*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"
|[https://drive.google.com/file/d/1kHdMuMwAIAc1L-MGNAnonnqzwjNOH8h2/view?usp=sharing v11-02-rc]
|22 Jun 2018
|
*GCHP option
*Halogen chemistry
*Updated isoprene & monoterpene chemistry
*Simple SOA scheme
*Updated PAN chemistry
*Several new and updated emissions inventories
*NetCDF diagnostic output
|
*[https://drive.google.com/file/d/1jAviPfgY3pRmYG_bVL5rK_RqswkXGRuN/view?usp=sharing v11-02-rc benchmark history]
|
*[https://geoschem.github.io/gcclassic-manpage-archive/man.GC_12/index.html v11-02/12.0.0 manual]
 
|-valign="top"
|[https://drive.google.com/file/d/1shXuGxqn5bpoZ8NBSRPeyY6Ec3frAJOk/view?usp=sharing v11-01]
|20 Dec 2016 (provisional)<br>01 Feb 2017 (public)
|
*FlexChem
*MERRA-2
*Species Database
*Air moisture fixes and updates
*Compatibility with the GNU Fortran compiler
*Updated emissions
*NetCDF restart files
|
*[https://drive.google.com/file/d/1FAj63KaRVM-8J4EaAkder0--D3zlUy0x/view?usp=sharing 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"
|[https://drive.google.com/file/d/11472Qh_bRzFgiRXab5eSUtwbr6SqqJnN/view?usp=sharing v10-01]
|01 May 2015 (provisional)<br>17 Jun 2015 (public)
|
*UCX chemistry mechanism
*HEMCO
*Online radiative transfer (RRTMG)
|
*[https://drive.google.com/file/d/1xv0lBsi6mQrVG1rPJHHsxiM7IvHNb8sW/view?usp=sharing v10-01 benchmark history]
|
*[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"
|[https://drive.google.com/file/d/1IyEcLHjTJkDsgz8hUiD9NjlSaEUiRR15/view?usp=sharing v9-02]
|17 Jan 2014 (provisional)<br>03 Mar 2014 (public)
|
*Updated soil NOx emissions module from Hudman et al. 2012
*POPs simulation
*Inorganic chemistry updates
*Methyl peroxy nitrate chemistry
*Adopt Paulot isoprene scheme as standard
*RCP emission scenarios
*AEIC aircraft emissions inventory
*GEOS-FP met fields
|
*[https://drive.google.com/file/d/19zWYi3JJJyMCu56tMe5mkWXItg7CD2ey/view?usp=sharing v9-02 benchmark history]
|
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v9-02/index.html v9-02 manual]
 
|-valign="top"
|[https://drive.google.com/file/d/1DCNqNXQSxmk6-7d8g8EldyVXytRsSQh4/view?usp=sharing v9-01-03]
|14 Sep 2012
|
*Updated acetone sources & sinks
*Improved sea salt emission and deposition
*Improved snow scavenging and washout parameterization
*Tropospheric bromine chemistry
*Stratospheric P and k (monthly climatological)
|
*[https://drive.google.com/file/d/1EfY-tVSQZOvNPlThwm5TNAbjQEhs1iGq/view?usp=sharing v9-01-03 benchmark history]
|
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v9-01-03/index.html v9-01-03 manual]
 
|-valign="top"
|[https://drive.google.com/file/d/1j5EJsxNRTExS-jyddrOEZhqyVj_2vRV4/view?usp=sharing v9-01-02]
|28 Nov 2011
|
*APM aerosol microphysics
*GFED3 biomass emissions
*RETRO Anthropogenic Emissions
|
*[https://drive.google.com/file/d/1JSIrZRdLas4D8Swi4gJdoXc63JOxeG3d/view?usp=sharing v9-01-02 benchmark history]
|
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v9-01-02/index.html v9-01-02 manual]
 
|-valign="top"
|[https://drive.google.com/file/d/1KejGiXiP0WkxI5OHeGjUjpieYkE5POvJ/view?usp=sharing v9-01-01]
|07 Jun 2011
|
*Compatibility with the GMAO MERRA met data product
*Updated lightning NOx; various fixes
|
*[https://drive.google.com/file/d/1V3w8-2PdZ22AvIys_Qf1MUMcSVlymP1C/view?usp=sharing v9-01-01 benchmark history]
|
*[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"
|[https://drive.google.com/file/d/1AFxINBOkKKO3J2ki8thYuSZJ076Rh5_0/view?usp=sharing v8-03-02]
|07 Sep 2010
|Updated Hg and CO2 simulations
|
*Archived to storage; contact [https://geoschem.github.io/support-team.html GCST]
|
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-03-02/index.html v8-03-02 manual]
 
|-valign="top"
|[https://drive.google.com/file/d/1Mcl34gVBzil1QgTiPdpkKYRuGWEJrus6/view?usp=sharing v8-03-01]
|04 May 2010
|
*ISORROPIA II
*TOMAS microphysics option
*Updates to SOA and photolysis
|
*Archived to storage; contact [https://geoschem.github.io/support-team.html GCST]
|
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-03-01/index.html GC v8-03-01 manual]
 
|-valign="top"
|[https://drive.google.com/file/d/1Oeq4QjkiC6zx79y5m7i2wFVqrBoAtW0f/view?usp=sharing v8-02-04]
|24 Feb 2010
|
*LINOZ strat chemistry
*NEI2005 anthro emissions
*MEGAN v2.1 biogenic emissions
|
*Archived to storage; contact [https://geoschem.github.io/support-team.html GCST]
|
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-02-01/index.html GC v8-02-04 manual]
 
|-valign="top"
|[https://drive.google.com/file/d/1ySr1c87xL8RhMA7hlI_qur-sWnbHxdOu/view?usp=sharing v8-02-03]
|Oct 2009
|
*KPP solver
*ICOADS emissions
*Updated makefile structure
|
*Archived to storage; contact [https://geoschem.github.io/support-team.html GCST]
|
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-02-01/index.html GC v8-02-03 manual]
 
|-valign="top"
|[https://drive.google.com/file/d/19iQINQsGcBxAHK-kVb4yPfxAuhjUNaVc/view?usp=sharing v8-02-02]
|08 Jun 2009
|
*Non-local PBL mixing scheme
*Updated Bond BC & OC emissions
|
*Archived to storage; contact [https://geoschem.github.io/support-team.html GCST]
|
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-02-01/index.html GC v8-02-02 manual]
 
|-valign="top"
|[https://drive.google.com/file/d/1p9nwLI7WDfZ8nyJ4A_8c-SdENfdFLHiZ/view?usp=sharing v8-02-01]]
|26 May 2009
|
*Updated chemistry & photolysis reactions
*Glyoxal chemistry mechanism
|
*Archived to storage; contact [https://geoschem.github.io/support-team.html GCST]
|
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-02-01/index.html GC v8-02-01 manual]
 
|-valign="top"
|[https://drive.google.com/file/d/1oNyQHBCQ4n7J9CG8eOBaoDUrZbCAOYGN/view?usp=sharing v8-01-04]]
|10 Mar 2009
|
*Various emissions updates (regional & global inventories)
*GFED2 biomass emissions updates
|
*Archived to storage; contact [https://geoschem.github.io/support-team.html GCST]
|
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-01-04/index.html GC v8-01-04 manual]
 
|-valign="top"
|[https://drive.google.com/file/d/1amtpFv5MRItNZsEYVnt26qKBVu_8KF6A/view?usp=sharing v8-01-03]]
|Dec 2008
|
*Installation of GMI TPCORE routine
|
*Archived to storage; contact [https://geoschem.github.io/support-team.html GCST]
|
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-01-04/index.html GC v8-01-03 manual]
 
|-valign="top"
|[https://drive.google.com/file/d/1Onp9dwZPruh5nQXl9fcChCzARaVHxqxN/view?usp=sharing v8-01-02]
|Nov 2008
|
*Nested grid simulations for 0.5&deg; x 0.666&deg;
|
*Archived to storage; contact [https://geoschem.github.io/support-team.html GCST]
|
*[https://geoschem.github.io/gcclassic-manpage-archive/man.v8-01-04/index.html GC v8-01-02 manual]
 
|-valign="top"
|[https://drive.google.com/file/d/1BNJYvAY6ReLcM98u2znCUq2f0OBd-d3u/view?usp=sharing v8-01-01]
|May 2008
|
*Capability to run with GEOS-5 met fields
|
*Archived to storage; contact [https://geoschem.github.io/support-team.html 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"
|[https://drive.google.com/file/d/1B8O9u55snMGlEPH8-8-OAhrGtu6tq88k/view?usp=sharing v7-04-13]
|Nov 2007
|
*H2/HD simulation
*Bug fixes in SMVGEAR, lightning, and dynamic tropopause
|
*Archived to storage; contact [https://geoschem.github.io/support-team.html GCST]
|
 
|-valign="top"
|[https://drive.google.com/file/d/1gc-w6YM7o0mvMKKNH3yP3amJYU_-XtSp/view?usp=sharing v7-04-12]
|Oct 2007
|
*Introduction of dynamic tropopause
|
*Archived to storage; contact [https://geoschem.github.io/support-team.html GCST]
|
 
|-valign="top"
|v7-04-11 and earlier
|March 2006 and earlier
|
|
*Archived to storage; contact [https://geoschem.github.io/support-team.html GCST]
|
 
|}

Latest revision as of 15:25, 4 December 2024

This page contains links to wiki pages describing past GEOS-Chem model releases. For information about upcoming releases see the GEOS-Chem model development priorities wiki page.

GEOS-Chem development history

In the tables below, we list information about current and past GEOS-Chem releases.

Some notes for the tables below:

  • Information about benchmarks can be found by following the links in the "Benchmarks" column
  • GCC = GEOS-hem "Classic" (uses OpenMP parallelization single node only)
  • GCHP = GEOS-Chem High Performance (uses MPI parallelization across multiple nodes)
  • DOI = digital object identifier, can be used to reference individual GEOS-Chem versions in publications
  • AMI = Amazon Machine Image, which provides GEOS-Chem Classic on the AWS Cloud

Also see our GEOS-Chem version numbering system wiki page for information on how GEOS-Chem versions are labeled.

GEOS-Chem benchmarking information

GEOS-Chem Benchmarking Procedure

For a complete description about the the standard 1-month and 1-year benchmark simulations, please see our GEOS-Chem Benchmarking wiki page.

Mean OH from GEOS-Chem 1-year benchmark simulations

Please see our Evolution of mean OH in GEOS-Chem wiki page.

Global burden history

Please see our Global burden history wiki page to view the global burdens for several species from several recent GEOS-Chem 1-year benchmark simulations.

GEOS-Chem Benchmark Performance

For an overview of GEOS-Chem 1-month benchmark timing results, please see our GEOS-Chem 1-month benchmark timing results wiki page.

GEOS-Chem 14 release series

14.6

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

14.5

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

14.4

Version / Date Important features Benchmarks DOIs
14.4.3
24 Jul 2024
See the GEOS-Chem 14.4.3 page for a complete list of updates, including:
  • Fix a significant performance bottleneck in Cloud-J
  • Other minor bug fixes
N/A
14.4.2
24 Jul 2024
See the GEOS-Chem 14.4.2 page for a complete list of updates, including:
  • Updates for GEOS-Chem in CESM
  • Other minor bug fixes
N/A
14.4.1
28 Jun 2024
See the GEOS-Chem 14.4.1 page for a complete list of updates, including:
  • Fix slowdown in 14.4.0 runs caused by reading met fields and nested-grid boundary conditions more frequently than necessary
  • Updates for GEOS-Chem in CESM
  • GCHP run directory fixes and improvements
N/A
14.4.0
31 May 2024
See the GEOS-Chem 14.4.0 page for a complete list of updates, including:
  • HETP aerosol thermodynamics
  • GCHP carbon simulation
  • Parameterized Reff for SNA and OM aerosols
  • Updated gravitational settling, diameters, hyg growth in aerosol drydep
  • Only convert units for species that require it

14.3

Version / Date Important features Benchmarks DOIs
14.3.1
02 Apr 2024
See the GEOS-Chem 14.3.1 page for a complete list of updates, including:
  • Updating CH4 emissions from EDGARv7 to EDGARv8
  • Adding budget diagnostic option for fixed level vertical region
  • Fixes to restore proper handling of NEI 3D emissions
  • ObsPack bug fixes
  • Fixing bug in transport tracer pressure mask criteria affecting tracer st80_25
N/A
14.3.0
09 Feb 2024
See the GEOS-Chem 14.3.0 page for a complete list of updates, including:
  • Update reactions with new JPL & IUPAC recommendations
  • Add capability for TOMAS simulations in GCHP
  • Use Cloud-J for computing photolysis rates as default
  • GEOS-IT meteorology

14.2

Version / Date Important features Benchmarks DOIs
14.2.3
01 Dec 2023
See the GEOS-Chem 14.2.3 page for a complete list of updates, including:
  • Now specify GCClassic restart file paths in a single location (used by rundir creation and dry-run data download)
  • Config file updates for CH4 and carbon simulations
  • Simplify turning off all emissions (including extensions)
  • Various fixes for bug and technical issues
N/A
14.2.2
23 Oct 2023
See the GEOS-Chem 14.2.2 page for a complete list of updates, including:
  • Update sample restart files for fullchem and TransportTracer simulations to output from the 14.2.0 1-year benchmarks
N/A
14.2.1
10 Oct 2023
See the GEOS-Chem 14.2.1 page for a complete list of updates, including:
  • Updated integration test scripts
  • Fixes for several bug and technical issues
  • Fixes for CH4, carbon, IMI simulations
  • Updates to interface GEOS-Chem with CESM and GEOS
N/A
14.2.0
05 Oct 2023
See the GEOS-Chem 14.2.0 page for a complete list of updates, including:
  • Nitrate photolysis
  • Update VOC fire emissions and adding lumped furan
  • Several fixes and updates in chemistry
  • Sea salt debromination on by default
  • Updated TransportTracer simulation
  • Climatology options for lightning NOx and GFED4
  • Updates and fixes for the CH4 simulation
  • Use dry pressure in GCHP advection
  • Fix error in pressure level edge construction

14.1

Version / Date Important features Benchmarks DOIs
14.1.1
03 Mar 2023
See the GEOS-Chem 14.1.1 page for a complete list of updates, including:
  • Fixes for several bugs and issues
  • Updated to HEMCO 3.6.2
  • Updated user registration
  • Updated GitHub issue templates
  • Updates for interfacing to external models (GEOS, CESM, WRF)
  • Updated integration tests
  • NOTE: This version has zero differences w/r/t the 14.1.0 benchmarks
N/A
14.1.0
01 Feb 2023
See the GEOS-Chem 14.1.0 page for a complete list of updates, including:
  • Mechanisms rebuilt with KPP 3.0.0, with auto-reduction option
  • Carbon simulation using a KPP-generated mechanism
  • Improved Hg0 dry deposition and AMAP Hg emissions
  • Option to use HTAPv3 global emissions
  • Option to archive species concentrations in molec cm-3
  • NetCDF satellite timeseries diagnostics replacing binary ND51
  • Cleanup of memory leaks
  • Time-averaged file timestamps changed from midpoint to start
  • GCHP tagged O3 simulation
  • MAPL updated to version 2.26.0

14.0

Version / Date Important features Benchmarks DOIs
14.0.2
29 Nov 2022
See the GEOS-Chem 14.0.2 page for a complete list of updates, including:
  • Update sample full-chemistry restart files to 10-year benchmark output for 14.0.0
  • Add several fixes to CH4 simulation
  • Flush GEOS-Chem restart files to disk immediately after writing
  • Remove memory leaks from GEOS-Chem and HEMCO
  • Update HEMCO to version 3.5.2
  • Improve HEMCO error messages
  • Add sanitize compile option to HEMCO
N/A
14.0.1
31 Oct 2022
See the GEOS-Chem 14.0.1 page for a complete list of updates, including:
  • Fix typo for AEIC2019 emissions in aerosol-only simulations
  • Fix units metadata for PHIS and AirNumDen
  • Add fix for activating ND51 satellite diagnostic
  • Point species concentration array pointers to GCHP internal state
  • Fix incorrect non-species data in GCHP mid-run checkpoint files
  • Document and cleanup GCHP run script operational examples
N/A
14.0.0
25 Oct 2022
See the GEOS-Chem 14.0.0 page for a complete list of updates, including:
  • Converted input.geos to geoschem_config.yml
  • Fixed bugs causing differences when splitting up simulations in time
  • Remove unnecessary met-fields from GCClassic restart file
  • Updated offline emissions
  • Rebuilt mechanisms with KPP 2.5.0
  • Changed 4D State_Chm%Species array to vector of 3D arrays
  • Boundary conditions are now saved on first timestep
  • Updated HEMCO to version 3.5.0
  • Updated GMAO libraries for GCHP
  • Added option to use native GEOS-FP winds for GCHP
  • Fixed bug in GCHP vertical mass flux diagnostic
  • Fix compilation errors for custom mechanism
  • Bug fixes for the Hg simulation
  • Updates for GEOS from GMAO
  • Updates for GEOS-Chem and HEMCO in CESM
  • Updates for GEOS-Chem in WRF-GC
  • Use newest CEDS data in CO2 simulation
  • Fix typo in HEMCO_Config.rc for GCHP
  • Bug fix in rundir creation for GCAP2
  • GEOS-Chem user registration

GEOS-Chem 13 release series

Manual pages for the GEOS-chem 13 release series:

13.4

Version Released Important features Benchmarks DOIs & AMIs


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

GCHP 13.4.1

13.4.0 02 May 2022 See the GEOS-Chem 13.4.0 page for a complete list of updates, including:
  • Migrated sulfate chemistry to KPP
  • Increased surface resistance for O3 drydep on ice/snow
  • Benchmarks now use degassing-only volcano climatology
  • Rn222 emissions from Zhang et al (2021)
  • Updates for automated run-directory creation
  • Updated Hg simulation via KPP
  • Plus bug fixes for HCl uptake on seasalt and Henry's law computation in hetchem
  • HEMCO has been updated to version 3.4.0
GC Classic 13.4.0

GCHP 13.4.0

HEMCO 3.4.0

GCPy 1.2.0

13.3

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

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

  • Bug fix: Now use proper restart file path for dry-run data download
  • Bug fix: Now check GEOS-Chem Classic History diagnostic subset regions properly
N/A GC Classic 13.3.4

GCHP 13.3.4

13.3.3 02 Dec 2021

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

  • Upgrade to HEMCO version 3.2.2, which restores updating of manual diagnostics. (This had been inadvertently clobbered during a Git merge).
  • Only affects CH4, Hg, and TOMAS simulations
N/A GC Classic 13.3.3

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

GCHP 13.3.3

HEMCO 3.2.2

13.3.2 18 Nov 2021

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

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

GCHP 13.3.2

13.3.1 15 Nov 2021 See the GEOS-Chem 13.3.1 page for a complete list of updates, including:
  • Nested grid simulations (except CH4) at 0.5° x 0.625° now use default timesteps of 600 s (transport) and 1200 s (chemistry)
  • Diagnostic fixes
  • GCHP fixes
N/A GC Classic 13.3.1

GCHP 13.3.1

HEMCO 3.2.1

13.3.0 15 Nov 2021 See the GEOS-Chem 13.3.0 page for a complete list of updates, including:
  • Chemistry mechanism updates
  • Heterogeneous chemistry updates
  • Emissions updates (NEI2016 as an option)
  • Diagnostic updates
  • GCHP adjoint updates
GC Classic 13.3.0

GCHP 13.3.0

HEMCO 3.2.0

13.2

Version Released Important features Benchmarks DOIs & AMIs
13.2.1 10 Sep 2021 See the GEOS-Chem 13.2.1 page for a complete list of updates, including: N/A GC Classic 13.2.1

GCHP 13.2.1

HEMCO 3.1.1

13.2.0 07 Sep 2021 See the GEOS-Chem 13.2.0 page for a complete list of updates, including:
  • CEDS v2 emissions
  • Updated Yuan/BNU MODIS LAI
  • Blowing snow emissions
  • Luo et al 2020 wetdep (option)
  • Trace metal simulation
  • Several fixes for minor issues
GC Classic 13.2.0

GCHP 13.2.0

HEMCO 3.1.0

13.1

Version Released Important features Benchmarks DOIs and AMIs
13.1.2 06 Jul 2021 See the GEOS-Chem 13.1.2 page for a complete list of updates, including: N/A GC Classic 13.1.2

GCHP 13.1.2

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

GCHP 13.1.1

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

GCHP 13.1.0

HEMCO 3.0.0

13.0

Version Released Important features Benchmarks DOIs and AMIs
13.0.2 12 Apr 2021 See the GEOS-Chem 13.0.2 page for a complete list of updates, including: N/A GC Classic 13.0.2

GCHP 13.0.2

HEMCO 3.0.0-rc.3

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

GCHP 13.0.1

HEMCO 3.0.0-rc.2

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

GCHP 13.0.0

GEOS-Chem 12 release series

Manual pages for the GEOS-chem 12 release series:

12.9

Version Released Important features Benchmarks DOI
12.9.3 06 Aug 2020 Bug fixes for minor issues discovered after the 12.9.2 release: 10.5281/zenodo.3974569
12.9.2 24 Jul 2020 Bug fixes for GEOS-Chem dryrun option, CO2 simulations, PARANOX, complexSOA_SVPOA: 10.5281/zenodo.3959279
12.9.1 17 Jul 2020 Bug fixes for GEOS-Chem dryrun option, Luo wetdep, and RCP emissions: 10.5281/zenodo.3950473
12.9.0 17 Jul 2020 10.5281/zenodo.3950327

12.8

Version Released Important features Benchmarks DOI
12.8.2 27 May 2020 Bug fixes and updates for WRF-GC development 10.5281/zenodo.3860693
12.8.1 21 May 2020 Fixes for several issues identified during 12.8.0 benchmarking (not affecting full-chemistry simulations): 10.5281/zenodo.3837666
12.8.0 04 May 2020 10.5281/zenodo.3784796

12.7

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

12.6

Version Released Important features Benchmarks DOI
12.6.3 25 Nov 2019 Contains GCHP bug fixes only: See: 10.5281/zenodo.3552959
12.6.2 15 Nov 2019 Contains several bug fixes. See: 10.5281/zenodo.3543702
12.6.1 28 Oct 2019 Contains several bug fixes. See: 10.5281/zenodo.3520966
12.6.0 18 Oct 2019
  • Hetchem updates and subgrid cloud NOy chemistry
  • HNO3 cold-temperature deposition
  • Quick fix for aerosol pH calculation when dry
  • Remove isoprene in VBS (leaving aqueous)
  • Updated aerosol hygroscopicity and optics
  • Various structural updates
  • Subsetting in netCDF diagnostics
  • Diagnostic for O3 at 10m (or other height) above surface
10.5281/zenodo.3507501

12.5

Version Released Important features Benchmarks DOI
12.5.0 09 Sep 2019
  • Retire obsolete emissions inventories
  • Fixes and updates for offline biogenic VOC and volcano emissions
  • Update GCHP to use MAPL v1.0.0 and ESMF v8.0.0 beta snapshot 28
10.5281/zenodo.3403111

12.4

Version Released Important features Benchmarks DOI
12.4.0 05 Aug 2019
  • Grid-independent emissions
  • FlexGrid Stage 2: define custom grids

NOTE: Users should use 12.5.0 instead. That version contains bug fixes and updates for offline biogenic VOC and volcano emissions.

10.5281/zenodo.3360635

12.3

Version Released Important features Benchmarks DOI
12.3.2 02 May 2019
  • Remove inconsistency for H2402 between GCHP and GCC
  • Bug fixes for FAST-JX
  • Updates for HEMCO diagnostics
  • Use the same Br2 seasalt emissions in both GCHP and GCC
  • Updates for GCHP run directories
This is an unofficial benchmark and the first GCHP benchmark using GCPy 10.5281/zenodo.2658178
12.3.1 08 Apr 2019
  • Fix for noontime J-values diagnostic
  • Fix for planeflight diagnotic
  • Declare State_Met%AREA_M2 as 2-D
10.5281/zenodo.2633278


12.3.0 01 Apr 2019
  • Update ISORROPIA from v2.0 to v2.2, in order to remove persistent noise in output
  • Updated PFT file for MEGAN
  • Bug fix for eruptive volcanic emissions
  • Read in and regrid existing MODIS LAI and OLSON data via HEMCO
  • Update from HEMCO version 2.1.011 to 2.1.012
  • Enable running time backwards in GCHP
This is the first benchmark to utilize GCPy 10.5281/zenodo.2620535

12.2

Version Released Important features Benchmarks DOI
12.2.1 28 Feb 2019
  • Bug fix: netCDF diagnostic collections with frequency "End" now properly span leap year days
  • Make polar bromine explosion the default option in Hg simulation
  • Add biomass burning subgrid coagulation option
  • Restore DST1, DST2, DST3, and DST4 in TOMAS
  • Add RRTMG fluxes to netCDF diagnostics
  • Fix for CO2 simulation chemical source
  • Fix missing scaling factors for MERRA-2 simulations with GCHP
  • Use online sea flux emissions by default in GCHP
10.5281/zenodo.2580198
12.2.0 19 Feb 2019
  • Transport Tracers simulation: a common set of tracers in GEOS-Chem and GEOS
  • ObsPack diagnostic
  • GFAS biomass burning emissions
  • Update ESMF version in GCHP from v5.2.0rp2 to v7.1.0r
1st version to have the new Transport Tracer benchmark (replaces Rn-Pb-Be benchmark) 10.5281/zenodo.2572887

12.1

Version Released Important features Benchmarks DOI
12.1.1 13 Dec 2018
  • Bug fix for tagged CO
  • Skip planeflight observations outside a nested domain
  • Always compile with BCPH_TPBC=y
  • Fix compilation issues
10.5281/zenodo.2249246
12.1.0 26 Nov 2018
  • Budget diagnostics
  • Anthropogenic PM2.5 dust source
  • GEOS-Chem restart file updates
  • Updates and fixes for the CEDS anthropogenic emissions inventory
  • HEMCO fixes
  • Fix mass conservation in non-local PBL mixing
  • FlexGrid Stage 1: Use HEMCO to read met fields
  • Add support for continuous integration with TravisCI
10.5281/zenodo.1553349

12.0

Version Released Important features Benchmarks DOI
12.0.3 16 Oct 2018
  • Fix incorrect run configuration for offline sea salt emissions in GCHP
  • Fix bug in application of CFC surface mixing ratios in GCHP
10.5281/zenodo.1464210
12.0.2 10 Oct 2018
  • Bug fixes for ND51/ND51b diagnostics
  • Bug fixes for TOMAS simulations
  • Bug fix for CO2 simulations
10.5281/zenodo.1455215
12.0.1 24 Aug 2018
  • Bug fixes for mercury simulation
  • Compatibility with IFORT 18
  • Compatibility with GNU Fortran 8.2.0
10.5281/zenodo.1403144
12.0.0*
aka v11-02-final
10 Aug 2018
  • Bug fixes identified during the v11-02 release candidate period
Note change in GEOS-Chem version numbering system 10.5281/zenodo.1343547

GEOS-Chem 11 release series

Version Date released Important features Benchmarks Documentation
v11-02-rc 22 Jun 2018
  • GCHP option
  • Halogen chemistry
  • Updated isoprene & monoterpene chemistry
  • Simple SOA scheme
  • Updated PAN chemistry
  • Several new and updated emissions inventories
  • NetCDF diagnostic output
v11-01 20 Dec 2016 (provisional)
01 Feb 2017 (public)
  • FlexChem
  • MERRA-2
  • Species Database
  • Air moisture fixes and updates
  • Compatibility with the GNU Fortran compiler
  • Updated emissions
  • NetCDF restart files

GEOS-Chem 10 release series

Version Date released Important features Benchmarks Documentation
v10-01 01 May 2015 (provisional)
17 Jun 2015 (public)
  • UCX chemistry mechanism
  • HEMCO
  • Online radiative transfer (RRTMG)

GEOS-Chem 9 release series

Version Date released Important features Benchmarks Documentation
v9-02 17 Jan 2014 (provisional)
03 Mar 2014 (public)
  • Updated soil NOx emissions module from Hudman et al. 2012
  • POPs simulation
  • Inorganic chemistry updates
  • Methyl peroxy nitrate chemistry
  • Adopt Paulot isoprene scheme as standard
  • RCP emission scenarios
  • AEIC aircraft emissions inventory
  • GEOS-FP met fields
v9-01-03 14 Sep 2012
  • Updated acetone sources & sinks
  • Improved sea salt emission and deposition
  • Improved snow scavenging and washout parameterization
  • Tropospheric bromine chemistry
  • Stratospheric P and k (monthly climatological)
v9-01-02 28 Nov 2011
  • APM aerosol microphysics
  • GFED3 biomass emissions
  • RETRO Anthropogenic Emissions
v9-01-01 07 Jun 2011
  • Compatibility with the GMAO MERRA met data product
  • Updated lightning NOx; various fixes

GEOS-Chem 8 release series

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

GEOS-Chem 7 release series

Version Date released Important features Benchmarks Documentation
v7-04-13 Nov 2007
  • H2/HD simulation
  • Bug fixes in SMVGEAR, lightning, and dynamic tropopause
  • Archived to storage; contact GCST
v7-04-12 Oct 2007
  • Introduction of dynamic tropopause
  • Archived to storage; contact GCST
v7-04-11 and earlier March 2006 and earlier
  • Archived to storage; contact GCST