Skip to main content

Activity Browser plugin to download scenario-based LCA databases

Project description

# ScenarioLink: An Activity Browser Plugin for Scenario-Based LCA Databases

ScenarioLink is a specialized plugin for the [Activity Browser](https://github.com/LCA-ActivityBrowser/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](https://github.com/polca/premise), using [unfold](https://github.com/polca/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](https://brightway.dev) 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).

![Flow Diagram](assets/flow_diagram.png)

## Installation

  1. Activate your existing Activity Browser conda environment.

  2. Install the ScenarioLink plugin using Pypi or conda:

    `bash pip install ab-plugin-scenariolink `

    `bash conda install -c romainsacchi ab-plugin-scenariolink `

  1. Launch the Activity Browser.

  2. Navigate to Tools > Plugins and select ScenarioLink from the plugin list.

## Usage

### Reproduce a scenario-based database

  1. Activate the plugin by selecting it from the plugin list.

    ![Plugin List](assets/plugin_list.png)

  2. After activating the plugin, select the ScenarioLink tab.

    ![ScenarioLink Tab](assets/scenariolink_tab.png)

  3. Select (double-click) the desired datapackage from the table.

    ![Datapackage Table](assets/datapackage_table.png)

  4. If the datapackage selected is not present in the local cache, it will be downloaded from the remote repository.

  5. Once the download is complete, a second table presents the scenarios contained in the datapackage.

    ![Scenario Table](assets/scenario_table.png)

  6. Select the desired scenario(s) by checking the corresponding checkboxes.

  7. Choose whether to merge the selected scenarios into a single database (superstructure database) or reproduce them individually.

  8. Click Import to start the process.

  9. The plugin will ask you to select the databases in your project that will be used as source databases.

    ![Source Database Selection](assets/source_database_selection.png)

  10. 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.

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

ab_plugin_scenariolink-0.0.6.tar.gz (19.8 kB view hashes)

Uploaded Source

Built Distribution

ab_plugin_scenariolink-0.0.6-py3-none-any.whl (20.4 kB view hashes)

Uploaded Python 3

Supported by

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