GEOS-Chem v11-02

Overview

History

The table below shows the previous, current, and successive versions of GEOS-Chem:

Previous version	This version	Next version
GEOS-Chem v11-01	GEOS-Chem v11-02	TBD
PROVISIONAL RELEASE 20 Dec 2016	TBD	TBD
View v11-01 benchmark history	View v11-02 benchmark history	TBD

What's new in this version

NOTE: v11-02a, v11-02b, etc. denote 1-month benchmark simulations, which are designed to evaluate GEOS-Chem's performance at intermediate stages of development.

v11-02a

Feature	Type	Submitted by	Status
Updating chemistry rate constants based on JPL Publication 15-10	Science	Barron Henderson (U. Florida) Mat Evans (U. York) Oxidants and Chemistry WG
PAN updates	Science	Emily Fischer (CSU)	Delivered to GCST (May 2013)

v11-02b

Feature	Type	Submitted by	Status
Halogen chemistry updates	Science	Tomás Sherwen (York) Johan Schmidt (Harvard) Oxidants and Chemistry WG
Enhance default GEOS-Chem simple SOA	Science	Aerosols Working Group

v11-02c

Feature	Type	Submitted by	Status
Updates to isoprene chemistry, includes: Fast photolysis of carbonyl nitrates Aerosol uptake of organic nitrates	Science	Jenny Fisher (U. Wollongong) Eloïse Marais (Harvard) Kelvin Bates (Caltech) Katie Travis (Harvard)

--Bob Yantosca (talk) 19:34, 20 December 2016 (UTC)

v11-02d

Feature	Type	Submitted by	Status
Update density of BC to 1.8 and add absorption enhancement factor in input.geos	Science	Xuan Wang (MIT)	Delivered to GCST (Jan 2016)
Add aqueous isoprene uptake to SOA scheme	Science	Eloise Marais (Harvard)	Delivered to GCST (Jul 2016)
Monthly mean surface methane distributions	Science	Lee Murray (NASA GISS/LDEO)
Radon flux diagnostic	Benchmark	GCST

In the pipeline

Feature	Type	Submitted by	Status
Ocean grid boxes now use the timezone of the nearest land mass for computing emissions	Science	Seb Eastham (Harvard) GCST	Delivered to GCST (Jan 2017)
EDGAR v4.3 emissions	Science	Chi Li (Dalhousie)	Delivered to GCST (Nov 2016)
EPA-derived BC/OA emissions over US (1990-2012)	Science	David Ridley (MIT)
Historical CAC emissions	Science	Chi Li (Dalhousie)	Delivered to GCST (Nov 2016)
Default US emissions to NEI after 2011	Science	Dalhousie group
Ammonia from Arctic birds	Science	Dalhousie group
Ocean ammonia emission inventory	Science	Fabien Paulot (NOAA/GFDL)	Data files delivered to GCST (Jan 2016) Needs to be implemented via HEMCO
A snow NOx source from deep snowpack	Science	Maria Zatko (UW) Becky Alexander (UW)	Implemented in v9-01-01 Needs to be added as a HEMCO extension
Fix to direct/diffuse radiation	Science	Katie Travis (Harvard)
Species Database Phase 3: Harmonizing Henry's Law coefficients across wet and dry deposition	Science	GCST
Updated organic deposition	Science	Katie Travis (Harvard) Jenny Fisher (U. Wollongong)
Remove dependence of species drydep on HNO3 drydep	Science	Katie Travis (Harvard) Jenny Fisher (U. Wollongong)
Update SO2 scavenging in convective updrafts for consistency	Science	Duncan Fairlie (NASA/LARC)
Sedimentation of stratospheric aerosols	Science	Sebastian Eastham (Harvard)
Uniformity of units	Structural	GCST	Phase 2 (unit uniformity throughout chemistry) to be implemented after Flexchem Phase 3 (unit uniformity in some specialty simulations) will be implemented in pieces with input from 3rd party developers Phase 4 (removal of area and area-dependent State_Met variables) will be ongoing
NetCDF Output Phase 3a: Output diagnostics in NetCDF format	Structural	GCST
NetCDF Output Phase 3b: Updates to eliminate differences between single and multi-segmented GEOS-Chem runs	Bug fix/Structural	GCST Christoph Keller
PCB simulation	Science	Carey Friedman (MIT) Helen Amos (Harvard)
Hg code updates (chemistry, ocean, land)	Science	Hg and POPs Working Group
Surface ocean Hg boundary conditions from MITgcm	Science	Hannah Horowitz (Harvard)
Additional modifications for FlexChem, including: Rebuild the pre-built chemistry mechanisms (Standard, Tropchem, UCX, SOA, SOA-SVPOA) with Kppa Add capability for custom chemistry mechanism by building KPP on-the-fly in GEOS-Chem	Structural	Mike Long (Harvard) GCST
FlexGrid: Use HEMCO I/O and regridding capabilities to read and regrid met fields	Structural	Jiawei Zhuang (Harvard) Jintai Lin (PKU)	Delivered to GCST (Oct 2016)
Merge standard simulation with specialty simulations for OVOC, acids, aromatics, dicarbonyls, terpenes	Science	Dylan Millet (UMN) Xin Chen (UMN)
Nested CO2, CH4, Hg, TOMAS, adjoint, etc.	Science	Nested Model Working Group

--Melissa Sulprizio (talk) 15:47, 7 November 2016 (UTC)

New data directories

The following HEMCO data directories have been added or updated for GEOS-Chem v11-02. You will have to download the directories relevant to your simulation.

Inventory	What was added?	When added?	Directory
TBD	TBD	TBD	TBD

Validation

In this section we provide information about the benchmarks and tests that we have done to validate GEOS-Chem v11-01.

1-month and 1-year benchmarks

For complete information about the benchmark simulations used to validate GEOS-Chem v11-02, please see our GEOS-Chem v11-02 benchmark history wiki page.

Unit tests for GEOS-Chem v11-02

We perform a full set of unit tests on GEOS-Chem on an almost daily basis. These tests ensure that each new feature being added does not break any existing functionality.

Here are the unit tests that we ran before submitting 1-month benchmark simulation for v11-02. Click on the links below to see the results from each set of unit tests:

Unit test	Date
TBD	TBD

Previous issues now resolved in GEOS-Chem v11-02

TBD

Outstanding issues not yet resolved in GEOS-Chem v11-02

Ocean grid boxes now use the timezone of the nearest land mass for computing emissions

NOTE: This update will be implemented and fully validated in v11-02. In the meantime, interested users may select this option for v11-01 at their own risk.

Seb Eastham wrote:

Here are the HEMCO timezones used by default in GEOS-Chem v11-01. These are read from the netCDF file HEMCO/TIMEZONES/v2015-02/timezones_1x1.edit.nc.

Note that the timezones of the ocean cells in the above file are not computed robustly. As Christoph Keller points out:

The current timezones mask file does not work properly in grid cells with large ocean overlap. The problem is that the ocean values are netCDF _FillValues that become zero within HEMCO. As a quick fix I updated the timezones file to use a value of –5000 in all ocean cells, which then forces HEMCO to determine the time zone based on longitude in those cells.

Please find a "nearest-cell" version of the HEMCO "timezones" file (HEMCO/TIMEZONES/v2015-02/timezones_voronoi_1x1.nc). I'd like to suggest that this replace the default HEMCO timezones file shown above. The new ("Voronoi") approach sets the timezone in every ocean cell to match that of the closest valid land cell by great circle distance. Without the update, some coastal areas will use the wrong timezone, resulting in incorrect diurnal scalings. Here is a plot of the Voronoi timezones:

As of this writing (04 Jan 2017), we expect that the Voronoi timezones will be made the default HEMCO timezones in v11-02, pending benchmarking and approval. In the meantime, interested GEOS-Chem users may select this option by updating this entry in the HEMCO_Config.rc file. Change the text in RED

* TIMEZONES $ROOT/TIMEZONES/v2015-02/timezones_1x1.edit.nc UTC_OFFSET 2000/1/1/0 C xy count * - 1 1

to the text in GREEN:

* TIMEZONES $ROOT/TIMEZONES/v2015-02/timezones_voronoi_1x1.nc UTC_OFFSET 2000/1/1/0 C xy count * - 1 1

--Bob Yantosca (talk) 19:00, 4 January 2017 (UTC)