# lca-activitybrowser/activity-browser architecture

> Architecture diagram of the GitHub repository lca-activitybrowser/activity-browser, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lca-activitybrowser/activity-browser
- Repository: https://github.com/lca-activitybrowser/activity-browser

## Overview

Activity Browser is a desktop life-cycle-assessment workbench built on Brightway. The principal workflow is to manage a project and its inventory, configure reference flows and impact methods, run LCA calculations, then inspect results. The README also highlights scenario and parameter modeling, graph exploration, contribution and Sankey analysis, Monte Carlo and sensitivity analysis, and plugins. The graph preserves these documented capabilities; several implementation paths are unsampled, so their connections are shown only where the README supports them.

Main entry points: [`activity_browser/layouts/main.py`](https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/layouts/main.py) (Desktop interface), [`activity_browser/layouts/tabs/project_manager.py`](https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/layouts/tabs/project_manager.py) (Project management), [`activity_browser/ui/tables/inventory.py`](https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/ui/tables/inventory.py) (Activity inventory), [`activity_browser/layouts/tabs/LCA_setup.py`](https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/layouts/tabs/LCA_setup.py) (Calculation setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Workspace and inventory"]
  node_desktop["Desktop interface<br/>[main.py]"]
  node_project["Project management<br/>[project_manager.py]"]
  node_inventory["Activity inventory<br/>[inventory.py]"]
  node_modeling["Modeling tools<br/>[parameter_new.py]"]
  node_scenario["Scenario superstructures<br/>[manager.py]"]
end

subgraph group_lca["LCA workflow"]
  node_setup["Calculation setup<br/>[LCA_setup.py]"]
  node_calculation["LCA calculations<br/>[calculations.py]"]
  node_results["LCA results"]
end

subgraph group_analysis["Analysis and exploration"]
  node_contribution["Contribution analysis<br/>[contribution.py]"]
  node_sankey["Sankey diagrams<br/>[figures.py]"]
  node_montecarlo["Monte Carlo<br/>[montecarlo.py]"]
  node_sensitivity["Sensitivity analysis"]
  node_graph["Graph explorer<br/>[activity_graph.py]"]
end

subgraph group_extensions["Extensions"]
  node_plugins["Plugin support<br/>[plugin.py]"]
end

subgraph group_platform["Brightway data layer"]
  node_brightway["Brightway data access<br/>[proxies.py]"]
  node_importexport["Database import and export<br/>[importers.py]"]
end

node_user(("LCA practitioner"))

node_user -->|"uses"| node_desktop
node_desktop -.->|"manages projects"| node_project
node_project -.->|"models inventory"| node_inventory
node_inventory -.->|"models in Brightway"| node_brightway
node_user -->|"models with parameters"| node_modeling
node_user -->|"models scenarios"| node_scenario
node_user -.->|"configures LCA"| node_setup
node_setup -.->|"runs calculations"| node_calculation
node_calculation -.->|"produces results"| node_results
node_user -->|"analyzes contributions"| node_contribution
node_user -->|"explores Sankey"| node_sankey
node_user -->|"runs Monte Carlo"| node_montecarlo
node_user -->|"runs sensitivity"| node_sensitivity
node_user -->|"explores graphs"| node_graph
node_user -->|"extends with plugins"| node_plugins
node_user -.->|"exchanges databases"| node_importexport

click node_desktop "https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/layouts/main.py"
click node_project "https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/layouts/tabs/project_manager.py"
click node_inventory "https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/ui/tables/inventory.py"
click node_modeling "https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/actions/parameter/parameter_new.py"
click node_scenario "https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/bwutils/superstructure/manager.py"
click node_setup "https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/layouts/tabs/LCA_setup.py"
click node_calculation "https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/bwutils/calculations.py"
click node_results "https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/layouts/tabs/LCA_results_tabs.py"
click node_contribution "https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/mod/bw2analyzer/contribution.py"
click node_sankey "https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/ui/figures.py"
click node_montecarlo "https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/bwutils/montecarlo.py"
click node_sensitivity "https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/bwutils/sensitivity_analysis.py"
click node_graph "https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/actions/activity/activity_graph.py"
click node_plugins "https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/controllers/plugin.py"
click node_brightway "https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/mod/bw2data/backends/proxies.py"
click node_importexport "https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/bwutils/importers.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_desktop,node_project,node_inventory,node_modeling,node_scenario toneBlue
class node_setup,node_calculation,node_results toneAmber
class node_contribution,node_sankey,node_montecarlo,node_sensitivity,node_graph toneMint
class node_plugins toneRose
class node_brightway,node_importexport,node_user toneIndigo
```

## Components

### Workspace and inventory

- [Desktop interface](https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/layouts/main.py): `activity_browser/layouts/main.py`
- [Project management](https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/layouts/tabs/project_manager.py): `activity_browser/layouts/tabs/project_manager.py`
- [Activity inventory](https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/ui/tables/inventory.py): `activity_browser/ui/tables/inventory.py`
- [Modeling tools](https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/actions/parameter/parameter_new.py): `activity_browser/actions/parameter/parameter_new.py`
- [Scenario superstructures](https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/bwutils/superstructure/manager.py): `activity_browser/bwutils/superstructure/manager.py`

### LCA workflow

- [Calculation setup](https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/layouts/tabs/LCA_setup.py): `activity_browser/layouts/tabs/LCA_setup.py`
- [LCA calculations](https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/bwutils/calculations.py): `activity_browser/bwutils/calculations.py`
- [LCA results](https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/layouts/tabs/LCA_results_tabs.py): `activity_browser/layouts/tabs/LCA_results_tabs.py`

### Analysis and exploration

- [Contribution analysis](https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/mod/bw2analyzer/contribution.py): `activity_browser/mod/bw2analyzer/contribution.py`
- [Sankey diagrams](https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/ui/figures.py): `activity_browser/ui/figures.py`
- [Monte Carlo](https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/bwutils/montecarlo.py): `activity_browser/bwutils/montecarlo.py`
- [Sensitivity analysis](https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/bwutils/sensitivity_analysis.py): `activity_browser/bwutils/sensitivity_analysis.py`
- [Graph explorer](https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/actions/activity/activity_graph.py): `activity_browser/actions/activity/activity_graph.py`

### Extensions

- [Plugin support](https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/controllers/plugin.py): `activity_browser/controllers/plugin.py`

### Brightway data layer

- [Brightway data access](https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/mod/bw2data/backends/proxies.py): `activity_browser/mod/bw2data/backends/proxies.py`
- [Database import and export](https://github.com/lca-activitybrowser/activity-browser/blob/main/activity_browser/bwutils/importers.py): `activity_browser/bwutils/importers.py`

### Other components

- **LCA practitioner**

## Connections

- LCA practitioner → Desktop interface: uses
- Desktop interface → Project management: manages projects
- Project management → Activity inventory: models inventory
- Activity inventory → Brightway data access: models in Brightway
- LCA practitioner → Modeling tools: models with parameters
- LCA practitioner → Scenario superstructures: models scenarios
- LCA practitioner → Calculation setup: configures LCA
- Calculation setup → LCA calculations: runs calculations
- LCA calculations → LCA results: produces results
- LCA practitioner → Contribution analysis: analyzes contributions
- LCA practitioner → Sankey diagrams: explores Sankey
- LCA practitioner → Monte Carlo: runs Monte Carlo
- LCA practitioner → Sensitivity analysis: runs sensitivity
- LCA practitioner → Graph explorer: explores graphs
- LCA practitioner → Plugin support: extends with plugins
- LCA practitioner → Database import and export: exchanges databases
