GCHP 14.2.1

Release Date: 10 Oct 2023

From CHANGELOG.md

Changed

• test now points to src/GCHP_GridComp/GEOSChem_GridComp/geos-chem/test
• Hard-coded ESMF logging option removed from GCHPctm.F90
• Updated version numbers and documentation

Pull Requests Included

• Update symbolic link from GCHP root folder to the test folder by @yantosca in #327
• Set ESMF logging option at run-time via config file by @lizziel in #330

Full Changelog: 14.2.0...14.2.1

GCHP 14.2.0

Release date: 05 Oct 2023

From CHANGELOG.md

Added

• Added run-time option to use dry air pressure in advection
• Added run-time option to correct mass flux for humidity
• Added .readthedocs.yaml to configure ReadTheDocs builds

Changed

• Updated GEOS-Chem submodule to 14.2.0
• Updated HEMCO submodule to 3.7.0
• Updated version numbers in CMakeLists.txt and docs/source/conf.py to 14.2.0
• Changed default air pressure in advection from total to dry
• Updated AUTHORS.txt for GCHP 14.2.0
• Updated README.md so that links point to http://geos-chem.org
• Updated logo & badge links in README.md
• Updated version number to 14.2.0

Fixed

• Fixed post-advection pressure edges (PLE1) passed to advection to be derived from the correct surface pressure
• Fixed typo in docs/source/conf.py, "_static" should be "_static/"

What's Changed

• Simplify Github issue and pull request templates by @msulprizio in #293
• Fix several problems with Github template issues by @yantosca in #297
• Make FindESMF.cmake use consistent libs by @sdeastham in #309
• Add submodule update issue template by @lizziel in #307
• Fix error in pressure level edge construction by @sdeastham in #312
• Add run-time options for dry pressure and moisture-corrected mass fluxes in advection by @lizziel in #317
• Feature/update docs by @yidant in #336

New Contributors

• @yidant made their first contribution in #336

Full Changelog: 14.1.0...14.2.0

GCHP 14.1.1

Release date: 03 Mar 2023

From CHANGELOG.md

Added

• Added EXE_FILE_NAME and INSTALLCOPY to src/CMakeLists.txt (facilitates integration testing)

Changed

• Changed "carboncycle" to "carbon" in src/GCHP_GridComp/GEOSChem_GridComp/CMakeLists.txt
• Simplified Github issue and pull request templates
• Updated ReadTheDocs to specify 8.1 is minimum version of ESMF
• Updated version numbers in CMakeLists.txt and docs/source/conf.py to 14.1.1

Fixed

• Fixed global attributes written to stretched grid checkpoint files to enable restart
• Fixed day-of-week scale factor handling in MAPL ExtData
• Fixed stretched grid checkpoint file issue in MAPL that prevented restarting stretched grid simulations

Full Changelog: 14.1.0...14.1.1

GCHP 14.1.0

Release date: 01 Feb 2023

This release features the updates and fixes listed below.

From CHANGELOG.md

Changed

• Updated GEOS-Chem submodule to 14.1.0
• Updated HEMCO submodule to 3.6.0
• Updated ReadTheDocs documentation for 14.1.0
• Updated MAPL submodule from v2.18.3 -> v2.26.0
• Updated gFTL-shared submodule from v1.4.1 -> v1.5.0
• Updated yaFyaml submodule from v1.0-beta.4 -> v1.0.4
• Updated pFlogger submodule from v1.6.1 -> v1.9.1
• Updated ReadTheDocs documentation for 14.1.0

What's Changed

• bugfix/findRefKey: update findRefKey.sh to find previous commits by @laestrada in #280
• Add carbon simulation and KPP mechanism by @msulprizio in #283

Full Changelog: 14.0.2...14.1.0

GCHP 14.0.2

Release date: 29 Nov 2022

This is a bug fix release featuring the updates and fixes listed below.

From CHANGELOG.md

Changed

• Updated GEOS-Chem submodule to 14.0.2
• Updated HEMCO submodule to 3.5.2
• Updated the documentation for clarity

Full Changelog: 14.0.1...14.0.2

GCHP 14.0.1

Release date: 31 Oct 2022

This is a bug fix release featuring minor fixes and updates since 14.0.0.

From CHANGELOG.md

Changed

• Updated GEOS-Chem submodule to 14.0.1

GCHP 14.0.0

Release date: 25 Oct 2022

This is a major version release featuring the following updates:

• Update GEOS-Chem submodule to 14.0.0
• Update HEMCO submodule to 3.5.0
• Update GEOS-ESM submodule versions

From CHANGELOG.md

This file documents all notable changes to the GCHP wrapper repository since version 13.4.1. See also CHANGELOG files for individual submodules, such as:

• src/GCHP_GridComp/GEOSChem_GridComp/geos-chem/CHANGELOG.md
• src/GCHP_GridComp/HEMCO_GridComp/HEMCO/CHANGELOG.md
• src/MAPL/CHANGELOG.md

Added

• Created CHANGELOG.md

Changed

• Changed GEOS-Chem submodule to 14.0.0 release
• Changed HEMCO submodule version: 3.4.0 -> 3.5.0
• Changed GEOS-ESM submodule versions:
  • MAPL: v2.6.3 -> v2.18.3
  • FVdycoreCubed_GridComp: v1.2.12 -> v1.8.0
  • fvdycore: geos/v1.1.6 -> geos/v1.4.0
  • GMAO_Shared: v1.3.8 -> v1.5.3
  • FMS: geos/2019.01.02+noaff.6 -> geos/2019.01.02+noaff.8
  • ESMA_cmake: v3.0.6 -> v3.8.0
• Changed Goddard-Fortran-Ecosystem submodule versions:
  • gFTL-shared: v1.2.0 -> v1.4.1
  • gFTL: v1.3.1 -> v1.6.0
  • pFlogger: v1.5.0 -> v1.6.1
  • yaFyaml: v0.5.0 -> v1.0-beta.4
• Updated build files for compatibility with new submodule versions
• Updated CONTRIBUTING.md and SUPPORT.md to retire guidelines on GEOS-Chem wiki
• Updated GCHP ReadTheDocs documentation
• Updated spack deployment action to use new installation procedure
• Update AWS benchmarking github actions to act on all dev* branches

Removed

• Removed Azure continuous integration test pipeline
• Removed pFUnit submodule since not used

Fixed

• Fixed broken CMAKE_BUILD_TYPE options for intel and gfortran compilers

What's Changed

• Update GMAO libraries in 14.0 by @lizziel in #214
• upwardsmassflux diagnostic has been scaled by 1/dt by @Jourdan-He in #248
• GCHP ReadTheDocs for 14.0.0 release by @lizziel in #249
• Add CHANGELOG.md by @msulprizio in #260

Full Changelog: 13.4.1...14.0.0

GCHP 14.0.0-rc.0

Release date: 03 Jun 2022

This is the first release candidate for GCHP 14.0.0. Major updates since GCHP 13.4.1 include:

• Fix bugs causing differences when splitting up GC-Classic and GCHP simulations in time
• Convert input.geos to geoschem_config.yml
• Update to KPP 2.5.0
• Change 4D State_Chm%Species array to vector of 3D concentration arrays
• Upgrade GMAO libraries
• Add option to use native GEOS-FP met fields
• Add fix to save boundary conditions on first timestep
• Fix total OC diagnostic
• Avoid div-by-zero in routine MMR_Compute_Flux
• Add bug fix in HEMCO MEGAN extension

For more information, please see:

• GEOS-Chem 14.0.0 page on the GEOS-Chem wiki
• 14.0.0 Github milestone for geoschem/geos-chem
• 14.0.0 Github milestone for geoschem/GCHP
• 3.5.0 Github milestone for geoschem/HEMCO

GCHP 13.4.1

Release date: 19 May 2022

Contains the following bug fixes:

• Bug fixes for anthropogenic CH4 emissions over US, Canada, and Mexico

For more information, please see:

• geoschem/geos-chem 13.4.1 milestone

GCHP 13.4.0

Release date: 02 May 2022

Updates that will affect full-chemistry benchmark simulations

• Migrate sulfate chemistry into KPP
• Convert the HOCl & HOBr reactions with dissolved SO2 to use gas phase SO2
• Turn off sea salt debromination by default
• Fix bug in Henry law CALC_HEFF routine in hetchem computations
• Bug fix: Remove double-counting of HCl uptake on acidic sea salt
• Update surface resistance for ozone deposition to ice/snow
• Update to HEMCO version 3.4.0
• AEIC 2019 aircraft emissions inventory
• Use degassing-only volcano emissions in GEOS-Chem benchmark simulations
• Fix end year for CEDS_NO_SHIP and MULTISEAICE entries in HEMCO_Config.rc
• Fix parallelization errors in GEOS-Chem Classic and add updates for better numerical stability
• Use updated definition of PM2.5; Add PM10 diagnostic

Updates that will NOT affect full-chemistry benchmark simulations

• Updated Hg chemistry in KPP
  • NOTE: Still undergoing validation, a fix may be issued in a patch version (e.g. 13.4.1)
• Bug fix: Use REAL*8 precision in for CH3O2 + OH reaction definition in fullchem.eqn
• Updated Global Inventory of Methane Emissions from Oil/Gas/Coal (GFEI v2)
• Anthropogenic Methane Emission Inventory for Canada
• Use EDGARv6 global anthro emissions for CH4 simulation
• Updated Rn-222 emissions for TransportTracers simulations
• Retire HEMCO extension for CH4 wetland emissions
• Updates to enable automated run directory creation
• Bug fix: Allow GEOS-Chem Classic History to archive irregular intervals (e.g. a month and a day)
• Updates for running GEOS-Chem within GEOS
• Add CH4 pseudo flux diagnostic
• Add capability to write GEOS-Chem Classic timers to JSON file
• Update tagged Ox simulation to use archived prod/loss rates from GEOS-Chem and retire Linoz
• Apply bug fix for dust aciduptake simulation

Updates that will only affect GCHP

• Add capability to use mass fluxes in advection
• Switch advection to use total pressure (rather than dry)
• Add option for driving GCHP with native GEOS meteorological files
• Add diagnostic for vertical air movement (vertical mass flux)
• Define a GCHP "Default" diagnostic collection that will archive a small number of commonly-requested diagnostic fields
• Add capability to read native meteorological data files
• Fix communicators leak Weiyuan Jiang (GSFC)
• Fix unintuitive error handling when untemplated file is missing
• Fix incorrect output file timestamp with 24-hour duration and 1-hour frequency
• Fix units in FV3 mass flux variable that impacted vertical mass flux diagnostic
• Move call to setup_wetscav to prevent zero C_H2O used in wet scavening in first timestep
  • This removes differences in wet scavenging when breaking up run

For more information, please see:

• Getting Started with GEOS-Chem
  • NOTE: We are in the process of moving the GEOS-Chem Classic manual to https://geos-chem.readthedocs.io
• GCHP manual at ReadTheDocs
• HEMCO manual at ReadTheDocs
• GEOS-Chem 13.4.0 page on the GEOS-Chem wiki