GEOS-Chem 14.0.2
This page includes information about GEOS-Chem 14.0.2. This version contains fixes for several issues that were discovered after the release of patch version GEOS-Chem 14.0.1.
Version overview
- Release date: 29 Nov 2022
- DOI for GC Classic 14.0.2: 10.5281/zenodo.7383492
- DOI for GCHP 14.0.2: 10.5281/zenodo.7383532
- DOI for GEOS-Chem 14.0.2: 10.5281/zenodo.7383132 (science code)
- DOI for HEMCO 3.5.2: 10.5281/zenodo.7383390
The following fixes for bugs and technical issues have been added to GEOS-Chem 14.0.2. Also see the following Github pages:
Feature | Contributor(s) | Model scope | Notes and references |
---|---|---|---|
Update sample full-chemistry restart files to 10-year 14.0.0 benchmark output | Melissa Sulprizio (Harvard) | Input data | |
Bug fixes for CH4 simulatons, including: | Melissa Sulprizio (Harvard) GitHub user @ruosiliang Bob Yantosca (Harvard) |
CH4 simulation | |
Fix indentation issue in geoschem_config.yml template files | Lucas Estrada (Harvard) | Diagnostics | |
Fix units of RxnRate diagnostics in Get_Metadata_State_Diag routine | Bob Yantosca (Harvard) | Diagnostics | |
Bug fix: Use proper KPP diagnostic flags in fullchem_mod.F90 | Christoph Keller (GMAO) | Diagnostics | |
Removed "dry air" text from metadata for State_Met%AIRVOL and State_Met%BXHEIGHT | Chris Holmes (FSU) | Diagnostics | |
Bug fix: Only write dry-run header to the HEMCO.log file if HEMCO output is not already being sent to the stdout stream | GitHub user @jiaying002 Bob Yantosca (Harvard) |
Dry-run | |
Close GEOS-Chem Classic restart files immediately after writing data to them | Chris Holmes (FSU) Bob Yantosca (Harvard) |
GEOS-Chem Classic | |
Improve error messages encountered when reading the HEMCO configuration file | Bob Yantosca (Harvard) | HEMCO | |
Remove memory leaks from GEOS-Chem and HEMCO code | Bob Yantosca (Harvard) | Structural | |
Updates and bug fixes for CESM, including enabling GEOS-Chem diagnostics | Haipeng Lin (Harvard) Lizzie Lundgren (Harvard) |
CESM |
New data directories
The following data directories have been added or updated in this version. You will have to download the directories relevant to your simulation.
Inventory | Simulations | What was added? | Directory |
---|---|---|---|
EDGAR v6.0, CH4 Lakes | CH4 | ExtData/HEMCO/CH4/v2022-11 | |
Restart files (version 14.0.0) |
Full-chemistry Transport Tracers |
|
ExtData/GEOSCHEM_RESTARTS/GC_14.0.0
|
GCClassic_Output (version 14.0.0) |
Specialty simulations |
|
ExtData/HEMCO/GCClassic_Output/14.0.0 |
1-month full-chemistry benchmarks
Benchmark simulations typically aren't performed for bug fix releases, but in this case the initial conditions of full-chemistry simulations were impacted because the sample restart file has been updated. Here we document the changes from that update.
1-month benchmark setup
The following table describes the GEOS-Chem setup for both GEOS-Chem Classic and GCHP 1-month benchmark simulations.
Git tag(s): |
|
Compared to previous version: | 14.0.1 (zero-diff from 14.0.0) |
Software environment: |
|
Model resolution: |
|
Meteorology fields: | MERRA-2
|
Initial conditions: | July 1, 2019
|
Benchmark month: | July 2019 |
Chemistry setup: | See fullchem.eqn |
This version will impact: (select all that apply with boldface) |
|
1-month benchmark assessment form
Performance | GEOS-Chem Classic | GCHP | |
---|---|---|---|
Grid resolution: | 4° x 5° | C24 | |
# CPUs, nodes: | 62 CPUs 1 node (AWS) |
62 CPUs 1 nodes (AWS) | |
Wall time: | 06:35:44 | 06:36:00 | |
Memory | 11.8 GB | 42.3 GB | |
Global mean OH: (% change from previous version) |
12.39176941719 x 105 molec/cm3 (-0.29%) |
12.37860938408 x 105 molec/cm3 (-0.29%) | |
Methyl chloroform lifetime: (% change from previous version) |
4.996396 years (0.086%) |
4.981733 years (0.080%) | |
Methane lifetime: (% change from previous version) |
8.421230 years (0.084%) |
8.392957 years (0.078%) | |
Details | |||
Species, J-Values, and COLUMN AOD values that changed by 10% or more at the surface: | GEOS-Chem Classic 14.0.0 vs 13.4.0 | GCHP 14.0.0 vs 13.4.0 | |
Species and J-Values that changed by 10% or more at 500 hPa: | GEOS-Chem Classic 14.0.0 vs 13.4.0 | GCHP 14.0.0 vs 13.4.0 | |
Species and J-Values that changed by 10% or more in zonal mean: | GEOS-Chem Classic 14.0.0 vs 13.4.0 | GCHP 14.0.0 vs 13.4.0 | |
Emissions that changed by 10% or more: | GEOS-Chem Classic 14.0.0 vs 13.4.0 | GCHP 14.0.0 vs 13.4.0 | |
Overview | |||
Below we summarize the notable changes caused by specific updates. See also the internal benchmark results which isolate impacts from specific updates.
This fix addressed the high O3 bias over the poles and decreased O3 by up to 10 ppb at high latitudes as shown in this plot. Global mean OH concentrations changed by -0.49% with this fix. This bug was identified when examining large differences in GEOS-Chem Classic vs GCHP that were introduced in 13.4.0. The decreases in O3 seen in GEOS-Chem Classic in this version largely correct the increases in O3 in GEOS-Chem Classic observed in 13.4.0
|
1-month GEOS-Chem Classic version comparison (14.0.1 vs 14.0.0)
Below are links to plots and tables comparing 1-month simulations for GEOS-Chem Classic 14.0.2 (Dev) and GEOS-Chem Classic 14.0.1 (Ref).
Species Category | Plots | Additional Information | ||||
---|---|---|---|---|---|---|
Level Map | Zonal Mean | Emissions | ||||
Oxidants
O3, CO, OH, NOx |
sfc | 500hPa | full column | stratosphere | sfc | |
Aerosols
DST1, DST2, DST3, DST4, NH4, NIT, SO4, HMS, BCPI, BCPO, OCPI, OCPO, AERI, BrSALA, BrSALC, ISALA, ISALC, NITs, SALA, SALC, SO4s, Simple_SOA, Complex_SOA, pFe |
sfc | 500hPa | full column | stratosphere | column total | AOD |
Bromine
Bry, BrOx, Br, Br2, BrCl, BrNO2, BrNO3, BrO, CH3Br, CH2Br2, CHBr3, HOBr, HBr |
sfc | 500hPa | full column | stratosphere | column total | |
Chlorine
Cly, ClOx, Cl, ClO, Cl2, Cl2O2, ClOO, ClNO2, ClNO3, CCl4, CFCs, CH3Cl, CH2Cl2, CH3CCl3, CHCl3, HOCl, HCl, Halons, HCFCs, OClO |
sfc | 500hPa | full column | stratosphere | -- | |
Iodine
Iy, IxOy, I, I2, IBr, ICl, IO, IONO, IONO2, CH3I, CH2I2, CH2ICl, CH2IBr, HI, HOI, OIO |
sfc | 500hPa | full column | stratosphere | column total | |
Nitrogen
NOy, NOx, HNO2, HNO3, HNO4, MPAN, NIT, NO, NO2, NO3, N2O5, MPN, PAN, PPN, N2O, NHx, NH3, NH4, MENO3, ETNO3, IPRNO3, NPRNO3, AONITA, ETHN, BZPAN, NPHEN |
sfc | 500hPa | full column | stratosphere | column total | |
Primary Organics
EOH, MOH, ISOP, MTPA, MTPO, LIMO, ALK4, BENZ, CH4, C2H2, C2H4, C2H6, C3H8, PRPE, TOLU, XYLE |
sfc | 500hPa | full column | stratosphere | column total | |
Secondary Organics
ACTA, ALD2, BALD, CH2O, HPALDs, MACR, IEPOX, ACET, HAC, MEK, MVK, ISOPN, GLYC, GLYX, HCOOH, MAP, PHEN, RCHO, ETHP, MP |
sfc | 500hPa | full column | stratosphere | column total | |
Secondary Organic Aerosols
TSOA0, TSOA1, TSOA2, TSOA3, ASOA1, ASOA2, ASOA3, ASOAN, TSOG0, TSOG1, TSOG2, TSOG3, ASOG1, ASOG2, ASOG3, INDIOL, LVOCOA, SOAIE, SOAGX, SOAP, SOAS |
sfc | 500hPa | full column | stratosphere | column total | |
Sulfur
SOx, DMS, HMS, OCS, SO2, SO4 |
sfc | 500hPa | full column | stratosphere | column total | |
ROy
H2O2, H, H2, H2O, HO2, O1D, OH, RO2 |
sfc | 500hPa | full column | stratosphere | -- | |
J-values | sfc | 500hPa | full column | stratosphere | -- | -- |
Emissions by HEMCO category | Total
Aircraft, Anthropogenic, Biomass Burning, Biogenic, Lightning, Natural, Ocean, Seabirds, Decaying Plants, Ship, Soil, Degassing Volcanoes, Erupting Volcanoes | |||||
Emission totals | Tables by species | |||||
Global mass | Entire atmosphere | |||||
Metrics | OH concentration, MCF lifetime, CH4 lifetime |
1-month GCHP version comparison (14.0.2 vs 14.0.1)
Below are links to plots and tables comparing 1-month simulations for GCHP 14.0.2 (Dev) and GCHP 14.0.1 (Ref).
Species Category2 | Plots | Additional Information | ||||
---|---|---|---|---|---|---|
Level Map | Zonal Mean | Emissions | ||||
Oxidants
O3, CO, OH, NOx |
sfc | 500hPa | full column | stratosphere | column total | |
Aerosols
DST1, DST2, DST3, DST4, NH4, NIT, SO4, BCPI, BCPO, OCPI, OCPO, AERI, BrSALA, BrSALC, ISALA, ISALC, NITs, SALA, SALC, SO4s, Simple_SOA, Complex_SOA, pFe |
sfc | 500hPa | full column | stratosphere | column total | AOD |
Bromine
Bry, BrOx, Br, Br2, BrCl, BrNO2, BrNO3, BrO, CH3Br, CH2Br2, CHBr3, HOBr, HBr |
sfc | 500hPa | full column | stratosphere | column total | |
Chlorine
Cly, ClOx, Cl, ClO, Cl2, Cl2O2, ClOO, ClNO2, ClNO3, CCl4, CFCs, CH3Cl, CH2Cl2, CH3CCl3, CHCl3, HOCl, HCl, Halons, HCFCs, OClO |
sfc | 500hPa | full column | stratosphere | -- | |
Iodine
Iy, IxOy, I, I2, IBr, ICl, IO, IONO, IONO2, CH3I, CH2I2, CH2ICl, CH2IBr, HI, HOI, OIO |
sfc | 500hPa | full column | stratosphere | column total | |
Nitrogen
NOy, NOx, HNO2, HNO3, HNO4, MPAN, NIT, NO, NO2, NO3, N2O5, MPN, PAN, PPN, N2O, NHx, NH3, NH4, MENO3, ETNO3, IPRNO3, NPRNO3 |
sfc | 500hPa | full column | stratosphere | column total | |
Primary Organics
EOH, MOH, ISOP, MTPA, MTPO, LIMO, ALK4, BENZ, CH4, C2H6, C3H8, PRPE, TOLU, XYLE |
sfc | 500hPa | full column | stratosphere | column total | |
Secondary Organics
ACTA, ALD2, CH2O, HPALDs, MACR, IEPOX, ACET, HAC, MEK, MVK, ISOPN, GLYC, GLYX, HCOOH, MAP, RCHO, MP |
sfc | 500hPa | full column | stratosphere | column total | |
Secondary Organic Aerosols
TSOA0, TSOA1, TSOA2, TSOA3, ASOA1, ASOA2, ASOA3, ASOAN, TSOG0, TSOG1, TSOG2, TSOG3, ASOG1, ASOG2, ASOG3, INDIOL, LVOCOA, SOAIE, SOAGX, SOAP, SOAS |
sfc | 500hPa | full column | stratosphere | column total | |
Sulfur
SOx, DMS, HMS, OCS, SO2, SO4 |
sfc | 500hPa | full column | stratosphere | column total | |
ROy
H2O2, H, H2, H2O, HO2, O1D, OH, RO2 |
sfc | 500hPa | full column | stratosphere | -- | |
J-values | sfc | 500hPa | full column | stratosphere | -- | -- |
Emissions by HEMCO category | Total
Aircraft, Anthropogenic, Biomass Burning, Biogenic, Lightning, Natural, Ocean, Seabirds, Decaying Plants, Ship, Soil, Degassing Volcanoes, Erupting Volcanoes | |||||
Emission totals | Tables by species | |||||
Global mass | Entire atmosphere |
1-month GCHP vs GEOS-Chem Classic comparison
Below are links to plots and tables comparing 1-month simulations for GCHP 14.0.2 (Dev) and GEOS-Chem Classic 14.0.2 (Ref).
Species Category2 | Plots | Additional Information | ||||
---|---|---|---|---|---|---|
Level Map | Zonal Mean | Emissions | ||||
Oxidants
O3, CO, OH, NOx |
sfc | 500hPa | full column | stratosphere | column total | |
Aerosols
DST1, DST2, DST3, DST4, NH4, NIT, SO4, BCPI, BCPO, OCPI, OCPO, AERI, BrSALA, BrSALC, ISALA, ISALC, NITs, SALA, SALC, SO4s, Simple_SOA, Complex_SOA, pFe |
sfc | 500hPa | full column | stratosphere | column total | AOD |
Bromine
Bry, BrOx, Br, Br2, BrCl, BrNO2, BrNO3, BrO, CH3Br, CH2Br2, CHBr3, HOBr, HBr |
sfc | 500hPa | full column | stratosphere | column total | |
Chlorine
Cly, ClOx, Cl, ClO, Cl2, Cl2O2, ClOO, ClNO2, ClNO3, CCl4, CFCs, CH3Cl, CH2Cl2, CH3CCl3, CHCl3, HOCl, HCl, Halons, HCFCs, OClO |
sfc | 500hPa | full column | stratosphere | -- | |
Iodine
Iy, IxOy, I, I2, IBr, ICl, IO, IONO, IONO2, CH3I, CH2I2, CH2ICl, CH2IBr, HI, HOI, OIO |
sfc | 500hPa | full column | stratosphere | column total | |
Nitrogen
NOy, NOx, HNO2, HNO3, HNO4, MPAN, NIT, NO, NO2, NO3, N2O5, MPN, PAN, PPN, N2O, NHx, NH3, NH4, MENO3, ETNO3, IPRNO3, NPRNO3 |
sfc | 500hPa | full column | stratosphere | column total | |
Primary Organics
EOH, MOH, ISOP, MTPA, MTPO, LIMO, ALK4, BENZ, CH4, C2H6, C3H8, PRPE, TOLU, XYLE |
sfc | 500hPa | full column | stratosphere | column total | |
Secondary Organics
ACTA, ALD2, CH2O, HPALDs, MACR, IEPOX, ACET, HAC, MEK, MVK, ISOPN, GLYC, GLYX, HCOOH, MAP, RCHO, MP |
sfc | 500hPa | full column | stratosphere | column total | |
Secondary Organic Aerosols
TSOA0, TSOA1, TSOA2, TSOA3, ASOA1, ASOA2, ASOA3, ASOAN, TSOG0, TSOG1, TSOG2, TSOG3, ASOG1, ASOG2, ASOG3, INDIOL, LVOCOA, SOAIE, SOAGX, SOAP, SOAS |
sfc | 500hPa | full column | stratosphere | column total | |
Sulfur
SOx, DMS, HMS, OCS, SO2, SO4 |
sfc | 500hPa | full column | stratosphere | column total | |
ROy
H2O2, H, H2, H2O, HO2, O1D, OH, RO2 |
sfc | 500hPa | full column | stratosphere | -- | |
J-values | sfc | 500hPa | full column | stratosphere | -- | -- |
Emissions by HEMCO category | Total
Aircraft, Anthropogenic, Biomass Burning, Biogenic, Lightning, Natural, Ocean, Seabirds, Decaying Plants, Ship, Soil, Degassing Volcanoes, Erupting Volcanoes | |||||
Emission totals | Tables by species | |||||
Global mass | Entire atmosphere |
1-month GCHP vs GEOS-Chem-Classic diff-of-diffs
Below are links to plots and tables comparing 1-month simulations for GCHP 14.0.2 - 14.0.1 (Dev) and GEOS-Chem Classic GCHP 14.0.2 - 14.0.1 (Ref).
Species Category2 | Plots | |||
---|---|---|---|---|
Level Map | Zonal Mean | |||
Oxidants
O3, CO, OH, NOx |
sfc | 500hPa | full column | stratosphere |
Aerosols
DST1, DST2, DST3, DST4, NH4, NIT, SO4, BCPI, BCPO, OCPI, OCPO, AERI, BrSALA, BrSALC, ISALA, ISALC, NITs, SALA, SALC, SO4s, Simple_SOA, Complex_SOA, pFe |
sfc | 500hPa | full column | stratosphere |
Bromine
Bry, BrOx, Br, Br2, BrCl, BrNO2, BrNO3, BrO, CH3Br, CH2Br2, CHBr3, HOBr, HBr |
sfc | 500hPa | full column | stratosphere
|
Chlorine
Cly, ClOx, Cl, ClO, Cl2, Cl2O2, ClOO, ClNO2, ClNO3, CCl4, CFCs, CH3Cl, CH2Cl2, CH3CCl3, CHCl3, HOCl, HCl, Halons, HCFCs, OClO |
sfc | 500hPa | full column | stratosphere |
Iodine
Iy, IxOy, I, I2, IBr, ICl, IO, IONO, IONO2, CH3I, CH2I2, CH2ICl, CH2IBr, HI, HOI, OIO |
sfc | 500hPa | full column | stratosphere
|
Nitrogen
NOy, NOx, HNO2, HNO3, HNO4, MPAN, NIT, NO, NO2, NO3, N2O5, MPN, PAN, PPN, N2O, NHx, NH3, NH4, MENO3, ETNO3, IPRNO3, NPRNO3 |
sfc | 500hPa | full column | stratosphere |
Primary Organics
EOH, MOH, ISOP, MTPA, MTPO, LIMO, ALK4, BENZ, CH4, C2H6, C3H8, PRPE, TOLU, XYLE |
sfc | 500hPa | full column | stratosphere |
Secondary Organics
ACTA, ALD2, CH2O, HPALDs, MACR, IEPOX, ACET, HAC, MEK, MVK, ISOPN, GLYC, GLYX, HCOOH, MAP, RCHO, MP |
sfc | 500hPa | full column | stratosphere |
Secondary Organic Aerosols
TSOA0, TSOA1, TSOA2, TSOA3, ASOA1, ASOA2, ASOA3, ASOAN, TSOG0, TSOG1, TSOG2, TSOG3, ASOG1, ASOG2, ASOG3, INDIOL, LVOCOA, SOAIE, SOAGX, SOAP, SOAS |
sfc | 500hPa | full column | stratosphere |
Sulfur
SOx, DMS, OCS, SO2, SO4 |
sfc | 500hPa | full column | stratosphere |
ROy
H2O2, H, H2, H2O, HO2, O1D, OH, RO2 |
sfc | 500hPa | full column | stratosphere |