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

HEMCO 3.9.1

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

HEMCO 3.9.0

Release Date: 30 May 2024

From CHANGELOG.md

Added

• GitHub Action config file .github/workflows/stale.yml, which replaces StaleBot

Changed

• Converted Github issue templates into issue forms using YAML definition files
• Updated Python package versions for ReadTheDocs in docs/requirements.txt
• Now request Python 3.12 for ReadTheDocs builds in .readthedocs.yaml

Removed

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

Pull Requests Included

• Replace stalebot with "stale" GitHub action by @yantosca in #274

Full Changelog: 3.8.1...3.9.0

HEMCO 3.8.1

Release date: 02 Apr 2024

From CHANGELOG.md

Changed

• Now allow up to 10 nested brackets (((( )))) in the HEMCO_Config.rc file
• Now use short submodule names (i.e. w/o path) in .gitmodules

Fixed

• Limit volcano climatology file read message to root core
• Updated hco_interp_mod.F90 to handle 3D NEI emissions.

Pull requests included

• Allow up to 10 nested brackets in the HEMCO_Config.rc file by @yantosca in #262
• Now use short submodule names in .gitmodules by @yantosca in #266

Full Changelog: 3.8.0...3.8.1

HEMCO 3.8.0

Release date: 09 Feb 2024

From CHANGELOG.md

Changed

• Updated TOMAS_Jeagle sea salt extension

Fixed

• Updated IsModelLevel check for CESM and WRF-GC
• Interpolation error for 8-day MODIS LAI files (removed month loop in GetIndex2Interp)

Pull requests merged

• Implementation of TOMAS in GCHP by @Jourdan-He in #164
• Update TOMAS extensions for use in GCHP by @msulprizio in #251
• Update IsModelLevel check for CESM and WRF-GC by @jimmielin in #244
• Change GEOS-IT meteorology constants file year by @lizziel in #252
• Remove month loop in GetIndex2Interp by @nicholasbalasus in #254
• TOMAS fixes to address failure to integrate in dev/14.3.0 by @BettyCroft in #259

New Contributors

• @Jourdan-He made their first contribution in #164
• @BettyCroft made their first contribution in #259

Full Changelog: 3.7.2...3.8.0

HEMCO 3.7.2

Release date 01 Dec 2023

From CHANGELOG.md

Added

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

Changed

• Increased netCDF variable string length from 50 to 100

Fixed

• Rename HEMCO_Config.rc.sample to HEMCO_Config.rc in createRunDir.sh if sample is used.
• Added fix to turn off emissions extensions when EMISSIONS logical is false

Pull Requests Included

• rename HEMCO_Config.rc.sample to HEMCO_Config.rc by @nicholasbalasus in #245
• Increase string length for netCDF variable name by @msulprizio in #248
• Include a utility script that can be used to change HEMCO version numbers before release by @yantosca in #242
• Turn off emission extensions when EMISSIONS logical is set to false by @msulprizio in #250

Full Changelog: 3.7.1...3.7.2

HEMCO 3.7.1

Release date: 10 Oct 2023

From CHANGELOG.md

Changed

• Updated version numbers to 3.7.1
• Make Hg0 emission factors in hcox_gfed_include_gfed4.H multipliers of the CO emission factor
• Removed superfluous routine GetExtSpcVal_Dr in src/Core/hco_extlist_mod.F90
• NetCDF routines in src/Shared/NcdfUtil now use the Fortran-90 API
• Overhauled vertical regridding src/Core/hco_interp_mod.F90
• Removed INFLATE (but retained its behavior only for 47L -> 72L vertical regridding, warning users that this isn't recommended)
• ModelLev_Interpolate is only called when the input is 47/48, 72/73, or 102/103 levels (otherwise, MESSy is used).
• A bug that averaged the wrong number of levels in COLLAPSE is fixed (and edges are now sampled instead of averaged).
• Removed the now superfluous NC_ISMODELLEVEL and NC_SISIGMALEVEL from src/Shared/NcdfUtil/hco_ncdf_mod.F90
• Removed old code and references to GEOS-4.

Fixed

• Fixed incorrect XMIN, XMAX values in HEMCO_sa_Grid.025x03125.rc and HEMCO_sa_Grid.05x0625.rc
• Fixed line length too long for the GC_72_EDGE_SIGMA variable in src/Core/hcoio_read_std_mod.F90

Pull Requests Included

• Update Hg0 Emission Factors in hcox_gfed_include_gfed4.H by @emroy00 in #215
• Remove redundant code in hco_extlist_mod.F90 by @yantosca in #218
• Update netCDF code (in src/Shared/NcdfUtil) to use the netCDF-F90 interface by @yantosca in #226
• Fix several minor issues that were not addressed in PR #226 (the netCDF-F90 update) by @yantosca in #227
• Fix incorrect longitude definition in HEMCO_sa_Grid.025x0625.rc and HEMCO_sa_Grid.05x0625.rc by @yantosca in #229
• Limit GC_72_EDGE_SIGMA variable to 135 columns per Fortran-90 spec by @jimmielin in #234

New Contributors

• @emroy00 made their first contribution in #215

Full Changelog: 3.7.0...3.7.1