lair.inventories.EPAv2#

class lair.inventories.EPAv2(express=False, scale_by_month=False, inventory_dir=None)[source]#

Bases: EPA

EPA U.S. Anthropogenic Methane Greenhouse Gas Inventory

https://zenodo.org/records/8367082

McDuffie, Erin, E., Maasakkers, Joannes, D., Sulprizio, Melissa, P., Chen, C., Schultz, M., Brunelle, L., Thrush, R., Steller, J., Sherry, C., Jacob, Daniel, J., Jeong, S., Irving, B., & Weitz, M. (2023). Gridded EPA U.S. Anthropogenic Methane Greenhouse Gas Inventory (gridded GHGI) (v1.0) [Data set]. Zenodo. https://doi.org/10.5281/zenodo.8367082

What total_emissions covers:

  • Base product (express=False): the 26 GHGI sectors, 2012-2018.

  • Express extension (express=True): 2012-2020, revised, plus the supplemental PostMeter sector (leaks downstream of customer meters: buildings and appliances), which is outside the GHGI national total. In the Salt Lake Valley it is ~7.5% of the express total. Use sum_sectors(data, exclude=["PostMeter"]) for the GHGI sectors alone.

scale_by_month=True keeps every sector, holding those without monthly scale factors at their annual rate, so its total covers the same sectors.

Parameters:
  • express (bool, optional) – Whether to use the express extension, by default False.

  • scale_by_month (bool, optional) – Whether to scale emissions by month, by default False. The data is then monthly: each year’s flux times EPA’s monthly scale factors (get_monthly_scale_factors()).

  • inventory_dir (str, optional) – Root of the inventory archive, by default $LAIR_INVENTORY_DIR.

See also

EPA

Why lair’s totals differ a little from EPA’s own.

Notes

One file per year, in EPA/v2/ below the inventory root (inventory_dir, default $LAIR_INVENTORY_DIR). lair reads every .nc file of the one folder it needs: EPA/v2/ for the base product (2012 to 2018), express/ when express=True (2012 to 2020), and monthly_scale_factors/ as well when scale_by_month=True (2012 to 2018):

EPA/v2/
  Gridded_GHGI_Methane_v2_2012.nc
  ...
  Gridded_GHGI_Methane_v2_2018.nc
  express/
    Express_Extension_Gridded_GHGI_Methane_v2_2012.nc
    ...
  monthly_scale_factors/
    Gridded_GHGI_Methane_v2_Monthly_Scale_Factors_2012.nc
    ...

Examples

The express extension by month, without the supplemental PostMeter sector. It reads $LAIR_INVENTORY_DIR, so these lines are not run when the docs build:

>>> from lair.inventories import EPAv2, sum_sectors
>>> epa = EPAv2(express=True, scale_by_month=True)
>>> flux = sum_sectors(epa.data, exclude=["PostMeter"])

Methods

get_monthly_scale_factors()

Get the monthly scale factors.

Inherited

From Inventory: absolute_emissions, collapsed, convert_units, data, get_files, get_standard_name, get_units, integrate, plot, quantify, regrid, reproject, resample, total_emissions

From BaseGrid: clip, copy, gridcell_area