Pbaesa

<h1> <img src="docs/_static/AESA_icon.svg" width="70" style="vertical-align: middle;" /> pbaesa </h1>

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.

<br> <div style="margin: 0;"> <picture style="display: block; width: 100vw;"> <source media="(prefers-color-scheme: dark)" srcset="docs/_static/AESA.svg"> <img alt="AESA method" src="docs/_static/AESA.svg" style="width: 100vw; height: auto; display: block;" > </picture> </div>

⚙️ 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.

📚 Citation

pbaesa implements the methodology presented in:

Allocation and characterisation factors for absolute environmental sustainability assessment
Jan Marcus Hartmann, David Yang Shu, André Bardow, Niklas von der Assen

📄 https://www.researchsquare.com/article/rs-9223095/v1
🔗 https://doi.org/10.21203/rs.3.rs-9223095/v1

• If you use pbaesa in academic work, please cite the paper.
• The paper also provides additional background and methodological details.

🤝 Contributing

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

• Open an Issue
• Send a Pull Request

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

• Jan Hartmann (jan.hartmann@ltt.rwth-aachen.de)