Skip to main content

Pulpo package for optimization in LCI databases

Project description

Python-based User-defined Lifecycle Production Optimization

Jupyter Python Markdown

License Last Commit Commit Activity Top Language

PyPI - Version GitHub Stars


📍 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
  • [ ] ℹ️ Development of a GUI for simple optimization tasks
  • [X] ℹ️ Enable PULPO to work on both bw2 and bw25 projects
  • [ ] ℹ️ Thorough documentation to be hosted in the docs.brightway.dev

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:

pip install pulpo-dev[bw2]

or

pip install pulpo-dev[bw25]

🤖 Running pulpo

Find 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:

python -m unittest discover -s tests

What's new in 0.1.3?

  • Enable users to work on both bw2 and bw25 projects.

🤝 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) 2024, 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


↑ Return

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pulpo_dev-0.1.4.tar.gz (31.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pulpo_dev-0.1.4-py3-none-any.whl (31.2 kB view details)

Uploaded Python 3

File details

Details for the file pulpo_dev-0.1.4.tar.gz.

File metadata

  • Download URL: pulpo_dev-0.1.4.tar.gz
  • Upload date:
  • Size: 31.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.11.11

File hashes

Hashes for pulpo_dev-0.1.4.tar.gz
Algorithm Hash digest
SHA256 458b81265099f4093d3cded8aa6dd6596ae45916c3bfda92e99e6624ed684624
MD5 701e1bd1d25687766ed63bab678613ae
BLAKE2b-256 ca60e8526cd0fd6b42a97d5becd12bd1ae0078cf0fb21fae3d4f202a23f0fb81

See more details on using hashes here.

File details

Details for the file pulpo_dev-0.1.4-py3-none-any.whl.

File metadata

  • Download URL: pulpo_dev-0.1.4-py3-none-any.whl
  • Upload date:
  • Size: 31.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.11.11

File hashes

Hashes for pulpo_dev-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 68668411d56bffb8448e662c483708ce0cd07dd7c90abed0a6dc6ef4c2fa6be1
MD5 385ae22da463a795d1cb9369dd67a4de
BLAKE2b-256 5486d55339002559fe9d7cbec483717a9cec8163e8228c27bb9145ddca1b492c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page