lair.inventories.Vulcan#
- class lair.inventories.Vulcan(time_step='annual', region='US', inventory_dir=None)[source]#
Bases:
InventoryThe 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 withpollutant='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 theUSfiles of the central estimate (mn), and not thetotalfile; theloandhifiles (the 95% bounds) are read only byget_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 aValueError: Alaska crosses the 180th meridian.inventory_dir (str, optional) – Root of the inventory archive, by default
$LAIR_INVENTORY_DIR.
See also
Vulcan.clipClip in the native Lambert conformal coordinates first.
Vulcan.reprojectThen 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 the data to the given bounds. |
|
Return this region's sector files for one uncertainty ( |
|
Get the lower or upper 95% confidence bound of the emissions. |
|
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