Skip to main content

Planetary-boundary-based Absolute Environmental Sustainability Assessment

Project description

pbaesa

PyPI Status Python Version License Read the documentation at https://pbaesa.readthedocs.io/ pre-commit Black

pbaesa is a python package for planetary-boundary-based absolute environmental sustainability assessment of anthropogenic systems.

🌍 Features

pbaesa enables:

  1. The assessment of system-specific impacts on all global planetary boundary categories except novel entities by integration new life cycle impact assessment methods into the Brightway LCA framework.
  2. The calculation of system-specific sustainability thresholds from time-explicit multi-regional input-output tables.

AESA method

⚙️ Installation

You can install pbaesa via [pip] from [PyPI]:

$ pip install pbaesa

🚀 Usage

Basic Example

import bw2data as bd
import pbaesa
from pbaesa import utils

# Set your Brightway project
bd.projects.set_current('your_project_name')

# Load your biosphere database
bio = bd.Database("ecoinvent-3.10.1-biosphere")

# Create all planetary boundary LCIA methods
pbaesa.create_pbaesa_methods(biosphere_db=bio)

# Get allocation factors for a specific sector and location
allocation_factors = pbaesa.get_all_allocation_factor(
    geographical_scope="DE",  
    sector="Cultivation of wheat",
    year=2022
)

# Calculate a multi-LCA using Brightway to obtain mlca_scores

# Calculate exploitation of global safe operating space 
utils.calculate_exploitation_of_SOS(mlca_scores)

# Plot exploitation of global safe operating space against allocation factors
utils.plot_AESA(exploitations, allocation_factor_total_FCE, allocation_factor_total_GVA)

Key Functions

  • create_pbaesa_methods(biosphere_db, process_ids=[]): Creates and registers LCIA methods for all global planetary boundary categories except novel entities (climate change, ocean acidification, biosphere integrity, phosphorus cycle, atmospheric aerosol loading, freshwater use, stratospheric ozone depletion, land-system change, and nitrogen cycle).

  • get_all_allocation_factor(geographical_scope, sector, year): Retrieves allocation factors for a specific sector and geographical scope. If the allocation factors file is not present, the function will generate it automatically.

For a more detailed example, see the examples/ directory.

🤝 Contributing

We welcome contributions! If you have suggestions or want to fix a bug, please:

🧾 License and Data Notice

This project is licensed under the MIT License — see the LICENSE file for details.

© 2025 Institute of Technical Thermodynamics, RWTH Aachen University

This repository does not include any EXIOBASE 3 data or derived coefficients.
Users must obtain EXIOBASE data directly from the official EXIOBASE source.
Please ensure you comply with the EXIOBASE license terms when using their data.

Note: This code is released under the MIT License.
The MIT License allows both commercial and non-commercial use of the code,
but EXIOBASE data may have its own separate restrictions.

💬 Support

If you have any questions or need help, do not hesitate to contact me:

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

pbaesa-0.1.0.tar.gz (18.9 kB view details)

Uploaded Source

Built Distribution

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

pbaesa-0.1.0-py3-none-any.whl (16.9 kB view details)

Uploaded Python 3

File details

Details for the file pbaesa-0.1.0.tar.gz.

File metadata

  • Download URL: pbaesa-0.1.0.tar.gz
  • Upload date:
  • Size: 18.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for pbaesa-0.1.0.tar.gz
Algorithm Hash digest
SHA256 5a25f5f63f897a7a14c73378823e8ed55ff7dc5d8f6aff5e19f2cae0cdbffb49
MD5 f0fa4522a4424004ba2c912e3ae178cd
BLAKE2b-256 d9286038c8ba5452171f8d19e934023d7b4102dca60f324c88c3b630133850bb

See more details on using hashes here.

Provenance

The following attestation bundles were made for pbaesa-0.1.0.tar.gz:

Publisher: python-package-deploy.yml on RWTH-LTT/pbaesa

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pbaesa-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: pbaesa-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 16.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for pbaesa-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 1d16aef91bac2701d26330cd026f0589b4efb0773b8655aaf810c559f7b9a6e4
MD5 61867b6541e8afd30f7ac7d0c26d8788
BLAKE2b-256 ef5e148e004fdad69ea24e8d5bd8dda8877d0bdcf5e0cb90bb53688d89cc98d3

See more details on using hashes here.

Provenance

The following attestation bundles were made for pbaesa-0.1.0-py3-none-any.whl:

Publisher: python-package-deploy.yml on RWTH-LTT/pbaesa

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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