pulpo

Python package for life cycle optimization

https://github.com/flechtenberg/pulpo

Science Score: 59.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 9 DOI reference(s) in README
  • Academic publication links
    Links to: sciencedirect.com, springer.com, wiley.com, acs.org
  • Committers with academic emails
    2 of 2 committers (100.0%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (11.8%) to scientific vocabulary

Keywords

brightway ecoinvent lca lifecycle optimization pyomo
Last synced: 6 months ago · JSON representation

Repository

Python package for life cycle optimization

Basic Info
Statistics
  • Stars: 22
  • Watchers: 2
  • Forks: 6
  • Open Issues: 6
  • Releases: 3
Topics
brightway ecoinvent lca lifecycle optimization pyomo
Created over 2 years ago · Last pushed 9 months ago
Metadata Files
Readme Changelog Contributing License Code of conduct

README.md

Python-based User-defined Lifecycle Production Optimization

[![Jupyter](https://img.shields.io/badge/Jupyter-F37626.svg?style=flat&logo=Jupyter&logoColor=white)](https://jupyter.org/) [![Python](https://img.shields.io/badge/Python-3776AB.svg?style=flat&logo=Python&logoColor=white)](https://www.python.org/) [![Markdown](https://img.shields.io/badge/Markdown-000000.svg?style=flat&logo=Markdown&logoColor=white)](https://www.markdownguide.org/) [![License](https://img.shields.io/github/license/flechtenberg/pulpo?style=flat&color=5D6D7E)](https://github.com/flechtenberg/pulpo/blob/main/LICENSE) [![Last Commit](https://img.shields.io/github/last-commit/flechtenberg/pulpo?style=flat&color=5D6D7E)](https://github.com/flechtenberg/pulpo/commits/main) [![Commit Activity](https://img.shields.io/github/commit-activity/m/flechtenberg/pulpo?style=flat&color=5D6D7E)](https://github.com/flechtenberg/pulpo/pulse) [![PyPI - Version](https://img.shields.io/pypi/v/pulpo-dev?color=%2300549f)](https://pypi.org/project/pulpo-dev/) [![GitHub Stars](https://img.shields.io/github/stars/flechtenberg/pulpo?style=flat&color=FFD700)](https://github.com/flechtenberg/pulpo/stargazers) [![launch - renku](https://renkulab.io/renku-badge.svg)](https://renkulab.io/v2/projects/fabian/pulpo-test/sessions/01JRM54S4NKMS84Y6BAYT832WH/start)

📍 Overview

This is a python package for Life Cycle Optimization (LCO) based on life cycle inventories. pulpo is intended to serve as a platform for optimization tasks of varying complexity.

The package builds on top of the Brightway LCA framework as well as the optimization modeling framework Pyomo.


✨ Capabilities

Applying optimization is recommended when the system of study has (1) many degrees of freedoms which would prompt the manual assessment of a manifold of scenarios, although only the "optimal" one is of interest and/or (2) any of the following capabilities makes sense within the goal and scope of the study:

  • Specify technology and regional choices throughout the entire supply chain (i.e. fore- and background), such as choices for the production technology of electricity or origin of metal resources. Consistently accounting for changes in the background in "large scale" decisions can be significant.
  • Specify constraints on any activity in the life cycle inventories, which can be interpreted as tangible limitations such as raw material availability, production capacity, or environmental regulations.
  • Optimize for or constrain any impact category for which the characterization factors are available.
  • Specify supply values instead of final demands, which can become relevant if only production values are available (e.g. here).

The following features are currently under development:

  • [ ] ℹ️ Optimization under uncertainty [chance-constraints, stochastic optimization ...]
  • [ ] ℹ️ Multi-objective optimization [bi-objective epsilon constrained, goal programming ...]
  • [ ] ℹ️ Integration of economic and social indicators in the optimization problem formulation

  • [X] ℹ️ Development of a GUI for simple optimization tasks Link

  • [X] ℹ️ Enable PULPO to work on both bw2 and bw25 projects

  • [X] ℹ️ Thorough documentation hosted on flechtenberg.github.io/pulpo/

Feature requests are more than welcome!


🔧 Installation

PULPO has been deployed to the pypi index. Depending on the version of brightway projects you want to work on, install either the bw2 or bw25 version via: sh pip install pulpo-dev[bw2] or sh pip install pulpo-dev[bw25]

🤖 Running pulpo

Use this link to start a session and test PULPO launch - renku

Find further example notebooks for a hydrogen case, an electricity case, and a plastic case here.

There is also a workshop repository (here), which has been created for the Brightcon 2024 conference. It contains several notebooks that guide you through the PULPO package and its functionalities, as well as an exercise.

🧪 Tests

Calling from the package folder:

sh python -m unittest discover -s tests


What's new in 1.4.2?

  • Enable the use of gurobi solver

What's new in 1.4.0?

  • Enable the use of NEOS solver (commercial solvers without license)
  • Enable Monte-Carlo sampling feature
  • Retrieve uncertainty information to lci_data for future use

What's new in 1.3.0?

  • Switch packaging logic from setup.py to pyproject.toml and align pypi with Github versioning number

🤝 Contributing

Contributions are very welcome. If you would like to request a feature or report a bug please open an Issue. If you are confident in your coding skills don't hesitate to implement your suggestions and send a Pull Request.


📄 License

This project is licensed under the ℹ️ BSD 3-Clause License. See the LICENSE file for additional info. Copyright (c) 2025, Fabian Lechtenberg. All rights reserved.


👏 Acknowledgments

We would like to express our gratitude to the authors and contributors of the following main packages that PULPO is based on:

In addition, we acknowledge the pioneering ideas and contributions from the following works:

Follow-up work, incorporating features such as top-down matrix construction for the use of entire life cycle inventory databases and supply specification, was implemented in PULPO and culminated in the following publication, which details the approach and outlines its implementation:

Fabian Lechtenberg, Robert Istrate, Victor Tulus, Antonio Espuña, Moisès Graells, and Gonzalo Guillén‐Gosálbez.
“PULPO: A Framework for Efficient Integration of Life Cycle Inventory Models into Life Cycle Product Optimization.”
Journal of Industrial Ecology, October 10, 2024.
https://doi.org/10.1111/jiec.13561

This article is to be cited / referred to if PULPO is used to derive results of a publication or project.


Authors

- @vtulus

↑ Return

Owner

  • Name: Fabian Lechtenberg
  • Login: flechtenberg
  • Kind: user
  • Location: Barcelona
  • Company: Universitat Politècnica de Catalunya

GitHub Events

Total
  • Issues event: 12
  • Watch event: 6
  • Delete event: 16
  • Issue comment event: 6
  • Member event: 1
  • Push event: 55
  • Pull request event: 17
  • Fork event: 5
  • Create event: 19
Last Year
  • Issues event: 12
  • Watch event: 6
  • Delete event: 16
  • Issue comment event: 6
  • Member event: 1
  • Push event: 55
  • Pull request event: 17
  • Fork event: 5
  • Create event: 19

Committers

Last synced: 7 months ago

All Time
  • Total Commits: 133
  • Total Committers: 2
  • Avg Commits per committer: 66.5
  • Development Distribution Score (DDS): 0.451
Past Year
  • Commits: 88
  • Committers: 2
  • Avg Commits per committer: 44.0
  • Development Distribution Score (DDS): 0.318
Top Committers
Name Email Commits
Fabian Lechtenberg f****g@u****u 73
flechtenberg f****g@c****h 60
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 11
  • Total pull requests: 26
  • Average time to close issues: 27 days
  • Average time to close pull requests: 1 day
  • Total issue authors: 3
  • Total pull request authors: 1
  • Average comments per issue: 0.45
  • Average comments per pull request: 0.0
  • Merged pull requests: 26
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 11
  • Pull requests: 17
  • Average time to close issues: 27 days
  • Average time to close pull requests: 1 day
  • Issue authors: 3
  • Pull request authors: 1
  • Average comments per issue: 0.45
  • Average comments per pull request: 0.0
  • Merged pull requests: 17
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • flechtenberg (9)
  • Blowgren (1)
  • jacopocipriani (1)
Pull Request Authors
  • flechtenberg (29)
Top Labels
Issue Labels
enhancement (4) bug (1)
Pull Request Labels
enhancement (2)

Packages

  • Total packages: 2
  • Total downloads:
    • pypi 329 last-month
  • Total dependent packages: 0
    (may contain duplicates)
  • Total dependent repositories: 0
    (may contain duplicates)
  • Total versions: 19
  • Total maintainers: 1
proxy.golang.org: github.com/flechtenberg/pulpo
  • Versions: 6
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 5.4%
Average: 5.6%
Dependent repos count: 5.8%
Last synced: 6 months ago
pypi.org: pulpo-dev

Pulpo package for optimization in LCI databases

  • Versions: 13
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 329 Last month
Rankings
Dependent packages count: 7.3%
Forks count: 29.9%
Average: 36.2%
Stargazers count: 38.9%
Dependent repos count: 68.4%
Maintainers (1)
Last synced: 9 months ago