GEOS-Chem (science codebase) 14.7.0 release

This is the official release commit of GEOS-Chem 14.7.0

Updated version numbers in:
- CHANGELOG.md

Please see CHANGELOG.md for updates added to this version.

Signed-off-by: Bob Yantosca <[email protected]>

Author: yantosca

APM/apm_init_mod.F

@@ -132,7 +132,12 @@ MODULE APM_INIT_MOD
       INTEGER :: id_BCPO,id_BCPI,id_OCPO, id_OCPI
       INTEGER :: id_MSA
       INTEGER :: id_SALA, id_SALC
-      INTEGER :: id_DST1,id_DST2,id_DST3,id_DST4
+
+      ! NOTE: Renamed these to GC_DSTbin{1..7} to avoid clashing
+      ! with the id_DSTbin1 species flag
+      INTEGER :: id_GC_DSTbin1, id_GC_DSTbin2, id_GC_DSTbin3
+      INTEGER :: id_GC_DSTbin4, id_GC_DSTbin5, id_GC_DSTbin6
+      INTEGER :: id_GC_DSTbin7
 
       ! mono+sesq products
       INTEGER :: id_TSOA1, id_TSOG1
@@ -673,10 +678,13 @@ SUBROUTINE APM_NTRACERS( State_Chm )
       APMIDS%id_SALA = Ind_('SALA')
       APMIDS%id_SALC = Ind_('SALC')
 
-      APMIDS%id_DST1 = Ind_('DST1')
-      APMIDS%id_DST2 = Ind_('DST2')
-      APMIDS%id_DST3 = Ind_('DST3')
-      APMIDS%id_DST4 = Ind_('DST4')
+      APMIDS%id_GC_DSTbin1 = Ind_('DSTbin1')
+      APMIDS%id_GC_DSTbin2 = Ind_('DSTbin2')
+      APMIDS%id_GC_DSTbin3 = Ind_('DSTbin3')
+      APMIDS%id_GC_DSTbin4 = Ind_('DSTbin4')
+      APMIDS%id_GC_DSTbin5 = Ind_('DSTbin5')
+      APMIDS%id_GC_DSTbin6 = Ind_('DSTbin6')
+      APMIDS%id_GC_DSTbin7 = Ind_('DSTbin7')
 
       APMIDS%id_TSOA1 = Ind_('TSOA1')
       APMIDS%id_TSOG1 = Ind_('TSOG1')

CHANGELOG.md

@@ -4,6 +4,100 @@ This file documents all notable changes to the GEOS-Chem repository starting in
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [14.7.0] - 2026-02-05
+### Added
+- Added entries for FINNv25 biomass burning emissions to template HEMCO configuration files
+- Added comments to `HEMCO_Diagn.rc` template files instructing users on which ExtNr/Cat/Hier to use for online vs. offline biomass burning emissions
+- Added subroutine `Print_Species_Global_Mass` to print_mod for use by GC-Classic
+- Added log print of species global mass at start of each timestep if verbose is true
+- Added print of global mass computed from restart file values if delta pressure present in restart file
+- Added the capability for GCHP simulations to use CH4 restarts for Jacobian Tracers
+- Added operational run scripts for WashU Compute2
+- Added the option for LPJ_MERRA2 wetland CH4 emissions in CH4 and carbon simulations
+- Added GC-Classic config file option to read restart file as `REAL*8` via GEOS-Chem rather than HEMCO
+- Added new GCHP run-time option in GCHP.rc to print species mass proxy (Species 1 only) to log file from FV3
+- Added GEOS-Chem export in GCHP to send restart file (internal state) delta pressures to FV3 for mixing ratio scaling upon start-up
+- Added chemistry budget diagnostics to GCHP carbon HISTORY.rc
+- Added IUPAC names for Hg species in `run/shared/species_database.yml`
+- Added `gc_4x5_merra2_carbon_ch4_straddle_00utc` integraton test which runs across a UTC date boundary
+- Added statement to zero the `State_Diag%DryDepChm` array in routine `Zero_Diagnostics_StartOfTimestep`
+- Added clarifying comments in `flexgrid_read_met_mod.F90` for `TS` and `T2M` met fields
+- Added `&DSTbinproperties` and `&METALSproperties` YAML anchors in `run/shared/species_database.yml`
+- Added `DustL23M` as HEMCO extension 125 in `HEMCO_Config.rc.aerosol` and `HEMCO_Config.rc.fullchem` templates
+
+### Changed
+- Replaced comments in template HEMCO configuration files directing users to obsolete wiki documentation with comments directing users to `hemco.readthedocs.io`
+- Updated `EmisOCS_Bioburn` to `EmisOCS_BiomassBurn` in both GCHP `HEMCO_Diagn.rc.carbon` and `HISTORY.rc.carbon` template files
+- Updated the ESMF version from 8.4.2 to 8.6.1 in sample environment file `gchp.gcc12_openmpi4_cannon_rocky.env`
+- Changed call to `Accept_External_Date_Time` to also pass the seconds value, in order to prevent a WRF-GC bug
+- Removed convective washout for default scheme but keep it for LUO_WETDEP
+- Adapted Luo2023 WetDep for GF convection
+- Updated timestep scaling for convective precipitation areal fraction
+- Wrapped tests for infinity/NaN in `#ifdef DEBUG` blocks in `DO_GF_CLOUD_CONVECTION`
+- Changed optional argument `Update_Mixing_Ratio` in subroutine `Airqnt` to False by default
+- Change GC-Classic call to `Airqnt` to only update mixing ratios if advection is turned off
+- Updated mass flux and courant number import scaling in GCHP for compatibility with horizontal flux regridding in MAPL 2.59
+- Updated operational run script sample for WashU Compute1
+- Update GCHP AWS EFA operational run script examples to avoid crashes over large core counts
+- Updated GFEIv3 files to correct issue in original version
+- Updated `download_data.py` for compatibility with 0.125 x 0.15625 grids plus all pre-defined nested-grids
+- Restructured `download_data.py` to avoid several instances of repeated code
+- Changed `read_restart_as_real8` from `false` to `true` in `geoschem_config.yml` for GC-Classic benchmark simulations
+- Changed the default setting of `read_restart_as_real8` from `false` to `true` in template file `geoschem_config.yml.TransportTracers`
+- Disable PARANOX extension when using GEOS-Chem Classic 0.25x0.3125 or 0.125x0.15625 grids
+- Commented out met-fields `PEDGEDRY`, `PFICU`, `PFILSAN`, `PFLCU`, and `PFLLSAN` by default in GC-Classic and GCHP carbon HISTORY.rc, and GC-Classic CH4 HISTORY.rc
+- Turned on Carbon collection in `HISTORY.rc` for carbon simulations by default
+- Consolidated Hg species metdata from `run/shared/species_database_hg.yml` into `run/shared/species_database.yml`
+- Updated `run/shared/download_data.yml` so that aerosol and fullchem simulations will get the restart file from `GEOSCHEM_RESTARTS/GC_14.7.0`
+- Updated `DST1/DST1/DST3/DST4` to `TDST/DSTbin1/DSTbin2/.../DSTbin7` in `geoschem_config.yml`, `HEMCO_Config.rc`, and `HEMCO_Diagn.rc` template files for aerosol & fullchem simulations
+- Updated routine `ExtState_SetFields` in `hco_interface_gc_mod.F90` for readability and clarity
+- Assigned `ExtState%TSKIN` from `State_Met%TS` and `ExtState%T2M` from `State_Met%T2M` in routine `ExtState_SetFields`
+- Updated dust mass tuning factors for the `DustL23M` extension in `run/GCClassic/createRunDir.sh` and `run/GCHP/setCommonRunSettings.sh.template`
+- Replaced `id_DST{1..4}` with `id_DSTbin{1..7}` in the `APMidtype` derived type and `APMIDS` object
+- Replace hardwired values with constant parameters in routine `Aerosol_Conc` (in `GeosCore/aerosol_mod.F90`
+- Updated species database so that dust species use the anchor `&DSTbin properties` and metals species use `&METALSproperties`
+- Updated call to `ExtData_Set` in `hco_gc_interface_mod.F90` to accept `ExtState%SNOMAS`
+- Upated sample carbon simulation restart file to output generated from 10-year simulation
+
+### Fixed
+- Restored entries for TMB emissions in `HEMCO_Config.rc.fullchem` template files for GCClassic and GCHP
+- Moved `EmisOCS_Total` to the head of the `EmisOCS` diagnostic entries in the GCHP `HISTORY.rc.carbon` template file
+- Fixed OM/OC ratio for OCPO in SimpleSOA to be 1.4 instead of 2.1
+- Fixed precipitation formation rate unit in Luo2023 convective washout
+- Fixed bug where species mass in restart file was not conserved in first timestep if run-time meteorology different from restart file meteorology
+- Fixed parallel errors in `convection_mod.F90` by setting `AER = . TRUE.` and `KIN = .TRUE.` before calling `WASHOUT`
+- Fixed Hg directional ocean flux diagnostics in the Hg simulation so that they equal net flux
+- Fixed error where `//` were not being changed to `/` in `download_data.py`
+- Change precision of area import from GCHP advection from `REAL*4` to native `REAL*8`
+- Fixed time-range and units for CH4 emission inventories to be consistent with the corresponding netCDF files in ExtData directory for `HEMCO_Config.rc` and `ExtData.rc`
+- Updated scaling factor ID at 3000 to avoid conflicts with CEDS_01x01 scaling factor enabled in carbon simulation for IMI analytical inversion
+- Fixed typos in `ind_` variable names in `KPP/carbon/carbon_Funcs.F90`
+- Fixed typo in GCHP operational run script for Harvard Cannon to properly retrieve the run duration string
+- Fixed bug in ObsPack to include instantaneously-sampled data whose timestamps are within 1/2 of a model timestep of the end of the day
+- Fixed out-of-bounds error in `carbon_gases_mod.F90` that is caused by refernencing `OHdiurnalFac` array when it is not defined
+- Updated routines `Init_State_Chm`, `Init_Mapping_Vectors`, and `MapProdLossSpecies`to accept `TaggedDiag_List` as an argument
+- Updated routine `MapProdLossSpecies` to test if prod/loss family species or wildcards are scheduled for diagnostic archival before populating mapping arrays
+- Fixed indexing error in routine `Grav_Settling` (in module `GeosCore/sulfate_mod.F90`), which caused incorrect dry deposition diagnostics for some species
+- Fixed incorrect met vertical flipping in GCHP for cases where advection and non-advection met are from different sources, e.g. raw versus processed
+- Fixed several inconsistencies in `species_database.yml`
+- Fixed typo in GEOS-FP settings file used in GCClassic run directory creation
+
+### Removed
+- Removed entries for FINN v1.5 biomass burning emissions from template HEMCO configuration files
+- Removed `Is_Advected` tags from `run/shared/species_database*.yml` template files
+- Removed GCHP initialization of `State_Met` fields `TropLev`, `BxHeight`, and `DELP_DRY` from restart file values since over-written with values of current meteorology
+- Removed `OH_PosteriorSF` entry in carbon and CH4 HEMCO_Config.rc since never used
+- Retired the CO2, CH4, and tagCO simulations. These are now replaced by the carbon simulation, which can be used in joint or single-species mode.
+- Deleted `co2_mod.F90`, `global_ch4_mod.F90`, and `tagged_co_mod.F90`
+- Removed commented-out code for tagged Hg species in `state_diag_mod.F90`
+- Removed extraneous division by `TS_EMIS` in routine `Chem_H2O2` (located in `GeosCore/sulfate_mod.F90`)
+- Removed `run/shared/species_database_hg.yml`
+- Removed obsolete metadata for tagged Hg species from `run/shared/species_database.yml`
+- Removed code to zero `State_DiagDryDepMix` in `Compute_SFlx_For_Vdiff`; these are zeroed previously in `Zero_Diagnostics_StartOfTimestep`
+- Removed entries for `DustGinoux` and `DustDead` extensions from `HEMCO_Config.rc.aerosol` and `HEMCO_Config.rc.fullchem` templates
+- Removed `&DST{1,2,3,4}properties` in `run/shared/species_database.yml`
+- Removed references to `DustDead` and `DustGinoux` HEMCO extensios in template configuration files
+
 ## [14.6.3] - 2025-07-28
 ### Added
 - Added error check to exclude sampling ObsPack observations located outside of a nested-grid domain
@@ -133,6 +227,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 - Updated the `KPP-Standalone` for compatibility with KPP 3.2.0 and to write the proper number of header lines to skip before data begins
 - Set `use_archived_PCO_from_CH4` and `use_archived_PCO2_from_CO2` to true by default for carbon simulations
 - Updated CH4 global oil, gas, and coal emissions from GFEIv2 to GFEIv3
+- Changed GCHPctmEnv and DYNAMICS diagnostic names in GCHP to include suffix '_R4'
 
 ### Fixed
 - Fixed PDOWN definition to lower rather than upper edge

GeosCore/CMakeLists.txt

@@ -28,7 +28,6 @@ add_library(GeosCore
   cldice_HBrHOBr_rxn.F90
   cldj_interface_mod.F90
   cleanup.F90
-  co2_mod.F90
   convection_mod.F90
   depo_mercury_mod.F90
   diagnostics_mod.F90
@@ -41,7 +40,6 @@ add_library(GeosCore
   gc_environment_mod.F90
   get_ndep_mod.F90
   global_br_mod.F90
-  global_ch4_mod.F90
   gosat_ch4_mod.F90
   hcoi_gc_diagn_mod.F90
   hco_state_gc_mod.F90
@@ -70,7 +68,6 @@ add_library(GeosCore
   set_global_ch4_mod.F90
   sfcvmr_mod.F90
   sulfate_mod.F90
-  tagged_co_mod.F90
   tagged_o3_mod.F90
   tccon_ch4_mod.F90
   toms_mod.F90