Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

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

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

Emissions - Emission Observation and Modeling - 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

New Contributors

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

Emissions - Emission Observation and Modeling - 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

New Contributors

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

Emissions - Emission Observation and Modeling - 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

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

Emissions - Emission Observation and Modeling - 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

New Contributors

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

Emissions - Emission Observation and Modeling - Fortran
Published by yantosca 11 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

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

Emissions - Emission Observation and Modeling - 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

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

Emissions - Emission Observation and Modeling - 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

Emissions - Emission Observation and Modeling - 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

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

Emissions - Emission Observation and Modeling - 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

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

Emissions - Emission Observation and Modeling - 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

Emissions - Emission Observation and Modeling - 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

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

Emissions - Emission Observation and Modeling - 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

New Contributors

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

Emissions - Emission Observation and Modeling - 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

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

Emissions - Emission Observation and Modeling - 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

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

Emissions - Emission Observation and Modeling - Fortran
Published by yantosca over 2 years ago

HEMCO - HEMCO 3.7.0

Release date: 05 Oct 2023
DOI

What's Changed

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

Emissions - Emission Observation and Modeling - Fortran
Published by msulprizio over 2 years ago

HEMCO - HEMCO 3.6.3

Release Date 15 Sep 2023
DOI

CHANGELOG

Fixed

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

Emissions - Emission Observation and Modeling - 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

Emissions - Emission Observation and Modeling - Fortran
Published by yantosca almost 3 years ago

HEMCO - HEMCO 3.6.1

Release date: 01 Mar 2023
DOI

CHANGELOG

Added

Changed

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

Emissions - Emission Observation and Modeling - 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

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

Emissions - Emission Observation and Modeling - 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

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

Emissions - Emission Observation and Modeling - 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

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

Emissions - Emission Observation and Modeling - 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

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

Emissions - Emission Observation and Modeling - 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 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

Emissions - Emission Observation and Modeling - Fortran
Published by yantosca almost 4 years ago

HEMCO - HEMCO 3.3.0

Release date 02 May 2022

New Features

Emissions - Emission Observation and Modeling - 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:

Emissions - Emission Observation and Modeling - 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 hcox_seasalt_mod.F90 when using marinePOA option

For more information, please see:

Emissions - Emission Observation and Modeling - Fortran
Published by yantosca about 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](3.2.0 milestone for geoschem/HEMCO)

Emissions - Emission Observation and Modeling - Fortran
Published by yantosca about 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

Emissions - Emission Observation and Modeling - 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

Emissions - Emission Observation and Modeling - 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

Emissions - Emission Observation and Modeling - 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:

Emissions - Emission Observation and Modeling - 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

Emissions - Emission Observation and Modeling - 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 hco_interp_mod.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)

Emissions - Emission Observation and Modeling - 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

Emissions - Emission Observation and Modeling - Fortran
Published by msulprizio about 5 years ago