Recent Releases of gchp

gchp - GCHP 14.6.3

Release date: 28 Jul 2025 DOI

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 https://github.com/geoschem/GCHP/pull/499
  • Add -DSANITIZE compiler option to check for memory leaks by @lizziel in https://github.com/geoschem/GCHP/pull/504
  • GCHP 14.6.3 release by @yantosca in https://github.com/geoschem/GCHP/pull/505

Full Changelog: https://github.com/geoschem/GCHP/compare/14.6.2...14.6.3

- Fortran
Published by yantosca 7 months ago

gchp - GCHP 14.6.2

Release date: 12 Jun 2025 DOI

From CHANGELOG.md

Changed

  • Updated GEOS-Chem submodule to 14.6.2

What's Changed

  • GCHP 14.6.2 release by @yantosca in https://github.com/geoschem/GCHP/pull/497

Full Changelog: https://github.com/geoschem/GCHP/compare/14.6.1...14.6.2

- Fortran
Published by yantosca 9 months ago

gchp - GCHP 14.6.1

Release date: 29 May 2025 DOI

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 https://github.com/geoschem/GCHP/pull/495

Full Changelog: https://github.com/geoschem/GCHP/compare/14.6.0...14.6.1

- Fortran
Published by yantosca 9 months ago

gchp - GCHP 14.6.0

Release date: 18 Apr 2025 DOI

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 https://github.com/geoschem/GCHP/pull/471
  • Merge GCHP 14.5.2 into dev/14.6.0 by @yantosca in https://github.com/geoschem/GCHP/pull/475
  • Check if mass flux is top-down and flip accordingly to enable processed mass flux by @yuanjianz in https://github.com/geoschem/GCHP/pull/462
  • GCHP 14.6.0 release by @yantosca in https://github.com/geoschem/GCHP/pull/487

Full Changelog: https://github.com/geoschem/GCHP/compare/14.5.3...14.6.0

- Fortran
Published by yantosca 10 months ago

gchp - GCHP 14.5.3

Release date: 05 March 2025 DOI

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 https://github.com/geoschem/GCHP/pull/480

Full Changelog: https://github.com/geoschem/GCHP/compare/14.5.2...14.5.3

- Fortran
Published by yantosca 12 months ago

gchp - GCHP 14.5.2

From CHANGELOG.md

DOI

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 https://github.com/geoschem/GCHP/pull/469
  • Do not build KPP-Standalone executable unless specifically requested at compile time by @yantosca in https://github.com/geoschem/GCHP/pull/473
  • GCHP 14.5.2 release by @yantosca in https://github.com/geoschem/GCHP/pull/474

Full Changelog: https://github.com/geoschem/GCHP/compare/14.5.1...14.5.2

- Fortran
Published by yantosca about 1 year ago

gchp - GCHP 14.5.1

Release date: 10 Jan 2025 DOI

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 https://github.com/geoschem/GCHP/pull/463
  • Fix GCHPctmEnv small numerical bugs by @yuanjianz in https://github.com/geoschem/GCHP/pull/456
  • Fixed CMake error to prevent KPP standalone being built in carbon sim by @yantosca in https://github.com/geoschem/GCHP/pull/464
  • GCHP 14.5.1 release by @yantosca in https://github.com/geoschem/GCHP/pull/468

New Contributors

  • @yuanjianz made their first contribution in https://github.com/geoschem/GCHP/pull/456

Full Changelog: https://github.com/geoschem/GCHP/compare/14.5.0...14.5.1

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

- Fortran
Published by yantosca about 1 year ago

gchp - GCHP 14.5.0

Release date: 08 Nov 2024 DOI

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 https://github.com/geoschem/GCHP/pull/444
  • ReadTheDocs updates for GCHP 14.5.0 by @yantosca in https://github.com/geoschem/GCHP/pull/448

Full Changelog: https://github.com/geoschem/GCHP/compare/14.4.3...14.5.0

- Fortran
Published by yantosca over 1 year ago

gchp - GCHP 14.4.3

Release Date: 13 Aug 2024 DOI

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: https://github.com/geoschem/GCHP/compare/14.4.2...14.4.3

- Fortran
Published by yantosca over 1 year ago

gchp - GCHP 14.4.2

Release date: 2024-07-24 DOI

From CHANGELOG.md

Changed

  • Updated HEMCO submodule to 3.9.2
  • Updated Cloud-J submodule to 7.7.2
  • Disable support for FAST-JX for all simulations except Hg

Pull Requests Included

  • Add docs geos-chem-input-data-on-aws.rst to supplemental-guides. by @yidant in https://github.com/geoschem/GCHP/pull/425

Full Changelog: https://github.com/geoschem/GCHP/compare/14.4.1...14.4.2

- Fortran
Published by yantosca over 1 year ago

gchp - GCHP 14.4.1

Release date: 28 Jun 2024

CHANGELOG

Fixed

  • Fixed formatting error in .github/workflows/stale.yml that caused the Mark Stale Issues action not to run

Full Changelog: https://github.com/geoschem/GCHP/compare/14.4.0...14.4.1

- Fortran
Published by yantosca over 1 year ago

gchp - GCHP 14.4.0

Release date: 31 May 2024 DOI

Added

  • RTD docs now includes Supplemental Guide "Archiving Output with the History diagnostics"
  • GitHub Action config file .github/workflows/stale.yml, which replaces StaleBot
  • Added git submodule HETP for aerosol thermodynamics in GEOS-Chem

Changed

  • Updated Python package versions for ReadTheDocs in docs/requirements.txt
  • Now request Python 3.12 for ReadTheDocs builds in .readthedocs.yaml
  • Updated GEOS-Chem submodule to 14.4.0
  • Updated HEMCO submodule to 3.9.0
  • Changed subdirectory name HEMCO_GridComp to HEMCO since not its own gridded component
  • Moved HEMCO and Cloud-J submodules from GCHPGridComp to GCHPGridComp/GEOSChem_GridComp where they are used
  • Converted Github issue templates to issue forms using YAML definition files

Removed

  • GitHub config files .github/stale.yml and .github/no-response.yml

Full Changelog: https://github.com/geoschem/GCHP/compare/14.3.0...14.4.0

- Fortran
Published by yantosca over 1 year ago

gchp - GCHP 14.3.1

Release date: 02 Apr 2024 DOI

From CHANGELOG.md

Added

  • Now print container name being read by ExtData when CAP.EXTDATA is set to DEBUG in logging.yml
  • Added new pre-processer setting GCHP_WRAPPER for use in submodules
  • Added PLEadv export to FV3 submodule for inclusion in GCHP HISTORY.rc files

Changed

Fixed

  • Fixed bug where SPHU used to construct PLE for advection was vertically inverted if using raw GMAO meteorology files
  • Fixed bug in UpwardsMassFlux diagnostic that was causing all values to be zero

Pull requests included

  • Fix bug in advection when using raw GMAO meteorology files by @lizziel in https://github.com/geoschem/GCHP/pull/392
  • Now use short submodule names in .gitmodules by @yantosca in https://github.com/geoschem/GCHP/pull/394
  • Add GCHP_WRAPPER cpp definition by @lizziel in https://github.com/geoschem/GCHP/pull/396
  • Expand GCHP advection diagnostics by @lizziel in https://github.com/geoschem/GCHP/pull/395

Full Changelog: https://github.com/geoschem/GCHP/compare/14.3.0...14.3.1

- Fortran
Published by msulprizio almost 2 years ago

gchp - GCHP 14.3.0

Release date: 09 Feb 2024 DOI

From CHANGELOG.md

Added

  • Added capability for TOMAS simulations in GCHP
  • Added Cloud-J as submodule within GCHP_GridComp directory
  • Added compile option FASTJX to use legacy Fast-JX to compute J-values in GEOS-Chem instead of Cloud-J (required for mercury simulation)

Changed

Fixed

  • Avoid semicolon in CMAKE_ Fortran_FLAGS variable when additional flags are passed to cmake
  • Updated debugging guide with clearer examples

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

Pull requests included

  • Implementation of TOMAS in GCHP by @Jourdan-He in https://github.com/geoschem/GCHP/pull/252
  • Add capability for TOMAS simulations in GCHP by @msulprizio in https://github.com/geoschem/GCHP/pull/359
  • Add Cloud-J as submodule to GCHP by @lizziel in https://github.com/geoschem/GCHP/pull/356
  • Avoid a semicolon in CMAKEFortranFLAGS when additional flags are passed to cmake by @branfosj in https://github.com/geoschem/GCHP/pull/334
  • Merge no-diff-to-benchmark updates into the 14.3.0 development stream by @yantosca in https://github.com/geoschem/GCHP/pull/365

New Contributors

  • @branfosj made their first contribution in https://github.com/geoschem/GCHP/pull/334

Full Changelog: https://github.com/geoschem/GCHP/compare/14.2.3...14.3.0

- Fortran
Published by msulprizio about 2 years ago

gchp - GCHP 14.2.3

Release date: 01 Dec 2023 DOI

CHANGELOG

Added

  • Script .release/changeVersionNumbers.sh to change version numbers before a new GCHP release

Full Changelog: https://github.com/geoschem/GCHP/compare/14.2.2...14.2.3

- Fortran
Published by yantosca about 2 years ago

gchp - GCHP 14.2.2

Release date: 23 Oct 2023 DOI

CHANGELOG

Changed

  • Updated GEOS-Chem submodule to 14.2.2

What's Changed

  • Feature/container aws docs by @yidant in https://github.com/geoschem/GCHP/pull/350

Full Changelog: https://github.com/geoschem/GCHP/compare/14.2.1...14.2.2

- Fortran
Published by msulprizio over 2 years ago

gchp - GCHP 14.2.2

Release date: 23 Oct 2023

CHANGELOG

Changed

  • Updated GEOS-Chem submodule to 14.2.2

What's Changed

  • Feature/container aws docs by @yidant in https://github.com/geoschem/GCHP/pull/350

Full Changelog: https://github.com/geoschem/GCHP/compare/14.2.1...14.2.2

- Fortran
Published by msulprizio over 2 years ago

gchp - GCHP 14.2.1

Release Date: 10 Oct 2023 DOI

CHANGELOG

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

Full Changelog: https://github.com/geoschem/GCHP/compare/14.2.0...14.2.1

- Fortran
Published by yantosca over 2 years ago

gchp - GCHP 14.2.0

Release date: 05 Oct 2023 DOI

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 https://github.com/geoschem/GCHP/pull/293
  • Fix several problems with Github template issues by @yantosca in https://github.com/geoschem/GCHP/pull/297
  • Make FindESMF.cmake use consistent libs by @sdeastham in https://github.com/geoschem/GCHP/pull/309
  • Add submodule update issue template by @lizziel in https://github.com/geoschem/GCHP/pull/307
  • Fix error in pressure level edge construction by @sdeastham in https://github.com/geoschem/GCHP/pull/312
  • Add run-time options for dry pressure and moisture-corrected mass fluxes in advection by @lizziel in https://github.com/geoschem/GCHP/pull/317
  • Feature/update docs by @yidant in https://github.com/geoschem/GCHP/pull/336

New Contributors

  • @yidant made their first contribution in https://github.com/geoschem/GCHP/pull/336

Full Changelog: https://github.com/geoschem/GCHP/compare/14.1.0...14.2.0

- Fortran
Published by msulprizio over 2 years ago

gchp - GCHP 14.1.1

Release date: 03 Mar 2023 DOI

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: https://github.com/geoschem/GCHP/compare/14.1.0...14.1.1

- Fortran
Published by yantosca almost 3 years ago

gchp - GCHP 14.1.0

Release date: 01 Feb 2023 DOI

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 https://github.com/geoschem/GCHP/pull/280
  • Add carbon simulation and KPP mechanism by @msulprizio in https://github.com/geoschem/GCHP/pull/283

Full Changelog: https://github.com/geoschem/GCHP/compare/14.0.2...14.1.0

- Fortran
Published by msulprizio about 3 years ago

gchp - GCHP 14.0.2

Release date: 29 Nov 2022

DOI

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

From CHANGELOG.md

Changed

Full Changelog: https://github.com/geoschem/GCHP/compare/14.0.1...14.0.2

- Fortran
Published by msulprizio about 3 years ago

gchp - GCHP 14.0.1

Release date: 31 Oct 2022

DOI

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

From CHANGELOG.md

Changed

- Fortran
Published by msulprizio over 3 years ago

gchp - GCHP 14.0.0

Release date: 25 Oct 2022

DOI

This is a major version release featuring the following updates:

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/GCHPGridComp/GEOSChemGridComp/geos-chem/CHANGELOG.md - src/GCHPGridComp/HEMCOGridComp/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 CMAKEBUILDTYPE options for intel and gfortran compilers

What's Changed

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

Full Changelog: https://github.com/geoschem/GCHP/compare/13.4.1...14.0.0

- Fortran
Published by msulprizio over 3 years ago

gchp - GCHP 14.0.0-rc.0

Release date: 03 Jun 2022 DOI

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 MMRComputeFlux
  • Add bug fix in HEMCO MEGAN extension

For more information, please see:

- Fortran
Published by msulprizio over 3 years ago

gchp - GCHP 13.4.1

Release date: 19 May 2022 DOI

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

- Fortran
Published by msulprizio almost 4 years ago

gchp - GCHP 13.4.0

Release date: 02 May 2022 DOI

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 CEDSNOSHIP 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 setupwetscav to prevent zero CH2O used in wet scavening in first timestep
    • This removes differences in wet scavenging when breaking up run

For more information, please see:

- Fortran
Published by yantosca almost 4 years ago

gchp - GCHP 13.3.4

Release date: 07 Dec 2021 DOI

Contains the following bug fixes (affecting GEOS-Chem Classic only) - Bug fix: Now correctly check GEOS-Chem Classic History diagnostic subset indices
- Fix incorrect restart file path in dry-run configuration file download_data.yml

For more information, please see: - geoschem/geos-chem 13.3.4 milestone

- Fortran
Published by yantosca about 4 years ago

gchp - GCHP 13.3.3

Release date: 02 Dec 2021 DOI

Contains the following updates: - Upgrade to HEMCO version 3.2.2, which includes the following bug fixes: - Restore updating of manual HEMCO diagnostics, which had been clobbered due to a prior Git merge - NOTE: This affects only the CH4, Hg, and TOMAS simulations

For more information, please see: - geoschem/HEMCO 3.2.2 milestone

- Fortran
Published by yantosca about 4 years ago

gchp - GCHP 13.3.2

Release date: 18 Nov 2021 DOI

Contains the following updates: - Fix outdated path in GCHP fullchem config file ExtData.rc

Please see the following pages for details on these updates: - 13.3.2 wiki page - 13.3.2 Github milestone for geoschem/geos-chem

- Fortran
Published by yantosca over 4 years ago

gchp - GCHP 13.3.1

Release date: 15 Nov 2021

Contains fixes for minor issues that were discovered during the 13.3.0 benchmarking process: - Diagnostic fixes: - Fix incorrect units in ProdLoss diagnostic output - Bug fix: Remove second underscore from StateChm Hg simulation fields - Remove duplicate unit conversion from kg/kg dry to v/v dry in planeflightmod.F90 - Now allow GEOS-Chem Classic History collection names to contain an underscore - Other updates and fixes: - Stop gracefully if the chemical solver fails to converge to a solution twice in a row - Also print out concentrations and reaction rates at the affected grid box, which can aid in debugging the problem - Fix call to timers in fullchemmod.F90 - Use default timesteps (transport=600s, chemistry=1200s) for nested-grid simulations using 0.5° x 0.625° grids
- EXCEPTION: CH4 simulations at 0.5° x 0.625° will still use transport=300s, chemistry=600s timesteps - Fix incorrect file path in TOMAS routine YuIMN
Code.F90 - GCHP updates and fixes: - Fix incorrect file timestamp with freq=1hr and duration=24hr - The cleanRunDir.sh script now removes additional log files produced by GCHP

Please see the following pages for details on these updates: - 13.3.1 wiki page - 13.3.1 Github milestone for geoschem/geos-chem - 13.3.1 Github milestone for geoschem/GCHP - 3.2.1 Github milestone for geoschem/HEMCO

- Fortran
Published by yantosca over 4 years ago

gchp - GCHP 13.3.0

Release Date: 15 Nov 2021

GCHP 13.3.0 contains the following updates: - Gas-phase chemistry updates: - Addition of aromatic VOC chemistry - Addition of C2H2 and C2H4 chemistry - Addition of CH3O2 + OH reaction
- Addition of HMS chemistry - Heterogenous chemistry updates: - Cleaning up hetchem reaction rate computations for clarity and efficiency - Updates to IONO2 hydrolysis reaction following Wang et al. (2021) - Revise gamma(N2O5) computation; cap A at 3.2e-8 - Fixed typo in routine CloudHet - Fixed typos in ClNO2 hetchem reactions: HNO2 should be a product, not HNO3 - Add better error trap criteria to prevent reaction rate computations from blowing up - Emissions updates: - Add option to use NEI2016 emissions over the US (turned off by default) - Avoid double counting of acetone source from monoterpenes when using online MEGAN - Update volcano emissions to May 2020 and add climatology - Updated offline dust emissions from Meng et al. (2021) - NOTE: benchmark simulations use online dust emissions instead - Send all HEMCO error messages to GEOS-Chem log - Other updates: - Updated aerosol dry deposition - The ObsPack diagnostic can now use the ?ADV? Wildcard - Features only affecting GCHP: - Include thread number in GEOS-Chem and HEMCO error messages
- GCHP Adjoint updates

Please see the following pages for details on these updates, including benchmarks: - 13.3.0 wiki page - 13.1.0 Github milestone for geoschem/geos-chem - 13.1.0 Github milestone for geoschem/GCHP - 3.2.0 Github milestone for geoschem/HEMCO

- Fortran
Published by yantosca over 4 years ago

gchp - GCHP 13.2.1

Release date: 10 Sep 2021 DOI

This release fixes the following issue identified since 13.2.0:

  • Retire tropchem simulation as an option
  • Bug fix for JvalO3O1D and JValO3O3P diagnostics
  • Bug fixes for the planeflight diagnostic
  • Several bug fixes for nested-grid simulations
  • Several bug fixes for Hg simulations
  • Add WashU data server to GCHP data download script
  • Update the download_data.py script to read global settings from a YAML file
  • Bug fix for better error messages if GCHP throws an error during set up
  • Minor GCHP run directory updates

Please see the following links for more information on this version.

- Fortran
Published by msulprizio over 4 years ago

gchp - GCHP 13.2.0

Release date: 07 Sep 2021 DOI

This is the release for GCHP 13.2.0. Major updates since 13.1.2 include:

  • CEDS v2 emissions through 2019
  • Updated Yuan/BNU MODIS LAI product (2000-2019)
  • Improved wet scavenging from Luo et al. (2020) (as option)
  • Blowing snow emissions of sea salt and sea salt bromide
  • Trace metal simulation
  • Set lev positive 'up' for all diagnostic files except Emission
  • Update MAPL to prevent minimum CMake version 3.14
  • Updates to GCHP sample run scripts including multi-run bug fix

Please see the following links for more information on this version.

Overview

Documentation

- Fortran
Published by msulprizio over 4 years ago

gchp - GCHP 13.1.2

Release date: 06 Jul 2021 DOI

Features: 1. Zero-diff updates required for CESM2-GC 2. Updated the download_data.py script to fetch GCAP2 met fields from U. Rochester server 3. Added .zenodo.json for auto-filling DOI fields

For more info: - GEOS-Chem 13.1.2 wiki page - 13.1.2 milestone for geoschem/geos-chem

- Fortran
Published by yantosca over 4 years ago

gchp - GCHP 13.1.1

Release date: 22 Jun 2021 DOI

This release fixes the following issue identified since 13.1.0:

  • Fix for PM2.5 diagnostic
  • Updates for compatibility of GEOS-Chem in GEOS
  • Expand support for GNU Fortran compilers to include version 10
  • Fix bug in regex used for linking to ESMF

Please see the following links for more information on this version.

- Fortran
Published by msulprizio over 4 years ago

gchp - GCHP 13.1.0

GCHP 13.1.0 17 Jun 2021 DOI

This is the official release for GCHP 13.1.0. Major updates since 13.0.2 include:

  • Vertical allocation of CEDS energy and industry emissions
  • Diurnal scale factors of power plane emissions in Chine
  • Fix for H2O boundary conditions at the tropopause
  • Updates to speed up the chemical solver
  • Support for GCAP 2.0
  • Updated CH4 emissions
  • Bug fix for nested grid simulations to read boundary conditions continuously
  • Update GMAO submodules in GCHP
  • Use logging.yml for MAPL ExtData debug prnits
  • Monthly diagnostic capability in GCHP

Please see the following links for more information on this version.

Overview

Documentation

- Fortran
Published by msulprizio over 4 years ago

gchp - GCHP 13.0.2

GCHP 13.0.2 12 Apr 2021 DOI

This patch version of GEOS-Chem fixes the following issues discovered since 13.0.1:

  • Met fields were only being read in once at the start of the simulation
    • As was originally reported in Issue https://github.com/geoschem/geos-chem/issues/686

See the 13.0.2 milestone for details.

- Fortran
Published by yantosca almost 5 years ago

gchp - GCHP 13.0.1

GCHP 13.0.1 23 Mar 2021 DOI

This release fixes the following issue identified since 13.0.0:

  • Updated Sphinx documentation
  • Use online dust emissions (DustDead) by default
  • Add several fixes for the GEOS-Chem Classic dry-run option
  • Force GEOS-Chem Classic restart file to match simulation date
  • Avoid "IsGas and IsAerosol are both false" error when adding new P/L species in KPP
  • Fix MAXRO2 in planeflight diagnostic

- Fortran
Published by msulprizio almost 5 years ago

gchp - GCHP 13.0.0

GCHP 13.0.0 18 Mar 2021 DOI

This is the official release for GCHP 13.0.0. Please see the following links for more information on this version.

Overview

Documentation

- Fortran
Published by msulprizio almost 5 years ago

gchp - GCHP 13.0.0-rc.2

GCHP 13.0.0-rc.2 17 Mar 2021 DOI

This release candidate fixes the following issue identified since 13.0.0-rc.1:

  • Expand run script samples
  • Add listInputDataFiles output
  • Make OMP=off the default for Intel and GNU compilers
  • Updates ESMA_make for ESMF build with 3rd party
  • Add support for ESMF build with 3rd party support
  • Fix several issues in specialty simulations identified by integration tests
  • Use output from 10-year full-chemistry benchmark for specialty simulations and full-chemistry restart files
  • Add stale bot and no-response bots

- Fortran
Published by msulprizio almost 5 years ago

gchp - GCHP 13.0.0-rc.1

GCHP 13.0.0-rc.1 13 Jan 2021

This release candidate fixes the following issue identified since 13.0.0-rc.1:

  • Update issues template

- Fortran
Published by msulprizio almost 5 years ago

gchp - GCHP 13.0.0-rc.0

GCHP 13.0.0-rc.0 08 Jan 2021 DOI

This is the first release candidate for GCHP 13.0.0. Major updates since GCHP 12.9.0 include.

  • This repository replaces the older GCHP legacy repository and contains the following changes:
    • NASA-maintained libraries are now submodules
    • GEOS-Chem and HEMCO codes have been split into separate submodules
    • ESMF is now an external dependency
    • A stretched-grid option has been introduced
  • MERRA-2 is the recommended meteorology field over GEOS-FP
  • CMake is the default build system; Support for GNU Make has been retired
  • Carbon based units for VOC species have been removed
  • CEDS GDB-MAPS is now the default anthropogenic emissions inventory
  • The "tropchem" chemistry mechanism has been retired
  • Several issues with the RRTMG diagnostics have been resolved

Please see the following links for more information on this version.

Overview

Documentation

- Fortran
Published by msulprizio about 5 years ago

gchp - GCHP 13.0.0-beta.2

This version includes the following updates since GCHP 13.0.0-beta.1. A ten-year full-chemistry benchmark was performed with this version. See the GEOS-Chem 13.0.0 wiki page for more details.

Structural updates: - Update GEOS-Chem and HEMCO documentation - Use all species in tagO3 simulations by default

Bug fixes: - Add fixes to restore HEMCO standalone simulations - Do not compress scalar variables in netCDF files

- Fortran
Published by msulprizio about 5 years ago

gchp - GCHP 13.0.0-beta.1

This version includes the following updates since GCHP 13.0.0-beta.0. One-year full-chemistry and transport tracer benchmarks were performed with this version. See the GEOS-Chem 13.0.0 wiki page for more details.

Structural updates: - Add integration testing for GEOS-Chem Classic and GCHP

Science updates: - Add CLOCK tracer for diagnosing age of air

Bug fixes: - Add several bug fixes that were identified by GEOS-Chem integration tests

- Fortran
Published by msulprizio about 5 years ago

gchp - GCHP 13.0.0-beta.0

Updates added since 13.0.0-alpha.11:

  • Rename GCHP executable from geos to gchp
  • Update OpenMP defaults: enable if using Intel compiler and disable if using gfortran compiler. Previously OpenMP was always enabled.
  • Make installation of multiple run directories at once possible
  • Update gfortran compiler flags to enable gfortran Debug mode build of GCHP
  • Add Isorropia variables stored in State_Chm to GCHP internal state for use in heterogeneous chemistry upon restart
  • Upgrade to latest GEOS-Chem dev 13.0.0:
    • Use CEDS total emissions rather than by fuel type by default
    • Bug fix in statemetmod variable initialization
    • Rename Isorropia SAV variables in State_Chm
    • Fix bug in DryDepMix diagnostic if using full-PBL mixing scheme
    • Updates for removing carbon units
    • Fix bug where State_Met%FRCLND (fraction land) now set to Olson not met import (caused single- vs multi-run diffs)
  • Upgrade to latest HEMCO dev 3.0.0:
    • Fix bug in xyL option
    • Remove unnecessary Interfaces/GCHPctm directory and HCOIGCHP library; link instead to HCOIMAPL_ESMF
    • Add initial Sphinx file for ReadTheDocs documentation
    • Updates for removing carbon units
    • Allow HEMCO compiler flags to be set within super-project outside of HEMCO
    • Fix bug in lightning NOx extension diagnostics that prevented GCHP output for those HEMCO diagnostics
    • Fix bug where Be7Strat and Be10Strat emissions not forced to zero below tropopause level (caused single- vs multi-run diffs)

- Fortran
Published by msulprizio over 5 years ago

gchp - 13.0.0-alpha.11

  • Add geos-chem-shared-docs as submodule
  • Initialize sphinx project for GCHPctm documentation
  • Upgrade to latest GEOS-Chem dev 13.0.0:
    • Reduction of diagnostic memory
    • Consolidation of KPP mechanisms; Standard is now fullchem
    • New CEDS inventory
    • Fix RRTMG run-time error when using Intel compiler
    • Automatically use o-server for writing restart files if using >1000 cores to avoid run hang with OpenMPI
    • Updates for compatibility with GEOS and CESM
  • Upgrade to latest HEMCO dev 3.0.0:
    • Fix bug in transport tracer simulation that caused that simulation to crash in 13.0.0-alpha.10

- Fortran
Published by lizziel over 5 years ago

gchp - 13.0.0-alpha.10

  • Enable running RRTMG in GCHP with full set of netCDF diagnostics and dedicated run directory
  • Allow using debug flags with Intel compilers (-DCMAKEBUILDTYPE=debug)
  • Upgrade GEOS-Chem to dev 13.0.0 just prior to reduction of diagnostic memory branch merge
  • Upgrade to latest HEMCO dev 3.0.0
  • Add GitHub issue and pull request templates

NOTES: 1. RRTMG in GCHP currently has a bug when using Intel compilers. Use GCC instead with RRTMG in this version. 2. Build with -DRRTMG=y in GCHP RRTMG run directories

- Fortran
Published by lizziel over 5 years ago

gchp - 13.0.0-alpha.9

  • Enable RRTMG build option
  • Upgrade to GEOS-Chem 12.9.1
  • Revert FMS to geos/orphan/v1.0.3 to avoid gfortran build issues
  • Fix bug when building with ifort19
  • Update continuous integration pipeline files
  • Update README
  • Use latest HEMCO 3.0.0 dev updates

- Fortran
Published by lizziel over 5 years ago

gchp - 13.0.0-alpha.8

This alpha version features upgraded versions of most submodules: - GEOS-Chem 12.9.0 (GCC 1-month benchmark approved version) - MAPL v2.2.7 - ecbuild v1.0.5 - ESMAcmake v3.0.6 - GMAOShared v1.1.6 - FMS tag geos/2019.01.02 - GFDLatmoscubedsphere (fvdycore directory) geos/v1.1.2 - FVdycoreCubedGridComp v1.1.3 - gFTL-shared v1.0.7 - gFTL branch major-refactor commit a8e72c42, off of v1.2.5 - yaFyaml v0.4.0 - pFlogger v1.4.2 - pFUnit v4.1.9 (not yet built or used)

A draft CHANGELOG.md file is now included at the highest level in GCHPctm. The format is based on Keep a Changelog.

- Fortran
Published by lizziel over 5 years ago

gchp - 13.0.0-alpha.7

This version updates GEOS-Chem to 12.9.0.

Changes: -Update GEOS-Chem to 12.9.0 -Update HEMCO version for compatibility with GEOS-Chem

Additions: -Add pFUnit v4.1.9 (not yet used)

- Fortran
Published by lizziel over 5 years ago

gchp - 13.0.0-alpha.6

This version updates GMAO submodules to more recent upstream versions used in Baselibs 6.0.3.

Changes: -Update MAPL to v2.1.5 -Update ESMA_cmake to v3.0.6 -Update ecbuild to v1.0.5 -Update gFTL-shared to v1.0.7 -Update gFTL to v1.2.5

Additions: -Add yaFyaml v0.3.3 -Add pFlogger v1.4.2

- Fortran
Published by lizziel over 5 years ago

gchp - 13.0.0-alpha.5

-Update GEOS-Chem submodule for 12.9.0-alpha.1 (pre-halogen updates) -Update HEMCO submodule to latest updates in dev/GC_13.0.0 -README updates -Input vector rather than lat/lon winds

- Fortran
Published by lizziel over 5 years ago

gchp - 13.0.0-alpha.4

-Use new geoschem/HEMCO repository rather than GEOS-Chem HEMCO subdirectory -Update GEOS-Chem to 12.8.0 -Add troposphere-only mass scaling and optional PLE output to fvdycore -Apply MAPL quick fix to avoid run-time bug with gfortran in MAPL_TrimString -Fix MAPL bug causing vector regridding to crash

- Fortran
Published by lizziel almost 6 years ago

gchp - 13.0.0-alpha.3

-Update GEOS-Chem to version 12.7.2 -Update MAPL to version 2.0.2 -Add GMAO MAPL update to read cubed-sphere data -Use GEOS-Chem cpp switches MODELGCHP and MODELGCHPCTM

- Fortran
Published by lizziel almost 6 years ago

gchp - 13.0.0-alpha.2

-Move and rename several submodules -Purge term GIGC from files and directory names -MAPL update to include missing stretched grid support -update GEOS-Chem to 12.7.1 release -fix gfortran bug in MAPL -expand ExtData prints

- Fortran
Published by lizziel almost 6 years ago

gchp - 13.0.0-alpha.1

- Fortran
Published by LiamBindle about 6 years ago

gchp - 13.0.0-alpha.0

Alpha testing

Simulations that ran to completion

| Duration | Resolution | Chemistry | Met | Tested on | Notes | |:---|:---|:---:|:---:|:---:|:---| | 1hr | c24 | Standard | GEOSFP | 3 | | | 1hr, 1d | c24 | Standard | GEOSFP | 2 | | | 1mo | c24, c48 | Transport T. | GEOSFP | 1 | | | 1hr | c24 | Transport T. | GEOSFP | 3 | | | 1hr | c24 | Transport T. | GEOSFP | 4 | | | 1mo | c48 | Benchmark | GEOSFP | 5 | - 96 cores / 3 nodes
- Max memory (1-node): 229 GB
- Wall time: 6.7 hours
- CPU time: 8.7 core-days
- Start/end mem (GB): 92.7/99.9 |

Other tests

Stretched-grid simulations that ran to completion.

| Duration | Resolution | Chemistry | Met | Tested on | Notes | |:---|:---|:---:|:---:|:---:|:---| | 7d, 1mo | c24, c48 | Transport T. | GEOS_FP | 1 | - Multiple stretch factors
- Multiple target lat/lons |

Sanity check that winds are oriented correctly. Now that automatic restaggering/reorienting was removed from ExtData in MAPL 2.0 we have to call A2D2C explicitly. This test checked that explicitly calling A2D2C restaggered and reoriented wind fields appropriately.

| Duration | Resolution | Chemistry | Met | Tested on | Notes | |:---|:---|:---:|:---:|:---:|:---| | 2d | c48 | Transport T. | GEOS_FP | 1 | - Advection only
- Prescribed eastward winds
- Custom restart file |

Testing platforms

| ID | Cluster | Compiler | MPI | OS | Who | |:---:|:---|:---|:---|:---|:---| | 1 | Stetson (Dalhousie) | GCC 7.4 | OpenMPI 3.1.4 | CentOS 7 | Liam Bindle | | 2 | Compute1 (WashU) | Intel 19.0.5 | Intel MPI 19.0.5 |CentOS 7 | Liam Bindle | | 3 | Cannon (Harvard) | Intel 17.0.4 | OpenMPI 3.1.1 | CentOS 7 | Lizzie Lundgren | | 4 | Cannon (Harvard) | GCC 8.2.0 | OpenMPI 3.1.1 | CentOS 7 | Lizzie Lundgren | | 5 | Compute1 (WashU) | GCC 8.3 | OpenMPI 3.1.4 | CentOS 7 | Liam Bindle |

- Fortran
Published by LiamBindle about 6 years ago