carbonr (version 0.2.7)

building_emissions: Building emissions (UK govt schema; table-driven)

Description

Building emissions (UK govt schema; table-driven)

Usage

building_emissions(
  water_supply = 0,
  water_trt = TRUE,
  water_unit = c("cubic metres", "million litres"),
  electricity_kWh = 0,
  electricity_TD = TRUE,
  electricity_WTT = TRUE,
  heat_kWh = 0,
  heat_TD = TRUE,
  heat_WTT = TRUE,
  units = c("kg", "tonnes"),
  value_col = c("value", "value_2024"),
  strict = TRUE
)

Value

numeric total CO2e in requested units.

Arguments

water_supply

numeric, amount of water in the given unit.

water_trt

logical, include treatment emissions (default TRUE).

water_unit

"cubic metres" or "million litres".

electricity_kWh

numeric kWh consumed.

electricity_TD

logical, include T&D losses (default TRUE).

electricity_WTT

logical, include WTT for electricity (default TRUE).

heat_kWh

numeric kWh of heat/steam (onsite; excludes district).

heat_TD

logical, include district heat distribution losses (default TRUE).

heat_WTT

logical, include WTT for heat/steam (default TRUE).

units

"kg" or "tonnes" for the result (default "kg").

value_col

which factor column to use: "value" or "value_2024" (default "value").

strict

logical, error if a required factor is missing (default TRUE).

Examples

# specify emissions in an office
# Basic office: include water treatment, electricity TD+WTT, and heat TD+WTT
building_emissions(
  water_supply = 10, water_unit = "cubic metres", water_trt = TRUE,
  electricity_kWh = 100, electricity_TD = TRUE, electricity_WTT = TRUE,
  heat_kWh = 50, heat_TD = TRUE, heat_WTT = TRUE,
  units = "kg"
)

# Water only, in million litres, reported in tonnes, using 2024 factors
building_emissions(
  water_supply = 0.002, water_unit = "million litres", water_trt = TRUE,
  electricity_kWh = 0, heat_kWh = 0,
  value_col = "value_2024", units = "tonnes"
)

# Electricity without TD (but with WTT generation)
building_emissions(
  electricity_kWh = 10, electricity_TD = FALSE, electricity_WTT = TRUE,
  heat_kWh = 0, water_supply = 0
)

# Heat only, include WTT but exclude distribution
building_emissions(
  heat_kWh = 20, heat_TD = FALSE, heat_WTT = TRUE,
  water_supply = 0, electricity_kWh = 0
)