# iamzhihanzhang/deltalca architecture

> Architecture diagram of the GitHub repository iamzhihanzhang/deltalca, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/iamzhihanzhang/deltalca
- Repository: https://github.com/iamzhihanzhang/deltalca

## Overview

DeltaLCA is an interactive tool for comparing the environmental impact of electronics designs. Its documented workflow turns PCB design files into a partial life-cycle inventory, compares two designs using component heuristics and carbon estimates, then presents results and lets users add rules for unresolved parts. The comparison package includes OR-Tools, brute-force, and greedy selection approaches. The README describes the inventory-generation stages, but the notebook and its runtime wiring were not excerpted; those connections are therefore documented rather than inferred from sampled code.

Main entry points: [`sec_6_comparative_impact_assessment/compare.py`](https://github.com/iamzhihanzhang/deltalca/blob/main/sec_6_comparative_impact_assessment/compare.py) (Comparison Orchestrator), [`sec_6_comparative_impact_assessment/ortools_model.py`](https://github.com/iamzhihanzhang/deltalca/blob/main/sec_6_comparative_impact_assessment/ortools_model.py) (OR-Tools Selection), [`user_interface/UI.py`](https://github.com/iamzhihanzhang/deltalca/blob/main/user_interface/UI.py) (Comparison UI), [`sec_6_comparative_impact_assessment/classes.py`](https://github.com/iamzhihanzhang/deltalca/blob/main/sec_6_comparative_impact_assessment/classes.py) (Component Models)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inventory["Inventory Generation"]
  node_inventory_notebook["Inventory Pipeline<br/>[notebook.ipynb]"]
  node_lca_data[("LCA Datasets")]
end

subgraph group_assessment["Impact Assessment"]
  node_design_examples["Toy Designs"]
  node_compare["Comparison Orchestrator<br/>[compare.py]"]
  node_design_loader["Design Loading<br/>[utils.py]"]
  node_ic_heuristic_models["Component Models<br/>[classes.py]"]
  node_heuristics["Domain Heuristics<br/>[heuristics.py]"]
  node_carbon_estimates["Non-IC Carbon"]
end

subgraph group_selection["Comparison Methods"]
  node_ortools["OR-Tools Selection<br/>[ortools_model.py]"]
  node_brute_force["Brute-Force Search"]
  node_greedy["Greedy Search<br/>[greedy_model.py]"]
end

subgraph group_interaction["User Interaction"]
  node_ui["Comparison UI<br/>[UI.py]"]
end

node_designer(("Designer"))
node_pcb["EDA Board Files"]

node_designer -->|"provides designs"| node_pcb
node_pcb -->|"parses boards"| node_inventory_notebook
node_inventory_notebook -.->|"uses datasets"| node_lca_data
node_designer -->|"starts comparison"| node_ui
node_design_examples -->|"loads examples"| node_ui
node_ui -->|"runs comparison"| node_compare
node_compare -->|"loads designs"| node_design_loader
node_compare -->|"applies rules"| node_heuristics
node_compare -->|"builds heuristics"| node_ic_heuristic_models
node_compare -->|"selects heuristics"| node_ortools
node_design_loader -->|"creates components"| node_ic_heuristic_models
node_design_loader -->|"estimates carbon"| node_carbon_estimates
node_carbon_estimates -->|"returns estimates"| node_design_loader
node_ortools -->|"uses models"| node_ic_heuristic_models
node_ortools -->|"uses rules"| node_heuristics
node_brute_force -->|"generates rules"| node_heuristics
node_brute_force -->|"builds models"| node_ic_heuristic_models
node_brute_force -->|"checks conflicts"| node_ortools
node_greedy -->|"verifies propositions"| node_brute_force
node_greedy -->|"checks conflicts"| node_ortools
node_greedy -->|"generates rules"| node_heuristics
node_greedy -->|"builds models"| node_ic_heuristic_models
node_compare -->|"returns results"| node_ui
node_designer -->|"adds rules"| node_ui

click node_inventory_notebook "https://github.com/iamzhihanzhang/deltalca/blob/main/sec_5_life_cycle_inventory/notebook.ipynb"
click node_lca_data "https://github.com/iamzhihanzhang/deltalca/tree/main/sec_5_life_cycle_inventory/lca_data"
click node_design_examples "https://github.com/iamzhihanzhang/deltalca/tree/main/sec_6_comparative_impact_assessment/toy_examples"
click node_ui "https://github.com/iamzhihanzhang/deltalca/blob/main/user_interface/UI.py"
click node_compare "https://github.com/iamzhihanzhang/deltalca/blob/main/sec_6_comparative_impact_assessment/compare.py"
click node_design_loader "https://github.com/iamzhihanzhang/deltalca/blob/main/sec_6_comparative_impact_assessment/utils.py"
click node_ic_heuristic_models "https://github.com/iamzhihanzhang/deltalca/blob/main/sec_6_comparative_impact_assessment/classes.py"
click node_heuristics "https://github.com/iamzhihanzhang/deltalca/blob/main/sec_6_comparative_impact_assessment/heuristics.py"
click node_carbon_estimates "https://github.com/iamzhihanzhang/deltalca/blob/main/sec_6_comparative_impact_assessment/precompute_carbon_number.py"
click node_ortools "https://github.com/iamzhihanzhang/deltalca/blob/main/sec_6_comparative_impact_assessment/ortools_model.py"
click node_brute_force "https://github.com/iamzhihanzhang/deltalca/blob/main/sec_6_comparative_impact_assessment/bruteforce_model.py"
click node_greedy "https://github.com/iamzhihanzhang/deltalca/blob/main/sec_6_comparative_impact_assessment/greedy_model.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_inventory_notebook,node_lca_data toneBlue
class node_design_examples,node_compare,node_design_loader,node_ic_heuristic_models,node_heuristics,node_carbon_estimates toneAmber
class node_ortools,node_brute_force,node_greedy toneMint
class node_ui toneRose
class node_designer,node_pcb toneIndigo
```

## Components

### Inventory Generation

- [Inventory Pipeline](https://github.com/iamzhihanzhang/deltalca/blob/main/sec_5_life_cycle_inventory/notebook.ipynb): `sec_5_life_cycle_inventory/notebook.ipynb`
- [LCA Datasets](https://github.com/iamzhihanzhang/deltalca/tree/main/sec_5_life_cycle_inventory/lca_data): `sec_5_life_cycle_inventory/lca_data`

### Impact Assessment

- [Toy Designs](https://github.com/iamzhihanzhang/deltalca/tree/main/sec_6_comparative_impact_assessment/toy_examples): `sec_6_comparative_impact_assessment/toy_examples`
- [Comparison Orchestrator](https://github.com/iamzhihanzhang/deltalca/blob/main/sec_6_comparative_impact_assessment/compare.py): `sec_6_comparative_impact_assessment/compare.py`
- [Design Loading](https://github.com/iamzhihanzhang/deltalca/blob/main/sec_6_comparative_impact_assessment/utils.py): `sec_6_comparative_impact_assessment/utils.py`
- [Component Models](https://github.com/iamzhihanzhang/deltalca/blob/main/sec_6_comparative_impact_assessment/classes.py): `sec_6_comparative_impact_assessment/classes.py`
- [Domain Heuristics](https://github.com/iamzhihanzhang/deltalca/blob/main/sec_6_comparative_impact_assessment/heuristics.py): `sec_6_comparative_impact_assessment/heuristics.py`
- [Non-IC Carbon](https://github.com/iamzhihanzhang/deltalca/blob/main/sec_6_comparative_impact_assessment/precompute_carbon_number.py): `sec_6_comparative_impact_assessment/precompute_carbon_number.py`

### Comparison Methods

- [OR-Tools Selection](https://github.com/iamzhihanzhang/deltalca/blob/main/sec_6_comparative_impact_assessment/ortools_model.py): `sec_6_comparative_impact_assessment/ortools_model.py`
- [Brute-Force Search](https://github.com/iamzhihanzhang/deltalca/blob/main/sec_6_comparative_impact_assessment/bruteforce_model.py): `sec_6_comparative_impact_assessment/bruteforce_model.py`
- [Greedy Search](https://github.com/iamzhihanzhang/deltalca/blob/main/sec_6_comparative_impact_assessment/greedy_model.py): `sec_6_comparative_impact_assessment/greedy_model.py`

### User Interaction

- [Comparison UI](https://github.com/iamzhihanzhang/deltalca/blob/main/user_interface/UI.py): `user_interface/UI.py`

### Other components

- **Designer**
- **EDA Board Files**

## Connections

- Designer → EDA Board Files: provides designs (evidence: `README.md`)
- EDA Board Files → Inventory Pipeline: parses boards (evidence: `README.md`)
- Inventory Pipeline → LCA Datasets: uses datasets
- Designer → Comparison UI: starts comparison (evidence: `README.md`)
- Toy Designs → Comparison UI: loads examples (evidence: `README.md`)
- Comparison UI → Comparison Orchestrator: runs comparison (evidence: `user_interface/UI.py`)
- Comparison Orchestrator → Design Loading: loads designs (evidence: `sec_6_comparative_impact_assessment/compare.py`)
- Comparison Orchestrator → Domain Heuristics: applies rules (evidence: `sec_6_comparative_impact_assessment/compare.py`)
- Comparison Orchestrator → Component Models: builds heuristics (evidence: `sec_6_comparative_impact_assessment/compare.py`)
- Comparison Orchestrator → OR-Tools Selection: selects heuristics (evidence: `sec_6_comparative_impact_assessment/compare.py`)
- Design Loading → Component Models: creates components (evidence: `sec_6_comparative_impact_assessment/utils.py`)
- Design Loading → Non-IC Carbon: estimates carbon (evidence: `sec_6_comparative_impact_assessment/utils.py`)
- Non-IC Carbon → Design Loading: returns estimates (evidence: `sec_6_comparative_impact_assessment/utils.py`)
- OR-Tools Selection → Component Models: uses models (evidence: `sec_6_comparative_impact_assessment/ortools_model.py`)
- OR-Tools Selection → Domain Heuristics: uses rules (evidence: `sec_6_comparative_impact_assessment/ortools_model.py`)
- Brute-Force Search → Domain Heuristics: generates rules (evidence: `sec_6_comparative_impact_assessment/bruteforce_model.py`)
- Brute-Force Search → Component Models: builds models (evidence: `sec_6_comparative_impact_assessment/bruteforce_model.py`)
- Brute-Force Search → OR-Tools Selection: checks conflicts (evidence: `sec_6_comparative_impact_assessment/bruteforce_model.py`)
- Greedy Search → Brute-Force Search: verifies propositions (evidence: `sec_6_comparative_impact_assessment/greedy_model.py`)
- Greedy Search → OR-Tools Selection: checks conflicts (evidence: `sec_6_comparative_impact_assessment/greedy_model.py`)
- Greedy Search → Domain Heuristics: generates rules (evidence: `sec_6_comparative_impact_assessment/greedy_model.py`)
- Greedy Search → Component Models: builds models (evidence: `sec_6_comparative_impact_assessment/greedy_model.py`)
- Comparison Orchestrator → Comparison UI: returns results (evidence: `user_interface/UI.py`)
- Designer → Comparison UI: adds rules (evidence: `README.md`)
