lair.inventories.EDGARv8#
- class lair.inventories.EDGARv8(pollutant, time_step='annual', inventory_dir=None, start=None, end=None)[source]#
Bases:
EDGAREDGAR 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’sTOTALSfollowPRO_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
starttoendare opened, asEDGARsays.
- Raises:
FileNotFoundError – If there are no files for the years from
starttoend.TypeError – If
startorendis 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 inEDGAR/v8/monthly/CH4/: one file per sector group and year, with the groupsAGRICULTURE,BUILDINGS,FUEL_EXPLOITATION,IND_COMBUSTION,IND_PROCESSES,POWER_INDUSTRY,TRANSPORTandWASTEeach 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.
startandendopen only the files of those years (both included); the inventory example says how long every year takes.See also
EDGARv7The version before.
Inventory.integrateThe 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