Skip to content

GCClassic 14.7.0 release#105

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

GCClassic 14.7.0 release#105
yantosca merged 92 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.7.0 branch into main in anticipation of the GCClassic 14.7.0 release.

The release/14.7.0 branch contains

  • Source code updates 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

Related GitHub issues:

yantosca added 30 commits June 17, 2025 14:46
This commit informs the GCClassic 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 GCClassic 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 GCClassic 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>
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 #99 (Merge GCClassic 14.6.3 into dev/14.7.0,
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>
Merge branch 'feature/merge-14.6.3-into-14.7.0' into dev/14.7.0
This commit informs the GCClassic 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/cloud-benchmarking-workflow.yml
- Use bash-safe string slicing instead of using the "cut" command
- Updated comments
- Trimmed trailing whitespace

.github/workflows/lint-ci-workflows.yml
- Define the GITHUB_TOKEN env var to pass the secret token to zizmor
- Updated comments
- Trimmed trailing whitespace

CHANGELOG.md
- Updated accordingly

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
.github/workflows/cloud-benchmarking-workflow.yml
- In the "Reset Initial Variables for pull request" task:
  - Move the "if: github.event_name == 'pull_request' to the top
    so that the task will immediately exit if not a pull request
  - Define the PR_SHA and GITHUB_SHA_SHORT environment variables
    in a bash-safe way
- In the "Reset Variables For Tags" task:
  - Move the "if: startswith" block to the top
- In the "Set Initial Variables" task:
  - Define the GITHUB_SHA_SHORT environment variable in a bash-safe way

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
.github/workflows/lint-ci-workflows.yml
- Add "dev/*" to the branches list, this will trigger the Lint
  workflow when pushing to dev/* branches
- Add the GITHUB_TOKEN environment variable to the zizmor task
- Trimmed trailing whitespace
- Added "permissions: contents:read" to allow Zizmor to read
  the secret GitHub token

CHANGELOG.md
- Updated accordingly

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
.ci-pipelines/*.yml
- Removed

CHANGELOG.md
- Updated accordingly
README.md
docs/source/index.rst
- Removed "Latest pre-release" badge
- Added "gcclassic-compile-tests" badge
- Changed the order of badges on the page

CHANGELOG.md
- Updated accordingly



Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
.github/workflows/cloud-benchmarking-workflow.yml
- Fixed typo: "GITHUB_HA_SHORT" -> "GITHUB_SHA_SHORT"
- Now use "dev/*" instead of "dev**" as the branch pattern

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
.github/workflows/cloud-benchmarking-workflow.yml
- In the "Set Initial Variables" task:
  - Remove the "env" section
  - Now use ${GITHUB_SHA:0:7} to define GITHUB_SHA_SHORT and
    COMMIT_NAME in the run section
- In the "Reset Initial Variables for pull request" task:
  - Remove PR_SHA from the env section
  - Set GITHUB_SHA_SHORT to the head sha of the pull request
  - Now use ${GITHUB_SHA_SHORT:0:7} to define GITHUB_SHA_SHORT and
    COMMIT_NAME in the run section

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
This merge brings PR #100 (Fix security issues in GitHub actions;
Remove Azure Dev Pipelines workflows , by @yantosca) into the
GCClassic "no-diff-to-benchmark" development stream.

PR #100 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.

3. 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.

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>
This commit informs the GCClassic superproject 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>
This commit informs the GCClassic 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 GCClassic 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 commit informs the GCClassic superproject about the following
commits that were pushed to the GitHub geoschem/geos-chem repository:

b7e60f96f Merge PR #2885 (Update for MAPL 2.59 compatibility)

PR #2885 contains assorted changes related to updating
GCHP from MAPL 2.26 to MAPL 2.59.

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:

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>
…e_Time)

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

8db991a59 Merge PR #2997 (Pass seconds to Accept_External_Date_Time)

PR #2997 fixes a bug in WRF-GC by making sure that seconds are
passed into the routine Accept_External_Date_Time.

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:

bfa3424 GEOS-Chem update: Merge PR #2997 (Pass seconds to Accept_External_Date_Time)

PR #3000 changes the OM/OC ratio for OCPO in SimpleSOA to 1.4
(instead of 2.1).

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

331f989 Update ESMF version in spack/packages.yaml to 8.6.1
4679349 Mention that the aerosol-only sim cannot simulate NH4-NO3-SO4 aerosols

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:

2311ed93a Merge PR #3001 (Update conv washout for G-F and Luo wetdep)

PR #3001 does the following:

1. In GF, remove convective washout for default scheme but keep it for
   LUO_WETDEP based on suggestion from @viral211

2. Adapt Luo2023 WetDep for GF convection.

3. Fix precipitation formation rate unit in Luo2023 convective washout.

4. Update timestep scaling for convective precipitation areal fraction.

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

cdc2304 Update TransportTracers simulation page

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
docs/source/supplemental-guides/vertical-grids.rst
- Added documentation about GEOS-Chem Classic vertical grids,
  ported from the GEOS-Chem wiki

docs/source/index.rst
- Added vertical-grids.rst to the Supplemental Guides toctree

CHANGELOG.md
- Updated accordingly

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
docs/source/supplemental-guides/horizontal-grids.rst
- Added documentation about GEOS-Chem Classic horizontal grids,
  migrated from the wiki

docs/source/index.rst
- Add horizontal-grids.rst to the Supplemental Guides toctree

CHANGELOG.md
- Updated accordingly

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
docs/source/supplemental-guides/horizontal-grids.rst
- Added grid definitions for all of the global and nested grids
  that can be created in createRunDir.sh.  Tables of lons/lats
  were generated with a test program using GCPy routine make_grid_LL.

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
docs/source/supplemental-guides/vertical-grids.rst
- Added a paragraph "Specifics for GMAO vertical grids"

docs/source/geos-chem/geos-chem-shared-docs
- Submodule update to 280e8e4 (list-tables in history-guide.rst)

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

e852c244d Merge PR #3113 (Consolidate Hg metadata into species_database.yml)

PR #3113 does the following:

1. Consolidates all metadata for Hg species (currently present in
   run/shared/species_database_hg.yml) into the
   run/shared/species_database.yml.

2. Removes metadata for obsolete tagged Hg species.

3. Updates run/GCClassic/createRunDir.sh accordingly so that we just
   copy run/shared/species_database.yml to the run directory.

4. Adds IUPAC names for Hg species in under the FullName tag of
   species_database.yml.

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:

3236dc5a7 Merge PR #3121 (Add GC-Classic int test straddling 00 UTC)

PR #3121 introduces a new GEOS-Chem Classic integration test (based
on gc_4x5_merra2_carbon_CH4) that straddles a UTC date boundary.
The test starts at 20190101T18:00:00 UTC and ends on
20190102T01:00:00 UTC.  This is one of the "wish list" integration
tests described in #714.

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
docs/source/gcclassic-user-guide/dry-run-download.rst
docs/source/getting-started/quick-start.rst
- Updated dry-run instructions to be more specific about activating
  the Conda environment.  Also split into subsections.

docs/source/geos-chem-shared-docs
- Submod update to d785e727 (species-guide.rst updates)

CHANGELOG.md
- Updated accordingly

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:

34042ced5 Merge PR #3118 (Fix OOB errors in DryDepChm diagnostic)

PR #3118 fixes an out-of-bounds error in the dry deposition
diagnostics that was responsible for creating striped patterns
in diagnostic output as first reported by @yc-chan.

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:

a3a795878 Merge PR #3131 (Fix vertical flipping of GEOS-FP C720 met fields)

PR #3131 is the companion PR to geoschem/GCHP#529.  These PRs fix
a bug by splitting the single category for vertical direction of
imports into 4 categories (mass flux, wind, humidity, and everything
else), which is needed for GCHP C720.

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:

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>
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 GCClassic 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 GCClassic 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 GCClassic 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 GEOS-Chem 14.7.0
release.

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

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
Updated version numbers in:
- CHANGELOG.md
- CMakeLists.txt
- docs/source/conf.py

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
@yantosca yantosca self-assigned this Feb 5, 2026
@yantosca yantosca added category: Feature Request New feature or request topic: Releases GCClassic releases labels Feb 5, 2026
@yantosca yantosca changed the title Release/14.7.0 GCClassic 14.7.0 release Feb 5, 2026
src/GEOS-Chem:
- Now points to the GEOS-Chem (science codebase) 14.7.0 release

src/HEMCO
- Now points to the HEMCO 3.12.0 release

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 cfba4e9 into main Feb 6, 2026
3 checks passed
@yantosca yantosca deleted the release/14.7.0 branch February 6, 2026 21:18
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 GCClassic releases

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants