HEMCO 3.12.0

Release date: 06 Feb 2026

From CHANGELOG.md

Added

• Added the functionality of selectively applying gridded scaling factor based on the value of mask ID from a gridded file
• Added functions HCO_WordWrapPrint and HCO_CountMatches as PRIVATE routines to hco_error_mod.F90
• Added function IO_ErrMsg to hcoio_read_std_mod.F90 to generate a replacement error message for the "cannot find field for current simulation time" message
• Added GNU compiler collection version 15 to the GitHub action that builds HEMCO on MacOS
• Added DustL23M extension module src/Extensions/hcox_dustl23m_mod.F90
• Added call to HCO_SetPBLm in routine HCOI_SA_RUN so that the PBL height will evolve with time in the HEMCO standalone
• Added ExtState%TSKIN for skin temperature and ExtState%HFLUX for sensible heat flux
• Added run/config_for_offline_emissions folder to contain sample HEMCO_Config.rc files
• Added do_sum argument to routine Collapse insrc/Core/hco_interp_mod.F90
• Added docs/read_the_docs_environment.yml Conda environment file

Changed

• Updated lint-ci-workflows to run on main and dev/* branches
• Updated badges on README.md and docs/source/index.rst
• Updated GitHub Actions to run if the branch name matches dev, dev/**, release, release/**
• Rewrote "cannot find field for current simulation time" error message for clarity
• Updated HCO_Error and HCO_Warning to call HCO_WordWrapPrint to wrap messages to 78 characters wide
• Replaced terse error messages in hcoio_read_std_mod.F90 with more descriptive ones
• Updated error messages in routine ExtStateInit to be more descriptive
• Renamed ExtState%SNOWHGT to ExtState%SNOMAS
• Changed call to ExtDat_Set for ExtData%SNOMAS to read data from the GMAO SNOMAS field instead of SNOWHGT
• Updated run/HEMCO_sa_Spec.rc to be consistent with the new dust species
• Updated run/createRunDir.sh to copy thecleanRunDir.sh script to the run directory
• Updated comment headers and removed GCHP-specific text in run/cleanRunDir.sh
• Replaced DST{1..4} with DSTbin{1..7} and renumbered lines accordingly in run/HEMCO_sa_Spec.rc
• Updated link to current HEMCO Standalone documentation in run/README
• Updated ReadTheDocs documentation for the addition of DustL23M and removal of DustDead and DustGinoux` extensions
• Updated geos-chem-shared-docs/editing_these_docs.rst with instructions for using a Conda environment to build RTD doc

Fixed

• Fixed security issues in GitHub Actions
• Fixed bug in routine Register_Species caused by a null string being passed to HCO_Msg
• Fixed bug in hco_interp_mod.F90 where Met_DELPDRY was being averaged in the vertical instead of summed

Removed

• Removed Microsoft Azure Dev Pipeline continuous integration tests
• Removed GNU Compiler Collection version 12 from the GitHub action that builds HEMCO on MacOS
• Removed ExtState%PBLH (and code that referenced this), as PBL height may be obtained from HcoState%Grid%PBLHEIGHT.
• Removed DustDead source code (src/Extensions/hcox_dustdead_mod.F)
• Removed DustGinoux source code (src/Extensions/hcox_dustginoux_mod.F90)

Pull requests included

• Add "Lint" GitHub action to check for errors in other actions by @yantosca in #339
• Add capability of selecting gridded scaling factors based on mask ID (needed for IMI with GCHP) by @1Dandan in #330
• Rewrite the "cannot find field for current simulation time" error with specific instructions for the user to take by @yantosca in #345
• Replace gcc 12 with gcc 15 in the GitHub action that builds HEMCO on MacOS by @yantosca in #346
• Merge PR #312 (7 dust bins in HEMCO) up to 3.12.0 and add necessary fixes/updates by @yantosca in #336
• Now sum DELPDRY in the vertical instead of averaging it when regridding from 72 -> 47 layers by @yantosca in #349
• HEMCO 3.12.0 release by @yantosca in #351

New Contributors

• @1Dandan made their first contribution in #330

Full Changelog: 3.11.2...3.12.0

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

HEMCO 3.11.2

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

HEMCO 3.11.1

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

HEMCO 3.11.0

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

HEMCO 3.10.3

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

HEMCO 3.10.2

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

HEMCO 3.10.1

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

HEMCO 3.10.0

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

HEMCO 3.9.3

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

HEMCO 3.9.2

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