Skip to content

GCHP 14.7.0 release#533

Merged
yantosca merged 114 commits intomainfrom
release/14.7.0
Feb 6, 2026
Merged

GCHP 14.7.0 release#533
yantosca merged 114 commits intomainfrom
release/14.7.0

Conversation

@yantosca
Copy link
Copy Markdown
Contributor

@yantosca yantosca commented Feb 5, 2026

Name and Institution (Required)

Name: Bob Yantosca
Institution: Harvard + GCST

Describe the update

This PR seeks to merge the release/14.6.3 branch into main in anticipation of the GCHP 14.6.3 release.

The release/14.6.3 branch contains

  • Commits from the dev/14.7.0 branch
  • Documentation updates from the docs/dev branch
  • Updated version numbers to 14.7.0 in the usual places
  • Updated GEOS-Chem submodule to 14.7.0
  • Updated HEMCO submodule to 3.12.0
  • Updated ESMA_cmake submodule to include pull requests 9 and 10

Related Github Issues

yantosca and others added 30 commits June 17, 2025 14:48
This commit informs the GCHP superproject about the following
commits that were pushed to the GitHub geoschem/geos-chem repository:

PR #2900 does the following:

1. Adds entries for FINN v2.5 biomass burning emissions to HEMCO_Config.rc
   template files for aerosol-only, carbon, and fullchem simulations.

2. Removes entries for the FINN v1.5 biomass burning extension from
   HEMCO_Config.rc template files, as FINN v1.5 is now superseded by FINN v2.5.

3. Adds clarifying comments in HEMCO_Diagn.rc template files instructing
   which settings of ExtNr, Cat, and Hier should be used for online vs.
   offline biomass burning emissions.

4. Replaces comments in HEMCO_Config.rc and HEMCO_Diagn.rc template files
   that were directing users to the obsolete HEMCO manual on the GC wiki
   with comments directing users to the current hemco.readthedocs.io
   documentation.

5. Restores TMB emission diagnostic entries to the HEMCO_Config.rc.fullchem
   files for GEOS-Chem Classic and GCHP.

6. Renames OCS biomass burning emissions to EmisOCS_BiomassBurn in GCHP
   HEMCO_Diagn.rc and HISTORY.rc files, for consistency with the corresponding
   diagnostic name in GEOS-Chem Classic.

7. Moves EmisOCS_Total to the top of the GCHP HISTORY.rc.carbon template file,
   which is expected by the script that edits the configuration files for
   single species carbon simulations.

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
This commit informs the GCHP superproject about the following
commits that were pushed to the GitHub geoschem/geos-chem repository:

78aa048e2 Merge PR #2889 (Updates for Luo2023)

PR #2889 updates the Luo wet deposition scheme accordintg to Luo, G., &
Yu, F. (2023). GRL, 50, e2023GL104258. https://doi.org/10.1029/2023GL104258.

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
This commit informs the GCHP superproject about the following
commits that were pushed to the GitHub geoschem/geos-chem repository:

1a97c01e5 Update ESMF to 8.6.1 in GCHP env file for Harvard Cannon

PR #2916 updates the ESMF version from 8.4.2 to 8.6.1 in the sample
GCHP environment file "gchp.gcc12_openmpi4_cannon_rocky.env",
which is used on the Harvard Cannon cluster.

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
docs/source/getting-started/requirements.txt
- Updated the installation instructions so that we install ESMF 8.6.1
  (needed for MAPL 2.55) instead of ESMF 8.4.2
- Now use "-" instead of "*" for bullet lists
- Cosmetic changes (word-wrapping, whitespace)
- Changed several code-block sections containing bash code to use
  "bash" instead of "console" format
- Updated modules in examples to GCC 12.2.0 (as used on Cannon)
This merge brings updates from the recently-released 14.6.3
version into a feature branch off dev/14.7.0, in preparation for
merging 14.6.3 back into 14.7.0.

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
This merge brings PR # (Merge GCHP 14.6.3 into the dev/14.7.0 branch,
by @yantosca) into the GEOS-Chem 14.7.0 development stream.

PR #507 updates dev/14.7.0 with the commits from the 14.6.3 release.

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
This commit informs the GCHP superproject about the following
commits that were pushed to the GitHub geoschem/geos-chem repository:

481b4fece Merge PR #2974 (Fix ocean flux diagnostics in Hg simulation)

PR #2974 removes the zeroing of the directional Hg ocean flux
diagnostics, in order to make the them equal the net flux.

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
.github/workflows/lint-ci-workflows.yml
- Added this workflow to error-check other workflows for security issues

.github/workflows/cloud-benchmarking-workflow.yml
- Now trigger the workflow on "dev/*" branches
- Update actions/checkout from v3 to v4
- Now use bash-safe syntax to get the 1st 7 chars of the commit hash
- Move "if:" statements before the "run:" blocks

README.md
docs/source/index.rst
- Updated GitHub badges (remove badges for obsolete functionality)

CHANGELOG.md
- Updated accordingly

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
.github/workflows/cloud-benchmarking-workflow.yml
- Added persist-credentials: false to actions/checkout@v4
  so that GitHub credentials will be wiped after the task finishes

.github/spack-deployment-workflow.yml
- Updated actions/checkout@v2 to @v4
- Added persist-credentials: false to actions/checkout@v4
  so that GitHub credentials will be wiped after the task finishes

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
This merge brings PR # (Add "Lint" GitHub action to check other
GitHub actions for security issues #508, by @yantosca) into the
GCHP "no-diff-to-benchmark" development stream.

PR #508 does the following:

1. We now use bash-safe code when defining the
   GITHUB_SHA_SHORT and PR_SHA environment variables in
   cloud-benchmark-workflow.yml

2. The lint-ci-workflows action now runs when updates are made
   to the main and dev/* branches.

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
This commit informs the GCClassic superproject about the following
commits that were pushed to the GitHub geoschem/HEMCO repository:

8dbae83 Merge PR #339 (Add "Lint" GitHub action)

PR #339 does the following:

1. The lint-ci-workflows action now runs when updates are
   made to the main and dev/* branches.

2. We have removed the .ci-pipelines folder, which contained the
   configuration files for the Microsoft Azure Dev Pipelines C-I tests.
   Many of these were broken anyway.

3. The windows, mac, and ubuntu GitHub actions have been updated to
   fix security issues. These actions now also run when pushes or
   pull requests are made to dev or release branches.

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
Signed-off-by: Lizzie Lundgren <elundgren@seas.harvard.edu>
Signed-off-by: Lizzie Lundgren <elundgren@seas.harvard.edu>
Signed-off-by: Lizzie Lundgren <elundgren@seas.harvard.edu>
… bug

This is a temporary update until GMAO implements a bug fix in MAPL History

Signed-off-by: Lizzie Lundgren <elundgren@seas.harvard.edu>
Signed-off-by: Lizzie Lundgren <elundgren@seas.harvard.edu>
Signed-off-by: Lizzie Lundgren <elundgren@seas.harvard.edu>
Signed-off-by: Lizzie Lundgren <elundgren@seas.harvard.edu>
Signed-off-by: Lizzie Lundgren <elundgren@seas.harvard.edu>
This commit informs the GCHPsuperproject about the following
commits that were pushed to the GitHub geoschem/geos-chem repository:

e4dc17b14 Merge PR #2984 (Fix GCHP restart for Jacobian tracers)

PR #2984 adds a logical flag of Is_JacobianTracer in species_database.yml.
This allows GCHP perturbation runs to define species "CH4_nnnn", which
will be initialized to the initial conditions from the "SPC_CH4" species
in GCHP restart files.

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
Signed-off-by: Lizzie Lundgren <elundgren@seas.harvard.edu>
This commit informs the GCHP superproject about the following
commits that were pushed to the GitHub geoschem/geos-chem repository:

bcb78036e Merge PR #2988 (Update Compute1 operation run script)

PR #2988 Update operational run script sample for the WashU Compute1
cluster with necessary changes following a system update.

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
This commit informs the GCClassic superproject about the following
commits that were pushed to the GitHub geoschem/geos-chem repository:

bcbfb3dd7 Merge PR #2989 (Add operational run scripts for WashU Compute2)

PR #2989 adds operational GCHP run scripts for the WashU Compute2 cluster.

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
This commit informs the GCHP superproject about the following
commits that were pushed to the GitHub geoschem/geos-chem repository:

8bb85739d Merge PR #2990 (Update GCHP AWS EFA run scripts to avoid crashes)

PR #2990 Update GCHP AWS EFA operational run script examples
to avoid crashes at large core counts.

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
This merge brings PR #496 (Update MAPL from 2.26 to 2.59,
by @lizziel) into the GCHP 14.7.0 development stream.

PR #496 contains changes needed for compatibility with MAPL 2.59.
Previously we used MAPL 2.26.

Important note: This update requires minimum ESMF version from 8.4.2
to 8.6.1, and minimum CMake version from 3.13 to 3.24.

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
src/GCHP_GridComp/FVDycoreCubed_GridComp
- Updated to:
  35da079 Merge pull request #9 from geoschem/bugfix/add_R4_exports_for_compatibility_with_mapl_2.55

src/GCHP_GridComp/GEOSChem_GridComp/geos-chem
- Updated to:
  b7e60f96f Merge PR #2885 (Update for MAPL 2.59 compatibility)

src/MAPL
- Updated to:
  d1d528e5 Merge pull request #39 from geoschem/feature/mapl_2.55.0

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
Signed-off-by: Lizzie Lundgren <elundgren@seas.harvard.edu>
This merge brings PR #510 (Docs updates for new udunits2 requirement
and stretched grid info, by @lizziel) into the GCHP 14.7.0 development
stream.

PR #510 adds documentation updates for the MAPL update to 2.59. The
history output file global attributes for stretched grid changed
in that version to match the restart file, and a new external package
called udunits2 is a new GCHP requirement.

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
This commit informs the GCHP superproject about the following
commits that were pushed to the GitHub geoschem/geos-chem repository:

90799084d Merge PR #2996 (Update GFEIv3 files, from peer review)

PR #2996 fixes an issue in the original GFEIv3 files.  The files were
corrected in July 2025 and redownloaded and processed for use in GEOS-Chem.
The corrected files can now be found in ExtData/HEMCO/CH4/v2025-08/GFEIv3/.

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
yantosca and others added 17 commits December 15, 2025 14:52
This commit informs the GCHP superproject about the following
commits that were pushed to the GitHub geoschem/geos-chem repository:

d65b73ff5 Merge PR #2946 (Add 7 dust bins in GEOS-Chem)
f4715d0 Merge PR #336 (Add 7 dust bins in HEMCO)

GEOS-Chem PR #2946 and HEMCO PR #336 add the DustL23M extension
from @1Dandan, and replace DST{1..4} species with DSTbin{1..7}.

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
docs/source/geos-chem-shared-docs
- Submod update to f8fe324
  (Warn that LevelEdgeDiags is renamed to StateMetLevEdge)

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>cd
docs/source/getting-started/requirements.txt
- Update ESMF version to 8.6.1 in documentation
- Also update compiler from GCC 10 to GCC 12 in documentation

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
geos-chem-shared-docs
- Submod update to 03078d4, add new documentation for PM2.5 and PM10
  in versions prior to 14.7.0

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
This commit informs the GCHP superproject about the following
commits that were pushed to the GitHub geoschem/geos-chem repository:

16b499b Merge PR #349 (Now sum DELPDRY when regridding from 72 -> 47 layers)

PR #349 adds a fix so that the Met_DELPDRY restart file variable is
summed in the vertical instead of averaged when regridding from 72
levels to 47 levels.  This fixes an issue first raised by @ltmurray
in geoschem/geos-chem#3170.

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
…GEOS-FP)

This commit informs the GCHP superproject about the following
commits that were pushed to the GitHub geoschem/geos-chem repository:

f3ef58547 Merge PR #3187 (Fix typo in GCClassic rundir creation w/ GEOS-FP)

In pull request #3131, the GEOS-FP met settings file
geosfp.preprocessed_ll.txt was renamed to geosfp.nonadv_preprocessed_ll.txt.
This was not updated in GCClassic/createRunDir.sh so when creating a
GEOS-FP run directory for GCClassic the met settings were not properly set.
For example, in geoschem_config.rc it still listed met_field: ${RUNDIR_MET}.
Fixing the filename corrects this issue.

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
This commit informs the GCHP superproject about the following
commits that were pushed to the GitHub geoschem/geos-chem repository:

dafdefa50 Merge PR #3147 (Update sample carbon sim restart file)

PR #3147 updates "run/GCClassic/download_data.yml" and
"run/GCHP/createRunDir.sh" to point to the GEOSCHEM_RESTARTS/GC_14.7.0
folder.  This is where updated carbon simulation restart files
(generated from a 10-year benchmark) are stored.

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
This merge brings updates from the "dev/14.7.0" branch into the
"release/14.7.0" branch, in anticipation of the GCHP 14.7.0 release.

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
This update brings documentation updates from the "docs/dev" branch
into the "release/14.7.0" branch in anticipation of the 14.7.0 release.

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
In anticipation of the GCHP 14.7.0 release, we have updated
version numbers to 14.7.0 in these files:
- CHANGELOG.md
- CMakeLists.txt
- docs/source/conf.py

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
src/GCHP_GridComp/GEOSChem_GridComp/HEMCO/HEMCO
- Now points to the HEMCO 3.12.0 release

src/GCHP_GridComp/GEOSChem_GridComp/geos-chem
- Now points to the GEOS-Chem 14.7.0 release

ESMA_cmake
- Now points to commit 01bbf2f (Merge PR #9)

geos-chem-shared-docs
- Now points to commit 03078d4

CHANGELOG.md
- Updated accordingly

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
@yantosca yantosca requested a review from msulprizio February 6, 2026 20:01
@yantosca yantosca marked this pull request as ready for review February 6, 2026 20:01
@yantosca yantosca merged commit 0779c7e into main Feb 6, 2026
1 check failed
@yantosca yantosca deleted the release/14.7.0 branch February 6, 2026 21:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

category: Feature Request New feature or request topic: Releases GCHP releases

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants