GEOS-Chem 14.4.0: Difference between revisions

Revision as of 15:33, 7 May 2024

This page includes information about GEOS-Chem 14.4.0. For a list of updates prioritized for future versions, please see our GEOS-Chem model development priorities page.

Version overview

This version is currently in development

Repository	GitHub Milestone	DOI
GCClassic 14.4.0	14.4.0 milestone for geoschem/GCClassic	TBD
GCHP 14.4.0	14.4.0 milestone for geoschem/GCHP	TBD
GEOS-Chem (science codebase) 14.4.0	14.4.0 milestone for geoschem/geos-chem	TBD
HEMCO 3.9.0	3.9.0 milestone for geoschem/HEMCO	TBD

What's new in this version

Updates that will affect full-chemistry benchmark simulations

Feature	Contributor(s)	Model scope	Notes and references
UCX bug fixes : (1) Use proper 4th index for WERADIUS array; (2) Get density of black carbon from the species database	Bob Yantosca (Harvard)	Aerosols	geos-chem PR #2176 geos-chem #2169
Replace ISORROPIA II with HETP aerosol thermodynamics	Lizzie Lundgren (Harvard) Seb Eastham (ICL)	Aerosols	geos-chem PR #2244
Parameterized Effective Radius for SNA and OM aerosols	Haihui Zhu (WashU)	Aerosols	geos-chem PR #2238 geos-chem #1747
Use GCARR_ac rate-law function for full-chemistry reactions where the Arrhenius B parameter is zero	Bob Yantosca (Harvard)	Chemistry	geos-chem PR #1717
Fix uptake coefficients on stratospheric aerosol	Chris Holmes (FSU)	Chemistry	geos-chem PR #2205
Updated gravitational settling, dry mass-weighted mean diameters and hygroscopic growth in aerosol dry deposition	Yanshun Li (WashU)	Dry Deposition	Li et al., ACP, 2023. geos-chem PR #1983
Global continental chlorine (pCl and HCl) emissions	Bingqing Zhang (Georgia Tech) Pengfei Liu (Georgia Tech)	Emissions	Zhang et al., ES&T, 2022. geos-chem PR #2275
Add diel and day-of-week scale factors to global base emissions	Dandan Zhang (WashU)	Emissions	geos-chem PR #1828
Updated 0.1x0.1 timezone file accounting for daylight savings	Karn Vohra (UCL)	Emissions	geos-chem PR #2145
Update volcano emissions through 2023	Melissa Sulprizio (Harvard)	Emissions	geos-chem PR #2246
Update surface methane boundary condition using NOAA flask data	Lee Murray (Rochester)	Input data	geos-chem PR #1979
Fix bug in usage of FRSNO met-field	Lizzie Lundgren (Harvard)	Met fields	geos-chem PR #2254
Fix PBL level calculations	Chris Holmes (FSU)	PBL height	geos-chem PR 2078 geos-chem PR 2211
Only convert units for species that require it	Bob Yantosca	Unit Conversion	geos-chem PR 2072 geos-chem #1820 geos-chem #1701

Updates that will NOT affect full-chemistry benchmark simulations

Feature	Contributor(s)	Model scope	Notes and references
Remove hardcoded year range for met fields, restart, and BC files in HEMCO_Config.rc	Melissa Sulprizio (Harvard)	Bug fix	geos-chem PR #2263
GCHP carbon simulation (and fixes for single-species carbon simulations)	Melissa Sulprizio (Harvard) Bob Yantosca (Harvard)	Carbon simulation	geos-chem PR #2272 geos-chem PR #1992 geos-chem PR #2236 GCHP Issue #339
Removing unused carbon simulation options #2266	Hannah Nesser (JPL)	Carbon simulation	geos-chem PR #2266
Add missing gas postmeter CH4 emissions for the GHGI express extension inventory	Melissa Sulprizio (Harvard) Bob Yantosca (Harvard)	Carbon simulation CH4 simulation	geos-chem PR #2261
Bug fix for stretched grid restart attribute check	Lizzie Lundgren (Harvard)	GCHP	MAPL PR #34
Updates for GEOS-Chem in GEOS	Christoph Keller (GMAO) Lizzie Lundgren (Harvard)	GEOS	geos-chem PR #2271 geos-chem PR #2249
Replace stalebot with "stale" GitHub action	Bob Yantosca (Harvard)	GitHub	GCClassic PR #56 GCHP PR #410 geos-chem PR #2260 HEMCO PR #274 HEMCO PR #315
Allow up to 10 nested brackets in the HEMCO_Config.rc file	Bob Yantosca (Harvard)	HEMCO	HEMCO PR #262
Rename tags in geoschem_config.yml for nitrate aerosol photolysis as per GCSC suggestion	Bob Yantosca (Harvard)	Run directory	geos-chem PR #1998
Remove remaining binary punch diagnostic code	Bob Yantosca (Harvard)	Structural	geos-chem PR #2166

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
Updated lookup tables for aerosol optical properties	Aerosol-only Fullchem Hg	Updated `org.dat` and `so4.dat` lookup tables	`ExtData/CHEM_INPUTS/FAST_JX/v2024-05` `ExtData/CHEM_INPUTS/FAST_JX/v2024-05-Hg`
Updated mask files	CH4 carbon	Canada, Mexico, and CONUS masks at 0.1° x 0.1° resolution. These replace the 0.01° x 0.01° resolution masks, which were causing an I/O bottleneck in GCHP.	`ExtData/HEMCO/MASKS/v2024-04`
NOAA GMD CH4 surface boundary conditions	Fullchem	Updated NOAA GMD surface CH4 boundary conditions through 2022	`ExtData/HEMCO/NOAA_GMD/v2023-10`
Georgia Tech chlorine emissions	Fullchem	Global continental chlorine (pCl and HCl) emissions	`ExtData/HEMCO/GT_Chlorine/v2024-05`

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):	GEOS-Chem Classic: 14.4.0-rc.0 (aka 14.4.0-alpha.17) GCHP: 14.4.0-rc.0 (aka 14.4.0-alpha.17) HEMCO: 3.8.0
Compared to previous benchmark:	14.3.1
Software environment:	gcc 10.2.0 OpenMPI 4.1.0 netcdf-fortran 4.5.3 CMake 3.17.3 ESMF 8.0.1
Model resolution:	GEOS-Chem Classic: 4° x 5° GCHP: c24
Meteorology fields:	MERRA-2 GEOS-Chem Classic: 4° x 5° GCHP: 0.5° x 0.625°
Initial conditions:	July 1, 2019 NOTE: GCHP c24 restart file regridded from GEOS-Chem Classic 4° x 5°
Benchmark month:	July 2019
Chemistry setup:	See fullchem.eqn
This version will impact: (select all that apply with boldface)	Emissions Photolysis Chemistry Dry Deposition Wet Deposition Advection BL Mixing Convection Meteorology Fields Other (please specify): Aerosol thermodynamics

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 GCST 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 nodes (AWS)
Wall time:	06:12	07:06
Memory	11.5 GB	42.1 GB
Global mean OH: (% change from previous version)	13.57862664898 x 10⁵ molec/cm3 (-%)	13.57068350813 x 10⁵ molec/cm3 (%)
Methyl chloroform lifetime: (% change from previous version)	4.524290 years (%)	4.502573 years (%)
Methane lifetime: (% change from previous version)	7.627114 years (%)	7.586405 years (%)
Details
Species, J-Values, and COLUMN AOD values that changed by 10% or more at the surface:	GEOS-Chem Classic 14.4.0 vs 14.3.1	GCHP 14.4.0 vs 14.3.1
Species and J-Values that changed by 10% or more at 500 hPa:	GEOS-Chem Classic 14.4.0 vs 14.3.1	GCHP 14.4.0 vs 14.3.1
Species and J-Values that changed by 10% or more in zonal mean:	GEOS-Chem Classic 14.4.0 vs 14.3.1	GCHP 14.4.0 vs 14.3.1
Emissions that changed by 10% or more:	GEOS-Chem Classic 14.4.0 vs 14.3.1	GCHP 14.4.0 vs 14.3.1
Overview
Below we summarize the notable changes caused by specific updates. See also the internal benchmark results which isolate impacts from specific updates. 1. 2.

1-month GEOS-Chem Classic version comparison (14.4.0 vs 14.3.1)

Below are links to plots and tables comparing 1-month simulations for GEOS-Chem Classic 14.4.0 (Dev) and GEOS-Chem Classic 14.3.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 Tables by inventory
Global mass	Entire atmosphere Troposphere only
Metrics	OH concentration, MCF lifetime, CH4 lifetime

1-month GCHP version comparision (14.4.0 vs 14.3.1)

Below are links to plots and tables comparing 1-month simulations for GCHP 14.4.0 (Dev) and GCHP 14.3.1 (Ref).

Species Category²	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 Tables by inventory
Global mass	Entire atmosphere Troposphere only

1-month GCHP vs GEOS-Chem Classic comparision

Below are links to plots and tables comparing 1-month simulations for GCHP 14.4.0 (Dev) and GEOS-Chem Classic 14.4.0 (Ref).

Species Category²	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 Tables by inventory
Global mass	Entire atmosphere Troposphere only

1-month GCHP vs GEOS-Chem-Classic diff-of-diffs

Below are links to plots and tables comparing 1-month simulations for GCHP 14.4.0 - 14.3.1 (Dev) and GEOS-Chem Classic GCHP 14.4.0 - 14.3.1 (Ref).

Species Category²	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

@@ Line 340: / Line 340: @@
 |
 *'''Emissions'''
-*''Photolysis'''
+*'''Photolysis'''
 *'''Chemistry'''
 *'''Dry Deposition'''

GEOS-Chem 14.4.0: Difference between revisions

Revision as of 15:33, 7 May 2024

Contents

Version overview

What's new in this version

Updates that will affect full-chemistry benchmark simulations

Updates that will NOT affect full-chemistry benchmark simulations

New data directories

1-month full-chemistry benchmarks

1-month benchmark setup

1-month internal benchmarks

1-month benchmark assessment form

1-month GEOS-Chem Classic version comparison (14.4.0 vs 14.3.1)

1-month GCHP version comparision (14.4.0 vs 14.3.1)

1-month GCHP vs GEOS-Chem Classic comparision

1-month GCHP vs GEOS-Chem-Classic diff-of-diffs

Navigation menu

GEOS-Chem 14.4.0: Difference between revisions

Revision as of 15:33, 7 May 2024

Version overview

What's new in this version

Updates that will affect full-chemistry benchmark simulations

Updates that will NOT affect full-chemistry benchmark simulations

New data directories

1-month full-chemistry benchmarks

1-month benchmark setup

1-month internal benchmarks

1-month benchmark assessment form

1-month GEOS-Chem Classic version comparison (14.4.0 vs 14.3.1)

1-month GCHP version comparision (14.4.0 vs 14.3.1)

1-month GCHP vs GEOS-Chem Classic comparision

1-month GCHP vs GEOS-Chem-Classic diff-of-diffs

Navigation menu

Search