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

HEMCO 3.7.0

Release date: 05 Oct 2023

Pull Requests Included

• Reduce logfile output in HEMCO, and combine Verbose and Warnings into a single switch by @yantosca in #182
• Remove src/Shared/NcdfUtil/perl folder by @yantosca in #183
• Update GFED4 biomass burning emission factors and add furans by @msulprizio in #189
• Deprecate HEMCO_CESM preprocessor constant. Now use MODEL_CESM by @jimmielin in #197
• Fixes for reading masks in HEMCO (merge bugfix/masks into HEMCO 3.7.0) by @yantosca in #198
• Remove computational bottlenecks in hco_calc_mod.F90 by @yantosca in #201
• Write HEMCO restart files to the rundir "Restarts/" subdirectory by @yantosca in #202
• Bug fix: Allow mask files ending in ".$NC" not to be interpreted as a mask having no file by @yantosca in #205
• Increase the string length for reading lines from HEMCO standalone grid by @msulprizio in #207
• Update tracer names in RnPbBe extension by @msulprizio in #214
• Update HCO_WARNING arguments in MODEL_GEOS block to avoid GEOS build … by @lizziel in #219
• Prevent run-time crash if using GEOSIT meteorolology directory by @lizziel in #220
• Change GEOS-IT meteorology constants year from 2011 to 2018 by @lizziel in #223
• Print HEMCO verbose status and volcano extension on root thread only by @lizziel in #221
• Fix bug in volcano extension causing crash when volcano turned off by @lizziel in #230
• Fix nvhpc compiler error in CESM due to line length exceeded by @lizziel in #240

Full Changelog: 3.6.2...3.7.0