Release date: 28 Jul 2025

From CHANGELOG.md

Changed

• Increase string length for reading lines from HEMCO standalone grid file for 0.125x0.15625 global resolution
• Bumped jinja2==3.1.5 to jinja2==3.1.6 in docs/requirements.txt to fix a security issue
• Updated ReadTheDocs documentation to state that we are using Spack v0.23.1 in the Spack installation guide
• Updated the ReadTheDocs "Known Bugs" page to include links to open and resolved issues

Fixed

• Fixed print in adjoint subroutine for getting current emissions

Pull requests included

• Fix print in adjoint code for getting current emissions by @lizziel in #332
• Increase string length for reading lines from HEMCO standalone grid file by @msulprizio in #335
• HEMCO 3.11.2 release by @yantosca in #338

Full Changelog: 3.11.1...3.11.2

Release Date: 29 May 2025

From CHANGELOG.md

Added

• Added option to enable InvMEGAN manual diagnostic output
• Added supplemental guide documentation updates in the geos-chem-shared-docs submodule
• Added Lons and Lats to FileData type to store bounds of mask files
• Added definition of 0.125x0.15625 grid resolution

Changed

• Use USTAR from meteorology instead of calculating from reference 10m wind in DustDead extension

Pull requests included

• Option to (re-)enable manual InvMEGAN diagnostics. by @drnimbusrain in #325
• HEMCO 3.11.1 release by @yantosca in #327

New Contributors

• @drnimbusrain made their first contribution in #325

Full Changelog: 3.11.0...3.11.1

Release date: 18 Apr 2025

From CHANGELOG.md

Added

• Added Lons and Lats to FileData type to store bounds of mask files
• Added definition of 0.125x0.15625 grid resolution

Changed

• Use USTAR from meteorology instead of calculating from reference 10m wind in DustDead extension

Fixed

• Fixed improper handling of mask files by removing code that overwrote mask file years and months with lat/lon values and later hardcoded year and month values to -999

Pull requests included

• Use USTAR read from GEOS instead of calculating from U10M and V10M by @yuanjianz in #279
• Merge updates from HEMCO 3.10.2 into dev/3.11.0 by @yantosca in #309
• Fix improper handling of date timestamps and lat/lon bounds for mask files by @msulprizio in #311
• Bring updates from HEMCO 3.10.3 into the dev/3.11.0 branch by @yantosca in #319
• Add capability to run HEMCO at 0.125x0.15625 resolution by @msulprizio in #290
• Release/3.11.0 by @yantosca in #322

New Contributors

• @yuanjianz made their first contribution in #279

Full Changelog: 3.10.3...3.11.0

Release date: 25 Mar 2025

From CHANGELOG.md

Added

• Added commented out debug print options useful for debugging HEMCO in MPI models

Fixed

• Fixed bug setting destination grid object sigma vector passed to MESSy for vertical regridding
• Updated README to fix display of workflow badges

Pull Requests Included

• Fix bug setting destination grid object sigma vector passed to MESSy by @lizziel in #314
• allowing workflow badges to show by @K20shores in #316
• Add commented out debug code useful for MPI debugging by @lizziel in #317
• HEMCO release 3.10.3 by @lizziel in #318

Full Changelog: 3.10.2...3.10.3

Release date: 04 Mar 2025

From CHANGELOG.md

Added

• Added .zenodo.json for auto-DOI generation upon version releases
• Added GitHub Actions tests to build and test HEMCO on Windows, macOS, and Ubuntu automatically with each submitted PR

Changed

• Bumped jinja2 to version 3.1.5 in docs/requirements.txt to fix a security issue
• Turned off map_a2a pole averaging when using CESM to avoid core-dependency in 2D emissions
• Updated ReadTheDocs documentation for AWS CLI

Fixed

• Updated several prints to limit to root thread to reduce log redundancy when using MPI

Pull requests included

• Added .zenodo.json file and updated jinja2 to 3.1.5 (security fix) by @yantosca in #304
• Add CI builds for macOS, Windows, and Ubuntu by @K20shores in #299
• Turn off map_a2a pole-averaging when using CESM by @lizziel in #306
• HEMCO release 3.10.2 by @yantosca in #308

New Contributors

• @K20shores made their first contribution in #299

Full Changelog: 3.10.1...3.10.2

Release date: 10 Jan 2025

From CHANGELOG.md

Added

• Added optional LUN argument to ConfigInit to allow external models to pass LUN of existing log file
• Added two log LUN variables (stdLogLUN and hcoLogLUN) to HcoState%Config for stdout and HEMCO log and initialize both in ConfigInit to stdout or optional LUN (if passed)
• Added output argument LUN to HCO_LOGFILE_OPEN to update HcoState%Config%hcoLogLun to LUN of new log (if using)
• Added optional LUN argument to HCO_MSG, HCO_WARNING, and HCO_ERROR to specify log to print to
• Added special log handling for CESM to ignore LogFile entry in HEMCO_Config.rc (will get passed CAM log LUN to use instead)

Changed

• Changed interfaces HCO_MSG, HCO_WARNING, and HCO_ERROR to each be a single subroutine that does not use HcoState%Config%Err
• Changed HCO_MSG, HCO_WARNING, and HCO_ERROR to be independent of verbose and cores
• Updated calls to HCO_MSG to send output to HcoState%Config%hcoLogLUN
• Updated calls to HCO_WARNING to print to stdout unless related to units
• Replaced usage of HCO_IsVerb with HcoState_Config%doVerbose
• Changed documentation in HCO_Error_Mod.F90 to summarize error and log handling in HEMCO
• Updated ReadTheDocs "Understand what error messages mean" supplemental guide

Fixed

• Fixed excessive prints when using MPI
• Fixed F77 formating in hcox_dustdead_mod.F

Removed

• Removed warnings count in HcoState%Config%Err
• Removed RC argument in HCO_WARNING
• Deleted subroutine HCO_IsVerb
• Remove print of HcoDiagn%MassScal since never set in the model
• Added ReadTheDocs documentation for the HEMCO LogFile setting

Pull requests included

• Remove excessive prints when using MPI by @lizziel in #296
• Improve log flexibility in HEMCO by @lizziel in #298
• Fixes to build and run in GEOS by @lizziel in #300
• HEMCO release 3.10.1 by @yantosca in #302

Full Changelog: 3.10.0...3.10.1

Release date: 08 Nov 2024

From CHANGELOG.md

Added

• Added TSOIL1 field to ExtState
• Added download_data.py and download_data.yml to the run folder. These will be copied into HEMCO standalone rundirs
• Added run/cleanRunDir.sh script to remove old output files & log files
• Added documentation for the HEMCO 3.10.0 release, including HEMCO standalone dry-run documentation

Changed

• Added emission factors for ALK6, C4H6, EBZ, STYR, TMB for GFED and FINN biomass burning extensions
• Updated soil NOx extention to include the option to use soil temperature and parameterization based on Yi Wang et al. (ERL, 2021) instead of the temperature at 2 meters.
• Updated HEMCO standalone to print the dry-run header to the HEMCO log file unit HcoState%Config%Err%Lun only if the file is opened
• ReadTheDocs update: Now use GNU 12.2.0 compilers in environment file examples
• Updated runHEMCO.sh standalone script: Change partitions, and pipe output to log file

Fixed

• Fixed formatting error in .github/workflows/stale.yml that caused the Mark Stale Issues action not to run
• Updated to jinja2==3.1.4 in docs/requirements.txt (fixes a security issue)

Removed

• Example "Scale (or zero) emissions with a rectangular mask" from ReadTheDocs. This is currently not working.

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

Pull requests included

• Fix inconsistent pressure units in HEMCO standalone by @yantosca in #284
• Add emission factors for ALK6, C4H6, EBZ, STYR, TMB emissions in GFED and FINN biomass burning by @yantosca in #285
• Updated soil NOx scheme from Yi Wang et al. (2021) as an option by @msulprizio in #287
• Bugfix: Restore stale workflow functionality by @msulprizio in #289
• Add HEMCO-standalone dry-run data download scripts by @yantosca in #295
• ReadTheDocs updates for HEMCO 3.10.0 by @yantosca in #292

Full Changelog: 3.9.3...3.10.0

Release date: 13 Aug 2024

CHANGELOG

Fixed

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

Pull requests included

• None

Full Changelog: 3.9.2...3.9.3

Release date: 2024-07-24

From CHANGELOG.md

Changed

• RTD updates: Converted several :option: tags to subsections and updated references accordingly

Fixed

• Typos in RTD doc file docs/source/hco_ref_guide/hemco-config.rst

Removed

• Manual InvMEGAN diagnostics from src/Extensions/hcox_megan_mod.F90; Activate these with HEMCO_Diagn.rc instead

Pull Requests Included

• Remove InvMEGAN manual diagnostics from hcox_megan_mod.F90 by @yantosca in #282

Full Changelog: 3.9.1...3.9.2

Release date: 28 Jun 2024

From CHANGELOG.md

Fixed

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

Pull Requests Included

• Now use comma-separated list for exempt-issue-labels YAML tag in stale.yml by @yantosca in #280

Full Changelog: 3.9.0...3.9.1