Skip to content

Layer over brightway2 for algebraic definition of parametric models and super fast computation of LCA

License

Notifications You must be signed in to change notification settings

oie-mines-paristech/lca_algebraic

Repository files navigation

Introduction

This library is a layer above brightway2 designed for the definition of parametric inventories with fast computation of LCA impacts, suitable for monte-carlo / global sensitivity analysis

It integrates the magic of Sympy in order to write parametric formulas as regular Python expressions.

lca-algebraic provides a set of helper functions for :

  • compact & human readable definition of activities :
    • search background (tech and biosphere) activities
    • create new foreground activities with parametrized amounts
    • parametrize / update existing background activities (extending the class Activity)
  • Definition of parameters
  • Fast computation of LCAs
  • Computation of monte carlo method and global sensitivity analysis (Sobol indices)

⚙ Installation

We don't provide conda package anymore.

This packages is available via pip /pypi

1) Setup separate environement

First create a python environment, with Python [>=3.9] :

With Conda (or mamba)

conda create -n lca python==3.10
conda activate lca

With virtual env

python3.10 -m venv .venv
source .venv/bin/activate

2) Install lca_algebraic

pip install lca_algebraic

3) [Optional] Install Jupyter & Activity Browser

You may also install Jupyter and Activity Browser on the same environment.

Jupyter :

pip install jupyter

Activity Browser can only be installed via conda/mamba. Note that it can also be installed on a separate Python env and will still be able to access and browse the projects created programmatically with lca_algebraic / Brightway.

conda install activity-browser

📚 Documentation & resources

Full documentation is hosted on readthedocs

We provides some notebooks :

  • Example notebook : Basic functionalities
  • Handbook : More examples, also showing the usage of the Brightway functions.
  • Workshop : A "real life" exercise used as a short training on lca_algebraic

📧 Mailing list

Please register to this dedicated mailing list to discuss the evolutions of this library and be informed of future releases :

[email protected]

© Licence & Copyright

This library has been developed by OIE - MinesParistech, for the project INCER-ACV, lead by ADEME.

It is distributed under the BSD License