Circularity LCI

A Python package for circularity and life cycle assessment (LCA) analysis built on top of Brightway2.

It provides tools for analyzing burden-free activities, duplicating technosphere flows to biosphere flows, calculating circularity indicators (aligned with ISO 59020), building circularity LCIA methods, and running them across case studies and entire LCA databases. Long-running calculations can be tracked with a built-in progress tracker.

Installation

pip install circularitylci

The package depends on the Brightway2 ecosystem (bw2data, bw2calc, bw2io) plus numpy, pandas, matplotlib, lxml, and stats_arrays, which are installed automatically.

Usage

The canonical import name is circularity_lci (the package is also mirrored under the alias circularitylci, so import circularitylci works too).

import circularity_lci as clci
# or, equivalently:
import circularitylci as clci

from circularity_lci import (
    BurdenFreeAnalyzer,
    BiosphereFlowManager,
    CircularityCalculator,
    MultiLCACalculator,
    CircularityDatabaseAnalyzer,
    LCIAMethodBuilder,
    ProgressTracker,
)

Verbose progress output from long-running operations goes through the standard logging module; control it with the usual configuration, e.g. logging.basicConfig(level=logging.INFO).

Worked examples are available in the examples/ directory:

• examples/simple_example.ipynb — minimal end-to-end run.
• examples/case_study.ipynb — a full case study.
• examples/main.ipynb — the main workflow walkthrough.

Features

• Burden-free activity analysis — identify and handle burden-free exchanges.
• Biosphere flow management — duplicate a list of technosphere flows to biosphere flows.
• Circularity indicators — compute circularity efficiency variables and indicators.
• LCIA method builder — create circularity LCIA methods (create_circularity_lcia_methods).
• Multi-LCA calculator — run LCAs across many activities or databases.
• Database analyzer — apply the workflow to a whole LCA database.
• Progress tracking — persist progress for long-running LCA projects.

Development

git clone https://github.com/LouisFreboeuf/circularity_lci
cd circularity_lci
pip install -e ".[dev]"

Run tests with pytest from the repository root.

License

MIT — see LICENSE.

Citation

If you use this software, please cite it (see CITATION.cff).