Recent Releases of hemco

hemco - HEMCO 3.11.2

Release date: 28 Jul 2025 DOI

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 https://github.com/geoschem/HEMCO/pull/332
  • Increase string length for reading lines from HEMCO standalone grid file by @msulprizio in https://github.com/geoschem/HEMCO/pull/335
  • HEMCO 3.11.2 release by @yantosca in https://github.com/geoschem/HEMCO/pull/338

Full Changelog: https://github.com/geoschem/HEMCO/compare/3.11.1...3.11.2

- Fortran
Published by yantosca 7 months ago

hemco - HEMCO 3.11.1

Release Date: 29 May 2025 DOI

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 https://github.com/geoschem/HEMCO/pull/325
  • HEMCO 3.11.1 release by @yantosca in https://github.com/geoschem/HEMCO/pull/327

New Contributors

  • @drnimbusrain made their first contribution in https://github.com/geoschem/HEMCO/pull/325

Full Changelog: https://github.com/geoschem/HEMCO/compare/3.11.0...3.11.1

- Fortran
Published by yantosca 9 months ago

hemco - HEMCO 3.11.0

Release date: 18 Apr 2025 DOI

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 https://github.com/geoschem/HEMCO/pull/279
  • Merge updates from HEMCO 3.10.2 into dev/3.11.0 by @yantosca in https://github.com/geoschem/HEMCO/pull/309
  • Fix improper handling of date timestamps and lat/lon bounds for mask files by @msulprizio in https://github.com/geoschem/HEMCO/pull/311
  • Bring updates from HEMCO 3.10.3 into the dev/3.11.0 branch by @yantosca in https://github.com/geoschem/HEMCO/pull/319
  • Add capability to run HEMCO at 0.125x0.15625 resolution by @msulprizio in https://github.com/geoschem/HEMCO/pull/290
  • Release/3.11.0 by @yantosca in https://github.com/geoschem/HEMCO/pull/322

New Contributors

  • @yuanjianz made their first contribution in https://github.com/geoschem/HEMCO/pull/279

Full Changelog: https://github.com/geoschem/HEMCO/compare/3.10.3...3.11.0

- Fortran
Published by yantosca 10 months ago

hemco - HEMCO 3.10.3

Release date: 25 Mar 2025 DOI

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 https://github.com/geoschem/HEMCO/pull/314
  • allowing workflow badges to show by @K20shores in https://github.com/geoschem/HEMCO/pull/316
  • Add commented out debug code useful for MPI debugging by @lizziel in https://github.com/geoschem/HEMCO/pull/317
  • HEMCO release 3.10.3 by @lizziel in https://github.com/geoschem/HEMCO/pull/318

Full Changelog: https://github.com/geoschem/HEMCO/compare/3.10.2...3.10.3

- Fortran
Published by lizziel 11 months ago

hemco - HEMCO 3.10.2

Release date: 04 Mar 2025 DOI

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 https://github.com/geoschem/HEMCO/pull/304
  • Add CI builds for macOS, Windows, and Ubuntu by @K20shores in https://github.com/geoschem/HEMCO/pull/299
  • Turn off map_a2a pole-averaging when using CESM by @lizziel in https://github.com/geoschem/HEMCO/pull/306
  • HEMCO release 3.10.2 by @yantosca in https://github.com/geoschem/HEMCO/pull/308

New Contributors

  • @K20shores made their first contribution in https://github.com/geoschem/HEMCO/pull/299

Full Changelog: https://github.com/geoschem/HEMCO/compare/3.10.1...3.10.2

- Fortran
Published by yantosca 12 months ago

hemco - HEMCO 3.10.1

Release date: 10 Jan 2025 DOI

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 https://github.com/geoschem/HEMCO/pull/296
  • Improve log flexibility in HEMCO by @lizziel in https://github.com/geoschem/HEMCO/pull/298
  • Fixes to build and run in GEOS by @lizziel in https://github.com/geoschem/HEMCO/pull/300
  • HEMCO release 3.10.1 by @yantosca in https://github.com/geoschem/HEMCO/pull/302

Full Changelog: https://github.com/geoschem/HEMCO/compare/3.10.0...3.10.1

- Fortran
Published by yantosca about 1 year ago

hemco - HEMCO 3.10.0

Release date: 08 Nov 2024 DOI

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 https://github.com/geoschem/HEMCO/pull/284
  • Add emission factors for ALK6, C4H6, EBZ, STYR, TMB emissions in GFED and FINN biomass burning by @yantosca in https://github.com/geoschem/HEMCO/pull/285
  • Updated soil NOx scheme from Yi Wang et al. (2021) as an option by @msulprizio in https://github.com/geoschem/HEMCO/pull/287
  • Bugfix: Restore stale workflow functionality by @msulprizio in https://github.com/geoschem/HEMCO/pull/289
  • Add HEMCO-standalone dry-run data download scripts by @yantosca in https://github.com/geoschem/HEMCO/pull/295
  • ReadTheDocs updates for HEMCO 3.10.0 by @yantosca in https://github.com/geoschem/HEMCO/pull/292

Full Changelog: https://github.com/geoschem/HEMCO/compare/3.9.3...3.10.0

- Fortran
Published by yantosca over 1 year ago

hemco - HEMCO 3.9.3

Release date: 13 Aug 2024 DOI

CHANGELOG

Fixed

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

Pull requests included

  • None

Full Changelog: https://github.com/geoschem/HEMCO/compare/3.9.2...3.9.3

- Fortran
Published by yantosca over 1 year ago

hemco - HEMCO 3.9.2

Release date: 2024-07-24 DOI

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 hcoxmeganmod.F90 by @yantosca in https://github.com/geoschem/HEMCO/pull/282

Full Changelog: https://github.com/geoschem/HEMCO/compare/3.9.1...3.9.2

- Fortran
Published by yantosca over 1 year ago

hemco - HEMCO 3.9.1

Release date: 28 Jun 2024 DOI

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 https://github.com/geoschem/HEMCO/pull/280

Full Changelog: https://github.com/geoschem/HEMCO/compare/3.9.0...3.9.1

- Fortran
Published by yantosca over 1 year ago

hemco - HEMCO 3.9.0

Release Date: 30 May 2024 DOI

CHANGELOG

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

Full Changelog: https://github.com/geoschem/HEMCO/compare/3.8.1...3.9.0

- Fortran
Published by yantosca over 1 year ago

hemco - HEMCO 3.8.1

Release date: 02 Apr 2024 DOI

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 https://github.com/geoschem/HEMCO/pull/262
  • Now use short submodule names in .gitmodules by @yantosca in https://github.com/geoschem/HEMCO/pull/266

Full Changelog: https://github.com/geoschem/HEMCO/compare/3.8.0...3.8.1

- Fortran
Published by msulprizio almost 2 years ago

hemco - HEMCO 3.8.0

Release date: 09 Feb 2024 DOI

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 https://github.com/geoschem/HEMCO/pull/164
  • Update TOMAS extensions for use in GCHP by @msulprizio in https://github.com/geoschem/HEMCO/pull/251
  • Update IsModelLevel check for CESM and WRF-GC by @jimmielin in https://github.com/geoschem/HEMCO/pull/244
  • Change GEOS-IT meteorology constants file year by @lizziel in https://github.com/geoschem/HEMCO/pull/252
  • Remove month loop in GetIndex2Interp by @nicholasbalasus in https://github.com/geoschem/HEMCO/pull/254
  • TOMAS fixes to address failure to integrate in dev/14.3.0 by @BettyCroft in https://github.com/geoschem/HEMCO/pull/259

New Contributors

  • @Jourdan-He made their first contribution in https://github.com/geoschem/HEMCO/pull/164
  • @BettyCroft made their first contribution in https://github.com/geoschem/HEMCO/pull/259

Full Changelog: https://github.com/geoschem/HEMCO/compare/3.7.2...3.8.0

- Fortran
Published by msulprizio about 2 years ago

hemco - HEMCO 3.7.2

Release date 01 Dec 2023

CHANGELOG

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

New Contributors

  • @nicholasbalasus made their first contribution in https://github.com/geoschem/HEMCO/pull/245

Full Changelog: https://github.com/geoschem/HEMCO/compare/3.7.1...3.7.2

- Fortran
Published by yantosca about 2 years ago

hemco - HEMCO 3.7.1

Release date: 10 Oct 2023 DOI

CHANGELOG

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

New Contributors

  • @emroy00 made their first contribution in https://github.com/geoschem/HEMCO/pull/215

Full Changelog: https://github.com/geoschem/HEMCO/compare/3.7.0...3.7.1

- Fortran
Published by yantosca over 2 years ago

hemco - HEMCO 3.7.0

Release date: 05 Oct 2023 DOI

What's Changed

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

Full Changelog: https://github.com/geoschem/HEMCO/compare/3.6.2...3.7.0

- Fortran
Published by msulprizio over 2 years ago

hemco - HEMCO 3.6.3

Release Date 15 Sep 2023 DOI

CHANGELOG

Fixed

  • Fix nvhpc compiler error in CESM due to line length exceeded by @lizziel in https://github.com/geoschem/HEMCO/pull/240

Full Changelog: https://github.com/geoschem/HEMCO/compare/3.6.2...3.6.3

- Fortran
Published by yantosca over 2 years ago

hemco - HEMCO 3.6.2

Release date: 02 Mar 2023 DOI

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: https://github.com/geoschem/HEMCO/compare/3.6.1...3.6.2

- Fortran
Published by yantosca almost 3 years ago

hemco - HEMCO 3.6.1

Release date: 01 Mar 2023 DOI

CHANGELOG

Added

  • GEOS-only updates by Christoph Keller by @lizziel in https://github.com/geoschem/HEMCO/pull/191
  • Remove memory leaks in HEMCO core and standalone routines (closes #190) by @yantosca in https://github.com/geoschem/HEMCO/pull/194

Changed

  • Simplify Github issue and pull request templates by @msulprizio in https://github.com/geoschem/HEMCO/pull/195
  • Throw an error if HEMCO reads netCDF data on 360day, 365day, or noleap calendars by @yantosca in https://github.com/geoschem/HEMCO/pull/193

Full Changelog: https://github.com/geoschem/HEMCO/compare/3.6.0...3.6.1

- Fortran
Published by yantosca almost 3 years ago

hemco - HEMCO 3.6.0

Release date: 201 Feb 2023 DOI

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 https://github.com/geoschem/HEMCO/pull/171
  • Retire ExtState%WLI (land-water-ice index) by @lizziel in https://github.com/geoschem/HEMCO/pull/170
  • Add DimMax property to ModelSpc for HEMCO_CESM interface. by @jimmielin in https://github.com/geoschem/HEMCO/pull/186

Full Changelog: https://github.com/geoschem/HEMCO/compare/3.5.2...3.6.0

- Fortran
Published by msulprizio about 3 years ago

hemco - HEMCO 3.5.2

Release date: 29 Nov 2022

DOI

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 https://github.com/geoschem/HEMCO/pull/159

Full Changelog: https://github.com/geoschem/HEMCO/compare/3.5.1...3.5.2

- Fortran
Published by msulprizio about 3 years ago

hemco - HEMCO 3.5.1

Release date: 03 Nov 2022

DOI

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

What's Changed

  • Change Inst%NP to Inst%NumP in HCOXSeasaltMod for CESM compatibility by @jimmielin in https://github.com/geoschem/HEMCO/pull/175

Full Changelog: https://github.com/geoschem/HEMCO/compare/3.5.0...3.5.1

- Fortran
Published by msulprizio over 3 years ago

hemco - HEMCO 3.5.0

Release date: 25 Oct 2022

DOI

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

Full Changelog: https://github.com/geoschem/HEMCO/compare/3.4.0...3.5.0

- Fortran
Published by msulprizio over 3 years ago

hemco - HEMCO 3.4.0

Release date: 02 May 2022 DOI

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 hcoxtomasdustdead_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

- Fortran
Published by yantosca almost 4 years ago

hemco - HEMCO 3.3.0

Release date 02 May 2022

New Features - Updated Extensions/hcoxgcRnPbBe_mod.F90 to use Zhang et al 2021 emissions (now the default) - Reference: https://acp.copernicus.org/articles/21/1861/2021/

- Fortran
Published by yantosca almost 4 years ago

hemco - HEMCO 3.2.2

Release date: 01 Dec 2021 DOI

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

- Fortran
Published by yantosca about 4 years ago

hemco - HEMCO 3.2.1

Release date: 15 Nov 2021 DOI

Contains the following bug fixes: - Add patch branches to continuous integration tests; update HEMCO version to 3.2.1 - Fix indexing of species in hcoxseasaltmod.F90 when using marinePOA option

For more information, please see: - geoschem/HEMCO 3.2.1 milestone

- Fortran
Published by yantosca over 4 years ago

hemco - HEMCO 3.2.0

Release date: 15 Nov 2021

Contains the following updates: - GCHP adjoint updates - Modify volcano extension so that dry-run option also looks for climatology file - Add climatology input to volcano extension - Include PET number in error message if using ESMF - Send all HCO_ERROR messages to stderr and write from all threads - HEMCO diagnostics and standalone config files for consistency with GEOS-Chem updates

For more information, please see: - 3.2.0 milestone for geoschem/HEMCO

- Fortran
Published by yantosca over 4 years ago

hemco - HEMCO 3.1.1

Release date: 10 Sep 2021 DOI

This release fixes the following issue identified since HEMCO 3.1.0:

  • Fix to HEMCO lightning flash rate diagnostic units
  • Fix HEMCO's createRunDir.sh script to replace additional added tokens

Please see the following links for more information on this version.

Overview

- Fortran
Published by msulprizio over 4 years ago

hemco - HEMCO 3.1.0

Release date: 07 Sep 2021 DOI

This is the release for HEMCO 3.1.0. Major updates since HEMCO 3.0.0 include:

  • Blowing snow emissions of sea salt and sea salt bromide added to sea salt extension
  • Add HEMCO_INTERFACE cache variable to CMake build

Please see the following links for more information on this version.

Overview

Documentation

- Fortran
Published by msulprizio over 4 years ago

hemco - HEMCO 3.0.0

HEMCO 3.0.0 18 June 2021 DOI

This is the official release for HEMCO 3.0.0. Major updates since HEMCO 3.0.0-rc.3 include:

  • Updates to speed up HEMCO
  • Updates to calculate emissions sensitivities, apply emissions scaling factors, and output adjoint diagnostics
  • Support for GCAP 2.0
  • Unify HCOIO interfaces for standard and MAPL configurations
  • Updates for using HEMCO in CESM2-GC and WRF-GC

Please see the following links for more information on this version.

Overview

Documentation

- Fortran
Published by msulprizio over 4 years ago

hemco - HEMCO 3.0.0-rc.3

HEMCO 3.0.0-rc.3 12 Apr 2021 DOI

This release candidate fixes the following bugs discovered since 3.0.0-rc.2:

  • Met fields were only being read in once at the start of the simulation
    • As was originally reported in Issue https://github.com/geoschem/geos-chem/issues/686

- Fortran
Published by yantosca almost 5 years ago

hemco - HEMCO 3.0.0-rc.2

HEMCO 3.0.0-rc.2 23 Mar 2021 DOI

This release candidate fixes the following issue identified since 3.0.0-rc.1:

  • Remove duplicate Inst%FLUXSABI allocation in MEGAN HCO extension
  • Make sure data containers with the "EFY" time cycle flag are only updated once

- Fortran
Published by msulprizio almost 5 years ago

hemco - HEMCO 3.0.0-rc.1

HEMCO 3.0.0-rc.1 18 Mar 2021 DOI

This release candidate fixes the following issue identified since 3.0.0-rc.0:

  • Use HcoState%NZ instead of NLEV in hcointerpmod.F90
  • Set and update ExtState before computing emissions in HEMCO standalone
  • Add stale bot and no-response bot
  • Update isCoards script to account for files saved out by GCHP's History component
  • Remove hard-coded scale factors from DustDead extension (set in HEMCO_Config.rc instead)

- Fortran
Published by msulprizio almost 5 years ago

hemco - HEMCO 3.0.0-rc.0

HEMCO 3.0.0-rc.0 08 Jan 2021 DOI

This is the first release candidate for HEMCO 3.0.0. Major updates since HEMCO 2.2.0 include.

  • The HEMCO source code has been split off from the GEOS-Chem repository into this new repository
  • The source code has been reorganized
    • A script for creating HEMCO standalone run directories can now be found in the run/ subdirectory
    • Several driver programs have been added to the src/Interfaces/ subdirectory for using HEMCO in other models
  • CMake is the default build system; Support for GNU Make has been retired
  • Carbon based units for VOC species have been removed
  • CEDS GDB-MAPS is now the default anthropogenic emissions inventory

Please see the following links for more information on this version.

Overview

Documentation

- Fortran
Published by msulprizio about 5 years ago