Difference between revisions of "GEOS-Chem v11-01"
(→Added a test for mass conservation) |
(→Added a test for mass conservation) |
||
Line 424: | Line 424: | ||
make -j4 TRACEBACK=y NO_ISO=y mp | make -j4 TRACEBACK=y NO_ISO=y mp | ||
− | :this will start compiling and running the GEOS-5 mass conservation test. Output to the bpch, timeseries, and restart files will be disabled. Instead, the mass of the total CO2 tracer will be printed out to a file named <tt>tracer_mass_kg.dat</tt> (you can rename this in the <tt>ND49 MENU</tt> section of <tt>input.geos</tt>). The output will look similar to this: | + | :this will start compiling and running the GEOS-5 mass conservation test. The Makefile in this run directory will automatically set a new Makefile option <tt>MASSCONS=y</tt>, which turns on the mass conservation test. Output to the bpch, timeseries, and restart files will be disabled. Instead, the mass of the total CO2 tracer will be printed out to a file named <tt>tracer_mass_kg.dat</tt> (you can rename this in the <tt>ND49 MENU</tt> section of <tt>input.geos</tt>). The output will look similar to this: |
2.887072562747136E+015 : 2012/07/01 06:00 | 2.887072562747136E+015 : 2012/07/01 06:00 |
Revision as of 22:15, 24 June 2015
Contents
Overview
History
The table below shows the previous, current, and successive versions of GEOS-Chem:
Previous version | This version | Next version |
---|---|---|
GEOS-Chem v10-01 | GEOS-Chem v11-01 | TBD |
PUBLIC RELEASE 17 Jun 2015 | TBD | TBD |
View v10-01 benchmark history | View v11-01 benchmark history | TBD |
--Bob Y. (talk) 20:29, 17 June 2015 (UTC)
What's new in this version
NOTE: v11-01a, v11-02b, etc. denote 1-month benchmark simulations, which are designed to evaluate GEOS-Chem's performance at intermediate stages of development.
v11-01a
Please see the Benchmark approval form for GEOS-Chem v11-01a for complete information about the validation of GEOS-Chem v10-01a.
Feature | Type | Submitted by | Status |
---|---|---|---|
Incorporate moisture into air quantities, tracer units, and tracer unit conversions | Science & Bug fix |
Lizzie Lundgren (GEOS-Chem Support Team) | TBD |
Correct bug in below cloud average mixing ratio calculation in DO_MERRA_CONVECTION to improve mass balance | Bug fix | Lizzie Lundgren (GEOS-Chem Support Team) | TBD |
Added the capability to print out tracer masses every few hours, in order to check for mass conservation | Structural | Lizzie Lundgren (GEOS-Chem Support Team) | TBD |
--Lizzie Lundgren (talk) 14:37, 23 June 2015 (UTC)
--Bob Y. (talk) 21:33, 24 June 2015 (UTC)
v11-01b
NOTE: This version will require a 1-month benchmark simulation and 1-year benchmark simulation.
Feature | Type | Submitted by | Status |
---|---|---|---|
Update DMS climatology to Lana | Science | Tom Breider (Harvard) | TBD |
Impaction scavenging for hydrophobic BC | Science | Qiaoqiao Wang (Max Planck Institute) |
|
Homogeneous IN removal | Science | Qiaoqiao Wang (Max Planck Institute) |
|
Online emission of marine primary organic aerosol (POA) | Science | Brett Gantt (NCSU) Matthew Johnson (NASA Ames) |
|
Density of OA update | Science | Melanie Hammer (Dalhousie) Eloïse Marais (Harvard) |
|
Addition of BrC UV absorption to address impacts on OH | Science | Melanie Hammer (Dalhousie) |
|
Acid uptake on dust aerosols | Science | T. Duncan Fairlie (NASA/LARC) |
|
Improved dust size distribution scheme | Science | Li Zhang (Colorado U.) Daven Henze (Colorado U.) |
|
Metal catalyzed oxidation of SO2 (as a switch) | Science | Becky Alexander (UW) | |
Harmonizing Henry's Law coefficients across wet and dry deposition | Science | GEOS-Chem Support Team |
--Melissa Sulprizio (talk) 19:03, 22 June 2015 (UTC)
v11-01c
NOTE: This version will require a 1-month benchmark simulation only.
Feature | Type | Submitted by | Status |
---|---|---|---|
Updates to PAH code | Science | Carey Friedman (MIT) | TBD
|
Remove in-plume reduction of Hg | Science | Yanxu Zhang (Harvard) | " " |
--Melissa Sulprizio (talk) 18:23, 16 June 2015 (UTC)
In the pipeline
The following features are slated for inclusion in GEOS-Chem v11-01:
Feature | Type | Submitted by | Status |
---|---|---|---|
CO2 direct effect on isoprene emissions | Science | Amos Tai (CUHK) |
|
Criegee intermediates | Science | Dylan Millet (U. Minnesota) Eloïse Marais (Harvard) |
|
PAN updates | Science | Emily Fischer (CSU) |
|
NetCDF output: Flexible diagnostic package and tracer restart file | Science | GEOS-Chem Support Team | TBD |
Flexchem | Science | Mike Long (Harvard) | TBD |
Uniformity of units | Science | Lizzie Lundgren (GEOS-Chem Support Team) |
|
Monthly mean surface methane distributions | Science | Lee Murray (NASA GISS/LDEO) | TBD |
Fix to direct/diffuse radiation | Science & Bug fix |
Katie Travis | TBD |
Fix for NO3 + ISOP product | Science | Katie Travis | TBD |
Update MODIS LAI fields through 2015 | Science | Barron Henderson (UF) | TBD |
Updated organic deposition | Science | Katie Travis (Harvard) Jenny Fisher (U. Wollongong) |
TBD |
Hg emission update: NEI, EDGAR, NPRI, UNEP | Science | Hg and POPs WG | TBD |
Optimized ocean rate coefficients for Hg simulation | Science | Shaojie Song (MIT) | TBD |
Update offline oxidant fields for Hg simulation | Science | Viral Shah (UW) Johan Schmidt (Harvard) |
TBD |
Dry deposition updates for Hg simulation | Science | Bess Corbitt (Harvard) | TBD |
New atmospheric Hg redox mechanism | Science | Hannah Horowitz (Harvard) | TBD |
GTMM revision | Science | Bess Corbitt (Harvard) | TBD |
EPA-derived BC/OA emissions over US (1990-2012) | Science | David Ridley (MIT) | TBD |
Update density of BC to 1.8 and add absorption enhancement factor in input.geos | Science | Xuan Wang (MIT) | TBD |
Updates to isoprene chemistry, includes:
|
Science | Jenny Fisher (U. Wollongong) Eloïse Marais (Harvard) Kelvin Bates (Caltech) Katie Travis (Harvard) |
TBD |
Nighttime isoprene chemistry updates | Science | Rebecca Schwantes (Caltech) | TBD |
Remove dependence of species drydep on HNO3 drydep | Science | Katie Travis (Harvard) Jenny Fisher (U. Wollongong) |
TBD |
Arctic Hg cycling | Science | Jenny Fisher (U. Wollongong) | TBD |
A snow NOx source from deep snowpack | Science | Maria Zatko (UW) Becky Alexander (UW) |
TBD |
Land cover module in GEOS-Chem | Science | Jeffrey Geddes (MIT) Michael Long (Harvard) |
TBD |
Merge standard simulation with specialty simulations for OVOC, acids, aromatics, dicarbonyls, terpenes | Science | Dylan Millet (UMN) Xin Chen (UMN) |
TBD |
Automate redistribution of NOx in HEMCO | Science | Lee Murray (NASA GISS/LDEO) | TBD |
Injection height for fire emissions | Science | Emily Fischer (CSU) | TBD |
Improved lightning emission scheme | Science | Lee Murray (NASA GISS/LDEO) | TBD |
--Melissa Sulprizio (talk) 19:03, 22 June 2015 (UTC)
New data directories
The following new data directories have been added for GEOS-Chem v11-01. You will have to download the directories relevant to your simulation.
- 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-01, please see our GEOS-Chem v11-01 benchmark history wiki page.
--Melissa Sulprizio 10:30, 5 May 2015 (EDT)
Unit tests for GEOS-Chem v11-01
We performed a full set of unit tests on GEOS-Chem before submitting each 1-month benchmark. Click on the links below to see the results from each set of unit tests:
Unit test | Date | Notes |
---|---|---|
TBD | TBD |
--Melissa Sulprizio 10:30, 5 May 2015 (EDT)
Previous issues now resolved in GEOS-Chem v11-01
The following bugs and/or technical issues have now been resolved in GEOS-Chem v11-01.
Added a test for mass conservation
These updates will be validated in the 1-month benchmark simulation v11-01a. Approval date TBD.
In GEOS-Chem v11-01a, we have added a mass conservation check capability. This will let you see at a glance if GEOS-Chem is conserving mass.
In the GEOS-Chem Unit Tester, we have created two new run directories:
runs/geosfp_2x25_masscons runs/geos5_2x25_masscons
which are instances of the 2° x 2.5° CO2 simulation, but with zero emissions and with a constant (e.g. 370 ppm) initial condition field.
You can make a fresh copy of one (or both) of these directories with the gcCopyRunDirs script to a convenient location in your account. Once you have done that, then follow these steps:
- 1. Let's say you want to run the geos5_2x5_masscons test. First cd into the copied geos5_2x25_masscons directory.
- 2. Make sure you specify your desired start & end dates in your input.geos file. Also make sure to put a 3 on the last day of the simulation in the OUTPUT MENU section.
- 3. Then type this command:
make -j4 TRACEBACK=y NO_ISO=y mp
- this will start compiling and running the GEOS-5 mass conservation test. The Makefile in this run directory will automatically set a new Makefile option MASSCONS=y, which turns on the mass conservation test. Output to the bpch, timeseries, and restart files will be disabled. Instead, the mass of the total CO2 tracer will be printed out to a file named tracer_mass_kg.dat (you can rename this in the ND49 MENU section of input.geos). The output will look similar to this:
2.887072562747136E+015 : 2012/07/01 06:00 2.887072562747084E+015 : 2012/07/01 12:00 2.887072562747109E+015 : 2012/07/01 18:00 2.887072562747105E+015 : 2012/07/02 00:00 2.887072562747306E+015 : 2012/07/02 06:00 2.887072562747272E+015 : 2012/07/02 12:00 2.887072562747154E+015 : 2012/07/02 18:00 2.887072562746720E+015 : 2012/07/03 00:00
- The output shows the sum of CO2 tracer (in kg) over all longitudes, latitudes and levels, with a corresponding time stamp. As you can see from this example, mass is conserved to about the 11th decimal place, which indicates good mass conservation.
--Bob Y. (talk) 21:53, 24 June 2015 (UTC)
Outstanding issues not yet resolved in GEOS-Chem v11-01
The following issues have not yet been resolved in GEOS-Chem v11-01. Some of these issues represent questions of open research rather than bugs in the source code.
- None yet