lair.inventories.GFEIv1#

class lair.inventories.GFEIv1(inventory_dir=None)[source]#

Bases: GFEI

Global Fuel Exploitation Inventory v1

https://dataverse.harvard.edu/dataset.xhtml?persistentId=doi:10.7910/DVN/HH4EUM&version=1.0

Scarpelli, T. R., Jacob, D. J., Maasakkers, J. D., Sulprizio, M. P., Sheng, J.-X., Rose, K., Romeo, L., Worden, J. R., and Janssens-Maenhout, G.: A global gridded (0.1° × 0.1°) inventory of methane emissions from oil, gas, and coal exploitation based on national reports to the United Nations Framework Convention on Climate Change, Earth Syst. Sci. Data, 12, 563–575, https://doi.org/10.5194/essd-12-563-2020, 2020a.

Notes

One file per sector, in GFEI/v1/ below the inventory root (inventory_dir, default $LAIR_INVENTORY_DIR), for the year 2016. A sector’s _gsd and _rsd files (the geometric and the relative standard deviation) are read only by get_standard_deviations, and the _All files (Gas_All, Oil_All) are not read. Keep the Total_Fuel_Exploitation file in the folder: lair drops its variable after reading, and raises a ValueError when the file is missing:

GFEI/v1/
  Global_Fuel_Exploitation_Inventory_Coal.nc
  Global_Fuel_Exploitation_Inventory_Coal_gsd.nc
  Global_Fuel_Exploitation_Inventory_Coal_rsd.nc
  Global_Fuel_Exploitation_Inventory_Gas_Distribution.nc
  ...
  Global_Fuel_Exploitation_Inventory_Total_Fuel_Exploitation.nc
Parameters:

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

See also

GFEIv2

The update, for 2019.

Examples

It reads $LAIR_INVENTORY_DIR, so these lines are not run when the docs build:

>>> from lair.inventories import GFEIv1
>>> gfei = GFEIv1()
>>> rsd = gfei.get_standard_deviations("relative")

Methods

get_standard_deviations(kind)

Get the standard deviations.

Inherited

From GFEI: get_files

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