lair.inventories.Vulcan#

class lair.inventories.Vulcan(time_step='annual', region='US', inventory_dir=None)[source]#

Bases: Inventory

The Vulcan Project

https://vulcan.rc.nau.edu/ v3: https://daac.ornl.gov/NACP/guides/Vulcan_V3_Annual_Emissions.html

The Vulcan Project quantifies all fossil fuel CO2 emissions for the entire United States at high space- and time-resolution with details on economic sector, fuel, and combustion process. It was created by the research team of Dr. Kevin Robert Gurney at Northern Arizona University.

Gurney, K.R., J. Liang, R. Patarasuk, Y. Song, J. Huang, and G. Roest. 2019. Vulcan: High-Resolution Annual Fossil Fuel CO2 Emissions in USA, 2010-2015, Version 3. ORNL DAAC, Oak Ridge, Tennessee, USA. https://doi.org/10.3334/ORNLDAAC/1741

Note

Vulcan distributes emissions as mass of carbon (tC, i.e. Mg C km-2 yr-1). lair converts them to mass of CO2 on load (multiplying by M(CO2)/M(C) ~= 3.664) so the values are consistent with pollutant='CO2' and with unit conversions to moles. Divide by that factor to recover the published tC values. Cells without emissions (NaN in the files) are set to 0.

Notes

One file per sector, in vulcan/v3/data/native/ below the inventory root (inventory_dir, default $LAIR_INVENTORY_DIR). lair reads the US files of the central estimate (mn), and not the total file; the lo and hi files (the 95% bounds) are read only by get_uncertainties, and files of other regions (AK) are ignored. An annual file holds every year, 2010 to 2015. The hourly folder holds one file per sector and day of 2015:

vulcan/v3/data/native/
  annual/
    Vulcan_v3_US_annual_1km_airport_mn.nc4
    Vulcan_v3_US_annual_1km_airport_lo.nc4
    Vulcan_v3_US_annual_1km_airport_hi.nc4
    ...
  hourly/
    Vulcan.v3.US.hourly.1km.airport.mn.2015.d001.nc4
    Vulcan.v3.US.hourly.1km.airport.mn.2015.d002.nc4
    ...
Parameters:
  • time_step (Literal['annual', 'hourly'], optional) – The time step of the data, by default ‘annual’.

  • region (Literal['US', 'AK'], optional) – The region of the data, by default ‘US’. 'AK' raises a ValueError: Alaska crosses the 180th meridian.

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

See also

Vulcan.clip

Clip in the native Lambert conformal coordinates first.

Vulcan.reproject

Then put it on a lat/lon grid.

Examples

The data is on Vulcan’s 1 km Lambert conformal grid: clip it, then reproject it to lat/lon. It reads $LAIR_INVENTORY_DIR, so these lines are not run when the docs build:

>>> from lair.inventories import Vulcan
>>> vulcan = Vulcan()
>>> box = vulcan.clip(
...     bbox=(-112.3, 40.4, -111.7, 41.0), crs="EPSG:4326"
... )
>>> latlon = box.reproject(0.01)

Methods

clip([bbox, extent, geom, crs, inplace])

Clip the data to the given bounds.

get_files([uncertainty])

Return this region's sector files for one uncertainty (central by default).

get_uncertainties(uncertainty)

Get the lower or upper 95% confidence bound of the emissions.

reproject([resolution, regrid_method, ...])

Reproject the data to a lat lon rectilinear grid.

Inherited

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

From BaseGrid: copy, gridcell_area