Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

HEMCO

Computing atmospheric emissions from different sources, regions, and species on a user-defined grid.
https://github.com/geoschem/HEMCO

Category: Emissions
Sub Category: Emission Observation and Modeling

Keywords

atmospheric-composition atmospheric-modeling aws bash-script cloud-computing configuration-files data-broker emissions geos-chem hemco masks regridding run-directory scale-factors scientific-computing standalone

Keywords from Contributors

earth-system-modeling atmospheric-chemistry climate greenhouse-gases methane aerosols atmospheric-chemistry-modeling atmospheric-modelling carbon-cycle mercury

Last synced: about 22 hours ago
JSON representation

Repository metadata

The Harmonized Emissions Component (HEMCO), developed by the GEOS-Chem Support Team.

README.md

HEMCO: The Harmonized Emissions Component

Description

This repository (https://github.com/geoschem/HEMCO) contains the Harmonized Emissions Component (HEMCO) source code. HEMCO is a software component for computing (atmospheric) emissions from different sources, regions, and species on a user-defined grid. It can combine, overlay, and update a set of data inventories ('base emissions') and scale factors, as specified by the user through the HEMCO configuration file. Emissions that depend on environmental variables and non-linear parameterizations are calculated in separate HEMCO extensions. HEMCO can be run
in standalone mode or coupled to an atmospheric model. A more detailed description of HEMCO is given in Keller et al. (2014) and Lin et al (2021).

HEMCO has been coupled to several atmospheric and Earth System Models, and can be coupled with or without using the Earth System Modeling Framework (ESMF). A detailed description of HEMCO coupled with other models is given in Lin et al. (2021).

Documentation

Reference

C. A. Keller, M. S. Long, R. M. Yantosca, A. M. Da Silva, S. Pawson, D. J. Jacob, HEMCO v1.0: a versatile, ESMF-compliant component for calculation emissions in atmospheric models, Geosci. Model Dev., 7, 1409-1417, 2014.

Lin, H., Jacob, D. J., Lundgren, E. W., Sulprizio, M. P., Keller, C. A., Fritz, T. M., Eastham, S. D., Emmons, L. K., Campbell, P. C., Baker, B., Saylor, R. D., and Montuoro, R.: Harmonized Emissions Component (HEMCO) 3.0 as a versatile emissions component for atmospheric models: application in the GEOS-Chem, NASA GEOS, WRF-GC, CESM2, NOAA GEFS-Aerosol, and NOAA UFS models, Geosci. Model Dev., 14, 5487–5506, 2021.

Online user's manual

Installation and usage instructions are posted online at hemco.readthedocs.io

Support

We encourage GEOS-Chem users to use the Github issue tracker attached to this repository to report bugs or technical issues with the HEMCO code.

License

HEMCO is distributed under the MIT license. Please see the license documents LICENSE.txt and AUTHORS.txt in the root folder.

Owner metadata

GitHub Events

Total
Last Year

Committers metadata

Last synced: 2 days ago

Total Commits: 760
Total Committers: 25
Avg Commits per committer: 30.4
Development Distribution Score (DDS): 0.53

Commits in past year: 67
Committers in past year: 3
Avg Commits per committer in past year: 22.333
Development Distribution Score (DDS) in past year: 0.045

Name Email Commits
Bob Yantosca y****a@s****u 357
Lizzie Lundgren e****n@s****u 127
Melissa Sulprizio m****r@s****u 95
Killian Murphy k****y@y****k 79
Haipeng Lin j****n@g****m 31
Christoph Keller c****r@n****v 13
William Jamieson w****n@h****u 9
Liam Bindle l****e@g****m 8
Colin Lee c****e@d****a 6
yuanjian.z y****z@w****u 6
Kyle Shores k****4@g****m 5
bcroft b****t@w****u 4
drnimbusrain d****n@g****m 3
nicholasbalasus n****s@g****u 3
1Dandan d****g@s****u 2
Francis Vitt f****t@u****u 2
Lee T. Murray l****y@r****u 2
Amidu Oloso a****o@n****v 1
Dylan B. Millet d****m@u****u 1
Eric Roy 1****0 1
Matthew Thompson m****n@n****v 1
William Putman W****n@n****v 1
laestrada l****0@g****m 1
Dandan Zhang d****8@b****u 1
xlwangg w****0@g****m 1

Committer domains:

Issue and Pull Request metadata

Last synced: 2 days ago

Total issues: 110
Total pull requests: 158
Average time to close issues: 7 months
Average time to close pull requests: about 1 month
Total issue authors: 51
Total pull request authors: 20
Average comments per issue: 4.29
Average comments per pull request: 2.14
Merged pull request: 117
Bot issues: 0
Bot pull requests: 2

Past year issues: 10
Past year pull requests: 12
Past year average time to close issues: about 1 month
Past year average time to close pull requests: 16 days
Past year issue authors: 7
Past year pull request authors: 5
Past year average comments per issue: 2.5
Past year average comments per pull request: 3.5
Past year merged pull request: 7
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/geoschem/HEMCO

Top Issue Authors

  • yantosca (14)
  • msulprizio (12)
  • jimmielin (8)
  • lizziel (7)
  • yuanjianz (4)
  • jiaying002 (4)
  • ktravis213 (3)
  • arianatribby (3)
  • nicholasbalasus (3)
  • drnimbusrain (3)
  • eamarais (3)
  • jinlx (3)
  • JFBrewer (2)
  • jdshutter (2)
  • 1Dandan (2)

Top Pull Request Authors

  • yantosca (58)
  • lizziel (34)
  • msulprizio (21)
  • jimmielin (11)
  • nicholasbalasus (6)
  • K20shores (3)
  • yuanjianz (3)
  • drnimbusrain (3)
  • BettyCroft (3)
  • jdshutter (2)
  • kaysuselj (2)
  • dependabot[bot] (2)
  • 1Dandan (2)
  • Lazarus302722 (2)
  • fvitt (1)

Top Issue Labels

  • category: Bug (30)
  • stale (26)
  • bug (26)
  • never stale (23)
  • category: Feature Request (19)
  • category: Question (12)
  • config-files / rundir (11)
  • question (11)
  • data sources / I-O (10)
  • topic: Configuration Files (10)
  • topic: Input Data (8)
  • topic: HEMCO Extensions (8)
  • topic: HEMCO Standalone Model (8)
  • feature (7)
  • topic: Diagnostics (5)
  • topic: Scaling or Masking (4)
  • deferred (4)
  • topic: Structural Modifications (4)
  • topic: Regridding or Interpolation (4)
  • structural (3)
  • help needed: Request Input from Community (3)
  • interpolation / regridding (3)
  • standalone (3)
  • interface to external model (3)
  • no-diff-to-benchmark (3)
  • documentation (3)
  • extensions (2)
  • topic: Performance (2)
  • performance / parallelization (2)
  • category: Debug Help (2)

Top Pull Request Labels

  • category: Feature Request (41)
  • bugfix (37)
  • no-diff-to-benchmark (35)
  • category: Bug Fix (26)
  • feature (16)
  • topic: Structural Modifications (12)
  • zero-diff update (12)
  • topic: HEMCO Extensions (12)
  • interface to external model (11)
  • structural (11)
  • extensions (10)
  • topic: Releases (9)
  • never stale (8)
  • data sources / I-O (7)
  • config-files / rundir (7)
  • category: Interface to External Model (7)
  • topic: GitHub (7)
  • topic: ESMF or MPI (6)
  • interpolation / regridding (5)
  • topic: Scaling or Masking (4)
  • topic: Diagnostics (4)
  • standalone (3)
  • topic: HEMCO Standalone Model (3)
  • topic: Regridding or Interpolation (3)
  • topic: Dry-Run Simulation (2)
  • performance / parallelization (2)
  • dependencies (2)
  • scaling / masking (2)
  • topic: File I/O (2)
  • diagnostics (2)

Dependencies

docs/requirements.txt pypi
  • docutils ==0.16
  • recommonmark *
  • sphinx <4.0.0
  • sphinx_rtd_theme <1.0.0
  • sphinxcontrib-bibtex ==2.2.0
.github/workflows/stale.yml actions
  • actions/stale v10 composite
.github/workflows/lint-ci-workflows.yml actions
  • actions/checkout v6 composite
  • actions/setup-python v6 composite
.github/workflows/mac.yml actions
  • actions/checkout v6 composite
.github/workflows/ubuntu.yml actions
  • actions/checkout v6 composite
.github/workflows/windows.yml actions
  • actions/checkout v6 composite
  • msys2/setup-msys2 v2 composite

Score: 7.150701457592526