lair.inventories.EDGARv8#

class lair.inventories.EDGARv8(pollutant, time_step='annual', inventory_dir=None, start=None, end=None)[source]#

Bases: EDGAR

EDGAR v8 - Global Greenhouse Gas Emissions

https://edgar.jrc.ec.europa.eu/dataset_ghg80

EDGAR (Emissions Database for Global Atmospheric Research) Community GHG Database, a collaboration between the European Commission, Joint Research Centre (JRC), the International Energy Agency (IEA), and comprising IEA-EDGAR CO2, EDGAR CH4, EDGAR N2O, EDGAR F-GASES version 8.0, (2023) European Commission, JRC (Datasets).

Annual data drop EDGAR’s combined fuel-exploitation file PRO_FFF (CH4 2020: 109.42 Mt) in favor of its COAL/GAS/OIL parts (109.27 Mt). The 0.15 Mt gap is an inconsistency within EDGAR’s own files, not data lair fails to read; EDGAR’s TOTALS follow PRO_FFF, so the sum of the sectors is 0.15 Mt below them (see GitHub issue #37).

Parameters:
  • pollutant (str) – The pollutant, as the name of its folder ('CH4').

  • time_step (Literal['annual', 'monthly'], optional) – The time step of the data, by default ‘annual’.

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

  • start (int, optional) – The first year to read, by default the first year the archive has.

  • end (int, optional) – The last year to read (included), by default the last year the archive has. Only the files of the years from start to end are opened, as EDGAR says.

Raises:
  • FileNotFoundError – If there are no files for the years from start to end.

  • TypeError – If start or end is not an integer year.

Notes

The annual files are in EDGAR/v8/CH4/, as the inventory example shows. The monthly files (time_step="monthly") are in EDGAR/v8/monthly/CH4/: one file per sector group and year, with the groups AGRICULTURE, BUILDINGS, FUEL_EXPLOITATION, IND_COMBUSTION, IND_PROCESSES, POWER_INDUSTRY, TRANSPORT and WASTE each in a folder of its own:

EDGAR/v8/monthly/CH4/
  AGRICULTURE/v8.0_FT2022_GHG_CH4_2000_AGRICULTURE_flx.nc
  AGRICULTURE/v8.0_FT2022_GHG_CH4_2001_AGRICULTURE_flx.nc
  ...
  WASTE/v8.0_FT2022_GHG_CH4_2022_WASTE_flx.nc

Without arguments every year is read. start and end open only the files of those years (both included); the inventory example says how long every year takes.

See also

EDGARv7

The version before.

Inventory.integrate

The total over a region.

Examples

The methane EDGAR v8 puts in the Salt Lake Valley each year, in kg, as Total an inventory over a region computes it. It reads $LAIR_INVENTORY_DIR, so these lines are not run when the docs build:

>>> from lair.inventories import EDGARv8
>>> inv = EDGARv8("CH4", start=2020, end=2022)
>>> slv = inv.clip(bbox=(-112.3, 40.4, -111.7, 41.0))
>>> slv.integrate().compute()

Inherited

From EDGAR: get_files, get_sector_name

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

From BaseGrid: clip, copy, gridcell_area