# sel-columbia/accel_tlnd architecture

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

- Interactive diagram: https://gitdiagram.com/sel-columbia/accel_tlnd
- Repository: https://github.com/sel-columbia/accel_tlnd

## Overview

Accel-TLND is a geospatial planning script that turns structure locations into clustered transformer locations and low- and medium-voltage network layouts, then reports costs and exports maps and spatial data. The main workflow is driven by `scripts/main.py`; structure merging is a separate preprocessing capability. The README documents both MST and Gurobi MILP LV design. Relationships for those design stages are shown at the level supported by the main calls and documentation; the unsampled configuration and internal implementation details are not inferred.

Main entry points: [`scripts/main.py`](https://github.com/sel-columbia/accel_tlnd/blob/main/scripts/main.py) (Model runner), [`results/.gitkeep`](https://github.com/sel-columbia/accel_tlnd/blob/main/results/.gitkeep) (Generated results), [`scripts/preparation/merge_structures.py`](https://github.com/sel-columbia/accel_tlnd/blob/main/scripts/preparation/merge_structures.py) (Structure merging), [`scripts/write_outputs.py`](https://github.com/sel-columbia/accel_tlnd/blob/main/scripts/write_outputs.py) (Metrics and costs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Model workflow"]
  node_source_data["Geospatial input"]
  node_config["Scenario configuration<br/>[params.yaml]"]
  node_runner["Model runner<br/>[main.py]"]
  node_outlier_filter["Outlier exclusion"]
end

subgraph group_preparation["Structure preparation"]
  node_structure_merge["Structure merging"]
end

subgraph group_design["Network design"]
  node_cluster["Node clustering<br/>[network_design.py]"]
  node_lv_mst["LV MST design<br/>[network_design.py]"]
  node_lv_milp["LV MILP design<br/>[network_design.py]"]
  node_mv_design["MV MST design<br/>[network_design.py]"]
end

subgraph group_results["Results"]
  node_metrics["Metrics and costs<br/>[write_outputs.py]"]
  node_spatial_export["Spatial exports<br/>[write_outputs.py]"]
  node_network_map["Network visualization<br/>[write_outputs.py]"]
  node_result_files["Generated results<br/>[.gitkeep]"]
end

node_planner(("Planner"))

node_planner -->|"runs"| node_runner
node_runner -->|"reads"| node_source_data
node_runner -->|"loads"| node_config
node_runner -->|"optionally filters"| node_outlier_filter
node_runner -->|"clusters"| node_cluster
node_runner -->|"selects MST"| node_lv_mst
node_runner -->|"selects MILP"| node_lv_milp
node_runner -->|"designs network"| node_mv_design
node_planner -.->|"runs preprocessing"| node_structure_merge
node_structure_merge -->|"writes merged data"| node_result_files
node_runner -->|"computes metrics"| node_metrics
node_runner -->|"requests exports"| node_spatial_export
node_runner -->|"requests map"| node_network_map
node_metrics -->|"writes summary"| node_result_files
node_spatial_export -->|"writes spatial data"| node_result_files
node_network_map -->|"saves map"| node_result_files

click node_source_data "https://github.com/sel-columbia/accel_tlnd/blob/main/inputs/test_example/nodes_for_netdesign.shp"
click node_config "https://github.com/sel-columbia/accel_tlnd/blob/main/scripts/params.yaml"
click node_runner "https://github.com/sel-columbia/accel_tlnd/blob/main/scripts/main.py"
click node_outlier_filter "https://github.com/sel-columbia/accel_tlnd/blob/main/scripts/outlier_exclusion.py"
click node_structure_merge "https://github.com/sel-columbia/accel_tlnd/blob/main/scripts/preparation/merge_structures.py"
click node_cluster "https://github.com/sel-columbia/accel_tlnd/blob/main/scripts/network_design.py"
click node_lv_mst "https://github.com/sel-columbia/accel_tlnd/blob/main/scripts/network_design.py"
click node_lv_milp "https://github.com/sel-columbia/accel_tlnd/blob/main/scripts/network_design.py"
click node_mv_design "https://github.com/sel-columbia/accel_tlnd/blob/main/scripts/network_design.py"
click node_metrics "https://github.com/sel-columbia/accel_tlnd/blob/main/scripts/write_outputs.py"
click node_spatial_export "https://github.com/sel-columbia/accel_tlnd/blob/main/scripts/write_outputs.py"
click node_network_map "https://github.com/sel-columbia/accel_tlnd/blob/main/scripts/write_outputs.py"
click node_result_files "https://github.com/sel-columbia/accel_tlnd/blob/main/results/.gitkeep"

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_source_data,node_config,node_runner,node_outlier_filter toneBlue
class node_structure_merge toneAmber
class node_cluster,node_lv_mst,node_lv_milp,node_mv_design toneMint
class node_metrics,node_spatial_export,node_network_map,node_result_files toneRose
class node_planner toneIndigo
```

## Components

### Model workflow

- [Geospatial input](https://github.com/sel-columbia/accel_tlnd/blob/main/inputs/test_example/nodes_for_netdesign.shp): `inputs/test_example/nodes_for_netdesign.shp`
- [Scenario configuration](https://github.com/sel-columbia/accel_tlnd/blob/main/scripts/params.yaml): `scripts/params.yaml`
- [Model runner](https://github.com/sel-columbia/accel_tlnd/blob/main/scripts/main.py): `scripts/main.py`
- [Outlier exclusion](https://github.com/sel-columbia/accel_tlnd/blob/main/scripts/outlier_exclusion.py): `scripts/outlier_exclusion.py`

### Structure preparation

- [Structure merging](https://github.com/sel-columbia/accel_tlnd/blob/main/scripts/preparation/merge_structures.py): `scripts/preparation/merge_structures.py`

### Network design

- [Node clustering](https://github.com/sel-columbia/accel_tlnd/blob/main/scripts/network_design.py): `scripts/network_design.py`
- [LV MST design](https://github.com/sel-columbia/accel_tlnd/blob/main/scripts/network_design.py): `scripts/network_design.py`
- [LV MILP design](https://github.com/sel-columbia/accel_tlnd/blob/main/scripts/network_design.py): `scripts/network_design.py`
- [MV MST design](https://github.com/sel-columbia/accel_tlnd/blob/main/scripts/network_design.py): `scripts/network_design.py`

### Results

- [Metrics and costs](https://github.com/sel-columbia/accel_tlnd/blob/main/scripts/write_outputs.py): `scripts/write_outputs.py`
- [Spatial exports](https://github.com/sel-columbia/accel_tlnd/blob/main/scripts/write_outputs.py): `scripts/write_outputs.py`
- [Network visualization](https://github.com/sel-columbia/accel_tlnd/blob/main/scripts/write_outputs.py): `scripts/write_outputs.py`
- [Generated results](https://github.com/sel-columbia/accel_tlnd/blob/main/results/.gitkeep): `results/.gitkeep`

### Other components

- **Planner**

## Connections

- Planner → Model runner: runs (evidence: `README.md`)
- Model runner → Geospatial input: reads (evidence: `scripts/main.py`)
- Model runner → Scenario configuration: loads (evidence: `scripts/main.py`)
- Model runner → Outlier exclusion: optionally filters (evidence: `scripts/main.py`)
- Model runner → Node clustering: clusters (evidence: `scripts/main.py`)
- Model runner → LV MST design: selects MST (evidence: `scripts/main.py`)
- Model runner → LV MILP design: selects MILP (evidence: `scripts/main.py`)
- Model runner → MV MST design: designs network (evidence: `scripts/main.py`)
- Planner → Structure merging: runs preprocessing
- Structure merging → Generated results: writes merged data (evidence: `scripts/preparation/merge_structures.py`)
- Model runner → Metrics and costs: computes metrics (evidence: `scripts/main.py`)
- Model runner → Spatial exports: requests exports (evidence: `scripts/main.py`)
- Model runner → Network visualization: requests map (evidence: `scripts/main.py`)
- Metrics and costs → Generated results: writes summary (evidence: `scripts/write_outputs.py`)
- Spatial exports → Generated results: writes spatial data (evidence: `scripts/write_outputs.py`)
- Network visualization → Generated results: saves map (evidence: `scripts/write_outputs.py`)
