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

HEMCO 3.6.3

Release Date 15 Sep 2023

What's Changed

• Fix nvhpc compiler error in CESM due to line length exceeded by @lizziel in #240

Full Changelog: 3.6.2...3.6.3

HEMCO 3.6.2

Release date: 02 Mar 2023

NOTE: This release contains zero-diff updates. There are no science or other structural changes.

CHANGELOG

Added

• Added .github/config.yml with settings for the issue chooser page

Changed

• Replace description: with about: in GitHub issue templates
• The PR template is now .github/PULL_REQUEST_TEMPLATE.md

Fixed

• Now point to proper commit of the geos-chem-shaed-docs submodule

Full Changelog: 3.6.1...3.6.2

HEMCO 3.6.1

Release date: 01 Mar 2023

CHANGELOG

Added

• GEOS-only updates by Christoph Keller by @lizziel in #191
• Remove memory leaks in HEMCO core and standalone routines (closes #190) by @yantosca in
  #194

Changed

• Simplify Github issue and pull request templates by @msulprizio in #195
• Throw an error if HEMCO reads netCDF data on 360_day, 365_day, or noleap calendars by @yantosca in #193

Full Changelog: 3.6.0...3.6.1

HEMCO 3.6.0

Release date: 201 Feb 2023

This is release features the updates listed below.

From CHANGELOG.md

Added

• Added MAPL_ESMF compiler option for use with GCHP and GEOS
• New "Parallelize GEOS-Chem and HEMCO source code" guide on ReadTheDocs
• Updated documentation describing a masking error that can happen when performing simulations with cropped horizontal grids

Changed

• Set HCO_MISSVAL to MAPL missing value (1e15) if using GCHP or GEOS
• Use fraction surface type inputs instead of ExtState%WLI
• The version number in docs/source/conf.py is now 3.6.0
• Updated compilation output splash screen in compiling.rst ReadTheDocs file

Fixed

• Bug fix for inserting hard breaks in hemco-config.rst ReadTheDocs file

Removed

• Removed old kludge for MAPL missing data if applying mask
• Removed ExtState field for water-land-ice index (WLI)

What's Changed

• Use MAPL_UNDEF value for HEMCO missing values if using GCHP or GEOS by @lizziel in #171
• Retire ExtState%WLI (land-water-ice index) by @lizziel in #170
• Add DimMax property to ModelSpc for HEMCO_CESM interface. by @jimmielin in #186

Full Changelog: 3.5.2...3.6.0

HEMCO 3.5.2

Release date: 29 Nov 2022

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

From CHANGELOG.md

Added

• Added sanitizer option for detecting memory leaks in HEMCO standalone during build

Changed

• Remove unused, commented-out code in src/Extensions/hcox_dustdead_mod.F
• Replaced placeholder error messages in src/Core/hco_config_mod.F90 with more informational messages (often including the line of the HEMCO_Config.rc in the printout)
• Added improved documentation for time cycle flag EFYO in ReadTheDocs

Fixed

• Removed memory leaks that were identified by the code sanitizer

What's Changed

• Fix memory leaks and other issues identified by the code sanitizer by @yantosca in #159

Full Changelog: 3.5.1...3.5.2

HEMCO 3.5.1

Release date: 03 Nov 2022

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

What's Changed

• Change Inst%NP to Inst%NumP in HCOX_Seasalt_Mod for CESM compatibility by @jimmielin in #175

Full Changelog: 3.5.0...3.5.1

HEMCO 3.5.0

Release date: 25 Oct 2022

This version features the following updates since HEMCO 3.4.0.

From CHANGELOG.md

Added

• Support for MAPL 2.16 (needed by GCHP and GEOS)
• Bug fix for HEMCO standalone run directory creation
• Bug fix: If HEMCO masks are specified as lon1/lat1/lon2/lat2, then don't try to read from disk
• Documentation from the GEOS-Chem wiki (now on ReadTheDocs)
• Badges for the ReadTheDocs front page
• Bug fix for masking issues in MPI environment (for WRF, CESM)
• Mapping of CAM-Chem species to GFED4 (for CESM)
• New documentation for hemco.readthedocs.io, migrated from GC wiki
• Updated documentation on vertical regridding behavior

Changed

• Ignore non-printing characters (e.g. tabs) when readingHEMCO_Config.rc. This had caused a bug in GCHP.
• Updated module names for MAPL 2.16 upgrade
• "Diagnostic counter zero" warning is now printed at warning level 2 (instead of 1)
• OFFLINE_BIOGENICVOC emissions in MEGAN now include species MOH

What's Changed

• Bug fix in megan extension by @lizziel in #140
• MAPL 2.16 updates (on top of HEMCO 3.4.0) by @yantosca in #129
• Strip out tabs and end-of-line comments when reading from HEMCO_Config.rc -- Closes #150 by @yantosca in #151
• Change diagnostic counter zero warning from warning level 1 to 2 by @lizziel in #148
• Docs updates on vertical regridding and HEMCO_Config.rc by @jimmielin in #154
• Add fixes for generating HEMCO standalone run directories by @msulprizio in #155
• Add fix to restore copying all needed HEMCO_Config.rc files when creating HEMCO standalone run directories by @msulprizio in #157
• Fix masking issues in MPI (WRF, CESM) environment by @jimmielin in #161
• Map CAM-chem species list to GFED4 by @jimmielin in #158

Full Changelog: 3.4.0...3.5.0

HEMCO 3.4.0

Release date: 02 May 2022

New features in this version:

• Retire CH4 wetlands emissions extension
• Make sure each routine exits HEMCO with an error message (even if a placeholder message is used)
• Fixed syntax error that caused more than 72 columns of fixed-format Fortran code in hcox_tomas_dustdead_mod.F
• Added updates for HEMCO running in the NASA/GEOS ESM
• Prevent undefined variable when calculating vertical scale factor
• GCHP bug fix: revert to all zeros in criteria for restart field not filled
• Several fixes for OpenMP parallelization and numerical stability
• Prevent out-of-bounds error in HEMCO vertical interpolation
• Set MEGAN biogenic annual emission factors to zero in before computing them
• Updated ReadTheDocs documentation

For more information, see our HEMCO manual at https://hemco.readthedocs.io

HEMCO 3.2.2

Release date: 01 Dec 2021

Contains 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