GEOS–Chem v9–01–03 Online User's Guide
Previous | Next | Printable View (no frames)
Appendix 10: GEOS–Chem Version History
On this page we shall preserve the list of "What's new" in each GEOS–Chem public release.
Please also see our archive of past GEOS–Chem User's Guides page.
A10.1 What's new in GEOS–Chem v9–02
The following features were introduced into GEOS–Chem public release v9–02:
| Feature | Developer(s) |
|---|---|
| Science updates |
|
Rynda Hudman Kay (EPA), Neil Moore (formerly of Dalhousie), Bram Maasakkers (Eindhoven) | |
Yanxu Zhang (U. Washington), Lyatt Jaeglé (U. Washington) | |
Yanxu Zhang (U. Washington), Lyatt Jaeglé (U. Washington) | |
Bess Corbitt (Harvard) | |
Correct Hg simulation to use updated Hg(0) oxidation kinetics |
Bess Corbitt (Harvard), Justin Parrella (Harvard) |
Bess Corbitt (Harvard), Justin Parrella (Harvard) | |
Carey Friedman (MIT), Noelle Selin (MIT) | |
Mat Evans (York) | |
Ellie Browne (UC Berkeley) | |
Fabien Paulot (Harvard), Eloise Marais (Harvard), Jingqiu Mao (NOAA/GFDL), Mat Evans (York) | |
Fabien Paulot (Harvard) | |
Jingqiu Mao (NOAA/GFDL) | |
GEOS-Chem Support Team | |
Lin Zhang (Peking University) | |
Jingqiu Mao (NOAA/GFDL) | |
Lin Zhang (Peking University) | |
Wai-Ho Lo (Dalhousie) | |
Chris Holmes (UC Irvine) | |
Kevin Wecht (Harvard) | |
Aaron van Donkelaar (Dalhousie) | |
Prasad Kasibhatla (Duke) | |
Jenny Fisher (U. Wollongong) | |
Sal Farina (CSU) | |
Sebastian Eastham (MIT), Steven Barrett (MIT) | |
Havala Pye (EPA), GEOS-Chem Support Team | |
Jintai Lin (Peking University), GEOS-Chem Support Team | |
Becky Alexander (U. Washington) | |
David Ridley (MIT), Randall Martin (Dalhousie) | |
| Structural updates |
|
GEOS-Chem Support Team |
|
Sal Farina (CSU), GEOS-Chem Support Team | |
Additional modifications to enable GEOS-Chem to run within the GEOS-5 GCM |
GEOS-Chem Support Team |
Chris Holmes (UC Irvine) | |
Rewriting inefficient subroutine calls to avoid wasting memory and CPU cycles |
GEOS-Chem Support Team |
GEOS-Chem Support Team | |
Nested-grid model at 0.25° x 0.3125° resolution using GEOS–FP met data product from GMAO |
Yuxuan Wang (Tsinghua), GEOS-Chem Support Team |
Global simulations with GEOS–FP data product from GMAO |
GEOS-Chem Support Team |
| Bug fixes |
|
Sajeev Philip (Dalhousie) |
|
Sajeev Philip (Dalhousie) | |
Jenny Fisher (U. Wollongong), GEOS-Chem Support Team | |
Sajeev Philip (Dalhousie) | |
Aaron van Donkelaar (Dalhousie) | |
GEOS-Chem Support Team | |
Bug fix in regridding of anthropogenic emissions (NEI2005, Streets) |
GEOS-Chem Support Team |
GEOS-Chem Support Team | |
Tzung-May Fu (Peking University) | |
Yanxu Zhang (U. Washington) | |
Prevent bad drydep flux values from being passed to the soil NOx emissions module |
Patrick Kim (Harvard), GEOS-Chem Support Team |
Bug fix for declaration of GEOS-FP PFICU, PFLCU, PFILSAN, PFLLSAN fields |
GEOS-Chem Support Team |
Jenny Fisher (U. Wollongong) | |
GEOS-Chem Support Team | |
Fabien Paulot (Harvard) | |
Emily Fischer (Harvard) | |
Fix diurnal NOx scale factors and fix double counting of biofuels over Mexico, Canada, and Europe |
Christoph Keller (Harvard) |
Christoph Keller (Harvard) | |
Christoph Keller (Harvard) | |
Bug fix for anthropogenic scaling factors for years 2006 and later |
Jenny Fischer (U. Wollongong) |
Correct additional bugs in ship emissions w/ non-local PBL mixing |
Chris Holmes (UC Irvine), Geert Vinken (Eindhoven) |
Chris Holmes (UC Irvine) | |
Thibaud Thonat (U. Edinburgh) | |
GEOS-Chem Support Team | |
Jenny Fisher (U. Wollongong) | |
GEOS-Chem Support Team | |
Corrected minor bugs for GCAP that were introduced by GIGC edits |
GEOS-Chem Support Team |
Sal Farina (CSU) | |
Bug fix in ND36 diagnostic when ship emissions are turned off |
Yanko Davila (U. Colorado) |
GEOS-Chem Support Team | |
GEOS-Chem Support Team | |
Gabriele Curci (U. L'Aquila) | |
Wai Ho Lo (Dalhousie) | |
A10.2 What's new in GEOS–Chem v9–01–03
The following features were introduced into GEOS–Chem public release v9–01–03:
| Feature | Description |
|---|---|
| Science updates |
|
Updated acetone chemistry |
Emily Fischer has updated the acetone formulation used in GEOS–Chem. See the acetone wiki page for more information. |
OVOC dry deposition updates |
The reactivity factor (f0) for all OVOCs has been changed from 0 to 1, according to Karl et al. (2010). See this wiki page for more information. |
Improved sea salt emission and deposition |
Sea salt emissions and dry deposition have been updated according to Jaeglé et al. (2011). |
Dust submicron size distribution |
A more realistic partitioning for the dust mass into the submicron size bins has been applied. See this wiki page for more information. |
Improved snow scavenging and washout parameterization |
The following updates have been added to improve wet scavenging algorithm: |
PARANOX ship plume emissions |
Previously, 10 molecules O3 and 1 molecule HNO3 were emitted per ship NOx molecule. Ship emissions have been updated according to Vinken et al. (2011) to account for non-linear chemistry of ship plumes. See this wiki page for more information. |
Add scaling of lightning NOx for 2x2.5 MERRA simulations |
Lee Murray has generated OTD/LIS local redistribution factors for use with MERRA at 2° x 2.5°. See this wiki page for more information. |
Historical emission inventories of SO2, NOx, BC, and POA |
Historical emission inventories of SO2, NOx, BC, and POA have been implemented according to Leibensperger et al. (2011). See this wiki page for more information. |
Nested-grid updates for offline simulations |
Nested-grid capability has been added to the following offline simulations:
|
Hg(II) gas-aerosol partitioning |
This update includes the following items:
|
| CH4 simulation updates | Kevin Wecht has updated the CH4 simulation to include GFED3 biomass burning emissions and linearized CH4 chemistry from GMI output. See the CH4 simulation wiki page for more information. |
Daily and 3-hourly GFED3 biomass emissions |
Prasad Kasibhatla updated GEOS–Chem to incorporate the capabilty to use GFED3 daily and 3-hourly fire fractions, and to regrid on the fly from the GFED3 native resolution (0.5° x 0.5°) to the model resolution. See this wiki page for more information. |
Tropospheric bromine chemistry |
Justin Parrella added 10 bromine tracers and their associated chemical reactions to the GEOS–Chem full chemistry simulation. See this wiki page for more information |
Satellite-based NOx emission trends |
Scaling factors for anthropogenic NOx emissions derived from OMI tropospheric NO2 columns (compiled by Lok Lamsal) have been implemented. See this wiki page for more information. |
Stratospheric P and k (monthly climatology) |
An updated linearized stratospheric chemistry scheme has been implemented into GEOS–Chem v9–01–03. See the stratospheric chemistry wiki page for more information. |
| Structural updates |
|
Retirement of obsolete GEIA biogenic emissions |
GEIA biogenic VOC emissions have been removed from GEOS–Chem v9–01–03. It is recommended that you use the MEGAN biogenic emissions in your GEOS–Chem simulations. |
Structural changes to clarify science behind washout |
Washout code has been split into three cases: aerosols, HNO3, and soluble gases. This was done to ensure that HNO3 is not affected by the aerosol scavenging updates and is still scavenged according to Eq. 14 from Jacob (2000). |
Initial source code modification for GEOS–5.7.2 |
GEOS–Chem has been modified for compatilibility with the GEOS–5.7.2 meteorological data. |
Remove support for GEOS–3 meteorology |
See this wiki page for more information. |
Updates from the grid-independent GEOS–Chem model code |
Modifications made for the grid-independent GEOS–Chem model include: |
MAP_A2A regridding package |
Matt Cooper replaced the existing GEOS–Chem regridding routines with the MAP_A2A regridding package (developed by S.-J. Lin and refined by Bob Yantosca). The new algorithm regrids emissions from any arbitrary horizontal grid to the current model resolution. |
| Bug fixes |
|
Fix for GLCO3/GLPAN bug in standard chemistry mechanism |
Fabien Paulot found a bug in the standard chemistry mechanism, which resulted in an artificial loss of NOx. See this wiki page for more information. |
Bug fix in routine ARSL1K |
The default value for the loss rate on wet aerosol (ARSL1K) has been changed from 1.0d-3 to 1.0d-30. See this wiki page for more information. |
Various other bug fixes |
The following updates were made to fix several bugs in GEOS–Chem v9–01–02:
|
A10.3 What's new in GEOS–Chem v9–01–02
The following features were introduced into GEOS–Chem public release v9–01–02:
| Feature | Description |
|---|---|
| Science updates |
|
Updated dry deposition velocities for aerosols over ice and snow |
Modeled aerosol dry deposition velocities over snow and ice surfaces in the Arctic were much higher than estimated from measured values (e.g., Ibrahim et al. [1983]; Duan et al. [1988]; Nilsson and Rannik [2001]). In v9–01–02, a dry deposition velocity of 0.03 cm/s is imposed for all aerosols over snow and ice surfaces. |
Imposed seasonality on the NH3 emissions from David Streets 2000 inventory |
The Streets 2000 inventory for anthropogenic ammonia (NH3) does not include any seasonal cycle. This has been corrected by using the annual total from Streets 2000 superimposed with monthly scale factors from a global inventory compiled by Marcel Meinders and Lex Bouwman. |
RETRO anthropogenic VOC emissions |
Monthly RETRO anthropogenic VOC emissions have been added as an optional inventory. For more information, please see this document: |
APM aerosol microphysics |
Fangqun Yu and Gan Luo developed the Advanced Particle Microphysics (APM) package for implementation into GEOS–Chem. APM is now one of two microphysics packages in GEOS–Chem, the other being TOMAS. |
GFED3 biomass burning emissions |
Monthly mean GFED3 biomass burning emissions have been added to v9-01-02. The GFED3 emissions inventory will eventually replace GFED2. |
GEIA 2005 Hg emissions |
Bess Corbit prepared the GEIA 2005 emission inventory for anthropogenic Hg. |
| Structural updates |
|
Modifications for compatability with ESMF |
Modifications were made to GEOS–Chem source code to enable compatability with the Earth System Model Framework (ESMF). These changes were were aimed at cleaning up legacy code and making specific portions of the code FORTRAN 90/95 compliant. For more information, please see the following links: |
MERRA SEAICExx fields added to the planeflight diagnostic |
The MERRA SEAICExx fields are now saved to the plane flight diagnostic. |
Overhaul of AOD diagnostics |
Patrick Kim discovered some inconsistencies in the way aerosol optical depth diagnostics were being computed in v9–01–01 and prior versions. See this wiki page for more information. |
Archive MERRA SWGDN field in the ND67 diagnostic |
MERRA "incident shortwave radiation at the ground" (SWGDN) is now archived to ND67, not "net longwave radiation at the ground" (LWGNT). |
Centralized chemistry time step |
The time at which chemistry, emissions, photolysis, and drydep operations are performed has been moved to the midpoint of the chemistry time step. See this wiki page for more information. |
| Bug fixes |
|
Bug fixes for the offline Hg simulation |
The following issues were discovered in the offline Hg simulation shortly after the release of v9-01-01 and have been fixed in v9-01-02: |
Various other bug fixes |
The following updates were made to fix several bugs:
|
A10.4 What's new in GEOS–Chem v9–01–01
The following features were introduced into GEOS–Chem public release v9–01–01:
| Feature | Description |
|---|---|
Capability to run with GMAO MERRA meteorological fields |
GEOS–Chem v9–01–01 is the first version to be compatible with the MERRA met data product from GMAO. MERRA is a 30-year reanalysis data set which spans the years 1979-2010. |
Bug fix for lightning NOx emissions |
In GEOS–Chem v9–01–01, the following updates were made that impact the emissions of lightning NOx:
For detailed information about these updates, please see this document: |
Improvements to the wet deposition and convective updraft scavenging algorithms |
Helen Amos and Bess Corbitt have updated the wet deposition and convective updraft scavenging algorithms, particularly for the new MERRA met fields. Also, following upon the work of Qiaoqiao Wang, we now allow both rainout and washout to happen simultaneously in a grid box where new precipitation is forming. |
Updated volcanic SO2 emissions from Aerocom |
The latest volcanic SO2 emissions update from Thomas Diehl have been applied to GEOS–Chem v9–01–01. |
Important bug fixes for ship emissions |
Geert Vinken has submitted a couple of important fixes for ship emissions. These have been added to v9-01-01. For more information, please see the following links: |
| EPA/NEI05 biofuel bug fix | A bug in the EPA/NEI05 emissions code was found prior to the release of GEOS–Chem v9–01–01. Long story short: when the EPA/NEI05 option is selected, the wrong biofuel emissions inventory is used over the continental USA. For a complete description of this bug, please see this post on our EPA/NEI05 wiki page. |
Various technical improvements |
The following updates were made to fix several technical issues:
|
A10.5 What's new in GEOS–Chem v8–03–01 and v8–03–02
The following features were introduced into GEOS–Chem public release v8–03–01:
| Feature | Description |
|---|---|
Caltech isoprene chemistry mechanism |
A new isoprene chemistry was introduced as an option to solve an over-estimation in isoprene in previous GEOSChem versions. |
LINOZ stratospheric ozone chemistry |
Implementation of LINOZ which provides a linear chemistry for ozone in the stratosphere. |
ISORROPIA II |
ISORROPIA II is now used to calculate the aerosol thermodynamic equilibrium instead of RPMARES. |
Updated aerosol optical properties for FAST-J photolysis |
The GEOS–Chem Aerosols Working Group has created an updated list of aerosol optical properties (i.e. quantum yields, cross-sections) for input into the FAST–J photolysis mechanism. |
Option to use chemical solver from KPP software |
The KPP chemical solver now contains 3 mechanisms to choose from:
|
Emissions modifications |
Various modifications to existing emissions inventories, including:
|
New non-local planetary boundary layer scheme |
Jintai Lin has implemented a new boundary layer mixing scheme option into GEOS–Chem. It is a non-local scheme formulated by Holtslag and Boville (1993). |
Modifications to SOA formation |
Several modifications were applied to the secondary organic aerosol scheme: |
Updates for sea salt aerosols |
Lyatt Jaeglé and Becky Alexander have updated the sea salt emissions scheme in GEOS–Chem. |
TOMAS aerosol microphysics option |
The Carnegie-Mellon group has interfaced the TOMAS aerosol microphysics scheme into GEOS–Chem. |
| Global 1° x 1.25° simulation capability | Lok Lamsal from Dalhousie University has added the capability to run GEOS–Chem at the GEOS–4 native resolution of 1° x 1.25°. |
| Modifications to / Creation of the GEOS-5 0.5° x 0.667° N. American and European Nested Grid simulation | Several modifications were made to GEOS–Chem's nested grid simulation capability, including:
|
| Updated CH4 simulation | Christopher Pickett-Heaps and Kevin Wecht have updated the CH4 simulation in GEOS–Chem, following earlier work by Jerome Drevet. |
The following features were introduced into GEOS–Chem beta release v8–03–02:
| Feature | Description |
|---|---|
Terrestrial and deep ocean mercury |
The Global Terrestrial Mercury Model (cf. Nicole Smith-Downey) can now be selected as an option in the standard mercury simulation. Many features of the mercury simulation have also been improved (cf. E. Sunderland, C. Holmes). |
Updated CO2 simulation |
Ray Nassar has updated the CO2 simulation with new inventories and fluxes. For a full description, see our CO2 simulation wiki page. |
Obtain liquid water content from GEOS–5 met fields |
Jenny Fisher modified the existing SO2 chemistry scheme such that it will obtain the cloud fraction and liquid water content directly from the GEOS–5 meteorlogy. |
A10.6 What's new in GEOS–Chem v8–02–01
The following features were introduced into GEOS–Chem public release v8–02–01:
| Feature | Description |
|---|---|
Updated chemical reactions |
Chemical relations and relation rates are updated mainly from JPL06 and IUPAC06. Photolysis quantum yields are updated from FAST–JX version 6.4 data. See HERE for detailed changes compared to v8–01–04. The pressure-dependency sheme for acetone photolysis is now updated to FAST–JX version 6.4. The format of jv_spec.dat file has slightly changed. The new format is explained in Chapter 5: GEOS–Chem run directories. |
Updated dust scattering |
|
Updated emissions |
Several emission inventories are updated or newly implemented. All details concerning emissions are in Chapter 4: GEOS–Chem data directories. |
Improved stratospheric exchange |
GEOS–Chem uses now the transport routine and pressure fixer from GMI. This ensures to have a reasonable troposphere-stratosphere exchange. |
A10.7 What's new in GEOS–Chem v8–01–01
The following features were introduced into GEOS–Chem public release v8–01–01:
| Feature | Description |
|---|---|
Compatibility with GEOS–5 meteorological fields |
GEOS–Chem v8–01–01 is now fully compatible with the GMAO GEOS–5 operational data product (e.g. GEOS-5.0.1 and GEOS-5.1.0). You must upgrade to GEOS–Chem v8–01–01 if you wish to drive GEOS–Chem with the GEOS–5 meteorology. Please see the GEOS–Chem wiki for a more complete account of some of the issues that were encountered during GEOS–5 implementation. |
GEOS–1 and GEOS–STRAT meteorology is no longer supported |
With the availability of several years of GMAO's GEOS–4 and GEOS–5 meteorological data products, it is no longer necessary to use the older GEOS–1 and GEOS–STRAT products. Therefore, GEOS–Chem v8–01–01 no longer supports these data sets. NOTE: GMAO's GEOS–3 meteorological data product is still supported in GEOS–Chem v8–01–01, and will continue to be supported indefinitely. |
Dynamic tropopause |
GEOS–Chem now has the capability to perform chemistry with SMVGEAR up to the location of the actual tropopause, as diagnosed by the tropopause pressure (TROPP) meteorological field. This results in a more accurate representation of the tropopause, and causes more grid boxes in the tropics to be sent to the SMVGEAR solver. In prior versions, SMVGEAR chemistry was only done up to the location of the annual mean tropopause. |
Updated lightning with OTD/LIS local redistribution |
The lightning NOx emissions algorithm in GEOS–Chem v8–01–01 has been substantially rewritten to try to better match the observational distribution of lightning flashes. The location of lightning flashes now follows the patterns observed by the OTD/LIS satellite instruments. |
Updated global and regional anthropogenic emissions |
In GEOS–Chem v8–01–01, the default GEIA/Piccot anthropogenic emissions can now be overwritten with a combination of global and regional anthropogenic emissions inventories, including:
Click HERE to view a table with more detailed information about each of these inventories. NOTE: In afuture version of GEOS–Chem, we will be introducing an improved algorithm to scale fossil fuel emissions from the baseline year of 2000 to the present year (cf. Aaron van Donkelaar). |
GFED2 biomass burning emissions |
In GEOS–Chem v8–01–01, you may select either the default Duncan et al (2001) biomass burning emissions, or the GFED2 biomass burning emissions. NOTE: At present only the GFED2 monthly mean emissions have been implemented. The 8-day-averaged GFED2 emissions will be introduced into a future version of GEOS–Chem (cf. Ray Nassar). |
Safer floating-point operations |
GEOS–Chem v8–01–01 includes some extra floating point error traps (e.g. safe division, avoiding division by zero, etc.) in order to prevent NaN and infinity values from propagating throughout the code. Also, a bug fix was implemented into SMVGEAR in order to better screen out negative values. |
Aerosol Thermodynamic Equilibrium with RPMARES |
It was recently discovered that the version of ISORROPIA that ships with GEOS–Chem can give bad values when computing the aerosol thermodynamical equilibrium for grid boxes where relative humidity is below 30%. Therefore, until further notice we have reverted back to the RPMARES code for computing aerosol thermodynamical equilibrium until further notice. |
Compatibility with SunStudio 11/12 and Intel Fortran Compiler 10 |
GEOS–Chem v8–01–01 now ships with Makefiles for compiling with the newest Sun or Intel Fortran compilers. Options for using the TotalView Debugger are also now included in the makefiles. |