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

In carbonr: Calculate Carbon-Equivalent 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
)

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).

Value

numeric total CO2e in requested units.

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
)

carbonr documentation built on Sept. 11, 2025, 9:11 a.m.