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: kg for a flux in kg/m**2/s, Mg for one in Mg/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, use Inventory.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-1 with annual data, month-1 with monthly, d-1 with daily, hr-1 with 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 state interval: 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 converting kg/m**2/s to Gg/km**2/yr first 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 units attribute.

See also

Inventory.integrate

The total over the grid, every sector added.

Inventory.total_emissions

The flux in each cell, every sector added.