Skip to content

stvn101/carbonconstruct_gen

Repository files navigation

CarbonConstruct - Embodied Carbon Calculator

A comprehensive web-based tool for calculating and reporting embodied carbon in Australian construction projects

Version Compliance License


🎯 Overview

CarbonConstruct is a professional embodied carbon calculator designed specifically for the Australian construction industry. Built to meet current and future reporting requirements, it provides comprehensive Life Cycle Assessment (LCA) and GHG Protocol Scopes reporting for construction projects.

Why This Tool Exists

The building and construction sector accounts for 39% of global carbon emissions. With new Australian regulations requiring climate-related financial disclosures from January 2025, construction companies need accessible tools to:

  • Calculate embodied carbon across all lifecycle stages
  • Ensure compliance with NCC, NABERS, and GBCA standards
  • Report emissions following GHG Protocol standards
  • Make informed decisions about material selection
  • Demonstrate sustainability to clients and stakeholders

✨ Key Features

πŸ“Š Complete Life Cycle Assessment (LCA)

  • Full cradle-to-grave analysis following ISO 14040/14044 and EN 15978
  • All lifecycle stages covered:
    • A1-A3: Product stage (raw materials β†’ manufacturing)
    • A4-A5: Construction stage (transport β†’ installation)
    • B1-B7: Use stage (maintenance, repair, replacement)
    • C1-C4: End-of-life stage (demolition β†’ disposal)
    • D: Benefits from recycling and recovery

🌍 GHG Protocol Scopes (1, 2, 3)

  • Scope 1: Direct emissions from owned/controlled sources
  • Scope 2: Indirect emissions from purchased energy
  • Scope 3: All other indirect emissions (materials, transport, waste)
  • Automatic mapping between LCA stages and GHG Scopes

βœ… Australian Compliance Standards

  • NCC 2022 (National Construction Code) - Section J compliance
  • NABERS (National Australian Built Environment Rating System) - Star ratings
  • GBCA Green Star - Points calculation and certification levels
  • TCFD (Climate-related Financial Disclosures) - Reporting requirements
  • NGER (National Greenhouse and Energy Reporting) - Threshold checks

πŸ—οΈ Comprehensive Materials Database

Over 40+ construction materials with verified embodied carbon coefficients:

  • Concrete (standard, high-strength, geopolymer, recycled aggregate)
  • Steel (virgin, recycled, structural sections, reinforcement)
  • Timber (hardwood, softwood, engineered products like CLT, LVL, Glulam)
  • Masonry (bricks, blocks, AAC)
  • Insulation (glasswool, rockwool, EPS, XPS)
  • Glazing (windows, frames, double-glazed units)
  • Finishes (plasterboard, paint, tiles, flooring)

πŸ“ˆ Visual Reporting & Analytics

  • Interactive charts using Chart.js
  • Industry benchmarking (compare against averages and best practice)
  • Material breakdown showing highest-carbon contributors
  • Compliance dashboards with real-time status updates
  • Export capabilities (JSON data and text reports)

πŸ’Ύ Project Management

  • Save and load projects using RESTful API
  • Project library with search and filter
  • Version tracking with last modified dates
  • Export reports for documentation and audits

πŸš€ Getting Started

Accessing the Application

The application is a static website that runs entirely in your browser. Simply open index.html in a modern web browser.

Creating Your First Project

  1. Enter Project Details

    • Project name (e.g., "Melbourne Office Tower")
    • Project type (Residential, Commercial, Industrial, Infrastructure)
    • Gross Floor Area (mΒ²)
    • Design life (typically 50 years)
  2. Add Materials

    • Select material category (Concrete, Steel, Timber, etc.)
    • Choose specific material type
    • Enter quantity and unit
    • Click "Add Material"
  3. Calculate Emissions

    • Click "Calculate All" button
    • View results across all sections:
      • LCA breakdown by lifecycle stage
      • GHG Scopes 1, 2, 3
      • Compliance status for NCC, NABERS, GBCA
      • Summary metrics and equivalents
  4. Save & Export

    • Click "Save Project" to store in database
    • Click "Export Report" for documentation
    • View saved projects in the "Saved Projects" section

πŸ“‹ Features Currently Implemented

βœ… Completed Features

  1. Project Setup & Management

    • Project details input (name, type, GFA, design life)
    • Material selection from comprehensive database
    • Add/remove materials functionality
    • Materials quantity tracking
  2. Calculation Engines

    • Full LCA calculator (A1-C4, D stages)
    • GHG Protocol Scopes calculator (1, 2, 3)
    • Embodied carbon computation
    • Carbon intensity per mΒ² calculation
  3. Compliance Checking

    • NCC 2022 compliance assessment
    • NABERS star rating calculation
    • GBCA Green Star points and certification
    • TCFD reporting requirement checks
  4. Visualizations

    • LCA stages doughnut chart
    • GHG Scopes bar chart
    • Materials breakdown horizontal bar chart
    • Industry benchmarking comparison
  5. Data Persistence

    • Save projects to database (RESTful API)
    • Load saved projects
    • Delete projects
    • Search projects by name
    • Export project data (JSON)
    • Export text reports
  6. User Interface

    • Responsive design (mobile-friendly)
    • Professional construction industry styling
    • Smooth navigation and scrolling
    • Real-time updates
    • Clear compliance status indicators

πŸ”„ Features Not Yet Implemented

Future Enhancements

  1. Advanced Scope 1 & 2 Inputs

    • Manual entry for on-site fuel consumption
    • Construction equipment tracking
    • Site electricity usage calculator
  2. Enhanced Transport Calculations

    • Specific transport distances for each material
    • Multiple transport modes (truck, rail, ship)
    • Overseas vs. local sourcing options
  3. Operational Carbon Integration

    • B6 (operational energy) detailed calculator
    • Energy modeling integration
    • Operational vs. embodied carbon comparison
  4. Advanced Reporting

    • PDF report generation with charts
    • EPD (Environmental Product Declaration) integration
    • Multi-project comparison dashboard
    • Portfolio-level reporting
  5. Material Alternatives Analysis

    • "What-if" scenarios for material substitution
    • Cost vs. carbon trade-off analysis
    • Optimization recommendations
  6. Certification Support

    • Pre-filled templates for Green Star submissions
    • NABERS certification documentation
    • ISO 14040 compliant report formatting
  7. User Accounts & Collaboration

    • User authentication
    • Team collaboration features
    • Role-based access control
    • Project sharing

πŸ—οΈ Technical Architecture

Technology Stack

  • Frontend Framework: Vanilla JavaScript (ES6+)
  • UI Framework: Tailwind CSS (CDN)
  • Charts: Chart.js v4
  • Icons: Font Awesome 6
  • Fonts: Google Fonts (Inter)
  • Data Storage: RESTful Table API (built-in)

File Structure

CarbonConstruct/
β”‚
β”œβ”€β”€ index.html                 # Main application page
β”‚
β”œβ”€β”€ js/
β”‚   β”œβ”€β”€ materials-database.js  # Material coefficients & data
β”‚   β”œβ”€β”€ lca-calculator.js      # LCA calculation engine
β”‚   β”œβ”€β”€ scopes-calculator.js   # GHG Scopes calculator
β”‚   β”œβ”€β”€ compliance.js          # Australian standards checker
β”‚   β”œβ”€β”€ charts.js              # Chart.js visualizations
β”‚   β”œβ”€β”€ storage.js             # Database interactions
β”‚   └── main.js                # Application controller
β”‚
└── README.md                  # This file

Data Model

Projects Table Schema (carbon_projects)

Field Type Description
id text Unique project identifier
projectName text Project name
projectType text Type (residential/commercial/industrial/infrastructure)
gfa number Gross Floor Area (mΒ²)
designLife number Design life (years)
materials text JSON string of materials array
totalCarbon number Total embodied carbon (kg CO2-e)
carbonIntensity number Carbon per mΒ² (kg CO2-e/mΒ²)
lcaResults text JSON string of LCA results
scopesResults text JSON string of Scopes results
complianceResults text JSON string of compliance results
lastModified datetime Last modification timestamp

πŸ“Š Understanding the Metrics

Embodied Carbon

Definition: Total greenhouse gas emissions associated with materials and construction processes, expressed in kg CO2-e (carbon dioxide equivalent).

Why it matters: Unlike operational carbon (energy use), embodied carbon is "locked in" at construction. It typically represents 20-40% of a building's lifetime carbon footprint, but for low-energy buildings, it can be 50% or more.

Carbon Intensity

Definition: Embodied carbon per square meter of gross floor area (kg CO2-e/mΒ²).

Industry Benchmarks (Australian commercial buildings):

  • Excellent: < 350 kg CO2-e/mΒ²
  • Good: 350-500 kg CO2-e/mΒ²
  • Average: 500-650 kg CO2-e/mΒ²
  • Poor: > 650 kg CO2-e/mΒ²

Life Cycle Stages

The calculator follows EN 15978 standard stages:

  • A1-A3 (Product): Typically 80-90% of embodied carbon

    • Material extraction, transport, manufacturing
  • A4-A5 (Construction): Typically 5-10% of embodied carbon

    • Transport to site, construction process emissions
  • B1-B7 (Use): Variable, depends on maintenance cycles

    • Maintenance, repair, replacement over design life
  • C1-C4 (End of Life): Typically 2-8% of embodied carbon

    • Demolition, transport, processing, disposal

GHG Protocol Scopes

For construction projects:

  • Scope 1: Minimal for materials (on-site fuel, generators)
  • Scope 2: Site electricity, temporary offices
  • Scope 3: The big one! Typically 80-95% of total
    • Category 1: Purchased goods (materials)
    • Category 4: Upstream transport
    • Category 5: Waste
    • Category 12: End-of-life treatment

πŸŽ“ How to Use This Tool Effectively

For Contractors & Builders

  1. During Tender Stage

    • Calculate embodied carbon for your proposed design
    • Compare different material options
    • Demonstrate sustainability credentials to clients
  2. During Design Development

    • Run scenarios for material substitutions
    • Optimize for carbon while managing costs
    • Identify high-carbon "hotspots"
  3. For Compliance

    • Generate reports for NCC Section J requirements
    • Support Green Star Materials credit submissions
    • Provide data for client sustainability reporting

For Architects & Engineers

  1. Early Design

    • Compare structural systems (concrete vs. steel vs. timber)
    • Assess carbon impact of major design decisions
    • Set project carbon targets
  2. Specification

    • Specify low-carbon alternatives
    • Balance performance, cost, and carbon
    • Document embodied carbon in specifications

For Project Managers

  1. Reporting

    • Track project carbon against targets
    • Report to stakeholders and clients
    • Support ESG (Environmental, Social, Governance) reporting
  2. Risk Management

    • Identify compliance risks early
    • Monitor regulatory changes
    • Prepare for carbon pricing scenarios

πŸ“š Compliance Standards Reference

NCC 2022 (National Construction Code)

Relevant Sections:

  • Section J: Energy Efficiency
  • JV3: Greenhouse and Energy Minimum Standards
  • Part J1: Building fabric
  • Part J6: Artificial lighting and power
  • Part J8: Facilities for energy monitoring

Compliance Approach:

  • DTS (Deemed-to-Satisfy) provisions
  • Performance Solutions (alternative compliance)
  • Evidence of Suitability required

Resources:

NABERS (National Australian Built Environment Rating System)

Rating Scale: 0-6 stars

  • 6 stars: Market-leading performance
  • 5 stars: Excellent performance
  • 4 stars: Good performance
  • 3 stars: Average performance
  • < 3 stars: Below average

For Construction:

  • NABERS Energy (operational)
  • NABERS Carbon Neutral (whole-of-life)
  • NABERS Waste (construction phase)

Resources:

GBCA Green Star

Rating Tool Categories:

  • Design & As Built
  • Interiors
  • Performance
  • Communities

Points System (100 points total):

  • 6 stars (75+ points): World Leadership
  • 5 stars (60-74 points): Australian Excellence
  • 4 stars (45-59 points): Best Practice
  • < 4 stars: Not certified

Materials Category Focus:

  • Life Cycle Impacts (embodied carbon)
  • Responsible Sourcing
  • Material Reuse
  • Recycled Content

Resources:

TCFD (Climate-Related Financial Disclosures)

Required from: January 2025 for large entities

Four Pillars:

  1. Governance: Board oversight
  2. Strategy: Climate risks and opportunities
  3. Risk Management: Identify and manage risks
  4. Metrics & Targets: GHG emissions reporting

Scope Requirements:

  • Scope 1 & 2: Mandatory
  • Scope 3: Required for material categories

Resources:


πŸ”§ API Reference

RESTful Table API Endpoints

All endpoints use relative URLs (e.g., tables/carbon_projects)

List Projects

GET tables/carbon_projects?page=1&limit=100&sort=-updated_at

Response:

{
  "data": [...],
  "total": 25,
  "page": 1,
  "limit": 100
}

Get Single Project

GET tables/carbon_projects/{record_id}

Create Project

POST tables/carbon_projects
Content-Type: application/json

{
  "projectName": "Example Project",
  "projectType": "commercial",
  "gfa": 5000,
  ...
}

Update Project

PUT tables/carbon_projects/{record_id}
Content-Type: application/json

{
  "projectName": "Updated Name",
  ...
}

Delete Project

DELETE tables/carbon_projects/{record_id}

🎨 Customization Guide

Adding New Materials

Edit js/materials-database.js:

"your-category": {
    name: "Your Category",
    materials: {
        "material-id": {
            name: "Material Name",
            unit: "tonnes", // or m3, m2, kg
            embodiedCarbon: 450, // kg CO2-e per unit
            density: 2400, // kg/mΒ³
            lcaStages: {
                a1a3: 0.90, // % in product stage
                a4: 0.05,   // % in transport
                a5: 0.05    // % in installation
            }
        }
    }
}

Modifying Compliance Thresholds

Edit js/compliance.js to adjust benchmarks:

this.nccBenchmarks = {
    commercial: {
        excellent: 350,
        good: 500,
        average: 650,
        minimum: 850
    }
}

Customizing Charts

Edit js/charts.js to change colors, chart types, or data display:

this.colorScheme = {
    green: '#059669',
    blue: '#3b82f6',
    // Add your colors...
}

πŸ§ͺ Example Projects

Example 1: Small Commercial Office

Project Details:

  • Type: Commercial
  • GFA: 500 mΒ²
  • Design Life: 50 years

Materials:

  • 32 MPa Concrete: 120 mΒ³
  • Recycled Steel: 15 tonnes
  • Double Glazed Windows: 100 mΒ²
  • Glasswool Insulation: 500 mΒ²

Expected Results:

  • Total Carbon: ~225,000 kg CO2-e
  • Carbon Intensity: ~450 kg CO2-e/mΒ²
  • NCC: Good - Above Average
  • NABERS: 4-5 stars
  • Green Star: 4 stars (Best Practice)

Example 2: Timber-Frame Residential

Project Details:

  • Type: Residential
  • GFA: 200 mΒ²
  • Design Life: 50 years

Materials:

  • Softwood Timber: 30 mΒ³
  • 32 MPa Concrete (slab): 20 mΒ³
  • Steel Mesh: 0.5 tonnes
  • Timber Windows: 20 mΒ²

Expected Results:

  • Total Carbon: ~45,000 kg CO2-e
  • Carbon Intensity: ~225 kg CO2-e/mΒ²
  • NCC: Excellent - Exceeds Standards
  • Performance: Top 10% of projects

🀝 Contributing

This is an open-source educational tool. Contributions are welcome!

Areas for Contribution

  1. Material Database Expansion

    • Add more Australian-specific materials
    • Include EPD-verified coefficients
    • Regional variations
  2. Compliance Updates

    • NCC updates and amendments
    • New standards and regulations
    • International standards (for comparison)
  3. Calculation Refinements

    • More detailed transport calculations
    • Construction waste factors
    • Regional grid emission factors
  4. Documentation

    • Tutorial videos
    • Case studies
    • Best practice guides

πŸ“ž Support & Resources

Getting Help

  1. Documentation: This README covers most functionality
  2. Code Comments: All JavaScript files are heavily commented
  3. Console Logging: Enable browser console for debugging

External Resources


πŸ“ License

MIT License - Free to use, modify, and distribute.


πŸ™ Acknowledgments

Data Sources

  • Australian Life Cycle Assessment Database (AusLCI)
  • ICE Database v3.0 (Inventory of Carbon & Energy)
  • EPD Australasia verified declarations
  • GBCA Materials Calculator
  • NABERS benchmarking data

Standards Referenced

  • ISO 14040:2006 - Environmental management β€” Life cycle assessment
  • ISO 14044:2006 - Environmental management β€” Life cycle assessment
  • EN 15978:2011 - Sustainability of construction works
  • GHG Protocol Corporate Accounting and Reporting Standard
  • AS 5334-2013 - Climate change adaptation for settlements and infrastructure

πŸš€ Recommended Next Steps

For Immediate Use

  1. Familiarize yourself with the material database
  2. Create a test project with sample data
  3. Explore all features - LCA, Scopes, Compliance
  4. Save projects for future reference
  5. Export reports to understand output formats

For Production Deployment

  1. Review material coefficients for your region
  2. Customize compliance thresholds if needed
  3. Add company branding (logo, colors)
  4. Set up regular backups of project database
  5. Train team members on tool usage

For Advanced Users

  1. Extend the material database with custom materials
  2. Integrate with existing project management tools
  3. Develop custom reports for specific compliance needs
  4. Contribute improvements back to the project

πŸ“Š Version History

v1.0.0 - Initial Release (2025)

  • Complete LCA calculator (A1-D stages)
  • GHG Protocol Scopes 1, 2, 3
  • NCC 2022, NABERS, GBCA compliance
  • 40+ materials in database
  • Project save/load functionality
  • Chart visualizations
  • Export capabilities

🎯 Project Goals

This tool was created to:

  1. Democratize carbon accounting - Make it accessible to all construction professionals
  2. Support compliance - Meet Australian regulatory requirements
  3. Drive sustainability - Enable informed material decisions
  4. Build industry capacity - Educate about embodied carbon
  5. Accelerate decarbonization - Provide data for carbon reduction strategies

Built for the Australian construction industry by Steve (First Class Carpenter turned Sustainability Tech Entrepreneur)

"From hammer to keyboard - building the future of sustainable construction"


For questions, feedback, or contributions, please open an issue in the project repository.

Let's build a lower-carbon future together! πŸŒ±πŸ—οΈ

Releases

No releases published

Packages

No packages published