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.1.tar.gz (249.0 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.1-py3-none-any.whl (244.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: pbaesa-0.1.1.tar.gz
  • Upload date:
  • Size: 249.0 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.1.tar.gz
Algorithm Hash digest
SHA256 bc2e8d285e0569e3ca7c65b862e9ca94aa39d24b481c3366a3b2bec4029da35d
MD5 70aedd7771f2ce65b508dd8daf06caec
BLAKE2b-256 3e0a01e5a693de8744584abd96426b50674ab1cbfdc31a9addaa13afd8081eb7

See more details on using hashes here.

Provenance

The following attestation bundles were made for pbaesa-0.1.1.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.1-py3-none-any.whl.

File metadata

  • Download URL: pbaesa-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 244.7 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 9de2caac32f825412401796acd0151621db93e63f6383d779a6777aa35042f35
MD5 cd2c6acacd9aa1482685d14003d40e75
BLAKE2b-256 398dc1849b4d588e25e8a7383218ab13c9eeefda2e7fa8d571cce8ceb72e9126

See more details on using hashes here.

Provenance

The following attestation bundles were made for pbaesa-0.1.1-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