# bulayer/transmission_line_simulator architecture

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

- Interactive diagram: https://gitdiagram.com/bulayer/transmission_line_simulator
- Repository: https://github.com/bulayer/transmission_line_simulator

## Overview

TransLine-Sim is a Tkinter desktop workstation for transmission-line studies. The user enters system and conductor data, then runs forward performance analysis or reverse loadability analysis; results and schematic views update in the interface. The README documents conductor parameter calculations, short/medium/long ABCD models, performance metrics, and the interactive SLD. The sampled source confirms UI wiring, reverse-mode iteration, performance calculations, and schematic updates; other internal relationships below are included only where documented.

Main entry points: [`main.py`](https://github.com/bulayer/transmission_line_simulator/blob/main/main.py) (Tkinter Workstation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Desktop Interface"]
  node_workstation["Tkinter Workstation<br/>[main.py]"]
  node_input_controls["Operating Inputs<br/>[main.py]"]
end

subgraph group_inputs["System Inputs"]
  node_conductor_catalog[("Conductor Catalog<br/>[main.py]")]
  node_custom_conductors["Custom Conductors<br/>[main.py]"]
end

subgraph group_analysis["Line Analysis"]
  node_parameter_engine["Physical Parameters<br/>[main.py]"]
  node_line_models["ABCD Line Models<br/>[main.py]"]
  node_forward_analysis["Forward Analysis<br/>[main.py]"]
  node_reverse_analysis["Reverse Loadability<br/>[main.py]"]
end

subgraph group_outputs["Results &amp; Visualization"]
  node_performance_metrics["Performance Metrics<br/>[main.py]"]
  node_results_panel["Numerical Results<br/>[main.py]"]
  node_sld_canvas["Single-Line Schematic<br/>[main.py]"]
end

node_user(("Engineer"))

node_user -->|"operates"| node_workstation
node_workstation -->|"presents"| node_input_controls
node_input_controls -->|"selects conductor"| node_conductor_catalog
node_input_controls -->|"configures"| node_custom_conductors
node_input_controls -->|"supplies geometry"| node_parameter_engine
node_parameter_engine -->|"provides parameters"| node_line_models
node_workstation -->|"dispatches calculation"| node_forward_analysis
node_workstation -->|"dispatches calculation"| node_reverse_analysis
node_forward_analysis -->|"uses ABCD model"| node_line_models
node_reverse_analysis -->|"iterates loadability"| node_line_models
node_forward_analysis -->|"calculates metrics"| node_performance_metrics
node_reverse_analysis -->|"checks voltage drop"| node_performance_metrics
node_workstation -->|"updates results"| node_results_panel
node_workstation -->|"redraws schematic"| node_sld_canvas

click node_workstation "https://github.com/bulayer/transmission_line_simulator/blob/main/main.py"
click node_input_controls "https://github.com/bulayer/transmission_line_simulator/blob/main/main.py"
click node_conductor_catalog "https://github.com/bulayer/transmission_line_simulator/blob/main/main.py"
click node_custom_conductors "https://github.com/bulayer/transmission_line_simulator/blob/main/main.py"
click node_parameter_engine "https://github.com/bulayer/transmission_line_simulator/blob/main/main.py"
click node_line_models "https://github.com/bulayer/transmission_line_simulator/blob/main/main.py"
click node_forward_analysis "https://github.com/bulayer/transmission_line_simulator/blob/main/main.py"
click node_reverse_analysis "https://github.com/bulayer/transmission_line_simulator/blob/main/main.py"
click node_performance_metrics "https://github.com/bulayer/transmission_line_simulator/blob/main/main.py"
click node_results_panel "https://github.com/bulayer/transmission_line_simulator/blob/main/main.py"
click node_sld_canvas "https://github.com/bulayer/transmission_line_simulator/blob/main/main.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_workstation,node_input_controls toneBlue
class node_conductor_catalog,node_custom_conductors toneAmber
class node_parameter_engine,node_line_models,node_forward_analysis,node_reverse_analysis toneMint
class node_performance_metrics,node_results_panel,node_sld_canvas toneRose
class node_user toneIndigo
```

## Components

### Desktop Interface

- [Tkinter Workstation](https://github.com/bulayer/transmission_line_simulator/blob/main/main.py): `main.py`
- [Operating Inputs](https://github.com/bulayer/transmission_line_simulator/blob/main/main.py): `main.py`

### System Inputs

- [Conductor Catalog](https://github.com/bulayer/transmission_line_simulator/blob/main/main.py): `main.py`
- [Custom Conductors](https://github.com/bulayer/transmission_line_simulator/blob/main/main.py): `main.py`

### Line Analysis

- [Physical Parameters](https://github.com/bulayer/transmission_line_simulator/blob/main/main.py): `main.py`
- [ABCD Line Models](https://github.com/bulayer/transmission_line_simulator/blob/main/main.py): `main.py`
- [Forward Analysis](https://github.com/bulayer/transmission_line_simulator/blob/main/main.py): `main.py`
- [Reverse Loadability](https://github.com/bulayer/transmission_line_simulator/blob/main/main.py): `main.py`

### Results & Visualization

- [Performance Metrics](https://github.com/bulayer/transmission_line_simulator/blob/main/main.py): `main.py`
- [Numerical Results](https://github.com/bulayer/transmission_line_simulator/blob/main/main.py): `main.py`
- [Single-Line Schematic](https://github.com/bulayer/transmission_line_simulator/blob/main/main.py): `main.py`

### Other components

- **Engineer**

## Connections

- Engineer → Tkinter Workstation: operates (evidence: `README.md`)
- Tkinter Workstation → Operating Inputs: presents (evidence: `main.py`)
- Operating Inputs → Conductor Catalog: selects conductor (evidence: `README.md`)
- Operating Inputs → Custom Conductors: configures (evidence: `README.md`)
- Operating Inputs → Physical Parameters: supplies geometry (evidence: `README.md`)
- Physical Parameters → ABCD Line Models: provides parameters (evidence: `README.md`)
- Tkinter Workstation → Forward Analysis: dispatches calculation (evidence: `main.py`)
- Tkinter Workstation → Reverse Loadability: dispatches calculation (evidence: `main.py`)
- Forward Analysis → ABCD Line Models: uses ABCD model (evidence: `README.md`)
- Reverse Loadability → ABCD Line Models: iterates loadability (evidence: `main.py`)
- Forward Analysis → Performance Metrics: calculates metrics (evidence: `main.py`)
- Reverse Loadability → Performance Metrics: checks voltage drop (evidence: `main.py`)
- Tkinter Workstation → Numerical Results: updates results (evidence: `main.py`)
- Tkinter Workstation → Single-Line Schematic: redraws schematic (evidence: `main.py`)
