Difference between revisions of "GEOS-Chem versions"

From Geos-chem
Jump to: navigation, search
(1-year benchmarks)
(358 intermediate revisions by 5 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, Dylan Millet, Palmer group @ U. Edinburgh)
+
*GCC = GEOS-Chem "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 March 10, 2009
+
  
Will contain everything in [[#v8-01-03|v8-01-03]] plus the following updates:
+
== GEOS-Chem 13 release series ==
  
# Annual scale factors for NOx-CO-SOx from, applied to ALL inventory if needed (Aaron)
+
Manual pages for the GEOS-chem 13 release series:
# 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)
+
  
Philippe Le Sager has prepared [http://wiki.seas.harvard.edu/geos-chem/images/Anth_emiss_gc_v8-01-04.pdf a document (PDF format)] which describes the anthropogenic emissions sources in some detail.
+
*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]
  
=== 1-year benchmarks ===
+
=== 13.2 ===
  
==== Run0 - v8-01-04 ====
+
{| 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
  
The 3 models compared (and their colors on the plots) were:
+
|-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]
 +
*AMI: ami-0c34ff4c0555df2cc
 +
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 Field Type
 
! A.T.E. algorithm
 
! Anthro Emissions
 
! Biogenic Emissions
 
! Advection
 
! Annual Mean OH<br>[10<sup>5</sup> molec/cm3]
 
|-align="center"
 
| Red 
 
| [[#Run0|v8-01-01 Run0]]
 
| 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" MEGAN AEF's for isoprene
 
| "old" tpcore
 
| 12.006
 
|-align="center"                                   
 
| Green
 
| [[#Run1|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" MEGAN AEF's for isoprene
 
| "old" tpcore
 
| 12.040
 
|-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
 
| [[Biogenic_emissions#Updated_annual_emission_factor_for_Isoprene|"new" MEGAN AEF's for isoprene]]
 
| "new" tpcore
 
| 10.689
 
|-align="center"
 
| Black
 
| Observations           
 
| &nbsp;         
 
| &nbsp;
 
| &nbsp;
 
| &nbsp;
 
| &nbsp;
 
| &nbsp;
 
 
|}
 
|}
  
NOTES for Run0:
+
=== 13.1 ===
# 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.
+
  
The output plots for Run0 may be downloaded from:
+
{| 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
  
ftp ftp.as.harvard.edu
+
|-valign="top"
cd pub/geos-chem/1yr_benchmarks/v8-01-04/geos5/2005/Run0/output
+
|[[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]
  
==== Run1 - v8-01-04 ====
+
|-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]
 +
*AMI: ami-08831be62fcaad16c
 +
GCHP 13.1.1
 +
*DOI: [https://doi.org/10.5281/zenodo.5014888 10.5281/zenodo.5014888]
  
The 3 models compared (and their colors on the plots) were:
+
|-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]
 +
*AMI: ami-0ec4dce44bcb05b69
 +
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 Field Type
 
! A.T.E. algorithm
 
! Anthro Emissions
 
! Biogenic Emissions
 
! Advection
 
! Annual Mean OH<br>[10<sup>5</sup> molec/cm3]
 
|-align="center"                                   
 
| Red
 
| [[#Run1|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" MEGAN AEF's for isoprene
 
| "old" tpcore
 
| 12.040
 
|-align="center"
 
| Green 
 
| [[#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
 
|[[Biogenic_emissions#Updated_annual_emission_factor_for_Isoprene|"new" MEGAN AEF's for isoprene]]
 
| "new" tpcore
 
| 10.689
 
|-align="center"
 
| Blue
 
| [[#Run1 - v8-01-04|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
 
| [[Biogenic_emissions#Updated_annual_emission_factor_for_Isoprene|"new" MEGAN AEF's for isoprene]]
 
| "new" tpcore
 
| 10.294
 
|-align="center"
 
| Black
 
| Observations           
 
| &nbsp;         
 
| &nbsp;
 
| &nbsp;
 
| &nbsp;
 
| &nbsp;
 
| &nbsp;
 
 
|}
 
|}
  
NOTES for Run1:
+
=== 13.0 ===
# This benchmark uses the same input conditions v8-01-04 Run0.
+
# NOTE: v8-01-04 Run1 uses the "approximate random cloud overlap" option in FAST-J, whereas v8-01-04 Run0 used the "linear overlap option".  Please see the [[Photolysis_mechanism#Cloud_overlap_options_in_FAST-J|cloud overlap options in FAST-J]] page for more information.
+
# All runs use the same biomass (GFED2 monthly), biofuel, biogenic (MEGAN), lightning, and aircraft emissions.
+
  
The output plots for Run1 may be downloaded from:
+
{| 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
  
ftp ftp.as.harvard.edu
+
|-valign="top"
cd pub/geos-chem/1yr_benchmarks/v8-01-04/geos5/2005/Run1/output
+
|[[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]
  
=== Post-release patches ===
+
|-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]
 +
*AMI: ami-0ebb738afafa614cf
 +
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]
  
A couple of issues were reported after the release of v8-01-04:
+
|-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]
 +
*AMI: ami-0ef2c8a2d3464485c
 +
GCHP 13.0.0
 +
*DOI [https://doi.org/10.5281/zenodo.4618205 10.5281/zenodo.4618205]
 +
|}
  
'''''Fabien Paulot (fabienpaulot@gmail.com) wrote:'''''
+
== GEOS-Chem 12 release series ==
  
:The tracer id is hardcoded in the sulfate module (<tt>sulfate_mod.f</tt> which causes error when calling the ship emission module (<tt>GET_EMEP_ANTHRO</tt>) if the user wants to modify the tracer list.  I just replaced 26 by <tt>IDTSO2</tt> and 30 by <tt>IDTNH3</tt> to fix the problem.  See line 6594.
+
Manual pages for the GEOS-chem 12 release series:
  
This issue was due to a typo in <tt>sulfate_mod.f</tt>. The error only occurred during aerosol-only offline simulations.
+
*[[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 ===
  
'''''Prasad Kasibhatla (psk9@duke.edu) wrote:'''''
+
{| 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
  
:I also noticed in the standard distribution, that the CPU time for the one month full chem simulation at Harvard went from 56 minutes for v8-01-02 to 75 minutes for v8-01-03 to 121 minutes for v8-01-04, an increase of a factor of 2.2. I was wondering if you have looked at this slowdown?
+
|-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]
  
This issue was traced to the way the <tt>!$OMP PARALLEL DO</tt> loops were implemented in the TPCORE advection module <tt>tpcore_fvdas_mod.f</tt>. Claire Carouge has fixed this by changing the order of some of the parallel loops in the code. The updated TPCORE now runs much faster than before!
+
|-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]
  
'''''Hongyu Liu (hyl@nianet.org) reported:'''''
+
|-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]
 +
*[http://acmg.seas.harvard.edu/publications/2020/Shah_2020.pdf 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]
  
:The following references need to be deleted from the OBJS section in the Makefile:
+
|}
  
    arctas_ship_emiss_mod.o      \
+
=== 12.8 ===
    cac_anthro_mod.o              \
+
    scale_anthro_mod.o            \
+
    tpcore_fvdas_mod.o            \
+
    vistas_anthro_mod.o          \
+
  
:since these are already listed in the MODS section.  Having these listed twice will cause a link-time error.
+
{| 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]
  
'''''Colette Heald (heald@atmos.colostate.edu) wrote:'''''
+
|-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]
  
:I wanted to let you know that to get v8-01-04 to compile [with the SunStudio compiler], I needed to modify the code in <tt>Makefile.sparc</tt> on L354 (i.e. under the line for <tt>gamap_mod.o</tt>) from:
+
|-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]
  
    f90 -fpp -stackvar -O0 -xfilebyteorder=big16:%all
+
|}
  
:to the following:
+
=== 12.7 ===
  
    f90 -fpp -O0 -stackvar -xfilebyteorder=big16:%all $(FARCH) -c $*.f
+
{| 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
  
:otherwise it fails in <tt>input_mod.f</tt> compilation with messages that it did not recognize <tt>gamap_mod.f</tt>.
+
|-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]
  
:I also wanted to point out that there is a syntax error on L1040 of <tt>rpmares_mod.f</tt> (a comma after the write(6,*) but before the statement), which can cause compile to fail depending on the compiler options.
+
|-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]
  
'''''Fabien Paulot (fabienpaulot@gmail.com) also reported...'''''
+
|}
  
:..an overestimate in the North-South mass flux computed in the new TPCORE. A geometric scale factor was applied twice when computing the flux. The updated TPCORE now correctly computes the NS mass flux.
+
=== 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
  
All users of GEOS-Chem v8-01-04 should replace the existing versions of <tt>sulfate_mod.f</tt> and <tt>tpcore_fvdas_mod.f</tt> with the fixed files. If you are using the PGI compiler, then also get the new <tt>Makefile.pgi</tt> file. If you are using the SunStudio compiler, then get the new <tt>Makefile.sparc</tt> file.
+
|-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]
  
The updated files are available for download from:
+
|-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]
  
ftp ftp.as.harvard.edu
+
|-valign="top"
  cd pub/geos-chem/patches/v8-01-04
+
|[[GEOS-Chem 12#12.6.1|12.6.1]]
get sulfate_mod.f
+
|28 Oct 2019
get tpcore_fvdas_mod.f90
+
|Contains several bug fixes. See:
get Makefile.sparc
+
*[https://github.com/geoschem/geos-chem/milestone/5?closed=1 geoschem/geos-chem: Milestone 12.6.1]
get Makefile.pgi
+
|
 +
|[https://doi.org/10.5281/zenodo.3520966 10.5281/zenodo.3520966]
  
===Note===
+
|-valign="top"
All users of GEOS-Chem v8-01-04 should turn on the mass flux diagnostics (ND24/ND25/ND26) in input.geos to be safe. See [[Bugs_and_fixes#Unallocated_Diagnostic_Arrays_in_TPCORE|this bug report]].
+
|[[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]
  
--[[User:Bmy|Bob Y.]] 10:31, 2 April 2009 (EDT)
+
|}
  
== v8-01-03 ==
+
=== 12.5 ===
BETA RELEASE December 2008
+
  
Contains everything in [[#v8-01-02|v8-01-02]] plus the following updates:
+
{| 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
  
* [[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]]
+
|-valign="top"
* [[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]]
+
|[[GEOS-Chem 12#12.5.0|12.5.0]]
* [[Previous issues now resolved in v8-01-03#Bug fixes in diag3.f|Minor bug fixes in diag3.f]]
+
|09 Sep 2019
* [[Previous_issues_now_resolved_in_v8-01-03#Change_of_location_of_calls_to_diagnostics_in_main.f|Minor diagnostic fixes in main.f]]
+
|
 +
*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]
  
== v8-01-02 ==
+
|}
BETA RELEASE November 2008
+
  
Contains everything in [[#v8-01-01|v8-01-01]], with the following additions:
+
=== 12.4 ===
  
* GEOS-5 0.5 x 0.666 degree nested-grid simulation for China/SE Asia
+
{| border=1 cellspacing=0 cellpadding=5
* Improvements to the GEOS-3 1x1 nested-grid simulation for N. America
+
|-valign="top" bgcolor="#cccccc"
* Modifications for using reprocessed GEOS-5 met fields (i.e. w/ corrected optical depths)
+
!width="75px"|Version
* [[Previous issues now resolved in v8-01-02|Several bug fixes and improvements for robustness, scientific algorithms, and diagnostics]]
+
!width="100px"|Released
 +
!width="360px"|Important features
 +
!width="200px"|Benchmarks
 +
!width="250px"|DOI
  
== v8-01-01 ==
+
|-valign="top"
PUBLIC RELEASE May 2008
+
|[[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]
  
Contains everything in [[#v7-04-13|v7-04-13]], with the following additions:
+
|}
# Compatibility for [[GEOS-5 issues|GEOS-5]] met fields.
+
 
# Now uses [[Aerosol thermodynamical equilibrium#RPMARES|RPMARES]] instead of [[Aerosol thermodynamical equilibrium#ISORROPIA|ISORROPIA]]
+
=== 12.3 ===
# 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"|DOI
  
=== 1-Year Benchmarks ===
+
|-valign="top"
 +
|[[GEOS-Chem 12#12.3.2|12.3.2]]
 +
|02 May 2019
 +
|
 +
*[[#Inconsistency in H2402 concentrations in GCHP vs GEOS-Chem Classic|Remove inconsistency for H2402 between GCHP and GCC]]
 +
*Bug fixes for FAST-JX
 +
*Updates for HEMCO diagnostics
 +
*Use the same Br2 seasalt emissions in both GCHP and GCC
 +
*Updates for GCHP run directories
 +
|This is an unofficial benchmark and the first GCHP benchmark using [https://github.com/geoschem/gcpy GCPy]
 +
*[[Benchmark/GEOS-Chem_12.3.2#GEOS-Chem_Classic_1-month_benchmark|1-month GCC]]
 +
*[[Benchmark/GEOS-Chem_12.3.2#GCHP_1-month_benchmark|1-month GCHP]]
 +
|[https://doi.org/10.5281/zenodo.2658178 10.5281/zenodo.2658178]
  
We have done two 1-year benchmarks for GEOS-Chem v8-01-01:
+
|-valign="top"
 +
|[[GEOS-Chem 12#12.3.1|12.3.1]]
 +
|08 Apr 2019
 +
|
 +
*[[List_of_diagnostics_archived_to_netCDF_format#The_JValuesLocalNoon_collection|Fix for noontime J-values diagnostic]]
 +
*[[Planeflight_diagnostic#Planeflight_diagnostic_now_writes_out_data_for_the_last_timestep_of_the_day|Fix for planeflight diagnotic]]
 +
*[[Stratospheric_chemistry#Do not allocate memory to array MINIT in strat_chem_mod.F90|Don't allocate the MINIT array]]
 +
*[[GEOS-Chem 12#Declare State_Met%AREA_M2 as 2-dimensional, not 3-dimensional|Declare State_Met%AREA_M2 as 2-D]]
 +
|
 +
|[https://doi.org/10.5281/zenodo.2633278 10.5281/zenodo.2633278]
  
==== Run0 ====
 
  
The 3 models compared (and their colors on the plots) were:
+
|-valign="top"
 +
|[[GEOS-Chem 12#12.3.0|12.3.0]]
 +
|01 Apr 2019
 +
|
 +
*[[ISORROPIA_II#Investigating_persistent_noise_observed_in_ISORROPIA_output|Update ISORROPIA from v2.0 to v2.2, in order to remove persistent noise in output]]
 +
*[[MEGAN_v2.1_plus_Guenther_2012_biogenic_emissions#Updated_PFT_file|Updated PFT file for MEGAN]]
 +
*[[Volcanic_SO2_emissions#Bug_fix_for_eruptive_volcanic_emissions|Bug fix for eruptive volcanic emissions]]
 +
*Read in and regrid existing MODIS LAI and OLSON data via HEMCO
 +
*Update from [[HEMCO_versions#HEMCO_development_history|HEMCO version]] 2.1.011 to 2.1.012
 +
*[[#GCHP_adjoint_development_requires_time_to_run_backwards_in_GCHP|Enable running time backwards in GCHP]]
 +
|This is the first benchmark to utilize [https://github.com/geoschem/gcpy GCPy]
 +
*[[Benchmark/GEOS-Chem_12.3.0|1-month GCC]]
 +
|[https://doi.org/10.5281/zenodo.2620535 10.5281/zenodo.2620535]
  
{| border=1 cellspacing=0 cellpadding=5
 
|- bgcolor="#CCCCCC"
 
! Color
 
! Quantity Plotted
 
! Met Field Type
 
! Lightning algorithm
 
! A.T.E. algorithm
 
! Annual Mean OH<br>[10<sup>5</sup> molec/cm3]
 
|-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]]
 
| 12.816
 
|-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]]
 
| 12.147
 
|-align="center"
 
| Blue 
 
| v8-01-01 Run0   
 
| GEOS-5 4x5
 
| updated non-near-land w/ OTD-LIS local scaling
 
| [[Aerosol_thermodynamical_equilibrium#ISORROPIA|ISORROPIA]]
 
| 12.006
 
|-align="center"
 
| Black
 
| Observations           
 
| &nbsp;         
 
| &nbsp;
 
| &nbsp;
 
| &nbsp;
 
 
|}
 
|}
  
NOTES for Run0:
+
=== 12.2 ===
# 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="75px"|Version
 +
!width="100px"|Released
 +
!width="360px"|Important features
 +
!width="200px"|Benchmarks
 +
!width="250px"|DOI
  
The 3 models compared (and their colors on the plots) were:
+
|-valign="top"
 +
|[[GEOS-Chem 12#12.2.1|12.2.1]]
 +
|28 Feb 2019
 +
|
 +
*[[#Bug fix: netCDF diagnostic collections with frequency "End" now properly span leap year days|Bug fix: netCDF diagnostic collections with frequency "End" now properly span leap year days]]
 +
*[[Mercury#Polar_bromine_explosion_default_option|Make polar bromine explosion the default option in Hg simulation]]
 +
*[[TOMAS_aerosol_microphysics#Biomass_burning_subgrid_coagulation_switch|Add biomass burning subgrid coagulation option]]
 +
*[[TOMAS_aerosol_microphysics#Restore_DST1.2C_DST2.2C_DST3.2C_and_DST4_in_TOMAS_simulations|Restore DST1, DST2, DST3, and DST4 in TOMAS]]
 +
*[[List_of_diagnostics_archived_to_netCDF_format|Add RRTMG fluxes to netCDF diagnostics]]
 +
*[[CO2_simulation#Prevent_double-counting_in_CO2_chemical_source|Fix for CO2 simulation chemical source]]
 +
*[[GEOS-Chem_12#Missing_scaling_factors_for_MERRA-2_simulations_with_GCHP|Missing scaling factors for MERRA-2 simulations with GCHP]]
 +
*[[GEOS-Chem_12#Use_online_sea_flux_emissions_by_default_in_GCHP|Use online sea flux emissions by default in GCHP]]
 +
|
 +
|[https://doi.org/10.5281/zenodo.2580198 10.5281/zenodo.2580198]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.2.0|12.2.0]]
 +
|19 Feb 2019
 +
|
 +
*[[Transport_Working_Group#Transport_Tracers_simulation|Transport Tracers simulation: a common set of tracers in GEOS-Chem and GEOS]]
 +
*[[ObsPack diagnostic]]
 +
*[[GFAS biomass burning emissions]]
 +
*[[GEOS-Chem_12#ESMF_version_update_required_for_MAPL_upgrade|Update ESMF version  in GCHP from v5.2.0rp2 to v7.1.0r]]
 +
|1st version to have the new [[Transport_Working_Group#Transport_Tracers_simulation|Transport Tracer benchmark]] (replaces Rn-Pb-Be benchmark)
 +
*[[GEOS-Chem_12_benchmark_history#12.2.0|1-month GCC]]
 +
*[[GEOS-Chem_12_benchmark_history#12.2.0-TransportTracers|1-year transport]]
 +
|[https://doi.org/10.5281/zenodo.2572887 10.5281/zenodo.2572887]
  
{| border=1 cellspacing=0 cellpadding=5
 
|- bgcolor="#CCCCCC"
 
! Color
 
! Quantity Plotted
 
! Met Field Type
 
! Lightning algorithm
 
! A.T.E. algorithm
 
! Annual Mean OH<br>[10<sup>5</sup> molec/cm3]
 
|-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]]
 
| 12.147
 
|-align="center"
 
| Green 
 
| [[#Run0|v8-01-01 Run0]]
 
| GEOS-5 4x5
 
| updated non-near-land w/ OTD-LIS local scaling
 
| [[Aerosol_thermodynamical_equilibrium#ISORROPIA|ISORROPIA]]
 
| 12.006
 
|-align="center"
 
| Blue
 
| v8-01-01 Run1 
 
| GEOS-5 4x5
 
| updated non-near-land w/ OTD-LIS local scaling
 
| [[Aerosol_thermodynamical_equilibrium#RPMARES|RPMARES]]
 
| 12.040
 
|-align="center"
 
| Black
 
| Observations           
 
| &nbsp;         
 
| &nbsp;
 
| &nbsp;
 
| &nbsp;
 
 
|}
 
|}
  
NOTES for Run1:
+
=== 12.1 ===
# 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.
+
# 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.]
+
  
=== Post-release patches ===  
+
{| 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
  
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.  
+
|-valign="top"
 +
|[[GEOS-Chem 12#12.1.1|12.1.1]]
 +
|13 Dec 2018
 +
|
 +
*[[Tagged CO simulation#Do not multiply emission timestep by 60|Bug fix for tagged CO]]
 +
*[[GEOS-Chem_12#Skip_planeflight_observations_outside_a_nested_domain|Skip planeflight observations outside a nested domain]]
 +
*[[GEOS-Chem_12#Always_enable_BCPH_TPBC_to_allow_saving_out_BC_files_in_global_simulations|Always compile with BCPH_TPBC=y]]
 +
*Fix compilation issues, see [https://github.com/geoschem/geos-chem/commit/096ad29d02afbdba64a5dd138df0c976ddee3140 (1)] & [https://github.com/geoschem/geos-chem/commit/f9b2f19593afeaa396ff3ee3d315148d5a6f8600 (2)]
 +
*[[GEOS-Chem_12#GCHP_transport_fix_to_prevent_instant_propagation_from_troposphere_to_stratosphere|GCHP transport fix]]
 +
|
 +
|[https://doi.org/10.5281/zenodo.2249246 10.5281/zenodo.2249246]
  
Please see the following GEOS–Chem wiki pages for information about the following issues, and how to resolve them.
+
|-valign="top"
 +
|[[GEOS-Chem 12#12.1.0|12.1.0]]
 +
|26 Nov 2018
 +
|
 +
*[[List_of_diagnostics_archived_to_netCDF_format#The_Budget_collection|Budget diagnostics]]
 +
*[[Mineral_dust_aerosols#Anthropogenic_PM2.5_dust_source_in_GEOS-Chem|Anthropogenic PM2.5 dust source]]
 +
*[[GEOS-Chem_Output_Files#GEOS-Chem_12|GEOS-Chem restart file updates]]
 +
*[[CEDS_anthropogenic_emissions|Updates and fixes for the CEDS anthropogenic emissions inventory]]
 +
*[[Implementation_of_HEMCO_in_GEOS-Chem#Features_added_in_12.1.0|HEMCO fixes]]
 +
*[[Boundary_layer_mixing#Mass_is_not_conserved_when_using_non-local_PBL_mixing|Fix mass conservation in non-local PBL mixing]]
 +
*[[FlexGrid|FlexGrid Stage 1: Use HEMCO to read met fields]]
 +
*[[GEOS-Chem 12#Add support for continuous integration with TravisCI|Add support for continuous integration with TravisCI]]
 +
|
 +
*[[GEOS-Chem_12_benchmark_history#12.1.0|1-month GCC]]
 +
|[https://doi.org/10.5281/zenodo.1553349 10.5281/zenodo.1553349]
  
'''''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.'''''
+
|}
  
==== Fixes for the full-chemistry simulation ====
+
=== 12.0 ===
  
*[[Bugs_and_fixes#Too_many_levels_in_photolysis_code|"Too many levels" error in the photolysis routine OPMIE.f]]
+
{| border=1 cellspacing=0 cellpadding=5
*[[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]]
+
|-valign="top" bgcolor="#cccccc"
*[[Previous_issues_now_resolved_in_v8-01-02#Numerical_noise_bug_in_upbdflx_mod.f|Numerical noise error in upbdflx_mod.f]]
+
!width="75px"|Version
*[[Previous_issues_now_resolved_in_v8-01-02#Problem_w.2F_ND65_diagnostic_and_dynamic_tropopause|Problem w/ ND65 diagnostic and the dynamic tropopause]]
+
!width="100px"|Released
*[[Common_GEOS-Chem_error_messages#Negative_tracer_found_in_WETDEP|Negative tracer found in WETDEP]]
+
!width="360px"|Important features
*[[GEOS-5_issues#Small_negative_RH_value_in_20060206.a6.2x25_file|Negative relative humidity from met fields causing negative tracer]]
+
!width="200px"|Benchmarks
*[[Aerosol_thermodynamical_equilibrium#Run_dies_in_RPMARES_unexpectedly|Run dies in RPMARES unexpectedly]]
+
!width="250px"|DOI
*[[Aerosol_thermodynamical_equilibrium#RPMARES|Error in sulfate_mod.f caused by switching from ISORROPIA to RPMARES]]
+
  
==== Fixes for offline simulations ====
+
|-valign="top"
 +
|[[GEOS-Chem 12#12.0.3|12.0.3]]
 +
|16 Oct 2018
 +
|
 +
*[[#Fix_incorrect_run_configuration_for_offline_sea_salt_emissions_in_GCHP|Fix incorrect run configuration for offline sea salt emissions in GCHP]]
 +
*[[#Fix_bug_in_application_of_CFC_surface_mixing_ratios_in_GCHP|Fix bug in application of CFC surface mixing ratios in GCHP]]
 +
|
 +
|[https://doi.org/10.5281/zenodo.1464210 10.5281/zenodo.1464210]
  
*[[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]]
+
|-valign="top"
*[[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)]]
+
|[[GEOS-Chem 12#12.0.2|12.0.2]]
 +
|10 Oct 2018
 +
|
 +
*[[GEOS-Chem 12#Fixed_local-time_averaging_in_ND51_and_ND51b_satellite_timeseries_diagnostics|Bug fixes for ND51/ND51b diagnostics]]
 +
*[[TOMAS_aerosol_microphysics#Fixes_for_missing_biomass_emissions_and_incorrect_aerosol_dry_deposition|Bug fixes for TOMAS simulations]]
 +
*[[CO2_simulation#CO2_emissions_are_double_counted|Bug fix for CO2 simulations]]
 +
|
 +
|[https://doi.org/10.5281/zenodo.1455215 10.5281/zenodo.1455215]
  
=== Lines of code ===
+
|-valign="top"
 +
|[[GEOS-Chem 12#12.0.1|12.0.1]]
 +
|24 Aug 2018
 +
|
 +
*[[Mercury#Restore_biomass_emissions_and_do_not_double_count_anthropogenic_emissions|Bug fixes for mercury simulation]]
 +
*[[Intel_Fortran_Compiler#Compilation_issues_with_Intel_Fortran_18|Compatibility with IFORT 18]]
 +
*[[GNU_Fortran_compiler#Compiliation_issues_with_GNU_Fortran_8.2.0|Compatibility with GNU Fortran 8.2.0]]
 +
|
 +
|[https://doi.org/10.5281/zenodo.1403144 10.5281/zenodo.1403144]
  
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 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]
  
Total number of files    :          217
+
|}
Number of files searched :          217
+
Number of files skipped  :            0
+
+
Number of lines searched :      174177
+
Number of comment lines  :        77788
+
Number of blank lines    :        25981
+
Number of code lines    :        70408
+
+
Ratio: Comments/Code    :        1.1048176
+
  
Results were generated with IDL program <tt>linecount.pro</tt> by Bob Yantosca,
+
== GEOS-Chem 11 release series ==
  
--[[User:Bmy|Bob Y.]] 14:27, 8 August 2008 (EDT)
+
{| 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
  
== v7-04-13 ==
+
|-valign="top"
BETA RELEASE November 2007
+
|[[GEOS-Chem v11-02|v11-02-rc]]
 +
|22 Jun 2018
 +
|
 +
*[[GEOS-Chem_HP|GCHP option]]
 +
*[[Halogen_chemistry_mechanism|Halogen chemistry]]
 +
*[[GEOS-Chem_chemistry_mechanisms#Updated_isoprene_and_monoterpene_chemistry|Updated isoprene & monoterpene chemistry]]
 +
*[[Secondary_organic_aerosols#Simple_SOA_scheme|Simple SOA scheme]]
 +
*[[PAN|Updated PAN chemistry]]
 +
*[[GEOS-Chem_v11-02#v11-02f|Several new and updated emissions inventories]]
 +
*[[GEOS-Chem_Output_Files#NetCDF_File_Format|NetCDF diagnostic output]]
 +
|
 +
*[[GEOS-Chem v11-02 benchmark history|v11-02 benchmark history page]]
 +
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.GC_12/index.html v11-02/12.0.0 manual]
  
Contains everything in v7-04-12, with the following additions:
+
|-valign="top"
 +
|[[GEOS-Chem v11-01|v11-01]]
 +
|20 Dec 2016 (provisional)<br>01 Feb 2017 (public)
 +
|
 +
*[[FlexChem]]
 +
*[[MERRA-2]]
 +
*[[GEOS-Chem_species_database|Species Database]]
 +
*[[Moisture_Updates_in_v11-01|Air moisture fixes and updates]]
 +
*[[GNU_Fortran_compiler|Compatibility with the GNU Fortran compiler]]
 +
*[[GEOS-Chem_v11-01#New_data_directories|Updated emissions]]
 +
*[[GEOS-Chem_Output_Files#NetCDF_File_Format|NetCDF restart files]]
 +
|
 +
*[[GEOS-Chem v11-01 benchmark history|v11-01 benchmark history page]]
 +
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v11-01/index.html v11-01 manual]
 +
 
 +
|}
 +
 
 +
== GEOS-Chem 10 release series ==
 +
 
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top" bgcolor="#cccccc"
 +
!width="75x"|Version
 +
!width="100px"|Date released
 +
!width="360px"|Important features
 +
!width="200px"|Benchmarks
 +
!width="250px"|Documentation
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v10-01|v10-01]]
 +
|01 May 2015 (provisional)<br>17 Jun 2015 (public)
 +
|
 +
*[[UCX chemistry mechanism]]
 +
*[[HEMCO]]
 +
*[[Coupling_GEOS-Chem_with_RRTMG|Online radiative transfer]]
 +
|
 +
*[[GEOS-Chem v10-01 benchmark history|v10-01 benchmark history page]]
 +
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v10-01/index.html v10-01 manual]
 +
 
 +
|}
 +
 
 +
== GEOS-Chem 9 release series ==
 +
 
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top" bgcolor="#cccccc"
 +
!width="75px"|Version
 +
!width="100px"|Date released
 +
!width="360px"|Important features
 +
!width="200px"|Benchmarks
 +
!width="250px"|Documentation
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v9-02|v9-02]]
 +
|17 Jan 2014 (provisional)<br>03 Mar 2014 (public)
 +
|
 +
*[[Hudman et al 2012 soil NOx emissions algorithm|Updated soil NOx emissions module]]
 +
*[[POPs simulation]]
 +
*[[Updating standard chemistry with JPL_10-6|Inorganic chemistry updates]]
 +
*[[Methyl peroxy nitrate chemistry]]
 +
*[[New isoprene scheme|Adopt Paulot isoprene scheme as standard]]
 +
*[[Historical and Future Emissions#RCP future emission scenarios|RCP emission scenarios]]
 +
*[[Aircraft_emissions#MIT_aviation_emissions_inventory|AEIC aircraft emissions inventory]]
 +
*[[GEOS-FP|GEOS-FP met fields]]
 +
|
 +
*[[GEOS-Chem v9-02 benchmark history|v9-02 benchmark history page]]
 +
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v9-02/index.html v9-02 manual]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v9-01-03|v9-01-03]]
 +
|14 Sep 2012
 +
|
 +
*[[Acetone|Updated acetone sources & sinks]]
 +
*Improved sea salt [[Sea salt aerosols#SST dependent sea salt emissions|emission]] & [[Sea salt aerosols#Updates to sea salt dry deposition|deposition]]
 +
*Improved [[Wet_deposition#Add_scavenging_by_snow|snow scavenging]] and [[Wet deposition#Updates for aerosol scavenging efficiency|washout parameterization]]
 +
*[[Bromine chemistry mechanism|Tropospheric bromine chemistry]]
 +
*[[Stratospheric chemistry|Stratospheric P and k (monthly climatological)]]
 +
|
 +
*[[GEOS-Chem v9-01-03 benchmark history|v9-01-03 benchmark history page]]
 +
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v9-01-03/index.html v9-01-03 manual]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v9-01-02|v9-01-02]]
 +
|28 Nov 2011
 +
|
 +
*[[APM aerosol microphysics]]
 +
*[[Biomass burning emissions#GFED3|GFED3 biomass emissions]]
 +
*[[Implementation of RETRO Anthropogenic Emissions|RETRO Anthropogenic Emissions]]
 +
*[[GEOS-Chem v9-01-02#Previous issues now resolved in v9-01-02|Various fixes to correct several identified issues]]
 +
|
 +
*[[GEOS-Chem v9-01-02 benchmark history|v9-01-02 benchmark history page]]
 +
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v9-01-02/index.html v9-01-02 manual]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v9-01-01|v9-01-01]]
 +
|07 Jun 2011
 +
|
 +
*Compatibility with the GMAO [[MERRA|MERRA met data product]]
 +
*Updated lightning NOx; various fixes
 +
|
 +
*[[GEOS-Chem v9-01-01 benchmark history|v9-01-01 benchmark history page]]
 +
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/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]]
 +
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/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]]
 +
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/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]]
 +
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/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]]
 +
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/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]]
 +
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/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]]
 +
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/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]]
 +
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/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]]
 +
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/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]]
 +
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/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]]
 +
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v8-01-04/index.html GC v8-01-01 manual]
 +
 
 +
|}
  
# Offline H2/HD simulation (cf. Lyatt Jaegle et al)
+
== GEOS-Chem 7 release series ==
# [[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.
+
# [[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]]
+
# [[NOx-Ox-HC-aerosol#variable_tropopause|Bug fix -- cap variable tropopause at 200hPa for polar regions (90S-60S and 60N-90N)]]
+
# [[Lightning_NOx_emissions#24-Sep-2007|Lee Murray's local lightning redistribution of lightning flashes]]
+
# Minor bug fixes for GCAP and diagnostics
+
  
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".
+
{| 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
  
=== 1-Year Benchmarks ===
+
|-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]]
 +
|
  
==== Run ====
+
|-valign="top"
 +
|[[GEOS-Chem v7-04-12|v7-04-12]]
 +
|Oct 2007
 +
|
 +
*Introduction of dynamic tropopause
 +
|
 +
*Archived to storage; contact [[GCST]]
 +
|
  
The 3 models compared (and their colors on the plots) were:
+
|-valign="top"
 +
|[http://acmg.seas.harvard.edu/geos/geos_versions.html v7-04-11 and earlier]
 +
|March 2006 and earlier
 +
|
 +
|
 +
*Archived to storage; contact [[GCST]]
 +
|
  
{| 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:
+
NOTE: For information about 1-year benchmark simulations for GEOS-Chem v8-02-04 and earlier, see [http://acmg.seas.harvard.edu/geos/geos_1yr_plots.html this website].
# Results from v7-04-13-Run can be downloaded from FTP directory
+
#* pub/geos/1yr_benchmarks/v7-04-13/geos4/2005/Run/output/pdf
+
# 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.]
+
# 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.
+
  
== v7-04-12 ==
+
== GEOS-Chem benchmarking information ==
BETA RELEASE October 2007
+
  
# [[NOx-Ox-HC-aerosol#Variable_Tropopause|Variable tropopause]] has bug fix from v7-04-11 but not 200 hPa cap at polar latitudes
+
=== GEOS-Chem Benchmarking Procedure ===
# 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:
+
  
==== Run1 ====
+
=== Mean OH from 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 output plots via the web [http://www.as.harvard.edu:16080/ctm/geos/G/v7-04-12/geos4/2005/Run1/output/pdf/ HERE.]
+
Please see [[Mean_OH_concentration#Evolution_of_mean_OH_in_GEOS-Chem|our ''Evolution of mean OH in GEOS-Chem'' wiki page]].
  
* Run w/ 4x5 GEOS-4 for met field year 2005 (spun up thru 2003 & 2004)
+
=== Global burden history ===
* 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 [[Photolysis mechanism|FAST-J photolysis]]
+
* with variable tropopause on
+
  
==== Run2 ====
+
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>/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.]
+
=== GEOS-Chem Benchmark Performance ===
  
* 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 [[Photolysis mechanism|FAST-J photolysis]]
+
* with variable tropopause on
+

Revision as of 18:26, 5 October 2021

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 13 release series

Manual pages for the GEOS-chem 13 release series:

13.2

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

GCHP 13.2.1

HEMCO 3.1.1

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

GCHP 13.2.0

HEMCO 3.1.0

13.1

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

GCHP 13.1.2

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

GCHP 13.1.1

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

GCHP 13.1.0

HEMCO 3.0.0

13.0

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

GCHP 13.0.2

HEMCO 3.0.0-rc.3

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

GCHP 13.0.1

HEMCO 3.0.0-rc.2

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

GCHP 13.0.0

GEOS-Chem 12 release series

Manual pages for the GEOS-chem 12 release series:

12.9

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

12.8

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

12.7

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

12.6

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

12.5

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

12.4

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

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

10.5281/zenodo.3360635

12.3

Version Released Important features Benchmarks DOI
12.3.2 02 May 2019 This is an unofficial benchmark and the first GCHP benchmark using GCPy 10.5281/zenodo.2658178
12.3.1 08 Apr 2019 10.5281/zenodo.2633278


12.3.0 01 Apr 2019 This is the first benchmark to utilize GCPy 10.5281/zenodo.2620535

12.2

Version Released Important features Benchmarks DOI
12.2.1 28 Feb 2019 10.5281/zenodo.2580198
12.2.0 19 Feb 2019 1st version to have the new Transport Tracer benchmark (replaces Rn-Pb-Be benchmark) 10.5281/zenodo.2572887

12.1

Version Released Important features Benchmarks DOI
12.1.1 13 Dec 2018 10.5281/zenodo.2249246
12.1.0 26 Nov 2018 10.5281/zenodo.1553349

12.0

Version Released Important features Benchmarks DOI
12.0.3 16 Oct 2018 10.5281/zenodo.1464210
12.0.2 10 Oct 2018 10.5281/zenodo.1455215
12.0.1 24 Aug 2018 10.5281/zenodo.1403144
12.0.0*
aka v11-02-final
10 Aug 2018
  • Bug fixes identified during the v11-02 release candidate period
Note change in GEOS-Chem version numbering system 10.5281/zenodo.1343547

GEOS-Chem 11 release series

Version Date released Important features Benchmarks Documentation
v11-02-rc 22 Jun 2018
v11-01 20 Dec 2016 (provisional)
01 Feb 2017 (public)

GEOS-Chem 10 release series

Version Date released Important features Benchmarks Documentation
v10-01 01 May 2015 (provisional)
17 Jun 2015 (public)

GEOS-Chem 9 release series

Version Date released Important features Benchmarks Documentation
v9-02 17 Jan 2014 (provisional)
03 Mar 2014 (public)
v9-01-03 14 Sep 2012
v9-01-02 28 Nov 2011
v9-01-01 07 Jun 2011

GEOS-Chem 8 release series

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

GEOS-Chem 7 release series

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

NOTE: For information about 1-year benchmark simulations for GEOS-Chem v8-02-04 and earlier, see this website.

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.