GEOS-Chem 14.6.0
Version overview
- This is the current stable release of GEOS-Chem
- Release date: 18 Apr 2025
This page includes information about GEOS-Chem 14.6.0. For a list of updates prioritized for future versions, please see our GEOS-Chem model development priorities page.
Model | GitHub Release Page | DOI |
---|---|---|
GEOS-Chem Classic 14.6.0 | https://github.com/geoschem/GCClassic/releases/tag/14.6.0 | 10.5281/zenodo.4437678 |
GCHP 14.6.0 | https://github.com/geoschem/GCHP/releases/tag/14.6.0 | 10.5281/zenodo.15243297 |
Submodule updates this version
The following submodules were updated to new versions in this release.
Submodule version | GitHub release page | DOI |
---|---|---|
GEOS-Chem 14.6.0 | https://github.com/geoschem/geos-chem/releases/tag/14.6.0 | 10.5281/zenodo.15242410 |
HEMCO 3.11.0 | https://github.com/geoschem/HEMCO/releases/tag/3.11.0 | 10.5281/zenodo.15242231 |
Cloud-J 8.0.2 | https://github.com/geoschem/Cloud-J/releases/tag/8.0.2 | 10.5281/zenodo.15085795 |
What's new in this version
Updates that will affect full-chemistry benchmark simulations
Feature | Contributor(s) | Model scope | Notes and references |
---|---|---|---|
Aerosol table updates for mineral dust | Inderjeet Singh (WashU) | Convection | |
Fixed PDOWN definition and re-evaporation requirement for washout | Yuanjian Zhang (WashU) | Convection | |
Now define the dry deposition land cover type properly for O3 deposition to oceans | Eloise Marais (UCL) Bob Yantosca (Harvard) |
Dry deposition | |
Output sea flux species dry deposition velocity with DryDep collection | Eloise Marais (UCL) Bob Yantosca (Harvard) |
Dry deposition |
|
Fix CEDS TMB emissions | Kelvin Bates (CU Boulder) | Emissions | |
HEMCO online dust extensions (DustDead, Tomas_DustDead) now use USTAR directly from met field input instead of computing it from winds | Yuanjian Zhang (WashU) Bob Yantosca (Harvard) |
Emissions | |
New version of CEDS at 0.1 x 0.1 degree resolution | Dandan Zhang (WashU) | Emissions | |
Bug fix: Emit C6H14 (hexanes) into ALK6 in CEDS 0.1 degree, CMIP, HTAP inventories | Bob Yantosca (Harvard) | Emissions |
|
Make GC-Classic bit-for-bit reproducible upon restart (part 1 of 2) |
Lizzie Lundgren (Harvard) | GC-Classic |
Updates that will NOT affect full-chemistry benchmark simulations
Feature | Contributor(s) | Model scope | Notes and references |
---|---|---|---|
Need to increase memory for GCHP cloud benchmarks in GitHub action YAML file | Bob Yantosca (Harvard) | Benchmarking |
|
Set a C-preprocessor switch so that we can block out code specific to the KPP rosenbrock_autoreduce integrator | Bob Yantosca (Harvard) | Build | |
Need to increase memory for GCHP cloud benchmarks in GitHub action YAML file | Bob Yantosca (Harvard) | Benchmarking |
|
Add fix to recompute CH4 reservoir emissions monthly to properly apply seasonality | Melissa Sulprizio (Harvard) | Carbon gases | |
Updated bottom-up global CH4 oil, gas, and coal emissions (GFEI v3) | Tia Scarpelli (Carbon Mapper) Melissa Sulprizio (Harvard) |
Carbon gases Emissions |
|
Add fixes to eliminate differences between the carbon simulation and individual CO2, CH4, and CO simulations | Melissa Sulprizio (Harvard) | Carbon gases | |
Now allow RxnRate and RxnConst to use four-digit reaction numbers | Alfred Mayhew (Utah) | Diagnostics | |
Fix bugs in fixed level and PBL budget diagnostics | Lizzie Lundgren (Harvard) | Diagnostics | |
Fix UVFlux diagnostics when using Cloud-J | Lizzie Lundgren (Harvard) | Diagnostics | |
Fixed incorrect description metadata for FluxHg0FromOceanToAir and FluxHg0FromAirToOcean diagnostics | Ben Geyman (Harvard) | Diagnostics | |
Add SatDiagnPMID diagnostic to save pressure at level midpoints for the SatDiagn collection | Jared Brewer (U. Minnesota) | Diagnostics | |
Fix dry-run simulation issues in 14.6.0 development version | Bob Yantosca (Harvard) | Dry-run | |
Add #ifdef MODEL_BCC C-preprocessor switches to enable interface with the Beijing Climate Centre model | Bob Yantosca (Harvard) | External models | |
Check if mass flux is top-down and flip accordingly to enable processed mass flux | Yuanjian Zhang (WashU) | GCHP | |
Add linter (error-checker) for GitHub Actions in GCClassic | Joe Wallwork (U. Cambridge) | GitHub | |
Fix improper handling of date timestamps and lat/lon bounds for mask files | Bob Yantosca (Harvard) | HEMCO | |
Update KPP/CMakeLists.txt to only compile KPP-Standalone if configured with -DKPPSA=y | Bob Yantosca (Harvard) | KPP-Standalone | |
Capability to run GCClassic nested-grid simulations at 0.125x0.15625 resolution | Melissa Sulprizio (Harvard) Xiaolin Wang (Harvard) |
Nested grid | |
Remove goto statements in drydep_mod.F90 | Bob Yantosca (Harvard) | Structural | |
Rebuild chemical mechansims with KPP 3.2.0 (and update KPP-Standalone accordingly) | Bob Yantosca (Harvard) | Structural | |
Fix issues causing fullchem_alldiags integration tests to differ | Bob Yantosca (Harvard) | Testing | |
Fix GC-Classic TOMAS slowness introduced in 14.4.0 | Lizzie Lundgren (Harvard) Bob Yantosca (Harvard) Betty Croft (WashU) |
TOMAS | |
Bug fix: Update paths to CEDS_CO_25 emissions in ExtData.rc.TransportTracers | Bob Yantosca (Harvard) | TransportTracers (GCHP only) |
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 |
---|---|---|---|
Aerosol optics | aerosol-only fullchem |
|
|
CEDS_01x01 | most simulations |
|
|
CLOUD-J inputs | fullchem Hg |
|
|
GFEIv3 | carbon CH4 |
|
|
Species changes
Species metric | 14.5.0 | 14.6.0 | Change | % Change |
---|---|---|---|---|
Total # species | 372 | 372 | 0 | 0 |
# advected | 265 | 265 | 0 | 0 |
# dry deposited | 198 | 198 | 0 | 0 |
# wet deposited | 181 | 181 | 0 | 0 |
# photolyzed | 160 | 160 | 0 | 0 |
1-month full-chemistry benchmarks
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 benchmark: | 14.5.3 |
Software environment: |
|
Model resolution: |
|
Meteorology fields: | MERRA-2
|
Initial conditions: | July 1, 2019
|
Benchmark month: | July 2019 |
Chemistry setup: |
|
This version will impact: (select all that apply with boldface) |
|
1-month internal benchmarks
Each update that will introduce a significant change in the full-chemistry simulation is tagged with an alpha version in Git. For each of these alpha versions, the [1] runs an internal 1-month benchmark simulation to isolate the impact from that update.
For more details on the update(s) included in each alpha version and a link to benchmark results, see this Google sheet.
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 node (AWS) | |
Wall time: | 06:27 | 08:09 | |
Memory | 12.8 GB | 42.0 GB | |
Global mean OH: (% change from previous version) |
13.20250697486 x 105 molec/cm3 (-0.489%) |
13.18941540588 x 105 molec/cm3 (-0.528%) | |
Methyl chloroform lifetime: (% change from previous version) |
4.732650 years (0.814%) |
4.713236 years (0.870%) | |
Methane lifetime: (% change from previous version) |
7.991936 years (0.852%) |
7.955118 years (0.906%) | |
Details | |||
Species, J-Values, and COLUMN AODs having at least one grid cell that differs by 10% or more at the surface: | GEOS-Chem Classic 14.5.3 vs 14.6.0 | GCHP 14.5.3 vs 14.6.0 | |
Species and J-Values for having at least one grid cell that differs by 10% or more at 500 hPa: | GEOS-Chem Classic 14.5.3 vs 14.6.0 | GCHP 14.5.3 vs 14.6.0 | |
Species and J-Values having at least one grid cell that differs by 10% or more in the zonal means: | GEOS-Chem Classic 14.4.3 vs 14.5.0 | GCHP 14.4.3 vs 14.5.0 | |
Emissions having at least one grid cell that changes by 10% or more: | GEOS-Chem Classic 14.5.3 vs 14.6.0 | GCHP 14.5.3 vs 14.6.0 | |
Overview | |||
Below we summarize the notable changes caused by specific updates. See also the internal benchmark results which isolate impacts from specific updates.
2a. Add CEDS 0.1 x 0.1 degree emissions #2171 and
3a. Use USTAR read from GEOS instead of calculating from U10M and V10M #279 and
4. Now define the dry deposition land cover type properly for O3 deposition to oceans
5. Fixed PDOWN definition and re-evaporation requirement for washout
6. Fixes towards achieving bit-for-bit reproducibility in GC-Classic upon restart
7. Output sea flux species dry deposition velocity with DryDep collection
8. Aerosol table updates for mineral dust
|
1-month GEOS-Chem Classic version comparison (14.5.3 vs 14.6.0)
Below are links to plots and tables comparing 1-month simulations for GEOS-Chem Classic 14.6.0 (Dev) and GEOS-Chem Classic 14.5.3 (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, ALK6, BENZ, CH4, C2H2, C2H4, C2H6, C3H8, C4H6, EBZ, PRPE, STYR, TMB, TOLU, XYLE |
sfc | 500hPa | full column | stratosphere | column total | |
Secondary Organics
ACTA, MACR, ALD2, BALD, CH2O, HPALDs, MACR, IEPOX, ACET, HAC, MEK, MVK, ISOPN, FURA, GLYC, GLYX, HCOOH, RCOOH, 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 | |||||
Timing | GCClassic 14.5.3 vs 14.6.0 |
1-month GCHP version comparison (14.5.3 vs 14.6.0)
Below are links to plots and tables comparing 1-month simulations for GCHP 14.6.0 (Dev) and GCHP 14.5.3 (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, ALK6, BENZ, CH4, C2H2, C2H4, C2H6, C3H8, C4H6, EBZ, PRPE, STYR, TMB, TOLU, XYLE |
sfc | 500hPa | full column | stratosphere | column total | |
Secondary Organics
ACTA, MACR, ALD2, BALD, CH2O, HPALDs, MACR, IEPOX, ACET, HAC, MEK, MVK, ISOPN, FURA, GLYC, GLYX, HCOOH, RCOOH, 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 | |||||
Timing | GCHP 14.5.3 vs 14.6.0 |
1-month GCHP vs GEOS-Chem Classic comparison
Below are links to plots and tables comparing 1-month simulations for GCHP 14.6.0 (Dev) and GEOS-Chem Classic 14.6.0 (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, ALK6, BENZ, CH4, C2H2, C2H4, C2H6, C3H8, C4H6, EBZ, PRPE, STYR, TMB, TOLU, XYLE |
sfc | 500hPa | full column | stratosphere | column total | |
Secondary Organics
ACTA, MACR, ALD2, BALD, CH2O, HPALDs, MACR, IEPOX, ACET, HAC, MEK, MVK, ISOPN, FURA, GLYC, GLYX, HCOOH, RCOOH, 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 vs GEOS-Chem-Classic diff-of-diffs
Below are links to plots and tables comparing 1-month simulations for GCHP 14.6.0 - 14.5.3 (Dev) and GEOS-Chem Classic GCHP 14.6.0 - 14.5.3 (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, ALK6, BENZ, CH4, C2H2, C2H4, C2H6, C3H8, C4H6, EBZ, PRPE, STYR, TMB, TOLU, XYLE |
sfc | 500hPa | full column | stratosphere |
Secondary Organics
ACTA, MACR, ALD2, BALD, CH2O, HPALDs, MACR, IEPOX, ACET, HAC, MEK, MVK, ISOPN, FURA, GLYC, GLYX, HCOOH, RCOOH, MAP, PHEN, RCHO, ETHP, 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 |