lair.inventories.Inventory.absolute_emissions#
- property Inventory.absolute_emissions: Dataset#
The mass emitted in each grid cell in each time step, sector by sector.
Each sector’s flux is multiplied by the area of its grid cell and by the length of the time step. The area and time units cancel, so the values are in the inventory’s own mass (or amount) unit:
kgfor a flux inkg/m**2/s,Mgfor one inMg/km**2/yr. With annual data, each value is the mass the cell emitted in that year; with monthly data, in that month.Use it for the mass in one cell, or a sector’s total over a region (
absolute_emissions.sum(["lat", "lon"])). For the total of every sector over the region, useInventory.integrate(), which is that sum added over the sectors. The inventory example shows the three sums side by side.The length of a time step:
When the flux is a rate per time step (
a-1with annual data,month-1with monthly,d-1with daily,hr-1with hourly …), each value is multiplied by exactly one step. This avoids pint’s Julian year (365.25 d) and month (1/12 of that), so 1 Mg km-2 a-1 over 1 km2 is exactly 1 Mg in every year.Any other rate (e.g.
s-1) is multiplied by the true calendar length of each step: 366 days in leap years, the actual days in each month. This matches EDGAR, whose leap-year files stateinterval: 1 year, 366 days.
So the unit of the flux does not matter.
Inventory.convert_units()gives a rate per time step the same calendar length, so convertingkg/m**2/stoGg/km**2/yrfirst gives the same masses.- Returns:
xr.Dataset – One variable per sector, on the inventory’s grid and time steps, each with its mass unit in its
unitsattribute.
See also
Inventory.integrateThe total over the grid, every sector added.
Inventory.total_emissionsThe flux in each cell, every sector added.