Lifecycle Carbon Calculator
Scanned@datadrivenconstruction
npx machina-cli add skill @datadrivenconstruction/lifecycle-carbon-calculator --openclawLifecycle Carbon Calculator for Construction
Overview
Calculate embodied carbon (EC) and lifecycle carbon emissions for construction materials, assemblies, and projects. Support sustainable design decisions and carbon reduction targets.
Business Case
Carbon calculation supports:
- Regulatory Compliance: Meet carbon reporting requirements
- Green Certifications: LEED, BREEAM, Living Building Challenge
- Design Optimization: Choose lower-carbon alternatives
- Sustainability Goals: Track progress toward net-zero
Technical Implementation
from dataclasses import dataclass, field
from typing import List, Dict, Any, Optional
from enum import Enum
import pandas as pd
class LifecycleStage(Enum):
A1_A3 = "Product Stage (A1-A3)" # Raw materials, transport, manufacturing
A4 = "Transport to Site (A4)"
A5 = "Construction (A5)"
B1_B7 = "Use Stage (B1-B7)" # Maintenance, repair, replacement
C1_C4 = "End of Life (C1-C4)" # Demolition, transport, disposal
D = "Beyond Lifecycle (D)" # Reuse, recycling potential
@dataclass
class MaterialCarbon:
material_id: str
name: str
category: str
unit: str
carbon_a1_a3: float # kgCO2e per unit
carbon_a4: float
carbon_a5: float
carbon_b: float
carbon_c: float
carbon_d: float # Usually negative (credit)
density: float # kg/m³ if applicable
source: str
epd_url: str = ""
@dataclass
class AssemblyCarbon:
assembly_id: str
name: str
materials: List[Dict[str, Any]]
total_carbon: float
carbon_by_stage: Dict[str, float]
@dataclass
class ProjectCarbon:
project_id: str
name: str
gross_area: float
assemblies: List[AssemblyCarbon]
total_embodied_carbon: float
carbon_per_area: float
carbon_by_stage: Dict[str, float]
carbon_by_category: Dict[str, float]
benchmark_comparison: Dict[str, Any]
class LifecycleCarbonCalculator:
"""Calculate lifecycle carbon for construction."""
# Sample material carbon data (kgCO2e per unit)
DEFAULT_MATERIALS = {
'concrete_30mpa': MaterialCarbon(
material_id='C30', name='Concrete 30MPa', category='Concrete',
unit='m³', carbon_a1_a3=300, carbon_a4=5, carbon_a5=2,
carbon_b=0, carbon_c=10, carbon_d=-20, density=2400,
source='EPD Database'
),
'concrete_40mpa': MaterialCarbon(
material_id='C40', name='Concrete 40MPa', category='Concrete',
unit='m³', carbon_a1_a3=350, carbon_a4=5, carbon_a5=2,
carbon_b=0, carbon_c=10, carbon_d=-20, density=2400,
source='EPD Database'
),
'steel_rebar': MaterialCarbon(
material_id='REBAR', name='Steel Reinforcing Bar', category='Steel',
unit='kg', carbon_a1_a3=1.99, carbon_a4=0.05, carbon_a5=0.02,
carbon_b=0, carbon_c=0.05, carbon_d=-0.5, density=7850,
source='WorldSteel EPD'
),
'steel_structural': MaterialCarbon(
material_id='STEEL', name='Structural Steel', category='Steel',
unit='kg', carbon_a1_a3=1.55, carbon_a4=0.05, carbon_a5=0.03,
carbon_b=0, carbon_c=0.05, carbon_d=-0.8, density=7850,
source='AISC EPD'
),
'timber_clt': MaterialCarbon(
material_id='CLT', name='Cross-Laminated Timber', category='Timber',
unit='m³', carbon_a1_a3=-500, carbon_a4=10, carbon_a5=5,
carbon_b=0, carbon_c=50, carbon_d=-100, density=500,
source='AWC EPD'
),
'gypsum_board': MaterialCarbon(
material_id='GYP', name='Gypsum Board 12.5mm', category='Finishes',
unit='m²', carbon_a1_a3=3.2, carbon_a4=0.2, carbon_a5=0.1,
carbon_b=0, carbon_c=0.3, carbon_d=-0.1, density=10,
source='EUROGYPSUM EPD'
),
'insulation_mineral': MaterialCarbon(
material_id='INS_MW', name='Mineral Wool Insulation', category='Insulation',
unit='m³', carbon_a1_a3=45, carbon_a4=2, carbon_a5=1,
carbon_b=0, carbon_c=5, carbon_d=-2, density=40,
source='EURIMA EPD'
),
'glass_double': MaterialCarbon(
material_id='GLASS', name='Double Glazed Unit', category='Glazing',
unit='m²', carbon_a1_a3=35, carbon_a4=1, carbon_a5=0.5,
carbon_b=0, carbon_c=2, carbon_d=-5, density=25,
source='Glass for Europe EPD'
),
'aluminum': MaterialCarbon(
material_id='ALU', name='Aluminum Profile', category='Metals',
unit='kg', carbon_a1_a3=8.0, carbon_a4=0.1, carbon_a5=0.05,
carbon_b=0, carbon_c=0.1, carbon_d=-4.0, density=2700,
source='EAA EPD'
),
}
# Building type benchmarks (kgCO2e/m²)
BENCHMARKS = {
'Office': {'typical': 500, 'good': 350, 'best': 200},
'Residential': {'typical': 400, 'good': 280, 'best': 150},
'Retail': {'typical': 450, 'good': 320, 'best': 180},
'Industrial': {'typical': 350, 'good': 250, 'best': 150},
'Healthcare': {'typical': 700, 'good': 500, 'best': 350},
}
def __init__(self):
self.materials: Dict[str, MaterialCarbon] = dict(self.DEFAULT_MATERIALS)
self.assemblies: Dict[str, AssemblyCarbon] = {}
def add_material(self, material: MaterialCarbon):
"""Add or update a material."""
self.materials[material.material_id] = material
def calculate_material_carbon(self, material_id: str, quantity: float,
stages: List[LifecycleStage] = None) -> Dict:
"""Calculate carbon for a material quantity."""
if material_id not in self.materials:
raise ValueError(f"Unknown material: {material_id}")
material = self.materials[material_id]
if stages is None:
stages = list(LifecycleStage)
carbon_by_stage = {}
total = 0
for stage in stages:
if stage == LifecycleStage.A1_A3:
carbon = material.carbon_a1_a3 * quantity
elif stage == LifecycleStage.A4:
carbon = material.carbon_a4 * quantity
elif stage == LifecycleStage.A5:
carbon = material.carbon_a5 * quantity
elif stage == LifecycleStage.B1_B7:
carbon = material.carbon_b * quantity
elif stage == LifecycleStage.C1_C4:
carbon = material.carbon_c * quantity
elif stage == LifecycleStage.D:
carbon = material.carbon_d * quantity
else:
carbon = 0
carbon_by_stage[stage.value] = carbon
total += carbon
return {
'material_id': material_id,
'material_name': material.name,
'quantity': quantity,
'unit': material.unit,
'total_carbon': total,
'carbon_by_stage': carbon_by_stage
}
def create_assembly(self, assembly_id: str, name: str,
components: List[Dict]) -> AssemblyCarbon:
"""Create an assembly from multiple materials."""
total_carbon = 0
carbon_by_stage = {stage.value: 0 for stage in LifecycleStage}
material_details = []
for comp in components:
material_id = comp['material_id']
quantity = comp['quantity']
result = self.calculate_material_carbon(material_id, quantity)
total_carbon += result['total_carbon']
for stage, carbon in result['carbon_by_stage'].items():
carbon_by_stage[stage] += carbon
material_details.append({
'material': result['material_name'],
'quantity': quantity,
'unit': result['unit'],
'carbon': result['total_carbon']
})
assembly = AssemblyCarbon(
assembly_id=assembly_id,
name=name,
materials=material_details,
total_carbon=total_carbon,
carbon_by_stage=carbon_by_stage
)
self.assemblies[assembly_id] = assembly
return assembly
def calculate_project_carbon(self, project_id: str, project_name: str,
gross_area: float, building_type: str,
quantities: List[Dict]) -> ProjectCarbon:
"""Calculate total project carbon."""
assemblies = []
total_carbon = 0
carbon_by_stage = {stage.value: 0 for stage in LifecycleStage}
carbon_by_category = {}
for qty in quantities:
if 'assembly_id' in qty:
# Use predefined assembly
if qty['assembly_id'] in self.assemblies:
assembly = self.assemblies[qty['assembly_id']]
multiplier = qty.get('multiplier', 1)
scaled_carbon = assembly.total_carbon * multiplier
assemblies.append(AssemblyCarbon(
assembly_id=assembly.assembly_id,
name=assembly.name,
materials=assembly.materials,
total_carbon=scaled_carbon,
carbon_by_stage={k: v * multiplier for k, v in assembly.carbon_by_stage.items()}
))
total_carbon += scaled_carbon
elif 'material_id' in qty:
# Direct material
result = self.calculate_material_carbon(
qty['material_id'], qty['quantity']
)
total_carbon += result['total_carbon']
for stage, carbon in result['carbon_by_stage'].items():
carbon_by_stage[stage] += carbon
# Track by category
material = self.materials[qty['material_id']]
cat = material.category
carbon_by_category[cat] = carbon_by_category.get(cat, 0) + result['total_carbon']
# Calculate metrics
carbon_per_area = total_carbon / gross_area if gross_area > 0 else 0
# Compare to benchmarks
benchmark = self.BENCHMARKS.get(building_type, self.BENCHMARKS['Office'])
benchmark_comparison = {
'carbon_per_area': carbon_per_area,
'typical_benchmark': benchmark['typical'],
'good_benchmark': benchmark['good'],
'best_benchmark': benchmark['best'],
'vs_typical': (carbon_per_area / benchmark['typical'] - 1) * 100,
'rating': self._get_rating(carbon_per_area, benchmark)
}
return ProjectCarbon(
project_id=project_id,
name=project_name,
gross_area=gross_area,
assemblies=assemblies,
total_embodied_carbon=total_carbon,
carbon_per_area=carbon_per_area,
carbon_by_stage=carbon_by_stage,
carbon_by_category=carbon_by_category,
benchmark_comparison=benchmark_comparison
)
def _get_rating(self, carbon: float, benchmark: Dict) -> str:
"""Get rating based on benchmark comparison."""
if carbon <= benchmark['best']:
return 'A (Best Practice)'
elif carbon <= benchmark['good']:
return 'B (Good Practice)'
elif carbon <= benchmark['typical']:
return 'C (Typical)'
else:
return 'D (Above Typical)'
def compare_alternatives(self, base_project: ProjectCarbon,
alternatives: List[Dict]) -> pd.DataFrame:
"""Compare carbon of design alternatives."""
comparisons = [{
'Option': 'Base Design',
'Total Carbon (tCO2e)': base_project.total_embodied_carbon / 1000,
'Carbon/m² (kgCO2e)': base_project.carbon_per_area,
'vs Base': '0%',
'Rating': base_project.benchmark_comparison['rating']
}]
for alt in alternatives:
project = self.calculate_project_carbon(
alt['id'], alt['name'], alt['gross_area'],
alt.get('building_type', 'Office'), alt['quantities']
)
change = (project.total_embodied_carbon - base_project.total_embodied_carbon) / base_project.total_embodied_carbon * 100
comparisons.append({
'Option': alt['name'],
'Total Carbon (tCO2e)': project.total_embodied_carbon / 1000,
'Carbon/m² (kgCO2e)': project.carbon_per_area,
'vs Base': f'{change:+.1f}%',
'Rating': project.benchmark_comparison['rating']
})
return pd.DataFrame(comparisons)
def suggest_reductions(self, project: ProjectCarbon) -> List[Dict]:
"""Suggest carbon reduction opportunities."""
suggestions = []
# Analyze by category
if 'Concrete' in project.carbon_by_category:
concrete_carbon = project.carbon_by_category['Concrete']
if concrete_carbon > project.total_embodied_carbon * 0.3:
suggestions.append({
'category': 'Concrete',
'current_carbon': concrete_carbon,
'suggestion': 'Consider low-carbon concrete (GGBS/PFA replacement)',
'potential_reduction': '20-40%',
'impact': concrete_carbon * 0.3
})
if 'Steel' in project.carbon_by_category:
steel_carbon = project.carbon_by_category['Steel']
if steel_carbon > project.total_embodied_carbon * 0.2:
suggestions.append({
'category': 'Steel',
'current_carbon': steel_carbon,
'suggestion': 'Specify high recycled content steel',
'potential_reduction': '10-25%',
'impact': steel_carbon * 0.2
})
# Benchmark-based suggestions
if project.benchmark_comparison['vs_typical'] > 0:
suggestions.append({
'category': 'Overall',
'current_carbon': project.total_embodied_carbon,
'suggestion': 'Project exceeds typical benchmark - review high-carbon elements',
'potential_reduction': f"{abs(project.benchmark_comparison['vs_typical']):.0f}%",
'impact': project.total_embodied_carbon * abs(project.benchmark_comparison['vs_typical']) / 100
})
return sorted(suggestions, key=lambda x: -x['impact'])
def generate_report(self, project: ProjectCarbon) -> str:
"""Generate carbon assessment report."""
lines = ["# Embodied Carbon Assessment Report", ""]
lines.append(f"**Project:** {project.name}")
lines.append(f"**Gross Area:** {project.gross_area:,.0f} m²")
lines.append(f"**Assessment Date:** {pd.Timestamp.now().strftime('%Y-%m-%d')}")
lines.append("")
# Summary
lines.append("## Carbon Summary")
lines.append(f"- **Total Embodied Carbon:** {project.total_embodied_carbon/1000:,.0f} tCO2e")
lines.append(f"- **Carbon Intensity:** {project.carbon_per_area:,.0f} kgCO2e/m²")
lines.append(f"- **Rating:** {project.benchmark_comparison['rating']}")
lines.append("")
# By lifecycle stage
lines.append("## Carbon by Lifecycle Stage")
for stage, carbon in project.carbon_by_stage.items():
if carbon != 0:
pct = carbon / project.total_embodied_carbon * 100
lines.append(f"- {stage}: {carbon/1000:,.1f} tCO2e ({pct:.1f}%)")
lines.append("")
# By category
lines.append("## Carbon by Material Category")
for cat, carbon in sorted(project.carbon_by_category.items(), key=lambda x: -x[1]):
pct = carbon / project.total_embodied_carbon * 100
lines.append(f"- {cat}: {carbon/1000:,.1f} tCO2e ({pct:.1f}%)")
lines.append("")
# Benchmark
lines.append("## Benchmark Comparison")
bc = project.benchmark_comparison
lines.append(f"- Project: {bc['carbon_per_area']:.0f} kgCO2e/m²")
lines.append(f"- Typical: {bc['typical_benchmark']} kgCO2e/m²")
lines.append(f"- Good Practice: {bc['good_benchmark']} kgCO2e/m²")
lines.append(f"- Best Practice: {bc['best_benchmark']} kgCO2e/m²")
lines.append("")
# Reduction opportunities
suggestions = self.suggest_reductions(project)
if suggestions:
lines.append("## Reduction Opportunities")
for sug in suggestions[:5]:
lines.append(f"\n### {sug['category']}")
lines.append(f"- **Suggestion:** {sug['suggestion']}")
lines.append(f"- **Potential Reduction:** {sug['potential_reduction']}")
lines.append(f"- **Impact:** {sug['impact']/1000:,.1f} tCO2e")
return "\n".join(lines)
Quick Start
# Initialize calculator
calc = LifecycleCarbonCalculator()
# Calculate project carbon
project = calc.calculate_project_carbon(
project_id="PROJ-001",
project_name="Office Building",
gross_area=5000,
building_type="Office",
quantities=[
{'material_id': 'concrete_40mpa', 'quantity': 1500}, # m³
{'material_id': 'steel_rebar', 'quantity': 150000}, # kg
{'material_id': 'steel_structural', 'quantity': 200000},
{'material_id': 'gypsum_board', 'quantity': 8000}, # m²
{'material_id': 'glass_double', 'quantity': 1200}, # m²
]
)
print(f"Total Carbon: {project.total_embodied_carbon/1000:,.0f} tCO2e")
print(f"Carbon Intensity: {project.carbon_per_area:,.0f} kgCO2e/m²")
print(f"Rating: {project.benchmark_comparison['rating']}")
# Get reduction suggestions
suggestions = calc.suggest_reductions(project)
for sug in suggestions:
print(f"- {sug['category']}: {sug['suggestion']}")
# Generate full report
report = calc.generate_report(project)
print(report)
Dependencies
pip install pandas
Overview
The Lifecycle Carbon Calculator estimates embodied carbon (EC) and lifecycle emissions for construction materials, assemblies, and projects. It supports sustainable design decisions and carbon reduction targets by providing stage-by-stage and category breakdowns, aiding regulatory reporting and green certifications.
How This Skill Works
This tool models lifecycle carbon across stages A1-A3, A4, A5, B (Use), C (End of Life), and D (Beyond Lifecycle) using material data objects (MaterialCarbon, AssemblyCarbon, ProjectCarbon). Users input material and assembly data, then the calculator aggregates emissions by stage and category to produce total project carbon and per-area metrics for benchmarking.
When to Use It
- Preparing regulatory carbon reporting and compliance documentation
- Pursuing LEED, BREEAM, Living Building Challenge, or other green certifications
- Design optimization to substitute high-carbon materials with lower-carbon alternatives
- Tracking progress toward net-zero or carbon reduction targets on a project
- Benchmarking different design options to compare embodied carbon outcomes
Quick Start
- Step 1: Gather material data (material_id, name, unit, and stage-specific carbon factors) and define assemblies and project scope
- Step 2: Input data into the calculator (assemble MaterialCarbon, AssemblyCarbon, and ProjectCarbon structures) and run the model
- Step 3: Review outputs (total_embodied_carbon, carbon_by_stage, carbon_per_area, and benchmark_comparison) and iterate design options
Best Practices
- Use verified EPD data or validated default datasets for each material
- Include all lifecycle stages (A1-A5, B, C, and D where relevant) in calculations
- Maintain unit consistency and document data sources and assumptions
- Break down emissions by material, assembly, and category for traceability
- Regularly update data as new EPDs become available and targets evolve
Example Use Cases
- Compare concrete mixes (e.g., 30 MPa vs. 40 MPa) to quantify differences in embodied carbon for a given structural shell
- Evaluate steel reinforcing vs. alternative low-carbon reinforcement to reduce EC in a concrete frame
- Use cross-laminated timber (CLT) assemblies to lower EC in a mid-rise building design
- Incorporate reuse and recycling strategies (D stage) to credit end-of-life emissions
- Benchmark a project against net-zero targets to drive material and design choices across assemblies