User Guide
/
09.4 · Carbon Emissions

Carbon Formulas

Core Formula

TotalEmissions = Quantity × EmissionFactor

Applied on:

EntityNotes
DirectCostEmissionQuantity is the item's quantity (editable).
OverheadEmissionUses Amount (dollar, or alternate) as the driver.
CarbonEmissionAllocationUses ActivityData × EmissionFactor for custom allocations.

Three Allocation Methods

CarbonEmissionAllocation.Method:

  1. ResourceBased — factor pulled from the linked resource; quantity from the item. Default and most common.
  2. Formula — user-supplied expression via FormulaExpression. Can reference any project value: ``` FormulaExpression: #concrete_volume #cement_ratio 0.82 ```
  3. Manual — you enter the total emission directly (no formula).

Aggregations and Roll-Ups

The Summary view and Dashboard expose:

KPIFormula
TotalScope1EmissionsΣ emissions where Scope = 1.
TotalScope2EmissionsΣ emissions where Scope = 2.
TotalScope3EmissionsΣ emissions where Scope = 3.
TotalEmissionsScope1 + Scope2 + Scope3.
VerifiedPercentageVerified rows ÷ total rows × 100.
Data quality weightedΣ (Quality × Emission) / Σ Emission — indicates overall confidence.

Carbon Apportionment to Direct Costs

When an overhead is apportioned to direct cost items, its emission can be distributed too. CarbonAllocationMethod setting:

  • ProportionalToCarbon — by each target's direct carbon emission ratio.
  • Equal — split evenly across targets.

The result is AllocatedOverheadCarbon on each item, shown on the sell-rate view and on PDF reports.

Sell-Rate Carbon

A SellRateLineItem includes three carbon fields:

  • DirectCarbonEmissions — the item's own emission.
  • AllocatedOverheadCarbon — the apportioned share.
  • TotalCarbon — the sum.

This means every tender line can show a cost and a kg-CO₂e figure for ESG-aware clients.

Unit Consistency Warning

If the item's unit (e.g. m³) differs from the emission factor's unit (e.g. kg), TX1 flags a potential mismatch. You must either:

  • Use a factor priced per the same unit, or
  • Add a unit-conversion factor in the formula (e.g. density for m³ → kg).

Reporting Example

A 100 m³ concrete item with a factor of 240 kgCO₂e/m³:

DirectCarbonEmissions = 100 × 240 = 24,000 kgCO₂e = 24.0 tCO₂e (Scope 3)

Apportioned site-office electricity (Scope 2) distributes its carbon proportionally:

AllocatedOverheadCarbon = item.share × overheadScope2Pool

TotalCarbon = DirectCarbonEmissions + AllocatedOverheadCarbon.