GEOS-Chem versions
NOTE: Information subject to change. Please check back here often for the latest information.
v8-01-05
CHEMISTRY RELEASE date TBD
Will contain everything in v8-01-04 plus the following:
- Glyoxal chemistry (May Fu)
- Updated J(O1D) cross sections (Lin Zhang)
- Updated reaction rates (Jingqiu Mao)
- HO2 uptake (Lyatt Jaegle)
- Updated dust single scattering albedo (Randall Martin)
v8-01-04
EMISSIONS RELEASE date TBD
Will contain everything in v8-01-03 plus the following updates:
- Annual scale factors for NOx-CO-SOx from, applied to ALL inventory if needed (Aaron)
- 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)
1-year benchmarks
v8-01-03
BETA RELEASE December 2008
Contains everything in v8-01-02 plus the following updates:
- Installation of new version of TPCORE (based on GMI model) to fix polar overshoot in stratosphere
- Minor bug fix for ND51 diagnostic
- Minor bug fixes in diag3.f
- Minor diagnostic fixes in main.f
v8-01-02
BETA RELEASE November 2008
Contains everything in v8-01-01, with the following additions:
- GEOS-5 0.5 x 0.666 degree nested-grid simulation for China/SE Asia
- Improvements to the GEOS-3 1x1 nested-grid simulation for N. America
- Modifications for using reprocessed GEOS-5 met fields (i.e. w/ corrected optical depths)
- Several bug fixes and improvements for robustness, scientific algorithms, and diagnostics
v8-01-01
PUBLIC RELEASE May 2008
Contains everything in v7-04-13, with the following additions:
- Compatibility for GEOS-5 met fields.
- Now uses RPMARES instead of ISORROPIA
- Implements 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 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:
| Color | Quantity Plotted | Met Field Type | Lightning algorithm | A.T.E. algorithm |
|---|---|---|---|---|
| Red | v7-04-12 Run2 | GEOS-4 4x5 | near-land w/ OTD-LIS regional scaling | ISORROPIA |
| Green | v7-04-13 | GEOS-4 4x5 | updated non-near-land w/ OTD-LIS local scaling | ISORROPIA |
| Blue | v8-01-01 | GEOS-5 4x5 | updated non-near-land w/ OTD-LIS local scaling | ISORROPIA |
| Black | Observations |
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 HERE.
Run1
The 3 models compared (and their colors on the plots) were:
| Color | Quantity Plotted | Met Field Type | Lightning algorithm | A.T.E. algorithm |
|---|---|---|---|---|
| Red | v7-04-13 | GEOS-4 4x5 | updated non-near-land w/ OTD-LIS local scaling | ISORROPIA |
| Green | v8-01-01 | GEOS-5 4x5 | updated non-near-land w/ OTD-LIS local scaling | ISORROPIA |
| Blue | v8-01-01 | GEOS-5 4x5 | updated non-near-land w/ OTD-LIS local scaling | RPMARES |
| Black | Observations |
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 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 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 standard GEOS-Chem v8-01-02 source code.
Fixes for the full-chemistry simulation
- "Too many levels" error in the photolysis routine OPMIE.f
- Confusing comments corrected in routine SOA_PARA in carbon_mod.f
- Numerical noise error in upbdflx_mod.f
- Problem w/ ND65 diagnostic and the dynamic tropopause
- Negative tracer found in WETDEP
- Negative relative humidity from met fields causing negative tracer
- Run dies in RPMARES unexpectedly
- Error in sulfate_mod.f caused by switching from ISORROPIA to RPMARES
Fixes for offline simulations
- Array-out-of-bounds error in tagged_co_mod.f
- 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 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 linecount.pro by Bob Yantosca,
--Bob Y. 14:27, 8 August 2008 (EDT)
v7-04-13
BETA RELEASE November 2007
Contains everything in v7-04-12, with the following additions:
- 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.
- Bug fix -- replace GEMISNOX w/ module arrays to avoid common block errors in lightning & aircraft NOx emissions
- Bug fix -- cap variable tropopause at 200hPa for polar regions (90S-60S and 60N-90N)
- Lee Murray's local lightning redistribution of lightning flashes
- 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:
- 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 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
BETA RELEASE October 2007
- Variable tropopause has bug fix from v7-04-11 but not 200 hPa cap at polar latitudes
- NOTE: There is a bug in this version when lightning 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