Difference between revisions of "GEOS-Chem versions"

From Geos-chem
Jump to: navigation, search
(New page: '''NOTE: The order in which various updates enter into the standard GEOS-Chem code may differ than what is listed here, depending on circumstances.''' == v8-01-04 ?? == Also adds: * [[wi...)
 
(GEOS-Chem 12 release series)
 
(341 intermediate revisions by 5 users not shown)
Line 1: Line 1:
'''NOTE: The order in which various updates enter into the standard GEOS-Chem code may differ than what is listed here, depending on circumstances.'''
+
Here we have posted links to a separate wiki page describing each GEOS-Chem model version.
  
== v8-01-04 ?? ==
+
== GEOS-Chem development history ==
Also adds:
+
  
* [[wiki:geos-chem:chem_forum|Hongyu Liu's fix: set random cloud overlap as the default option for FAST-J photolysis]]
+
In the 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]].
  
== v8-01-03 ?? ==
+
''NOTE: Information about benchmarks can be found by following the links to each GEOS-Chem version.''
Also adds:
+
* [[wiki:geos-chem:anthro_forum#jan_2008|EPA/NEI99 California transport sector fix]]
+
* [[wiki:geos-chem:biogenic_forum#sep_2007|Updated MEGAN annual emission factors for isoprene]]
+
* PERHAPS -- Updated mercury simulation (cf. Noelle, Elsie, Chris, Sarah Strode, etc.)
+
  
== v8-01-02 ?? ==
+
=== GEOS-Chem 12 release series ===
Also adds:
+
* May Fu's updated chemistry mechanism
+
  
== v8-01-01 ==
+
{| border=1 cellspacing=0 cellpadding=5
PUBLIC RELEASE scheduled for April 2008
+
|-valign="top" bgcolor="#cccccc"
 +
!width="150px"|Version
 +
!width="165px"|Released
 +
!width="350px"|Important features
 +
!width="300px"|Documentation
  
Contains everything in v7-04-13, with the following additions:
+
|-valign="top"
* This is the first version to be compatible with the [[wiki:geos-chem:geos5_forum|GEOS-5 met fields]].
+
|[[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 DOI: 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]
  
=== 1-Year Benchmarks ===
+
|-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 DOI: 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]
  
==== Description ====
+
|-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]
 +
|
 +
*[https://doi.org/10.5281/zenodo.3634864 DOI: 10.5281/zenodo.3634864]
 +
*[[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]
  
* Results from v8-01-01 1-year benchmark simulation (w/ GEOS-5 met) are contained in the directory:  
+
|-valign="top"
/as2/pub/ftp/pub/geos-chem/1yr_benchmarks/v7-04-12/geos5/2005/Run
+
|[[GEOS-Chem 12#12.6.3|12.6.3]]
* 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.
+
|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 DOI: 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]
  
The 3 models compared (and their colors on the plots) were:
+
|-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 DOI: 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"
 +
|[[GEOS-Chem 12#12.6.1|12.6.1]]
 +
|28 Oct 2019
 +
|Contains several bug fixes.  See:
 +
*[https://github.com/geoschem/geos-chem/milestone/5?closed=1 geoschem/geos-chem: Milestone 12.6.1]
 +
|
 +
*[https://doi.org/10.5281/zenodo.3520966 DOI: 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"
 +
|[[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
 +
|
 +
*[https://doi.org/10.5281/zenodo.3507501 DOI: 10.5281/zenodo.3507501]
 +
*[[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"
 +
|[[GEOS-Chem 12#12.5.0|12.5.0]]
 +
|09 Sep 2019
 +
|
 +
*Retire obsolete emissions inventories
 +
*Fixes and updates for offline biogenic VOC and volcano emissions
 +
*Update GCHP to use MAPL v1.0.0 and ESMF v8.0.0 beta snapshot 28
 +
|
 +
*[https://doi.org/10.5281/zenodo.3403111 DOI: 10.5281/zenodo.3403111]
 +
*[[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"
 +
|[[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.'''''
 +
 
 +
*[https://doi.org/10.5281/zenodo.3360635 DOI: 10.5281/zenodo.3360635]
 +
*[[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"
 +
|[[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
 +
|
 +
*[https://doi.org/10.5281/zenodo.2658178 DOI 10.5281/zenodo.2658178]
 +
*[[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"
 +
|[[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 DOI 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"
 +
|[[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]]
 +
|
 +
*[https://doi.org/10.5281/zenodo.2620535 DOI: 10.5281/zenodo.2620535]
 +
*[[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"
 +
|[[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 DOI: 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"
 +
|[[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]]
 +
|
 +
*[https://doi.org/10.5281/zenodo.2572887 DOI: 10.5281/zenodo.2572887]
 +
*[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"
 +
|[[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 DOI: 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"
 +
|[[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]]
 +
|
 +
*[https://doi.org/10.5281/zenodo.1553349 DOI: 10.5281/zenodo.1553349]
 +
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.GC_12/index.html  GC 12 manual]
 +
*[http://cloud.geos-chem.org Using GEOS-Chem on the AWS cloud]
 +
 
 +
|-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 DOI: 10.5281/zenodo.1464210]
 +
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.GC_12/index.html  GC 12 manual]
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem 12#12.0.2|12.0.2]]
 +
|10 Oct 2018
 +
|
 +
*[[GEOS-Chem 12#Fixed_local-time_averaging_in_ND51_and_ND51b_satellite_timeseries_diagnostics|Bug fixes for ND51/ND51b diagnostics]]
 +
*[[TOMAS_aerosol_microphysics#Fixes_for_missing_biomass_emissions_and_incorrect_aerosol_dry_deposition|Bug fixes for TOMAS simulations]]
 +
*[[CO2_simulation#CO2_emissions_are_double_counted|Bug fix for CO2 simulations]]
 +
|
 +
*[https://doi.org/10.5281/zenodo.1455215 DOI: 10.5281/zenodo.1455215]
 +
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.GC_12/index.html  GC 12 manual]
 +
 
 +
|-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 DOI: 10.5281/zenodo.1403144]
 +
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.GC_12/index.html GC 12 manual]<br>
 +
 
 +
|-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]]
 +
|10 Aug 2018
 +
|
 +
*Bug fixes identified during the v11-02 release candidate period
 +
|
 +
*[https://doi.org/10.5281/zenodo.1343547 DOI: 10.5281/zenodo.1343547]
 +
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.GC_12/index.html GC 12 manual]
 +
*[[GEOS-Chem_12_benchmark_history#12.0.0|1-month benchmark simulation]]
 +
*[[GEOS-Chem_12_benchmark_history#12.0.0-Run0|1-year benchmark simulation]]
  
{| border=1 cellspacing=0 cellpadding=5
 
! Color
 
! Quantity Plotted
 
! Met Type
 
! Lightning algorithm
 
|-
 
| Red 
 
| [[#Run2|v7-04-12 Run2]]
 
| GEOS-4 4x5
 
| [[wiki:geos-chem:lightning_forum#sep_2007|near-land w/ OTD-LIS regional scaling]]
 
|-                                   
 
| Green
 
| [[#v7-04-13|v7-04-13]] 
 
| GEOS-4 4x5
 
| updated non-near-land w/ OTD-LIS local scaling
 
|-
 
| Blue 
 
| This model version     
 
| GEOS-5 4x5
 
| updated non-near-land w/ OTD-LIS local scaling
 
|-
 
| Black
 
| Observations           
 
| &nbsp;         
 
| &nbsp;
 
 
|}
 
|}
  
==== Results ====
+
=== GEOS-Chem 11 release series ===
  
==== Release Notes ====
+
{| border=1 cellspacing=0 cellpadding=5
* We have implemented the fix for the [[wiki:geos-chem:biomass_forum#sep_2007|last year of GFED2 biomass emissions, (which is now 2006)]] into v8-01-01.
+
|-valign="top" bgcolor="#cccccc"
 +
!width="150px"|Version
 +
!width="165px"|Date released
 +
!width="350px"|Important features
 +
!width="300px"|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]]
 +
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.GC_12/index.html GC v11-02 manual]
 +
*[[GEOS-Chem v11-02 benchmark history|GC v11-02 benchmark history]]
  
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]]
 +
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v11-01/index.html GC v11-01 manual]
 +
*[[GEOS-Chem v11-01 benchmark history|GC v11-01 benchmark history]]
  
* Offline H2/HD simulation (cf. Lyatt Jaegle et al)
+
|}
* 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.
+
* [[wiki:geos-chem:lightning_forum|Bug fix -- replace GEMISNOX w/ module arrays to avoid common block errors in lightning & aircraft NOx emissions]]
+
* [[wiki:geos-chem:chem_forum#variable_tropopause|Bug fix -- cap variable tropopause at 200hPa for polar regions (90S-60S and 60N-90N)]]
+
* [[wiki:geos-chem:emissions#lightning_nox|Lee Murray's local lightning redistribution of lightning flashes]]
+
* Minor bug fixes for GCAP and diagnostics
+
  
=== 1-Year Benchmarks ===
+
=== GEOS-Chem 10 release series ===
  
==== Description ====  
+
{| border=1 cellspacing=0 cellpadding=5
* Results from 1-year benchmark simulation (w/ GEOS-4 met) are contained in the directory:
+
|-valign="top" bgcolor="#cccccc"
    /as2/pub/ftp/pub/geos-chem/1yr_benchmarks/v7-04-12/geos4/2005/Run
+
!width="150px"|Version
* This benchmark uses the same input conditions and emissions as v7-04-12-Run2, except for the updated lightning emissions as described above.
+
!width="165px"|Date released
 +
!width="350px"|Important features
 +
!width="300px"|Documentation
  
The 3 models compared (and their colors on the plots) were:
+
|-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]]
 +
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v10-01/index.html GC v10-01 manual]
 +
*[[GEOS-Chem v10-01 benchmark history|GC v10-01 benchmark history]]
  
^ 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 | [[wiki:geos-chem:lightning_forum#sep_2007|near-land w/ OTD-LIS regional scaling]] |
+
| Blue  | This model version      | GEOS-4 4x5 | updated non-near-land w/ OTD-LIS local scaling |
+
| Black | Observations            |            |                                                |
+
  
=== Results ===
+
=== GEOS-Chem 9 release series ===
  
==== Release Notes ====
+
{| border=1 cellspacing=0 cellpadding=5
  * [[wiki:geos-chem:biomass_forum#jan_2008|The maximum year for GFED2 emissions in this version is 2005.]] If you want to use the 2006 emissions you will have to edit the source code module "gfed2_biomass_mod.f".
+
|-valign="top" bgcolor="#cccccc"
 +
!width="150px"|Version
 +
!width="165px"|Date released
 +
!width="350px"|Important features
 +
!width="300px"|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]]
 +
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v9-02/index.html GC v9-02 manual]
 +
*[[GEOS-Chem v9-02 benchmark history|GC v9-02 benchmark history]]
 +
 
 +
|-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)]]
 +
|
 +
*[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|GC v9-01-03 benchmark history]]
 +
 
 +
|-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]]
 +
|
 +
*[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|GC v9-01-02 benchmark history]]
 +
 
 +
|-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
 +
|
 +
*[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|GC v9-01-01 benchmark history]]
 +
 
 +
|}
 +
 
 +
=== GEOS-Chem 8 release series ===
 +
 
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top" bgcolor="#cccccc"
 +
!width="150px"|Version
 +
!width="165px"|Date released
 +
!width="350px"|Important features
 +
!width="300px"|Documentation
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v8-03-02|v8-03-02]]
 +
|07 Sep 2010
 +
|Updated Hg and CO2 simulations
 +
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v8-03-02/index.html GC 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
 +
|
 +
*[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
 +
|
 +
*[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
 +
|
 +
*[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
 +
|
 +
*[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
 +
|
 +
*[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
 +
|
 +
*[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
 +
|
 +
*[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;
 +
|
 +
*[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
 +
|
 +
*[http://acmg.seas.harvard.edu/geos/doc/archive/man.v8-01-04/index.html GC v8-01-01 manual]
 +
 
 +
|}
 +
 
 +
=== GEOS-Chem 7 release series ===
 +
 
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top" bgcolor="#cccccc"
 +
!width="150px"|Version
 +
!width="165px"|Date released
 +
!width="350px"|Important features
 +
!width="300px"|Documentation
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v7-04-13|v7-04-13]]
 +
|Nov 2007
 +
|
 +
*H2/HD simulation
 +
*Bug fixes in SMVGEAR, lightning, and dynamic tropopause
 +
|
 +
 
 +
|-valign="top"
 +
|[[GEOS-Chem v7-04-12|v7-04-12]]
 +
|Oct 2007
 +
|
 +
*Introduction of dynamic tropopause
 +
|
 +
 
 +
|-valign="top"
 +
|[http://acmg.seas.harvard.edu/geos/geos_versions.html v7-04-11 and earlier]
 +
|March 2006 and earlier
 +
|
 +
|
 +
 
 +
|}
  
===== v7-04-12 =====
+
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].
INTERNAL RELEASE October 2007
+
  
We have already done the following 1-year benchmark simulations:
+
--[[User:Melissa Payer|Melissa Sulprizio]] ([[User talk:Melissa Payer|talk]]) 16:02, 10 August 2018 (UTC)<br>--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|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|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>.
  
==== 1-Year Benchmarks ====
+
[[Image:GC_Mean_OH_12.0.0.png]]
  
=== Run0 ===
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 18:16, 10 August 2018 (UTC)
In directory: /as2/pub/ftp/pub/geos-chem/1yr_benchmarks/v7-04-12/geos4/2001/Run0
+
  
  * Run w/ 4x5 GEOS-4 for met field year 2001 (spun up thru 2000 & 1999)
+
== 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 FAST-J photolysis
+
  * with variable tropopause on
+
  
=== Run1 ===
+
Please see [[Global_Burden_History|our ''Global burden history'' wiki page]] to view the global burdens for several species from several recent GEOS-Chem 1-year benchmark simulations.
In directory: /as2/pub/ftp/pub/geos-chem/1yr_benchmarks/v7-04-12/geos4/2005/Run1
+
  
  * Run w/ 4x5 GEOS-4 for met field year 2005 (spun up thru 2003 & 2004)
+
--[[User:Bmy|Bob Y.]] ([[User talk:Bmy|talk]]) 19:32, 9 November 2015 (UTC)
  * with G-C "old" fossil fuel (GEIA + EPA/NEI99)
+
  * with G-C "default" climatological biomass burning
+
  * with old lightning parameterization
+
  * with MEGAN biogenic emissions
+
  * with SMVGEAR chemistry up to dynamic tropopause
+
  * with new dust emissions (w/ GOCART source function)
+
  * with new TOMS/SBUV ozone columns for FAST-J photolysis
+
  * with variable tropopause on
+
 
+
=== Run2 ===
+
In directory: /as2/pub/ftp/pub/geos-chem/1yr_benchmarks/v7-04-12/geos4/2005/Run2
+
  
  * Run w/ GEOS-4 for met field year 2005 (spun up thru 2003 & 2004)
+
== GEOS–Chem Benchmarking Procedure ==
  * with G-C "old" fossil fuel (GEIA + EPA/NEI99)
+
  * with G-C "default" climatological biomass burning
+
  * with new lightning parameterization (with OTD/LIS v2 regional redistribution of flashes)
+
  * with MEGAN biogenic emissions
+
  * with SMVGEAR chemistry up to dynamic tropopause
+
  * with new dust emissions (w/ GOCART source function)
+
  * with new TOMS/SBUV ozone columns for FAST-J photolysis
+
  * with variable tropopause on
+
  
=== Results ===
+
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]].
  
==== Release Notes ====
+
--[[User:Bmy|Bob Y.]] 15:47, 30 April 2015 (EDT)
1. [[wiki:geos-chem:dev_forum|Variable tropopause]] has bug fix from v7-04-11 but not 200 hPa cap at polar latitudes
+
  
2. NOTE: There is a bug in this version when [[wiki:geos-chem:lightning_forum|lightning emissions are turned off]].  The bug will be fixed in [[wiki:geos-chem:dev_forum#v7-04-13|v7-04-13]].  For the time being, if you must turn lighting emissions off in v7-04-12, please do this by setting FLASHRATE = 0 in the lightning_nox_nl_mod.f. 
+
== 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.
  
===== Return to Menu =====
+
--[[User:Melissa Payer|Melissa Sulprizio]] ([[User talk:Melissa Payer|talk]]) 13:59, 20 September 2018 (UTC)
  * [[:start|Go to Harvard Atmospheric Sciences Wiki Home]]
+
  * [[wiki:basics|Go to "The Basics" Menu]]
+
  * [[wiki:idl|Go to IDL Menu]]
+
  * [[wiki:geos-chem|Go to GEOS-Chem Menu]]
+
  * [[wiki:computer_and_network_info|Go to Network Resources Menu]]
+

Latest revision as of 17:25, 9 March 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.

NOTE: Information about benchmarks can be found by following the links to each GEOS-Chem version.

GEOS-Chem 12 release series

Version Released Important features Documentation
12.7.2 09 Mar 2020 Contains several bug fixes:
12.7.1 03 Feb 2020 Contains several bug fixes:
12.7.0 03 Feb 2020 Contains several science updates and bug fixes:
12.6.3 25 Nov 2019 Contains GCHP bug fixes only: See:
12.6.2 15 Nov 2019 Contains several bug fixes. See:
12.6.1 28 Oct 2019 Contains several bug fixes. See:
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
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
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.

12.3.2 02 May 2019
12.3.1 08 Apr 2019
12.3.0 01 Apr 2019
12.2.1 28 Feb 2019
12.2.0 19 Feb 2019
12.1.1 13 Dec 2018
12.1.0 26 Nov 2018
12.0.3 16 Oct 2018
12.0.2 10 Oct 2018
12.0.1 24 Aug 2018
12.0.0*
aka v11-02-final

*Note the switch in version numbering system
10 Aug 2018
  • Bug fixes identified during the v11-02 release candidate period

GEOS-Chem 11 release series

Version Date released Important features 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 Documentation
v10-01 01 May 2015 (provisional)
17 Jun 2015 (public)

GEOS-Chem 9 release series

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

GEOS-Chem 7 release series

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

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 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 105 molecules cm-1.

GC Mean OH 12.0.0.png

--Bob Yantosca (talk) 18:16, 10 August 2018 (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)