Difference between revisions of "GEOS-Chem versions"

From Geos-chem
Jump to: navigation, search
(→‎v8-01-02)
(→‎v8-01-01)
Line 25: Line 25:
  
 
== v8-01-01 ==
 
== v8-01-01 ==
−
PUBLIC RELEASE May 2008
 
  
−
Contains everything in [[#v7-04-13|v7-04-13]], with the following additions:
+
Please see the separate wiki page for [[GEOS-Chem v8-01-01].
−
# Compatibility for [[GEOS-5 issues|GEOS-5]] met fields.
+
−
# Now uses [[Aerosol thermodynamical equilibrium#RPMARES|RPMARES]] instead of [[Aerosol thermodynamical equilibrium#ISORROPIA|ISORROPIA]]
+
−
# Implements [[Floating point math issues|floating point error traps]] (e.g. to prevent division by zero) in a few critical places
+
−
 
+
−
Also note that we have implemented the fix for the [[Biomass_burning_emissions#25-Sep-2007|Last year of GFED2 biomass emissions, (which is now 2006)]] into v8-01-01.
+
−
 
+
−
=== 1-Year Benchmarks ===
+
−
 
+
−
We have done two 1-year benchmarks for GEOS-Chem v8-01-01:
+
−
 
+
−
==== Run0 ====
+
−
 
+
−
The 3 models compared (and their colors on the plots) were:
+
−
 
+
−
{| 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:
+
−
# 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 ====
+
−
 
+
−
The 3 models compared (and their colors on the plots) were:
+
−
 
+
−
{| 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:
+
−
# 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 ===
+
−
 
+
−
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.
+
−
 
+
−
Please see the following GEOS–Chem wiki pages for information about the following issues, and how to resolve them.
+
−
 
+
−
'''''NOTE: As of November 2008, these post-release patches are now part of the [[#v8-01-02|standard GEOS-Chem v8-01-02]] source code.'''''
+
−
 
+
−
==== Fixes for the full-chemistry simulation ====
+
−
 
+
−
*[[Bugs_and_fixes#Too_many_levels_in_photolysis_code|"Too many levels" error in the photolysis routine OPMIE.f]]
+
−
*[[Previous_issues_now_resolved_in_v8-01-02#Corrected_labeling_of_SOA_quantities_in_carbon_mod.f|Confusing comments corrected in routine SOA_PARA in carbon_mod.f]]
+
−
*[[Previous_issues_now_resolved_in_v8-01-02#Numerical_noise_bug_in_upbdflx_mod.f|Numerical noise error in upbdflx_mod.f]]
+
−
*[[Previous_issues_now_resolved_in_v8-01-02#Problem_w.2F_ND65_diagnostic_and_dynamic_tropopause|Problem w/ ND65 diagnostic and the dynamic tropopause]]
+
−
*[[Common_GEOS-Chem_error_messages#Negative_tracer_found_in_WETDEP|Negative tracer found in WETDEP]]
+
−
*[[GEOS-5_issues#Small_negative_RH_value_in_20060206.a6.2x25_file|Negative relative humidity from met fields causing negative tracer]]
+
−
*[[Aerosol_thermodynamical_equilibrium#Run_dies_in_RPMARES_unexpectedly|Run dies in RPMARES unexpectedly]]
+
−
*[[Aerosol_thermodynamical_equilibrium#RPMARES|Error in sulfate_mod.f caused by switching from ISORROPIA to RPMARES]]
+
−
 
+
−
==== Fixes for offline simulations ====
+
−
 
+
−
*[[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]]
+
−
*[[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)]]
+
−
 
+
−
=== Lines of code ===
+
−
 
+
−
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.''
+
−
 
+
−
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,
+
−
 
+
−
--[[User:Bmy|Bob Y.]] 14:27, 8 August 2008 (EDT)
+
  
 
== v7-04-13 ==
 
== v7-04-13 ==

Revision as of 15:11, 6 May 2009

NOTE: Information subject to change. Please check back here often for the latest information.

v8-02-01

CHEMISTRY RELEASE date TBD

Will contain everything in v8-01-04 plus the following:

  1. Glyoxal chemistry (May Fu)
  2. Updated J(O1D) cross sections (Lin Zhang)
  3. Updated reaction rates (Jingqiu Mao, Dylan Millet, Palmer group @ U. Edinburgh)
  4. HO2 uptake (Lyatt Jaegle)
  5. Updated dust single scattering albedo (Randall Martin)

v8-01-04

Please see the separate wiki page for GEOS-Chem v8-01-04.

v8-01-03

Please see the separate wiki page for GEOS-Chem v8-01-03.

v8-01-02

Please see the separate wiki page for GEOS-Chem v8-01-02.

v8-01-01

Please see the separate wiki page for [[GEOS-Chem v8-01-01].

v7-04-13

BETA RELEASE November 2007

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

  1. Offline H2/HD simulation (cf. Lyatt Jaegle et al)
  2. 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.
  3. Bug fix -- replace GEMISNOX w/ module arrays to avoid common block errors in lightning & aircraft NOx emissions
  4. Bug fix -- cap variable tropopause at 200hPa for polar regions (90S-60S and 60N-90N)
  5. Lee Murray's local lightning redistribution of lightning flashes
  6. Minor bug fixes for GCAP and diagnostics

Also note that the 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".

1-Year Benchmarks

Run

The 3 models compared (and their colors on the plots) were:

Color Quantity Plotted Met Type Lightning algorithm
Red v7-04-12 Run1 GEOS-4 4x5 ancient
Green v7-04-12 Run2 GEOS-4 4x5 near-land w/ OTD-LIS regional scaling
Blue v7-04-13 GEOS-4 4x5 updated non-near-land w/ OTD-LIS local scaling
Black Observations    

NOTES:

  1. Results from v7-04-13-Run can be downloaded from FTP directory
    • pub/geos/1yr_benchmarks/v7-04-13/geos4/2005/Run/output/pdf
  2. Output plots from v7-04-13-Run can be viewed on the web HERE.
  3. 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

BETA RELEASE October 2007

  1. 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 lightning emissions are turned off. The bug will be fixed in 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

We have already done the following 1-year benchmark simulations:

Run1

In FTP directory: /as2/pub/ftp/pub/geos-chem/1yr_benchmarks/v7-04-12/geos4/2005/Run1

View output plots via the web HERE.

  • Run w/ 4x5 GEOS-4 for met field year 2005 (spun up thru 2003 & 2004)
  • with G-C "old" fossil fuel (GEIA + EPA/NEI99)
  • with G-C "default" climatological biomass burning
  • with old lightning parameterization
  • with MEGAN biogenic emissions
  • with SMVGEAR chemistry up to dynamic tropopause
  • with new dust emissions (w/ GOCART source function)
  • with new TOMS/SBUV ozone columns for FAST-J photolysis
  • with variable tropopause on

Run2

In FTP directory: /pub/geos-chem/1yr_benchmarks/v7-04-12/geos4/2005/Run2

View output plots via the web HERE.

  • Run w/ GEOS-4 for met field year 2005 (spun up thru 2003 & 2004)
  • 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
Retrieved from "https://wiki.seas.harvard.edu/geos-chem/index.php?title=GEOS-Chem_versions&oldid=2047"