ScenarioLink: An Activity Browser Plugin for Scenario-Based LCA Databases
ScenarioLink is a specialized plugin for the Activity Browser, an open-source software for Life Cycle Assessment (LCA). This plugin enables you to seamlessly fetch and reproduce scenario-based LCA databases, such as those generated by premise, using unfold datapackages.
Features
- Reproduce individual or multiple scenario-based databases within Activity Browser.
- Merge multiple databases into a unified superstructure database containing various scenarios.
- Leverage the capabilities of the
unfold
library to recreate databases with the necessary scaling factors.
Overview
The Activity Browser builds upon the Brightway2 LCA framework. ScenarioLink aims to simplify the use of scenario-based LCA databases within the Activity Browser by:
- Eliminating the need for separate tools required to generate these databases (e.g., premise).
- Utilizing
unfold
datapackages that contain scaling factors essential for reproducing scenario-based LCA databases, assuming a consistent source database (e.g., ecoinvent 3.7.1).
Requirements
activty-browser >= 2.9.7, < 2.10.0
Installation
-
Activate your existing Activity Browser conda environment.
-
Install the ScenarioLink plugin using conda (preferred) or Pypi (may create conflicts with activity-browser
dependencies):
conda install -c romainsacchi ab-plugin-scenariolink
or
pip install ab-plugin-scenariolink
-
Launch the Activity Browser.
-
Navigate to Tools > Plugins
and select ScenarioLink from the plugin list.
Usage
Reproduce a scenario-based database
-
Activate the plugin by selecting it from the plugin list.
-
After activating the plugin, select the ScenarioLink
tab.
-
Select (double-click) the desired datapackage from the table.
-
If the datapackage selected is not present in the local cache, it will be downloaded from the remote repository.
-
Once the download is complete, a second table presents the scenarios contained in the datapackage.
-
Select the desired scenario(s) by checking the corresponding checkboxes.
-
Choose whether to merge the selected scenarios into a single database (superstructure database) or reproduce them individually.
-
Click Import
to start the process.
-
The plugin will ask you to select the databases in your project that will be used as source databases.
-
The plugin will then reproduce the selected scenario(s) and add them to your project.
Contributing
You can make your own scenario-based LCA databases available to the community.
To do so, you need to create a unfold
datapackage and upload it to a remote repository.
We will then add it to the list of available datapackages in the ScenarioLink plugin.
Maintainers
For questions, issues, or contributions, you can reach out to:
Alternatively, you can open an issue on this GitHub repository.