GEOS-Chem versions: Difference between revisions

From Geos-chem
Jump to navigation Jump to search
(578 intermediate revisions by 8 users not shown)
Line 1: Line 1:
'''NOTE: The order in which various future-scheduled updates enter into the standard GEOS-Chem code may differ than what is listed here, depending on circumstances.  Please check back here often.'''
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:


* [[NOx-Ox-HC-aerosol#25-Sep-2007|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 will add:
*Information about benchmarks can be found by following the links in the "Benchmarks" column
# [[Anthropogenic_emissions#04-Jan-2008|EPA/NEI99 California transport sector fix]]
*GCC = GEOS-Chem "Classic" (uses OpenMP parallelization single node only)
# [[Biogenic_emissions#25-Sep-2007|Updated MEGAN annual emission factors for isoprene]]
*GCHP = GEOS-Chem High Performance (uses MPI parallelization across multiple nodes)
# [[Mercury|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 will add:
# May Fu's updated chemistry mechanism ???
# New scale factors for anthropogenic emissions (cf. Aaron van Donkelaar)


== v8-01-01 ==
== GEOS-Chem 14 release series ==
PUBLIC RELEASE scheduled for April 2008


=== Release Notes ===
* 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. 
* Seee our list of [[Software maintained by GEOS-Chem community members|software tools maintained by GEOS-Chem users]].


Contains everything in [[#v7-04-13|v7-04-13]], with the following additions:
=== 14.4 ===
# Compatibility for [[GEOS-5]] met fields.
# Now uses [[Aerosol thermodynamical equilibrium#RPMARES|RPMARES]] instead of [[Aerosol thermodynamical equilibrium#ISORROPIA|ISORROPIA]]
# Implements [[Floating point math issues|floating point error traps]] (e.g. to prevent division by zero) in a few critical places


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


=== 1-Year Benchmarks ===
|-valign="top"
|[[GEOS-Chem 14.4.0|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
|
*[[GEOS-Chem_14.4.0#1-month_full-chemistry_benchmarks|1-month benchmarks]]
*[[GEOS-Chem_14.4.0#1-year_full-chemistry_benchmarks|1-year benchmarks]]
|
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 (science code)
*[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]


We have done two 1-year benchmarks for GEOS-Chem v8-01-01:
|}
 
=== 14.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"|DOIs & AMIs
 
|-valign="top"
|[[GEOS-Chem 14.3.1|14.3.1]]
|02 Apr 2024
|See the [[GEOS-Chem 14.3.1]] page for a complete list of updates, including:
*Updating CH4 emissions from EDGARv7 to EDGARv8
*Adding budget diagnostic option for fixed level vertical region
*Fixes to restore proper handling of NEI 3D emissions
*ObsPack bug fixes
*Fixing bug in transport tracer pressure mask criteria affecting tracer st80_25
 
|N/A
|
GCClassic 14.3.1
*[https://doi.org/10.5281/zenodo.10909023 10.5281/zenodo.10909023]
GCHP 14.3.1
*[https://doi.org/10.5281/zenodo.10909030 10.5281/zenodo.10909030]
GEOS-Chem 14.3.1 (science code)
*[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]
 
|-valign="top"
|[[GEOS-Chem 14.3.0|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
|
*[[GEOS-Chem_14.3.0#1-month_full-chemistry_benchmarks|1-month benchmarks]]
*[[GEOS-Chem_14.3.0#1-year_full-chemistry_benchmarks|1-year full-chemistry benchmarks]]
|
GC Classsic 14.3.0
*DOI: [https://doi.org/10.5281/zenodo.10640536 10.5281/zenodo.10640536]
GCHP 14.3.0
*DOI: [https://doi.org/10.5281/zenodo.10640559 10.5281/zenodo.10640559]
GEOS-Chem 14.3.0 (science code)
*DOI: [https://doi.org/10.5281/zenodo.10640383 10.5281/zenodo.10640383]
HEMCO 3.8.0
*DOI: [https://doi.org/10.5281/zenodo.10640447 10.5281/zenodo.10640447]
 
|}
 
=== 14.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"|DOIs & AMIs
 
|-valign="top"
|[[GEOS-Chem 14.2.3|14.2.3]]
|01 Dec 2023
|See the [[GEOS-Chem 14.2.3]] page for a complete list of updates, including:
* Now specify GCClassic restart file paths in a single location (used by rundir creation and dry-run data download)
* Config file updates for CH4 and carbon simulations
* Simplify turning off all emissions (including extensions)
* Various fixes for bug and technical issues
|N/A
|GCClassic 14.2.3
* [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 (science code)
* [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 ]
 
|-valign="top"
|[[GEOS-Chem 14.2.2|14.2.2]]
|23 Oct 2023
|See the [[GEOS-Chem 14.2.2]] page for a complete list of updates, including:
* Update sample restart files for fullchem and TransportTracer simulations to output from the 14.2.0 1-year benchmarks
|N/A
|GCClassic 14.2.2
* [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 (science code)
* [https://doi.org/10.5281/zenodo.10034733 10.5281/zenodo.10034733]
 
|-valign="top"
|[[GEOS-Chem 14.2.1|14.2.1]]
|10 Oct 2023
|See the [[GEOS-Chem 14.2.1]] page for a complete list of updates, including:
* Updated integration test scripts
* Fixes for several bug and technical issues
* Fixes for CH4, carbon, IMI simulations
* Updates to interface GEOS-Chem with CESM and GEOS
|N/A
|GCClassic 14.2.1
* [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 (science code)
* [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]
 
|-valign="top"
|[[GEOS-Chem 14.2.0|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
|
*[[GEOS-Chem_14.2.0#1-month_full-chemistry_benchmarks|1-month benchmarks]]
*[[GEOS-Chem_14.2.0#1-year_full-chemistry_benchmarks|1-year full-chemistry benchmarks]]
*[[GEOS-Chem_14.2.0#1-year_transport_tracers_benchmarks|1-year transport tracer benchmarks]]
|
GC Classsic 14.2.0
*DOI: [https://doi.org/10.5281/zenodo.8411496 10.5281/zenodo.8411496]
GCHP 14.2.0
*DOI: [https://doi.org/10.5281/zenodo.8411829 10.5281/zenodo.8411829]
GEOS-Chem 14.2.0 (science code)
*DOI: [https://doi.org/10.5281/zenodo.8411433 10.5281/zenodo.8411433]
HEMCO 3.7.0
*DOI: [https://doi.org/10.5281/zenodo.8411445 10.5281/zenodo.8411445]
 
|}
 
=== 14.1 ===
 
{| border=1 cellspacing=0 cellpadding=5
|-valign="top" bgcolor="#cccccc"
!width="75px"|Version
!width="100px"|Released
!width="360px"|Important features
!width="200px"|Benchmarks
!width="250px"|DOIs & AMIs
 
|-valign="top"
|[[GEOS-Chem 14.1.1|14.1.1]]
|03 Mar 2023
|See the [[GEOS-Chem 14.1.1]] page for a complete list of updates, including:
* Fixes for several bugs and issues
* Updated to HEMCO 3.6.2
* Updated user registration
* Updated GitHub issue templates
* Updates for interfacing to external models (GEOS, CESM, WRF)
* Updated integration tests
* NOTE: This version has zero differences w/r/t the 14.1.0 benchmarks
|N/A
|
GC Classic 14.1.1
*DOI: [https://doi.org/10.5281/zenodo.7696651 10.5281/zenodo.7696651]
GCHP 14.1.1
*DOI: [https://doi.org/10.5281/zenodo.7696683 10.5281/zenodo.7696683]
GEOS-Chem 14.1.1 (science code)
*DOI: [https://doi.org/10.5281/zenodo.7696632 10.5281/zenodo.7696632]
HEMCO 3.6.1
*DOI: [https://doi.org/10.5281/zenodo.7692950 10.5281/zenodo.7689762]
HEMCO 3.6.2
*DOI: [https://doi.org/10.5281/zenodo.7692950 10.5281/zenodo.7692950]
 
|-valign="top"
|[[GEOS-Chem 14.1.0|14.1.0]]
|01 Feb 2023
|See the [[GEOS-Chem 14.1.0]] page for a complete list of updates, including:
*Mechanisms rebuilt with KPP 3.0.0, with auto-reduction option
*Carbon simulation using a KPP-generated mechanism
*Improved Hg0 dry deposition and AMAP Hg emissions
*Option to use HTAPv3 global emissions
*Option to archive species concentrations in molec cm-3
*NetCDF satellite timeseries diagnostics replacing binary ND51
*Cleanup of memory leaks
*Time-averaged file timestamps changed from midpoint to start
*GCHP tagged O3 simulation
*MAPL updated to version 2.26.0
|
*[[GEOS-Chem_14.1.0#1-month_full-chemistry_benchmarks|1-month benchmarks]]
|
GC Classic 14.1.0
*DOI: [https://doi.org/10.5281/zenodo.7600579 10.5281/zenodo.7600579]
GCHP 14.1.0
*DOI: [https://doi.org/10.5281/zenodo.7600586 10.5281/zenodo.7600586]
GEOS-Chem 14.1.0 (science code)
*DOI: [https://doi.org/10.5281/zenodo.7600404 10.5281/zenodo.7600404]
HEMCO 3.6.0
*DOI: [https://doi.org/10.5281/zenodo.7600424 10.5281/zenodo.7600424]
 
|}
 
=== 14.0 ===
 
{| border=1 cellspacing=0 cellpadding=5
|-valign="top" bgcolor="#cccccc"
!width="75px"|Version
!width="100px"|Released
!width="360px"|Important features
!width="200px"|Benchmarks
!width="250px"|DOIs & AMIs
 
|-valign="top"
|[[GEOS-Chem 14.0.2|14.0.2]]
|29 Nov 2022
|See the [[GEOS-Chem 14.0.2]] page  for a complete list of updates, including:
*Update sample full-chemistry restart files to 10-year benchmark output for 14.0.0
*Add several fixes to CH4 simulation
*Flush GEOS-Chem restart files to disk immediately after writing
*Remove memory leaks from GEOS-Chem and HEMCO
*Update HEMCO to version 3.5.2
*Improve HEMCO error messages
*Add sanitize compile option to HEMCO
|N/A
|GC Classic 14.0.2
*DOI: [https://doi.org/10.5281/zenodo.7383492 10.5281/zenodo.7383492]
GCHP 14.0.2
*DOI: [https://doi.org/10.5281/zenodo.7383532 10.5281/zenodo.7383532]
GEOS-Chem 14.0.2 (science code)
*DOI: [https://doi.org/10.5281/zenodo.7383132 10.5281/zenodo.7383132]
HEMCO 3.5.2
*DOI: [https://doi.org/10.5281/zenodo.7383390 10.5281/zenodo.7383390]


==== Run0 ====
|-valign="top"
|[[GEOS-Chem 14.0.1|14.0.1]]
|31 Oct 2022
|See the [[GEOS-Chem 14.0.1]] page  for a complete list of updates, including:
* Fix typo for AEIC2019 emissions in aerosol-only simulations
* Fix units metadata for PHIS and AirNumDen
* Add fix for activating ND51 satellite diagnostic
* Point species concentration array pointers to GCHP internal state
* Fix incorrect non-species data in GCHP mid-run checkpoint files
* Document and cleanup GCHP run script operational examples
|N/A
|GC Classic 14.0.1
*DOI: [https://doi.org/10.5281/zenodo.7271974 10.5281/zenodo.7271974]
*AMI: ami-08cd37668e1158330
GCHP 14.0.1
*DOI: [https://doi.org/10.5281/zenodo.7271982 10.5281/zenodo.7271982]
GEOS-Chem 14.0.1 (science code)
*DOI: [https://doi.org/10.5281/zenodo.7271960 10.5281/zenodo.7271960]


The 3 models compared (and their colors on the plots) were:
|-valign="top"
|[[GEOS-Chem 14.0.0|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
|
*[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]
*[http://wiki.seas.harvard.edu/geos-chem/index.php/GEOS-Chem_14.0.0#10-year_full-chemistry_benchmarks 10-year benchmarks]
|GC Classic 14.0.0
*DOI: [https://doi.org/10.5281/zenodo.7254984 10.5281/zenodo.7254984]
GCHP 14.0.0
*DOI: [https://doi.org/10.5281/zenodo.7254990 10.5281/zenodo.7254990]
GEOS-Chem 14.0.0 (science code)
*DOI: [https://doi.org/10.5281/zenodo.7254288 10.5281/zenodo.7254288]
HEMCO 3.5.0
*DOI: [https://doi.org/10.5281/zenodo.7254056 10.5281/zenodo.7254056]


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


NOTES for Run0:
== GEOS-Chem 13 release series ==
# 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.
Manual pages for the GEOS-chem 13 release series:
# 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.]
*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
 


==== Run1 ====
|-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]


The 3 models compared (and their colors on the plots) were:
|-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
|- 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           
|           
|  
|  
|}
|}


NOTES for Run1:
=== 13.3 ===
# 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.
{| border=1 cellspacing=0 cellpadding=5
# 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.]
|-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 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]


=== Release Notes ===
|-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]


Contains everything in v7-04-12, with the following additions:
|-valign="top"
|[[GEOS-Chem 13.3.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
*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]


# Offline H2/HD simulation (cf. Lyatt Jaegle et al)
|-valign="top"
# [[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.
|[[GEOS-Chem 13.3.1|13.3.1]]
# [[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]]
|15 Nov 2021
# [[NOx-Ox-HC-aerosol#variable_tropopause|Bug fix -- cap variable tropopause at 200hPa for polar regions (90S-60S and 60N-90N)]]
|See the [[GEOS-Chem 13.3.1]] page for a complete list of updates, including:
# [[Lightning_NOx_emissions#24-Sep-2007|Lee Murray's local lightning redistribution of lightning flashes]]
* Nested grid simulations (except CH4) at 0.5° x 0.625° now use default timesteps of 600 s (transport) and 1200 s (chemistry)
# Minor bug fixes for GCAP and diagnostics
* 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]


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


=== 1-Year Benchmarks ===
|}


==== Run ====  
=== 13.2 ===


The 3 models compared (and their colors on the plots) were:
{| 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.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]
 
|-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]


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


NOTES:
=== 13.1 ===
# 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="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]
 
|}
 
=== 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
|
*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"
|[[GEOS-Chem v11-02|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
|
*[[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
*Species Database
*Air moisture fixes and updates
*Compatibility with the GNU Fortran compiler
*Updated emissions
*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
*Online radiative transfer (RRTMG)
|
*[[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)
|
*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
|
*[[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
|
*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)
|
*[[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
*GFED3 biomass emissions
*RETRO Anthropogenic Emissions
|
*[[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 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]]
|
 
|}


== v7-04-12 ==
== GEOS-Chem benchmarking information ==
BETA RELEASE October 2007


=== Release Notes ===
=== GEOS-Chem Benchmarking Procedure ===
# [[NOx-Ox-HC-aerosol#Variable_Tropopause|Variable tropopause]] has bug fix from v7-04-11 but not 200 hPa cap at polar latitudes
# 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.


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


We have already done the following 1-year benchmark simulations:
=== Mean OH from GEOS-Chem 1-year benchmark simulations ===


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


==== Run1 ====
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.
In FTP directory: <tt>/as2/pub/ftp/pub/geos-chem/1yr_benchmarks/v7-04-12/geos4/2005/Run1</tt>
View via the web: [http://www.as.harvard.edu:16080/ctm/geos/G/v7-04-12/geos4/2005/Run1/output/pdf/]


* Run w/ 4x5 GEOS-4 for met field year 2005 (spun up thru 2003 & 2004)
=== GEOS-Chem Benchmark Performance ===
* 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 FTP directory: <tt>/pub/geos-chem/1yr_benchmarks/v7-04-12/geos4/2005/Run2</tt>
View via the web: [http://www.as.harvard.edu:16080/ctm/geos/G/v7-04-12/geos4/2005/Run2/output/pdf/]


* Run w/ GEOS-4 for met field year 2005 (spun up thru 2003 & 2004)
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]].
* 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

Revision as of 17:43, 31 May 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-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.4

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

GCClassic 14.4.0

GCHP 14.4.0

GEOS-Chem 14.4.0 (science code)

HEMCO 3.9.0

14.3

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

GCClassic 14.3.1

GCHP 14.3.1

GEOS-Chem 14.3.1 (science code)

HEMCO 3.8.1

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

GC Classsic 14.3.0

GCHP 14.3.0

GEOS-Chem 14.3.0 (science code)

HEMCO 3.8.0

14.2

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

GCHP 14.2.3

GEOS-Chem 14.2.3 (science code)

HEMCO 3.7.2

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

GCHP 14.2.2

GEOS-Chem 14.2.2 (science code)

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

GCHP 14.2.1

GEOS-Chem 14.2.1 (science code)

HEMCO 3.7.1

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

GC Classsic 14.2.0

GCHP 14.2.0

GEOS-Chem 14.2.0 (science code)

HEMCO 3.7.0

14.1

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

GC Classic 14.1.1

GCHP 14.1.1

GEOS-Chem 14.1.1 (science code)

HEMCO 3.6.1

HEMCO 3.6.2

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

GC Classic 14.1.0

GCHP 14.1.0

GEOS-Chem 14.1.0 (science code)

HEMCO 3.6.0

14.0

Version Released Important features Benchmarks DOIs & AMIs
14.0.2 29 Nov 2022 See the GEOS-Chem 14.0.2 page for a complete list of updates, including:
  • Update sample full-chemistry restart files to 10-year benchmark output for 14.0.0
  • Add several fixes to CH4 simulation
  • Flush GEOS-Chem restart files to disk immediately after writing
  • Remove memory leaks from GEOS-Chem and HEMCO
  • Update HEMCO to version 3.5.2
  • Improve HEMCO error messages
  • Add sanitize compile option to HEMCO
 N/A GC Classic 14.0.2

GCHP 14.0.2

GEOS-Chem 14.0.2 (science code)

HEMCO 3.5.2

14.0.1 31 Oct 2022 See the GEOS-Chem 14.0.1 page for a complete list of updates, including:
  • Fix typo for AEIC2019 emissions in aerosol-only simulations
  • Fix units metadata for PHIS and AirNumDen
  • Add fix for activating ND51 satellite diagnostic
  • Point species concentration array pointers to GCHP internal state
  • Fix incorrect non-species data in GCHP mid-run checkpoint files
  • Document and cleanup GCHP run script operational examples
 N/A GC Classic 14.0.1

GCHP 14.0.1

GEOS-Chem 14.0.1 (science code)

14.0.0 25 Oct 2022 See the GEOS-Chem 14.0.0 page for a complete list of updates, including:
  • Converted input.geos to geoschem_config.yml
  • Fixed bugs causing differences when splitting up simulations in time
  • Remove unnecessary met-fields from GCClassic restart file
  • Updated offline emissions
  • Rebuilt mechanisms with KPP 2.5.0
  • Changed 4D State_Chm%Species array to vector of 3D arrays
  • Boundary conditions are now saved on first timestep
  • Updated HEMCO to version 3.5.0
  • Updated GMAO libraries for GCHP
  • Added option to use native GEOS-FP winds for GCHP
  • Fixed bug in GCHP vertical mass flux diagnostic
  • Fix compilation errors for custom mechanism
  • Bug fixes for the Hg simulation
  • Updates for GEOS from GMAO
  • Updates for GEOS-Chem and HEMCO in CESM
  • Updates for GEOS-Chem in WRF-GC
  • Use newest CEDS data in CO2 simulation
  • Fix typo in HEMCO_Config.rc for GCHP
  • Bug fix in rundir creation for GCAP2
  • GEOS-Chem user registration
 GC Classic 14.0.0

GCHP 14.0.0

GEOS-Chem 14.0.0 (science code)

HEMCO 3.5.0

GEOS-Chem 13 release series

Manual pages for the GEOS-chem 13 release series:

13.4

Version Released Important features Benchmarks DOIs & AMIs


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

GCHP 13.4.1

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

GCHP 13.4.0

HEMCO 3.4.0

GCPy 1.2.0

13.3

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

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

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

GCHP 13.3.4

13.3.3 02 Dec 2021

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

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

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

GCHP 13.3.3

HEMCO 3.2.2

13.3.2 18 Nov 2021

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

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

GCHP 13.3.2

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

GCHP 13.3.1

HEMCO 3.2.1

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

GCHP 13.3.0

HEMCO 3.2.0

13.2

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

GCHP 13.2.1

HEMCO 3.1.1

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

GCHP 13.2.0

HEMCO 3.1.0

13.1

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

GCHP 13.1.2

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

GCHP 13.1.1

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

GCHP 13.1.0

HEMCO 3.0.0

13.0

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

GCHP 13.0.2

HEMCO 3.0.0-rc.3

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

GCHP 13.0.1

HEMCO 3.0.0-rc.2

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

GCHP 13.0.0

GEOS-Chem 12 release series

Manual pages for the GEOS-chem 12 release series:

12.9

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

12.8

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

12.7

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

12.6

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

12.5

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

12.4

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

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

10.5281/zenodo.3360635

12.3

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


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

12.2

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

12.1

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

12.0

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

GEOS-Chem 11 release series

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

GEOS-Chem 10 release series

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

GEOS-Chem 9 release series

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

GEOS-Chem 8 release series

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

GEOS-Chem 7 release series

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

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.

Retrieved from "https://wiki.seas.harvard.edu/geos-chem/index.php?title=GEOS-Chem_versions&oldid=53754"