carboncalc 1.0.0

Carbon footprint calculator library for small businesses

CarbonCalc

A Python library for calculating carbon footprints of small businesses. Provides emission factor databases, calculators for different emission categories (electricity, transportation, waste, etc.), and report generation utilities based on the GHG Protocol.

Installation

pip install carboncalc

Usage

from carboncalc import CarbonCalculator, EmissionFactorDB, EmissionRecord, EmissionCategory

calc = CarbonCalculator()
record = EmissionRecord(
    category=EmissionCategory.ELECTRICITY,
    quantity=1000,
    unit="kwh",
    date="2026-01-15",
    description="January office electricity"
)
result = calc.calculate_single(record)
print(f"CO2: {result.co2_kg} kg")

Features

• Emission factor database based on EPA/DEFRA data
• Support for 7 emission categories across all 3 GHG Protocol scopes
• Batch calculation and period comparison
• Report generation with recommendations
• Monthly trend analysis and intensity metrics