GEOS-Chem 12: Difference between revisions
(→12.0.0) |
(→12.0.0) |
||
| Line 202: | Line 202: | ||
|Kate O'Dell (CSU)<br>[[GCST]] | |Kate O'Dell (CSU)<br>[[GCST]] | ||
|Science | |Science | ||
|Data files downloaded 27 Jun 2018 | |Data files downloaded 27 Jun 2018<br>Awaiting approval of results by developers | ||
|-valign="top" | |-valign="top" | ||
Revision as of 21:33, 29 June 2018
GEOS-Chem v11-02-final will also carry the designation GEOS-Chem 12.0.0. We are migrating to a purely numeric versioning system in order to adhere more closely to software development best practices. For a complete description of the new versioning system, please see our GEOS-Chem version numbering system wiki page.
Version history
The table below shows the previous, current, and successive major GEOS-Chem versions:
| Previous major release | Current release candidate | Pending major release | Next stable version | Successive major release |
|---|---|---|---|---|
| GEOS-Chem v11-01-public | v11-02-release-candidate (aka v11-02-rc) |
GEOS-Chem 12.0.0 aka v11-02-final in the old version number system |
GEOS-Chem 12.1.0 | GEOS-Chem 13.0.0 |
| RELEASED 01 Feb 2017 | RELEASED 22 Jun 2018 | RELEASE TBD | RELEASE TBD | RELEASE TBD 2019 |
| GC v11-01 online manual | GC v11-02 benchmark history | GC 12 online manual | GC 12 benchmark history |
The sections below describe each GEOS-Chem feature version and GEOS-Chem patch version belonging to the GEOS-Chem 12 series. Each feature version carries the tag 12.Y.0, which indicates that the version will be (or has been) validated with a 1-month benchmark simulation (and one or more 1-year benchmark simulations if necessary). Each patch version carries the tag 12.Y.Z, which denotes that the version preserves backwards-compatibility with the prior feature version 12.Y.0. For more information, please see our GEOS-Chem version numbering system wiki page.
In the pipeline
Several GEOS-Chem updates have been proposed by the relevant Working Groups, but have not yet been assigned to a specific GEOS-Chem version. For a complete list of these updates, please visit our GEOS-Chem model development priorities wiki page.
12.3.0
The items listed below are slated to be included in GEOS-Chem 12.3.0. This is a feature release which will be validated with a 1-month benchmark simulation.
| Feature | Submitted by | Type | Status |
|---|---|---|---|
| Features affecting the full-chemistry simulation: | |||
| Update ISORROPIA from v2.0 to v2.2, in order to remove persistent noise in output | Seb Eastham (Harvard) | Science |
|
| Update MODIS LAI fields for 2005-2016 using Yuan et al. (2011) | Jenny Fisher (Wollongong) Barron Henderson (US EPA) |
Science |
|
| Extend UCX into the mesosphere | Sebastian Eastham (MIT) | Science | |
| OMI-based Volcanic emissions 2005-2012 | Cui Ge (U. Iowa) Jun Wang (U. Iowa) |
Science |
|
12.2.0
The items listed below are slated to be included in GEOS-Chem 12.2.0. This is a feature release which will be benchmarked with a 1-month benchmark simulation and a 1-year Rn-Pb-Be benchmark simulation.
| Feature | Submitted by | Type | Status |
|---|---|---|---|
| Features NOT affecting the full-chemistry simulation: | |||
| Common set of tracers in GEOS-Chem and GEOS | Transport WG GCST |
Benchmarking |
|
12.1.0
The items listed below are slated to be included in GEOS-Chem 12.1.0. This is a feature release which will be validated with a 1-month benchmark simulation.
| Feature | Submitted by | Type | Status |
|---|---|---|---|
| Features affecting the full-chemistry simulation: | |||
| FlexGrid: Use HEMCO to read met fields and enable nested simulations over any custom domains | Jiawei Zhuang (Harvard) Jintai Lin (PKU) |
Structural |
|
| Anthropogenic PM2.5 dust source | Sajeev Philip (Dalhousie) | Science |
|
| NetCDF Output Phase 3b: Updates to eliminate differences between single and multi-segmented GEOS-Chem runs | GCST Christoph Keller |
Bug Fix & Structural |
|
| Features NOT affecting the full-chemistry simulation: | |||
| Updated flux diagnostics | Chris Holmes (Florida State) GCST |
Structural/ Benchmarking |
|
12.0.0
GEOS-Chem v11-02-final will also carry the designation GEOS-Chem 12.0.0. We are migrating to a purely numeric versioning system in order to adhere more closely to software development best practices. For a complete description of the new versioning system, please see our GEOS-Chem version numbering system wiki page.
The following updates and fixes are slated to be added to GEOS-Chem 12.0.0 (aka v11-02-final). Many of these updates fix issues that were identified during the GEOS-Chem v11-02 "release candidate" testing period.
| Feature | Submitted by | Type | Status |
|---|---|---|---|
| Features affecting the full-chemistry simulation: | |||
| Grid offset bug fix in high-resolution MEGAN files at southern mid-latitudes | Jenny Fisher (Wollongong) Dylan Millet (UMN) |
Bug fix | New files received Run directory updates not yet applied |
| Bug fix in FlexChem: do not zero out ACTA, EOH, HCOOH concentrations | Katie Holmes | Bug Fix | Implemented 27 Jun 2018
|
| Add GFED4.1 data for 2015 and 2016; Use GFED4.1 2016 in benchmarks | Kate O'Dell (CSU) GCST |
Science | Data files downloaded 27 Jun 2018 Awaiting approval of results by developers |
| Avoid double counting CEDS and GEIA NH3 biofuel emissions | Christoph Keller (NASA/GMAO) GCST |
Bug fix | Implemented 29 Jun 2016
|
| Features NOT affecting the full-chemistry simulation: | |||
| Bug fixes for v11-02 simulations using the RRTMG radiative transfer model | Chris Holmes (U. Florida) | Bug Fix | Implemented 26 Jun 2018
|
| Now always declare the netCDF time variable with an unlimited dimension | Chris Holmes (U. Florida) | Structural | Implemented 26 Jun 2018
|
| Bug fix for HEMCO soil NOx error with ifort 17 | Jenny Fisher (U. Wollongong) | Structural | Implemented 26 Jun 2018
|
| Update to HEMCO v2.1.006, which adds several minor updates | Christoph Keller (NASA/GMAO) | Structural | Implemented 27 Jun 2018
|
| Make two-way nesting option compatible with GEOS-Chem v11-02 code | Yingying Yan (PKU) Jintai Lin (PKU) |
Bug Fix | Awaiting code from developer |
| Bug fix for ARCTAS_SHIP in HEMCO_Config.rc file | Barron Henderson (EPA) | Bug Fix | A minor edit to HEMCO_Config.rc is necessary. This will likely change the benchmark results, so validation will be necessary. |
--Bob Yantosca (talk) 20:21, 29 June 2018 (UTC)
New data directories
The following HEMCO data directories have been added or updated for GEOS-Chem 12. You will have to download the directories relevant to your simulation.
| Inventory | What was added? | When added? | Directory |
|---|---|---|---|
| GFED4 biomass inventory | GFED4.1 data files for 2015 and 2016 have been added | 12.0.0 | HEMCO/GFED4/v2015-10/2015 HEMCO/GFED4/v2015-10/2016 |
--Bob Yantosca (talk) 20:02, 29 June 2018 (UTC)
Validation
In this section we provide information about the benchmarks and tests that we have done to validate GEOS-Chem v11-03.
1-month and 1-year benchmarks
For complete information about the benchmark simulations used to validate GEOS-Chem v11-03, please see our GEOS-Chem 12 benchmark history wiki page.
Unit tests for GEOS-Chem 12
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-03. Click on the links below to see the results from each set of unit tests:
| Unit test | Date |
|---|---|
| TBD |
Previous issues now resolved in GEOS-Chem 12
The following bugs and/or technical issues have been resolved in v11-03.
Outstanding issues not yet resolved in GEOS-Chem 12
The following known issues are slated to be fixed in GEOS-Chem 12:
Bug fix for HEMCO soil NOx error with ifort 17
This fix will be included in GEOS-Chem 12.0.0.
For complete information about this issue and how it was resolved, please see this post on our Implementation of HEMCO in GEOS-Chem wiki page..
--Bob Yantosca (talk) 13:54, 27 June 2018 (UTC)
FlexChem bug fix: do not zero ACTA, EOH, HCOOH
This fix will be included in GEOS-Chem 12.0.0.
For complete information about this bug and how it was fixed, please see this post on our FlexChem wiki page.
--Bob Yantosca (talk) 14:42, 27 June 2018 (UTC)
Avoid double counting CEDS and GEIA NH3 biofuel emissions
This fix will be included GEOS-Chem 12.0.0.
Eloise Marais wrote:
If CEDS includes NH3 emissions, then this will be double counting. I recommend using CEDS, as GEIA is very out of date (1998 according to the HEMCO configuration file I have).
Daniel Jacob replied:
We should use the GEIA NH3 natural emission inventory (1° x 1° file from Eleanor Morris) but not the GEIA NH3 biofuel inventory.
UPDATE 29 Jun 2018:
We discovered that HEMCO's default behavior is to ignore the GEIA NH3 anthro and biofuel emissions if CEDS is turned on. This is shown in the HEMCO.log file when VERBOSE = 3:
Register_Base: Checking GEIA_NH3_ANTH HEMCO: Entering Get_targetID (hco_config_mod.F90) ( 4) Skip container GEIA_NH3_ANTH because of CEDS_NH3_WST . . . Register_Base: Checking GEIA_NH3_BIOF HEMCO: Entering Get_targetID (hco_config_mod.F90) ( 4) Skip container GEIA_NH3_BIOF because of CEDS_NH3_WST_Cat00002
But for the sake of clarity, we will modify the HEMCO_Config.rc files to explicitly request this behavior:
(((.not.CEDS.or.EDGARv43 # GEIA NH3 anthro (skip if CEDS or EDGARv43 is on) 0 GEIA_NH3_ANTH $ROOT/NH3/v2014-07/NH3_geos.4x5.nc NH3_ANTH 1990/1-12/1/0 C xy kg/m2/s NH3 - 1 1 # GEIA NH3 biofuel (skip if CEDS or EDGARv43 is on) (((BIOFUEL 0 GEIA_NH3_BIOF $ROOT/NH3/v2014-07/NH3_biofuel.geos.1x1.nc NH3_BIOFUEL 1998/1-12/1/0 C xy kg/m2/s NH3 - 2 1 )))BIOFUEL ))).not.CEDS.or.EDGARv43
--Bob Yantosca (talk) 21:02, 29 June 2018 (UTC)