lca_algebraic

This library is a small layer above brightway2, designed for the definition of parametric inventories with fast computation of LCA impacts, suitable for monte-carlo analyis.
https://github.com/oie-mines-paristech/lca_algebraic

Category: Industrial Ecology
Sub Category: Life Cycle Assessment

Keywords

brightway2 foreground-activities lca lca-algebraic monte-carlo numpy symbolic-expressions

Keywords from Contributors

transforms archiving measur generic optimize observation compose animals conversion projection

Last synced: 11 minutes ago
JSON representation

Repository metadata

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

Host: GitHub
URL: https://github.com/oie-mines-paristech/lca_algebraic
Owner: oie-mines-paristech
License: bsd-2-clause
Created: 2020-03-30T14:53:35.000Z (about 5 years ago)
Default Branch: main
Last Pushed: 2024-12-10T11:39:35.000Z (5 months ago)
Last Synced: 2025-04-25T13:46:46.671Z (2 days ago)
Topics: brightway2, foreground-activities, lca, lca-algebraic, monte-carlo, numpy, symbolic-expressions
Language: Jupyter Notebook
Size: 16.6 MB
Stars: 45
Watchers: 6
Forks: 18
Open Issues: 33
Releases: 5
Metadata Files:
- Readme: README.md
- License: LICENSE

README.md

lca_algebraic 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)
Support for automatic check of homogeneity of physical units

⚙ 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

NOTE
While the inventories created in lca_algebraic are stored in the Brightway project,
the formulas and parameters are not compatible with Activity Browser
Before computing impacts with vanilla Brightway2 or Activity Browser,
you may use the function freezeParams()
to update the amounts in your database for a given scenario / set of parameter values.

📚 Documentation & resources

Full documentation is hosted on readthedocs

We provide 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 MinesParis - PSL - O.I.E team, for the project INCER-ACV,
lead by ADEME.

It is distributed under the BSD License

Logo

Please use the following logo to advertise about this librairy.

Owner metadata

Name: OIE - Mines ParisTech
Login: oie-mines-paristech
Email:
Kind: organization
Description: Centre de recherche Observation, Impacts, Energie
Website: http://www.oie.mines-paristech.fr/
Location: Sophia Antipolis - France
Twitter:
Company:
Icon url: https://avatars.githubusercontent.com/u/62893802?v=4
Repositories: 2
Last ynced at: 2023-03-05T11:46:06.532Z
Profile URL: https://github.com/oie-mines-paristech

GitHub Events

Total

Issues event: 4
Watch event: 8
Issue comment event: 1
Push event: 8
Create event: 2

Last Year

Issues event: 4
Watch event: 8
Issue comment event: 1
Push event: 8
Create event: 2

Committers metadata

Last synced: 6 days ago

Total Commits: 229
Total Committers: 6
Avg Commits per committer: 38.167
Development Distribution Score (DDS): 0.044

Commits in past year: 50
Committers in past year: 3
Avg Commits per committer in past year: 16.667
Development Distribution Score (DDS) in past year: 0.1

Name	Email	Commits
Raphael Jolivet	r**t@m**r	219
Benoît Gschwind	g**d@g**t	4
Elias Sebastian Azzi	e**i@U**E	3
tristan_debonnet	7****t	1
f.pollet	f**t@h**r	1
dependabot[bot]	4****]	1

Committer domains:

Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 45
Total pull requests: 23
Average time to close issues: 6 months
Average time to close pull requests: about 1 month
Total issue authors: 20
Total pull request authors: 10
Average comments per issue: 1.33
Average comments per pull request: 0.26
Merged pull request: 7
Bot issues: 0
Bot pull requests: 5

Past year issues: 14
Past year pull requests: 5
Past year average time to close issues: 6 days
Past year average time to close pull requests: 11 days
Past year issue authors: 8
Past year pull request authors: 3
Past year average comments per issue: 1.14
Past year average comments per pull request: 0.0
Past year merged pull request: 1
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/oie-mines-paristech/lca_algebraic

Top Issue Authors

raphaeljolivet (12)
juliana-steinbach (3)
RomainBes (3)
felixpollet (3)
n1c0l492 (3)
zann2011 (2)
marc-vdm (2)
simb-sdu (2)
ljlazar (2)
simaosr (2)
gschwind (2)
thomasgibon (1)
AmeliePzk (1)
inrDL (1)
ntropy-esa (1)

Top Pull Request Authors

gschwind (6)
dependabot[bot] (5)
n1c0l492 (3)
felixpollet (2)
RomainBes (2)
A-JMinor (1)
mijafro (1)
tdebonnet (1)
raphaeljolivet (1)
ntropy-esa (1)

Top Issue Labels

enhancement (1)

Top Pull Request Labels

dependencies (5)

Package metadata

Total packages: 2
Total downloads:
- pypi: 2,128 last-month
Total dependent packages: 0 (may contain duplicates)
Total dependent repositories: 2 (may contain duplicates)
Total versions: 63
Total maintainers: 1

pypi.org: lca-algebraic-dev

This library provides a layer above brightway2 for defining parametric models and running super fast LCA for monte carlo analysis.

Homepage: https://github.com/oie-mines-paristech/lca_algebraic/
Documentation: https://lca-algebraic-dev.readthedocs.io/
Licenses: BSD
Latest release: 1.1.1985003.dev0 (published 7 months ago)
Last Synced: 2025-04-26T14:02:56.009Z (1 day ago)
Versions: 40
Dependent Packages: 0
Dependent Repositories: 1
Downloads: 1,204 Last month
Rankings:
- Dependent packages count: 7.31%
- Forks count: 10.199%
- Stargazers count: 11.892%
- Average: 15.814%
- Dependent repos count: 22.088%
- Downloads: 27.579%
Maintainers (1)
- oie-minesparistech

pypi.org: lca-algebraic