Skip to content

Commit

Permalink
Update paper.md
Browse files Browse the repository at this point in the history
Updates to introduction, statement of need, and history. 

We should be a bit careful how we refer to HERMES and should not disqualify that tool (too much).
  • Loading branch information
gredvis authored Oct 1, 2024
1 parent ebc87e4 commit 9aca54c
Showing 1 changed file with 15 additions and 42 deletions.
57 changes: 15 additions & 42 deletions joss/paper.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,58 +29,40 @@ bibliography: paper.bib

# Summary

In the effort to reduce air pollution and greenhouse gas concentrations, emission inventories
are created by countries and regions to estimate the magnitude of emissions and the share of individual source sectors.
Modellers use these inventories to simulate the atmospheric transport and processing of the emitted species to compute their distribution and potential impact on the environment. The simulations are often compared with measurements to control if the declared emissions and their trends are consistent with the observed changes in the atmosphere, improving the confidence in the inventories.
Emission inventories are created by countries and regions in the effort to improve air quality and to reduce the impacts of climate change. Knowing the magnitude of emissions and the share of different source sectors is a critical first step to design efficient emission reduction policies. Modellers use spatially gridded inventories to simulate the atmospheric transport and processing of the emitted species to compute their distribution and potential impact on the environment. The simulations are often compared with measurements to control if the declared emissions and their trends are consistent with the observed changes in the atmosphere, enhancing the confidence in the inventories.

Inventories are created in multiple different formats and resolutions, which makes it difficult to compare
and use them in atmospheric transport models.
Inventories are created in multiple different formats and resolutions, which makes it difficult to compare and use them in atmospheric transport models.

Figure \ref{fig:tno} presents an example of a gridded inventory.


![CO2 emissions of the year 2015 from the TNOGHGco_v6 inventory produced by TNO, the Netherlands \label{fig:tno}.](raster_total_CO2.png){ width=100% }

`emiproc` is a Python package that provides tools for processing and harmonizing emission inventories and for generating emission input files for atmospheric models. It includes functions for reading, writing, and exporting emission inventory data to various formats used in atmospheric transport models. `emiproc` also provides functions for performing various
operations on inventory data, such as remapping emissions to different model grids, aggregating emissions by sector or pollutant, or scaling emissions based on projection scenarios.
`emiproc` is a Python package that provides tools for processing and harmonizing emission inventories and for generating input files for atmospheric models. It includes functions for reading, writing, and exporting emission inventory data to various formats used in atmospheric transport models. `emiproc` also provides functions for performing various
operations on inventory data, such as remapping to different model grids, aggregating emissions by sector or pollutant, or scaling emissions based on projection scenarios.

Emission input files can be generated in regular (e.g. hourly) intervals by applying sector- and country-specific temporal and vertical emission profiles.
Alternatively, a small set of input files can be generated, which describe the sectorial gridded emissions and their temporal and vertical profiles.
This set of files can then be read by OEM [online emissions module] described by Jähn et al. (2020), which applies the temporal and vertical scaling online during the model simulation.
Emission input files can be generated in regular (e.g. hourly) intervals by applying sector- and country-specific temporal and vertical emission profiles. Alternatively, a small set of input files can be generated, which describe the sectorial gridded emissions and their temporal and vertical profiles.
This set of files can then be read by OEM [online emissions module] described by Jähn et al. (2020), which applies the temporal and vertical scaling online during the model simulation. OEM has been integrated into the atmospheric chemistry and transport models COSMO-ART and ICON-ART.

The package is designed to be flexible and extendable, allowing users to easily add new functionality, to read new inventories or export data to new formats.

# Statement of need

Emission inventory data can be represented in various formats and resolutions.
For example, TNO (Dutch Organization for Applied Scientific Research) provides an inventory which contains both, a area emissions on a grid and point
sources. Other inventories, such as the inventory from the city of Zurich, are provided as
GIS (Geographic information system) data with various shapes depending on the category of the emission source. As an
Emission inventory data can be represented in various formats and resolutions. For example, TNO (Dutch Organization for Applied Scientific Research) provides an inventory which contains both, area emissions on a regular grid and point
sources at their exact locations. Other inventories, such as the inventory from the city of Zurich, are provided as
GIS (Geographic information system) data with various shapes depending on the category of the source. As an
example:

* Traffic emissions are represented as lines
* Building/industry emissions are represented as point sources
* Private boats on the lake are represented as polygons

Atmospheric models require emission inventories to be in a specific format and often multiple inventories need to be combined to represent different anthropogenic and natural sources. The atmospheric chemistry transport model ICON-ART [@icon_art_2.1], for example, requires emissions on its complex, semi-structured triangular grid. As input for the OEM module it also requires cyclic time profiles to scale the emissions with daily, weekly and monthly variability.
As an other example, the Graz Lagrangian dispersion model (GRAL) can make direct use of emissions represented in a GIS format as line, point or rectangular sources. GRAL needs additional detailed information such as the height, the temperature or the gas exit velocity of a point source.

Atmospheric models require emission inventories to be in a specific format and often
multiple inventories need to be combined to represent different anthropogenic and
natural sources.
When modellers design their simulations, they often are interested in modifying the inventories. For example, they may want to scale the emissions based on different scenarios, or they may want to aggregate emissions by sector or pollutant.

The atmospheric chemistry transport model ICON-ART [@icon_art_2.1],
for example, requires emissions on
its complex, semi-structured triangular grid. As input for the OEM module it also requires
cyclic time profiles to scale the emissions with daily, weekly and monthly variability.
As an other example, the Graz Lagrangian dispersion model (GRAL) can make direct use of emissions
represented in a GIS format as line, point or rectangular sources.
GRAL needs additional detailed information such as the height, the temperature or the
gas exit velocity of a point source.

When modellers design transport simulations, they often are interested in
modifying the inventories. For example, they may want to scale the emissions based on
different scenarios, or they may want to aggregate emissions by sector or pollutant.

`emiproc` provides all this functionality and has already been successfully applied for different use cases.
`emiproc` provides all this functionality and has already been successfully applied for different use cases:

* [@acp-24-2759-2024] produced emission files for ICON-ART-OEM based on the EDGARv6
inventory [@edgar_v6] (Emissions Database for Global Atmospheric Research).
Expand All @@ -92,26 +74,17 @@ with `emiproc` for cities of Zurich and Basel.
inside the Swiss national inventory and to further nest the Swiss inventory
inside the European TNOGHGco inventory.

Another python software, `HERMESv3` [@hermesv3_part1], can already process emission
data and generate input files for atmospheric transport models. However, `HERMESv3` is
relying on specific configuration files. `emiproc` is much more flexible and extensible.
It is also easier to use as it can by integrated directly in python scripts.

`emiproc`shares some of its functionality with another python tool, `HERMESv3` [@hermesv3_part1], which is also designed to process emission data and generate input files for atmospheric transport models. Compared to `HERMESv3`, which relies on specific configuration files, `emiproc` is more flexible and extensible and is easier to use as it can by integrated as a module in existing python-based workflows.

# History

An older version of the `emiproc` package was already published [@gmd-13-2379-2020],
but it was written only for specific models and was not modular enough to easily account
for new inventories and models. `emiproc` was then refactored in 2022 to reach
the new requirements. This included a major structure change, the addition of new
capabilities, a performance increase, a new documentation and a test coverage.
An older version of the `emiproc` package was already published [@gmd-13-2379-2020], but it was written only for specific models and inventories. `emiproc` was then refactored starting in 2022 to satisfy the requirements of high flexibility and modularity. This included major changes to code structure, the addition of new capabilities, a major performance increase for the task of spatial regridding, a comprehensive documentation and the addition of test examples.

Since then the package is regularly updated with new features and bug fixes.


# Design


To be able to use these different kind of inventories in air quality models, it is
necessary to harmonize them. This is what the `emiproc` package is designed for.

Expand Down

0 comments on commit 9aca54c

Please sign in to comment.