Difference between revisions of "GEOS-Chem versions"

From Geos-chem
Jump to: navigation, search
(Mean OH from GEOS-Chem 1-year benchmark simulations)
(GEOS-Chem 12 release series)
(41 intermediate revisions by the same user not shown)
Line 5: Line 5:
 
In the table below, we list information about current and past GEOS-Chem releases. For information about upcoming releases, please visit [[GEOS-Chem model development priorities|our ''GEOS-Chem model development priorities'' wiki page]].
 
In the table below, we list information about current and past GEOS-Chem releases. For information about upcoming releases, please visit [[GEOS-Chem model development priorities|our ''GEOS-Chem model development priorities'' wiki page]].
  
''NOTE: Information about benchmarks can be found by following the links to each GEOS-Chem version.''
+
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
  
 
=== GEOS-Chem 12 release series ===
 
=== 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]
  
 
{| border=1 cellspacing=0 cellpadding=5
 
{| border=1 cellspacing=0 cellpadding=5
 
|-valign="top" bgcolor="#cccccc"
 
|-valign="top" bgcolor="#cccccc"
!width="150px"|Version
+
!width="100px"|Version
!width="165px"|Released
+
!width="100px"|Released
!width="350px"|Important features
+
!width="360px"|Important features
!width="300px"|Documentation
+
!width="300px"|Benchmarks
 +
!width="200px"|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"
 
|-valign="top"
 
|[[GEOS-Chem 12#12.8.1|12.8.1]]
 
|[[GEOS-Chem 12#12.8.1|12.8.1]]
 
|21 May 2020
 
|21 May 2020
|
+
|Fixes for several issues identified during 12.8.0 benchmarking (not affecting full-chemistry simulations):
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]
 
*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 DOI: 10.5281/zenodo.3837666]
+
|[https://doi.org/10.5281/zenodo.3837666 10.5281/zenodo.3837666]
*[[Getting_Started_with_GEOS-Chem|GEOS-Chem User's Guide]]
+
*[[Getting_Started_With_GCHP|GCHP manual]]
+
*[http://cloud.geos-chem.org Using GEOS-Chem on the AWS cloud]
+
  
 
|-valign="top"
 
|-valign="top"
Line 37: Line 53:
 
*See also [https://github.com/geoschem/geos-chem/milestone/11?closed=1 geoschem/geos-chem: Milestone 12.8.0]
 
*See also [https://github.com/geoschem/geos-chem/milestone/11?closed=1 geoschem/geos-chem: Milestone 12.8.0]
 
|
 
|
*[https://doi.org/10.5281/zenodo.3784796 DOI: 10.5281/zenodo.3784796]
+
*[[Benchmark/GEOS-Chem_12.8.0#GEOS-Chem_Classic_1-month_benchmark|1-month GCC]]
*[[Getting_Started_with_GEOS-Chem|GEOS-Chem User's Guide]]
+
*[[Benchmark/GEOS-Chem_12.8.0#GCHP_1-month_benchmark|1-month GCHP]]
*[[Getting_Started_With_GCHP|GCHP manual]]
+
*[[Benchmark/GEOS-Chem_12.8.0#GEOS-Chem_Classic_1-year_benchmark|1-year GCC]]
*[http://cloud.geos-chem.org Using GEOS-Chem on the AWS cloud]
+
*[[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]
  
 
|-valign="top"
 
|-valign="top"
Line 48: Line 65:
 
*[https://github.com/geoschem/geos-chem/milestone/11?closed=1 geoschem/geos-chem: Milestone 12.7.2]
 
*[https://github.com/geoschem/geos-chem/milestone/11?closed=1 geoschem/geos-chem: Milestone 12.7.2]
 
|
 
|
*[https://doi.org/10.5281/zenodo.3701669 DOI: 10.5281/zenodo.3701669]
+
|[https://doi.org/10.5281/zenodo.3701669 10.5281/zenodo.3701669]
*[[Getting_Started_with_GEOS-Chem|GEOS-Chem User's Guide]]
+
*[[Getting_Started_With_GCHP|GCHP manual]]
+
*[http://cloud.geos-chem.org Using GEOS-Chem on the AWS cloud]
+
  
 
|-valign="top"
 
|-valign="top"
Line 59: Line 73:
 
*[https://github.com/geoschem/geos-chem/milestone/9?closed=1 geoschem/geos-chem: Milestone 12.7.1]
 
*[https://github.com/geoschem/geos-chem/milestone/9?closed=1 geoschem/geos-chem: Milestone 12.7.1]
 
|
 
|
*[https://doi.org/10.5281/zenodo.3676008 DOI: 10.5281/zenodo.3676008]
+
|[https://doi.org/10.5281/zenodo.3676008 10.5281/zenodo.3676008]
*[[Getting_Started_with_GEOS-Chem|GEOS-Chem User's Guide]]
+
*[[Getting_Started_With_GCHP|GCHP manual]]
+
*[http://cloud.geos-chem.org Using GEOS-Chem on the AWS cloud]
+
  
 
|-valign="top"
 
|-valign="top"
Line 70: Line 81:
 
*[https://github.com/geoschem/geos-chem/milestone/4?closed=1 geoschem/geos-chem: Milestone 12.7.0]
 
*[https://github.com/geoschem/geos-chem/milestone/4?closed=1 geoschem/geos-chem: Milestone 12.7.0]
 
|
 
|
*[https://doi.org/10.5281/zenodo.3634864 DOI: 10.5281/zenodo.3634864]
+
*[[Benchmark/GEOS-Chem_12.7.0#GEOS-Chem_Classic_1-month_benchmark|1-month GCC]]
*[[Getting_Started_with_GEOS-Chem|GEOS-Chem User's Guide]]
+
*[[Benchmark/GEOS-Chem_12.7.0#GCHP_1-month_benchmark|1-month GCHP]]
*[[Getting_Started_With_GCHP|GCHP manual]]
+
*[[Benchmark/GEOS-Chem_12.7.0#1-year_Transport_Tracers_benchmarks|1-year GCC transport]]
*[http://cloud.geos-chem.org Using GEOS-Chem on the AWS cloud]
+
|[https://doi.org/10.5281/zenodo.3634864 10.5281/zenodo.3634864]
  
 
|-valign="top"
 
|-valign="top"
Line 81: Line 92:
 
*[https://github.com/geoschem/gchp/milestone/2?closed=1 geoschem/gchp: Milestone 12.6.3]
 
*[https://github.com/geoschem/gchp/milestone/2?closed=1 geoschem/gchp: Milestone 12.6.3]
 
|
 
|
*[https://doi.org/10.5281/zenodo.3552959 DOI: 10.5281/zenodo.3552959]
+
|[https://doi.org/10.5281/zenodo.3552959 10.5281/zenodo.3552959]
*[[Getting_Started_with_GEOS-Chem|GEOS-Chem User's Guide]]
+
*[[Getting_Started_With_GCHP|GCHP manual]]
+
*[http://cloud.geos-chem.org Using GEOS-Chem on the AWS cloud]
+
  
 
|-valign="top"
 
|-valign="top"
Line 92: Line 100:
 
*[https://github.com/geoschem/geos-chem/milestone/6?closed=1 geoschem/geos-chem: Milestone 12.6.2]
 
*[https://github.com/geoschem/geos-chem/milestone/6?closed=1 geoschem/geos-chem: Milestone 12.6.2]
 
|
 
|
*[https://doi.org/10.5281/zenodo.3543702 DOI: 10.5281/zenodo.3543702]
+
|[https://doi.org/10.5281/zenodo.3543702 10.5281/zenodo.3543702]
*[[Getting_Started_with_GEOS-Chem|GEOS-Chem User's Guide]]
+
*[[Getting_Started_With_GCHP|GCHP manual]]
+
*[http://cloud.geos-chem.org Using GEOS-Chem on the AWS cloud]
+
  
 
|-valign="top"
 
|-valign="top"
Line 103: Line 108:
 
*[https://github.com/geoschem/geos-chem/milestone/5?closed=1 geoschem/geos-chem: Milestone 12.6.1]
 
*[https://github.com/geoschem/geos-chem/milestone/5?closed=1 geoschem/geos-chem: Milestone 12.6.1]
 
|
 
|
*[https://doi.org/10.5281/zenodo.3520966 DOI: 10.5281/zenodo.3520966]
+
|[https://doi.org/10.5281/zenodo.3520966 10.5281/zenodo.3520966]
*[[Getting_Started_with_GEOS-Chem|GEOS-Chem User's Guide]]
+
*[[Getting_Started_With_GCHP|GCHP manual]]
+
*[http://cloud.geos-chem.org Using GEOS-Chem on the AWS cloud]
+
  
 
|-valign="top"
 
|-valign="top"
Line 121: Line 123:
 
*Diagnostic for O3 at 10m (or other height) above surface
 
*Diagnostic for O3 at 10m (or other height) above surface
 
|
 
|
*[https://doi.org/10.5281/zenodo.3507501 DOI: 10.5281/zenodo.3507501]
+
*[[Benchmark/GEOS-Chem_12.6.0#GEOS-Chem_Classic_1-month_benchmark|1-month GCC]]
*[[Getting_Started_with_GEOS-Chem|GEOS-Chem User's Guide]]
+
*[[Benchmark/GEOS-Chem_12.6.0#GCHP_1-month_benchmark|1-month GCHP]]
*[[Getting_Started_With_GCHP|GCHP manual]]
+
*[[Benchmark/GEOS-Chem_12.6.0#GEOS-Chem_Classic_1-year_benchmark|1-year GCC]]
*[http://cloud.geos-chem.org Using GEOS-Chem on the AWS cloud]
+
|[https://doi.org/10.5281/zenodo.3507501 10.5281/zenodo.3507501]
  
 
|-valign="top"
 
|-valign="top"
Line 134: Line 136:
 
*Update GCHP to use MAPL v1.0.0 and ESMF v8.0.0 beta snapshot 28
 
*Update GCHP to use MAPL v1.0.0 and ESMF v8.0.0 beta snapshot 28
 
|
 
|
*[https://doi.org/10.5281/zenodo.3403111 DOI: 10.5281/zenodo.3403111]
+
*[[Benchmark/GEOS-Chem_12.5.0#GEOS-Chem_Classic_1-month_benchmark|1-month GCC]]
*[[Getting_Started_with_GEOS-Chem|GEOS-Chem User's Guide]]
+
*[[Benchmark/GEOS-Chem_12.5.0#GCHP_1-month_benchmark|1-month GCHP]]
*[[Getting_Started_With_GCHP|GCHP manual]]
+
|[https://doi.org/10.5281/zenodo.3403111 10.5281/zenodo.3403111]
*[http://cloud.geos-chem.org Using GEOS-Chem on the AWS cloud]
+
  
 
|-valign="top"
 
|-valign="top"
Line 145: Line 146:
 
*Grid-independent emissions
 
*Grid-independent emissions
 
*FlexGrid Stage 2: define custom grids
 
*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.'''''
 
|
 
|
'''''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]]
*[https://doi.org/10.5281/zenodo.3360635 DOI: 10.5281/zenodo.3360635]
+
*[[Benchmark/GEOS-Chem_12.4.0#GEOS-Chem_Classic_1-year_benchmark|1-year GCC]]
*[[Getting_Started_with_GEOS-Chem|GEOS-Chem User's Guide]]
+
|[https://doi.org/10.5281/zenodo.3360635 10.5281/zenodo.3360635]
*[[Getting_Started_With_GCHP|GCHP manual]]
+
*[http://cloud.geos-chem.org Using GEOS-Chem on the AWS cloud]
+
  
 
|-valign="top"
 
|-valign="top"
Line 162: Line 162:
 
*Use the same Br2 seasalt emissions in both GCHP and GCC
 
*Use the same Br2 seasalt emissions in both GCHP and GCC
 
*Updates for GCHP run directories
 
*Updates for GCHP run directories
|
+
|This is an unofficial benchmark and the first GCHP benchmark using [https://github.com/geoschem/gcpy GCPy]
*[https://doi.org/10.5281/zenodo.2658178 DOI 10.5281/zenodo.2658178]
+
*[[Benchmark/GEOS-Chem_12.3.2#GEOS-Chem_Classic_1-month_benchmark|1-month GCC]]
*[[Getting_Started_with_GEOS-Chem|GEOS-Chem User's Guide]]
+
*[[Benchmark/GEOS-Chem_12.3.2#GCHP_1-month_benchmark|1-month GCHP]]
*[[Getting_Started_With_GCHP|GCHP manual]]
+
|[https://doi.org/10.5281/zenodo.2658178 10.5281/zenodo.2658178]
*[http://cloud.geos-chem.org Using GEOS-Chem on the AWS cloud]
+
  
 
|-valign="top"
 
|-valign="top"
Line 177: Line 176:
 
*[[GEOS-Chem 12#Declare State_Met%AREA_M2 as 2-dimensional, not 3-dimensional|Declare State_Met%AREA_M2 as 2-D]]
 
*[[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 DOI 10.5281/zenodo.2633278]
+
|[https://doi.org/10.5281/zenodo.2633278 10.5281/zenodo.2633278]
*[[Getting_Started_with_GEOS-Chem|GEOS-Chem User's Guide]]
+
 
*[[Getting_Started_With_GCHP|GCHP manual]]
+
*[http://cloud.geos-chem.org Using GEOS-Chem on the AWS cloud]
+
  
 
|-valign="top"
 
|-valign="top"
Line 192: Line 189:
 
*Update from [[HEMCO_versions#HEMCO_development_history|HEMCO version]] 2.1.011 to 2.1.012
 
*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]]
 
*[[#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]
*[https://doi.org/10.5281/zenodo.2620535 DOI: 10.5281/zenodo.2620535]
+
*[[Benchmark/GEOS-Chem_12.3.0|1-month GCC]]
*[[Getting_Started_with_GEOS-Chem|GEOS-Chem User's Guide]]
+
|[https://doi.org/10.5281/zenodo.2620535 10.5281/zenodo.2620535]
*[[Getting_Started_With_GCHP|GCHP manual]]
+
*[http://cloud.geos-chem.org Using GEOS-Chem on the AWS cloud]
+
  
 
|-valign="top"
 
|-valign="top"
Line 211: Line 206:
 
*[[GEOS-Chem_12#Use_online_sea_flux_emissions_by_default_in_GCHP|Use online sea flux emissions by default in 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 DOI: 10.5281/zenodo.2580198]
+
|[https://doi.org/10.5281/zenodo.2580198 10.5281/zenodo.2580198]
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.GC_12/index.html GC 12 manual]
+
*[[Getting_Started_With_GCHP|GCHP manual]]
+
*[http://cloud.geos-chem.org Using GEOS-Chem on the AWS cloud]
+
  
 
|-valign="top"
 
|-valign="top"
Line 224: Line 216:
 
*[[GFAS biomass burning emissions]]
 
*[[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]]
 
*[[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)
*[https://doi.org/10.5281/zenodo.2572887 DOI: 10.5281/zenodo.2572887]
+
*[[GEOS-Chem_12_benchmark_history#12.2.0|1-month GCC]]
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.GC_12/index.html GC 12 manual]
+
*[[GEOS-Chem_12_benchmark_history#12.2.0-TransportTracers|1-year transport]]
*[[Getting_Started_With_GCHP|GCHP manual]]
+
|[https://doi.org/10.5281/zenodo.2572887 10.5281/zenodo.2572887]
*[http://cloud.geos-chem.org Using GEOS-Chem on the AWS cloud]
+
  
 
|-valign="top"
 
|-valign="top"
Line 240: Line 231:
 
*[[GEOS-Chem_12#GCHP_transport_fix_to_prevent_instant_propagation_from_troposphere_to_stratosphere|GCHP transport fix]]
 
*[[GEOS-Chem_12#GCHP_transport_fix_to_prevent_instant_propagation_from_troposphere_to_stratosphere|GCHP transport fix]]
 
|
 
|
*[https://doi.org/10.5281/zenodo.2249246 DOI: 10.5281/zenodo.2249246]
+
|[https://doi.org/10.5281/zenodo.2249246 10.5281/zenodo.2249246]
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.GC_12/index.html GC 12 manual]
+
*[[Getting_Started_With_GCHP|GCHP manual]]
+
*[http://cloud.geos-chem.org Using GEOS-Chem on the AWS cloud]
+
  
 
|-valign="top"
 
|-valign="top"
Line 258: Line 246:
 
*[[GEOS-Chem 12#Add support for continuous integration with TravisCI|Add support for continuous integration with TravisCI]]
 
*[[GEOS-Chem 12#Add support for continuous integration with TravisCI|Add support for continuous integration with TravisCI]]
 
|
 
|
*[https://doi.org/10.5281/zenodo.1553349 DOI: 10.5281/zenodo.1553349]
+
*[[GEOS-Chem_12_benchmark_history#12.1.0|1-month GCC]]
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.GC_12/index.html  GC 12 manual]
+
|[https://doi.org/10.5281/zenodo.1553349 10.5281/zenodo.1553349]
*[http://cloud.geos-chem.org Using GEOS-Chem on the AWS cloud]
+
 
  
 
|-valign="top"
 
|-valign="top"
Line 269: Line 257:
 
*[[#Fix_bug_in_application_of_CFC_surface_mixing_ratios_in_GCHP|Fix bug in application of CFC surface mixing ratios 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 DOI: 10.5281/zenodo.1464210]
+
|[https://doi.org/10.5281/zenodo.1464210 10.5281/zenodo.1464210]
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.GC_12/index.html  GC 12 manual]
+
  
 
|-valign="top"
 
|-valign="top"
Line 280: Line 267:
 
*[[CO2_simulation#CO2_emissions_are_double_counted|Bug fix for CO2 simulations]]
 
*[[CO2_simulation#CO2_emissions_are_double_counted|Bug fix for CO2 simulations]]
 
|
 
|
*[https://doi.org/10.5281/zenodo.1455215 DOI: 10.5281/zenodo.1455215]
+
|[https://doi.org/10.5281/zenodo.1455215 10.5281/zenodo.1455215]
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.GC_12/index.html  GC 12 manual]
+
  
 
|-valign="top"
 
|-valign="top"
Line 291: Line 277:
 
*[[GNU_Fortran_compiler#Compiliation_issues_with_GNU_Fortran_8.2.0|Compatibility with GNU Fortran 8.2.0]]
 
*[[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 DOI: 10.5281/zenodo.1403144]
+
|[https://doi.org/10.5281/zenodo.1403144 10.5281/zenodo.1403144]
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.GC_12/index.html GC 12 manual]<br>
+
  
 
|-valign="top"
 
|-valign="top"
|[[GEOS-Chem 12#12.0.0|12.0.0]]*<br>aka v11-02-final<br><br>*Note the switch in [[GEOS-Chem version numbering system|version numbering system]]
+
|[[GEOS-Chem 12#12.0.0|12.0.0]]*<br>aka v11-02-final
 
|10 Aug 2018
 
|10 Aug 2018
 
|
 
|
 
*Bug fixes identified during the v11-02 release candidate period
 
*Bug fixes identified during the v11-02 release candidate period
|
+
|Note change in [[GEOS-Chem version numbering system]]
*[https://doi.org/10.5281/zenodo.1343547 DOI: 10.5281/zenodo.1343547]
+
*[[GEOS-Chem_12_benchmark_history#12.0.0|1-month GCC]]
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.GC_12/index.html GC 12 manual]
+
*[[GEOS-Chem_12_benchmark_history#12.0.0-Run0|1-year GCC]]
*[[GEOS-Chem_12_benchmark_history#12.0.0|1-month benchmark simulation]]
+
|[https://doi.org/10.5281/zenodo.1343547 10.5281/zenodo.1343547]
*[[GEOS-Chem_12_benchmark_history#12.0.0-Run0|1-year benchmark simulation]]
+
  
 
|}
 
|}
  
 
=== GEOS-Chem 11 release series ===
 
=== GEOS-Chem 11 release series ===
 +
 +
  
 
{| border=1 cellspacing=0 cellpadding=5
 
{| border=1 cellspacing=0 cellpadding=5
 
|-valign="top" bgcolor="#cccccc"
 
|-valign="top" bgcolor="#cccccc"
!width="150px"|Version
+
!width="100px"|Version
!width="165px"|Date released
+
!width="100px"|Date released
!width="350px"|Important features
+
!width="360px"|Important features
!width="300px"|Documentation
+
!width="300px"|Benchmarks
 +
!width="200px"|Documentation
  
 
|-valign="top"
 
|-valign="top"
Line 328: Line 315:
 
*[[GEOS-Chem_Output_Files#NetCDF_File_Format|NetCDF diagnostic output]]
 
*[[GEOS-Chem_Output_Files#NetCDF_File_Format|NetCDF diagnostic output]]
 
|
 
|
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.GC_12/index.html GC v11-02 manual]
+
*[[GEOS-Chem v11-02 benchmark history|v11-02 benchmark history page]]
*[[GEOS-Chem v11-02 benchmark history|GC v11-02 benchmark history]]
+
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.GC_12/index.html v11-02/12.0.0 manual]
  
 
|-valign="top"
 
|-valign="top"
Line 343: Line 331:
 
*[[GEOS-Chem_Output_Files#NetCDF_File_Format|NetCDF restart files]]
 
*[[GEOS-Chem_Output_Files#NetCDF_File_Format|NetCDF restart files]]
 
|
 
|
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v11-01/index.html GC v11-01 manual]
+
*[[GEOS-Chem v11-01 benchmark history|v11-01 benchmark history page]]
*[[GEOS-Chem v11-01 benchmark history|GC v11-01 benchmark history]]
+
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v11-01/index.html v11-01 manual]
  
 
|}
 
|}
Line 352: Line 341:
 
{| border=1 cellspacing=0 cellpadding=5
 
{| border=1 cellspacing=0 cellpadding=5
 
|-valign="top" bgcolor="#cccccc"
 
|-valign="top" bgcolor="#cccccc"
!width="150px"|Version
+
!width="100px"|Version
!width="165px"|Date released
+
!width="100px"|Date released
!width="350px"|Important features
+
!width="360px"|Important features
!width="300px"|Documentation
+
!width="300px"|Benchmarks
 +
!width="200px"|Documentation
  
 
|-valign="top"
 
|-valign="top"
Line 365: Line 355:
 
*[[Coupling_GEOS-Chem_with_RRTMG|Online radiative transfer]]
 
*[[Coupling_GEOS-Chem_with_RRTMG|Online radiative transfer]]
 
|
 
|
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v10-01/index.html GC v10-01 manual]
+
*[[GEOS-Chem v10-01 benchmark history|v10-01 benchmark history page]]
*[[GEOS-Chem v10-01 benchmark history|GC v10-01 benchmark history]]
+
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v10-01/index.html v10-01 manual]
  
 
|}
 
|}
Line 374: Line 365:
 
{| border=1 cellspacing=0 cellpadding=5
 
{| border=1 cellspacing=0 cellpadding=5
 
|-valign="top" bgcolor="#cccccc"
 
|-valign="top" bgcolor="#cccccc"
!width="150px"|Version
+
!width="100px"|Version
!width="165px"|Date released
+
!width="100px"|Date released
!width="350px"|Important features
+
!width="360px"|Important features
!width="300px"|Documentation
+
!width="300px"|Benchmarks
 +
!width="200px"|Documentation
  
 
|-valign="top"
 
|-valign="top"
Line 392: Line 384:
 
*[[GEOS-FP|GEOS-FP met fields]]
 
*[[GEOS-FP|GEOS-FP met fields]]
 
|
 
|
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v9-02/index.html GC v9-02 manual]
+
*[[GEOS-Chem v9-02 benchmark history|v9-02 benchmark history page]]
*[[GEOS-Chem v9-02 benchmark history|GC v9-02 benchmark history]]
+
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v9-02/index.html v9-02 manual]
  
 
|-valign="top"
 
|-valign="top"
Line 405: Line 398:
 
*[[Stratospheric chemistry|Stratospheric P and k (monthly climatological)]]
 
*[[Stratospheric chemistry|Stratospheric P and k (monthly climatological)]]
 
|
 
|
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v9-01-03/index.html GC v9-01-03 manual]
+
*[[GEOS-Chem v9-01-03 benchmark history|v9-01-03 benchmark history page]]
*[[GEOS-Chem v9-01-03 benchmark history|GC v9-01-03 benchmark history]]
+
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v9-01-03/index.html v9-01-03 manual]
  
 
|-valign="top"
 
|-valign="top"
Line 417: Line 411:
 
*[[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#Previous issues now resolved in v9-01-02|Various fixes to correct several identified issues]]
 
|
 
|
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v9-01-02/index.html GC v9-01-02 manual]
+
*[[GEOS-Chem v9-01-02 benchmark history|v9-01-02 benchmark history page]]
*[[GEOS-Chem v9-01-02 benchmark history|GC v9-01-02 benchmark history]]
+
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v9-01-02/index.html v9-01-02 manual]
  
 
|-valign="top"
 
|-valign="top"
Line 427: Line 422:
 
*Updated lightning NOx; various fixes
 
*Updated lightning NOx; various fixes
 
|
 
|
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v9-01-01/index.html GC v9-01-01 manual]
+
*[[GEOS-Chem v9-01-01 benchmark history|v9-01-01 benchmark history page]]
*[[GEOS-Chem v9-01-01 benchmark history|GC v9-01-01 benchmark history]]
+
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v9-01-01/index.html v9-01-01 manual]
  
 
|}
 
|}
Line 436: Line 432:
 
{| border=1 cellspacing=0 cellpadding=5
 
{| border=1 cellspacing=0 cellpadding=5
 
|-valign="top" bgcolor="#cccccc"
 
|-valign="top" bgcolor="#cccccc"
!width="150px"|Version
+
!width="100px"|Version
!width="165px"|Date released
+
!width="100px"|Date released
!width="350px"|Important features
+
!width="360px"|Important features
!width="300px"|Documentation
+
!width="300px"|Benchmarks
 +
!width="200px"|Documentation
  
 
|-valign="top"
 
|-valign="top"
Line 446: Line 443:
 
|Updated Hg and CO2 simulations
 
|Updated Hg and CO2 simulations
 
|
 
|
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v8-03-02/index.html GC v8-03-02 manual]
+
*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"
 
|-valign="top"
Line 455: Line 454:
 
*TOMAS microphysics option
 
*TOMAS microphysics option
 
*Updates to SOA and photolysis
 
*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]
 
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v8-03-01/index.html GC v8-03-01 manual]
Line 465: Line 466:
 
*NEI2005 anthro emissions
 
*NEI2005 anthro emissions
 
*MEGAN v2.1 biogenic 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]
 
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v8-02-01/index.html GC v8-02-04 manual]
Line 475: Line 478:
 
*ICOADS emissions
 
*ICOADS emissions
 
*Updated makefile structure
 
*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]
 
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v8-02-01/index.html GC v8-02-03 manual]
Line 484: Line 489:
 
*Non-local PBL mixing scheme
 
*Non-local PBL mixing scheme
 
*Updated Bond BC & OC emissions
 
*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]
 
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v8-02-01/index.html GC v8-02-02 manual]
Line 493: Line 500:
 
*Updated chemistry & photolysis reactions
 
*Updated chemistry & photolysis reactions
 
*Glyoxal chemistry mechanism
 
*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]
 
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v8-02-01/index.html GC v8-02-01 manual]
Line 502: Line 511:
 
*Various emissions updates (regional & global inventories)
 
*Various emissions updates (regional & global inventories)
 
*GFED2 biomass emissions updates
 
*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]
 
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v8-01-04/index.html GC v8-01-04 manual]
Line 510: Line 521:
 
|
 
|
 
*Installation of GMI TPCORE routine
 
*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]
 
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v8-01-04/index.html GC v8-01-03 manual]
Line 518: Line 531:
 
|
 
|
 
*Nested grid simulations for 0.5&deg; x 0.666&deg;
 
*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]
 
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v8-01-04/index.html GC v8-01-02 manual]
Line 526: Line 541:
 
|
 
|
 
*Capability to run with GEOS-5 met fields
 
*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]
 
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v8-01-04/index.html GC v8-01-01 manual]
Line 535: Line 552:
 
{| border=1 cellspacing=0 cellpadding=5
 
{| border=1 cellspacing=0 cellpadding=5
 
|-valign="top" bgcolor="#cccccc"
 
|-valign="top" bgcolor="#cccccc"
!width="150px"|Version
+
!width="100px"|Version
!width="165px"|Date released
+
!width="100px"|Date released
!width="350px"|Important features
+
!width="360px"|Important features
!width="300px"|Documentation
+
!width="300px"|Benchmarks
 +
!width="200px"|Documentation
  
 
|-valign="top"
 
|-valign="top"
Line 546: Line 564:
 
*H2/HD simulation
 
*H2/HD simulation
 
*Bug fixes in SMVGEAR, lightning, and dynamic tropopause
 
*Bug fixes in SMVGEAR, lightning, and dynamic tropopause
 +
|
 +
*Archived to storage; contact [[GCST]]
 
|  
 
|  
  
Line 553: Line 573:
 
|
 
|
 
*Introduction of dynamic tropopause
 
*Introduction of dynamic tropopause
 +
|
 +
*Archived to storage; contact [[GCST]]
 
|  
 
|  
  
Line 559: Line 581:
 
|March 2006 and earlier
 
|March 2006 and earlier
 
|
 
|
 +
|
 +
*Archived to storage; contact [[GCST]]
 
|
 
|
  
Line 569: Line 593:
 
== Mean OH from GEOS-Chem 1-year benchmark simulations ==
 
== Mean OH from GEOS-Chem 1-year benchmark simulations ==
  
Here is a plot of the [[Mean OH concentration|mean OH concentration]] from several recent GEOS–Chem 1-year benchmark simulations. The mean OH is an indicator how the chemistry mechanism is performing. Typical values are 10–12 x 10<sup>5</sup> molecules cm<sup>-1</sup>.
+
Here is a plot of the mean OH concentration from GEOS-Chem 1-year benchmark simulations through [[GEOS-Chem 12#12.8.0|version 12.8.0]] (released 04 May 2020). The mean OH is an indicator how the chemistry mechanism is performing. Typical values are 10–12 x 10<sup>5</sup> molecules cm<sup>-1</sup>.
  
 
[[Image:GC_Mean_OH_12.8.0.png]]
 
[[Image:GC_Mean_OH_12.8.0.png]]
  
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 17:00, 21 May 2020 (UTC)
+
For more information, please see [[Mean_OH_concentration#Evolution_of_mean_OH_in_GEOS-Chem|our ''Evolution of mean OH in GEOS-Chem'' wiki documentation]].
 +
 
 +
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 15:41, 27 May 2020 (UTC)
  
 
== Global burden history ==  
 
== Global burden history ==  

Revision as of 18:32, 27 May 2020

Here we have posted links to a separate wiki page describing each GEOS-Chem model version.

GEOS-Chem development history

In the table below, we list information about current and past GEOS-Chem releases. For information about upcoming releases, please visit our GEOS-Chem model development priorities wiki page.

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

GEOS-Chem 12 release series

Manual pages for the GEOS-chem 12 release series:

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.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.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.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.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.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.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.1 13 Dec 2018 10.5281/zenodo.2249246
12.1.0 26 Nov 2018 10.5281/zenodo.1553349


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.

--Melissa Sulprizio (talk) 16:02, 10 August 2018 (UTC)
--Bob Yantosca (talk) 15:11, 15 March 2019 (UTC)

Mean OH from GEOS-Chem 1-year benchmark simulations

Here is a plot of the mean OH concentration from GEOS-Chem 1-year benchmark simulations through version 12.8.0 (released 04 May 2020). The mean OH is an indicator how the chemistry mechanism is performing. Typical values are 10–12 x 105 molecules cm-1.

GC Mean OH 12.8.0.png

For more information, please see our Evolution of mean OH in GEOS-Chem wiki documentation.

--Bob Yantosca (talk) 15:41, 27 May 2020 (UTC)

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.

--Bob Y. (talk) 19:32, 9 November 2015 (UTC)

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.

--Bob Y. 15:47, 30 April 2015 (EDT)

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.

--Melissa Sulprizio (talk) 13:59, 20 September 2018 (UTC)