GCHP 14.7.0

Release date: 09 Feb 2026

From CHANGELOG.md

Added

• Added R4 exports in GCHPctmEnv for diagnostics since R8 to R4 conversion in MAPL 2.55 History is broken
• Added submodule for GFE (Goddard-Fortran-Ecosystem) which includes GMAO libraries yafYaml, pFlogger, gFTL, gFTL-shared, fArgParse, and pFUnit as its own submodules
• Added connectivity from GEOS-Chem to FV3 dynamics to pass DELP_DRY in GEOS-Chem restart file to advection for restart file species mass conservation
• Added supplemental guides for GCHP horizontal and vertical grids to ReadTheDocs
• Added "Particulate matter in GEOS-Chem" supplemental guide to ReadTheDocs
• Added docs/read_the_docs_environment.yml Conda environment file

Changed

• Changed minimum CMake version from 3.13 to 3.24
• Changed minimum ESMF version from 8.4.2 to 8.6.1
• Updated docs to indicate timing information now printed to allPEs.log
• Updated docs to include library requirement udunits2 and additional information about stretched grid parameters
• Updated lint-ci-workflows to run on main and dev/* branches
• Updated badges on README.md and docs/source/index.rst
• Updated submodule ESMA_cmake for GNU Fortran compiler compatibility with CPUs returning processor description INTEL
• Updated geos-chem-shared-docs/editing_these_docs.rst with instructions for using a Conda environment to build RTD doc
• Updated the ESMF version used in ReadTheDocs installation instructions from 8.4.2 to 8.6.1
• Updated GEOS-Chem submodule to version 14.7.0
• Updated HEMCO submodule to version 3.12.0
• Updated ESMA_cmake submodule to commit 01bbf2f (Merge PR #9)
• Updated geos-chem-shared-docs submodule to commit 03078d4
• Updated .github/workflows/cloud-benchmarking-workflow.yml to skip submodule clone (that is done on AWS) and clear cached state

Fixed

• Fixed security issues in GitHub Actions that caused the lint-ci-workflows action to fail
• Fixed vertical flipping bug in GCHPctmEnv when using C720 fields with GEOS-FP processed data

Removed

• Removed individual submodules for yafYaml, pFlogger, and gFTL-shared since now located in new submodule GFE

Pull requests included

• Merge GCHP 14.6.3 into the dev/14.7.0 branch by @yantosca in #507
• Add "Lint" GitHub action to check other GitHub actions for security issues by @yantosca in #508
• Update MAPL from 2.26 to 2.59 by @lizziel in #496
• Docs updates for new udunits2 requirement and stretched grid info by @lizziel in #510
• Add connectivity from GEOS-Chem to advection by @lizziel in #515
• Update ESMA_cmake submodule with fixes for GNU/Intel Fortran flags for certain chips by @lizziel in #518
• Fix vertical flipping c720 fields with processed met by @lizziel in #529

Full Changelog: 14.6.3...14.7.0

See the GEOS-Chem 14.7.0 page for a complete list of updates.

GCHP 14.6.3

Release date: 28 Jul 2025

From CHANGELOG.md

Added

• Added -DSANITIZE option for use with GNU Fortran compiler to check for memory leaks
• Added "Known Bugs" page under "Reference" section of the ReadTheDocs documentation

Changed

• Updated ReadTheDocs documentation to state that we are using Spack v0.23.1 in the Spack installation guide
• Reordered entries in the ReadTheDocs reference section to match the GCClassic documentation
• Updated GEOS-Chem submodule to 14.6.3
• Updated HEMCO submodule to 3.11.2

Fixed

• Fixed bug in GCHP adjoint code to compute mass fluxes after first run

Removed

• Removed descriptions of GEOS-IT as "beta release" in ReadTheDocs documentation

Pull requests included

• Adjoint fix for computing mass fluxes by @lizziel in #499
• Add -DSANITIZE compiler option to check for memory leaks by @lizziel in #504
• GCHP 14.6.3 release by @yantosca in #505

Full Changelog: 14.6.2...14.6.3

GCHP 14.6.2

Release date: 12 Jun 2025

From CHANGELOG.md

Changed

• Updated GEOS-Chem submodule to 14.6.2

What's Changed

• GCHP 14.6.2 release by @yantosca in #497

Full Changelog: 14.6.1...14.6.2

GCHP 14.6.1

Release date: 29 May 2025

From CHANGELOG.md

Added

• Added ReadTheDocs documentation updates for GCHP 14.6.1

Changed

• Updated GEOS-Chem submodule to 14.6.1
• Updated HEMCO submodule to 3.11.1

Pull requests included

• GCHP 14.6.1 release by @yantosca in #495

Full Changelog: 14.6.0...14.6.1

GCHP 14.6.0

Release date: 18 Apr 2025

From CHANGELOG.md

Added

• Added ReadTheDocs documentation about GEOS-Chem simulations

Changed

• Increased execution memory for GCHP cloud benchmarks from 80 to 120 GB in .github/workflows/cloud-benchmarking-workflow.yml

Fixed

• Check if mass flux import is top-down and flip accordingly
• Bumped jinja2 to 3.1.6 in docs/requirements.txt (fixes a security issue id

Pull requests included

• Increased execution memory for GCHP cloud benchmarks from 80 GB to 120 GB by @yantosca in #471
• Merge GCHP 14.5.2 into dev/14.6.0 by @yantosca in #475
• Check if mass flux is top-down and flip accordingly to enable processed mass flux by @yuanjianz in #462
• GCHP 14.6.0 release by @yantosca in #487

Full Changelog: 14.5.3...14.6.0

GCHP 14.5.3

Release date: 05 March 2025

From CHANGELOG.md

Added

• Updated RTD docs to state that users wishing not to open AWS account can use AWS CLI commands with --no-sign-request

Changed

• Updated GEOS-Chem submodule to 14.5.3
• Updated HEMCO submodule to 3.10.2

Pull requests included

• GCHP 14.5.3 release by @yantosca in #480

Full Changelog: 14.5.2...14.5.3

GCHP 14.5.2

From CHANGELOG.md

Added

• Added text to RTD stating that data download from s3://geos-chem is and s3://gcgrid is free

Changed

• Bumped jinja2 to version 3.1.5 in docs/requirements.txt to fix a security issue
• Changed the build sequence so that the KPP-Standalone is only built when configuring with -DKPPSA=y
• Updated RTD documentation for fullchem rundir creation, which now asks users if they wish to build KPP-Standalone

Pull requests included

• Bump jinja2 to 3.1.5 as suggested by Dependabot by @yantosca in #469
• Do not build KPP-Standalone executable unless specifically requested at compile time by @yantosca in #473
• GCHP 14.5.2 release by @yantosca in #474

Full Changelog: 14.5.1...14.5.2

GCHP 14.5.1

Release date: 10 Jan 2025

From CHANGELOG.md

Added

• Added code to src/CMakeLists.txt to build & install the KPP standalone executable when fullchem or custom mechanisms are selected
• Added ReadTheDocs Supplemental Guide on using the KPP-Standalone Box Model and KPP-Standalone Interface in GEOS-Chem

Fixed

• Fixed dry mass flux derivation in GCHPctmEnv when using mass flux imports
• Fixed UpwardsMassFlux sign to make positive represent upwards direction
• Fixed logic error in src/CMakeLists.txt that attempted to build the KPP standalone for the carbon simulation (see geoschem/GCClassic #78)

Pull requests included

• Add KPP Standalone into GEOS-Chem 14.5.1 by @yantosca in #463
• Fix GCHPctmEnv small numerical bugs by @yuanjianz in #456
• Fixed CMake error to prevent KPP standalone being built in carbon sim by @yantosca in #464
• GCHP 14.5.1 release by @yantosca in #468

New Contributors

• @yuanjianz made their first contribution in #456

Full Changelog: 14.5.0...14.5.1

See the GEOS-Chem 14.5.1 page for a complete list of updates.

GCHP 14.5.0

Release date: 08 Nov 2024

From CHANGELOG.md

Added

• Added documentation about GEOS convection change affecting meteorology starting June 1, 2020

Changed

• Updated GEOS-Chem to 14.5.0
• Updated HEMCO to 3.10.0
• Updated Cloud-J to 8.0.1

Fixed

• Fixed formatting error in .github/workflows/stale.yml that caused the Mark Stale Issues action not to run
• Updated compiler requirements to specify max GNU version is 12
• Updated documentation for version 14.5.0
• Updated docs/requirements.txt to use jinja2==3.1.4 (fixes a security issue)

See the GEOS-Chem 14.5.0 page for a complete list of updates.

Pull requests included

• Bugfix: Restore stale workflow functionality by @msulprizio in #444
• ReadTheDocs updates for GCHP 14.5.0 by @yantosca in #448

Full Changelog: 14.4.3...14.5.0

GCHP 14.4.3

Release Date: 13 Aug 2024

From CHANGELOG.md

Changed

• Updated GEOS-Chem (science codebase) to 14.4.3
• Updated HEMCO to 3.9.3
• Updated Cloud-J to 7.7.3

Fixed

• Added brackets around exempt-issue-labels list in .github/workflows/stale.yml

Pull Requests Included

• none

Full Changelog: 14.4.2...14.4.3