Energy

Energy emissions are computed based on the consumption, the emission factors for a specified fuel type and a share (of the heated area or the used electricity).

class co2calculator.api.energy.Energy(consumption: float, fuel_type: str | None = None, own_share: float = 1.0)

from_electricity(country_code: str)

Calculate emissions from electricity consumption

Parameters:

country_code (str) – 2-letter ISO country code

from_heating(unit: str)

Calculate emissions from heating consumption

Parameters:

unit (str) – unit of measurement for heating consumption

For the emission factors, see Emission factors

Heating

Per default, the expected unit is kWh. For some fuel types, the consumption may also be specified using different units, e.g., litres of oil or kg of wood chips. In these cases, it is possible to specify the unit. The consumption will then be converted from the specified unit to kWh, based on common conversion factors:

Conversion factors heating

	fuel_type	unit	conversion_value
0	oil	l	10.6
1	liquid gas	kg	14.1
2	coal	kg	6.0
3	wood pellets	kg	5.4
4	wood chips	kg	5.2
5	gas	m^3	10.8

The parameter own_share accounts for the fact, that the heating energy consumption may often only be known for an entire building, while a person/group/etc. just occupies parts of the building. In this case, the (approximate) share of the building floor space, that is occupied by the working group can be provided. The own_share must be between 0.0 and 1.0 and is 1.0 by default.

Electricity

Electricity emissions are computed based on the consumption (in kWh) and the emission factors for a specified energy mix or energy source.