# sujith-mg/fuzzy-traffic-signal-controller architecture

> Architecture diagram of the GitHub repository sujith-mg/fuzzy-traffic-signal-controller, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sujith-mg/fuzzy-traffic-signal-controller
- Repository: https://github.com/sujith-mg/fuzzy-traffic-signal-controller

## Overview

The product is a SUMO-based adaptive traffic-signal controller, evaluated against a fixed-time baseline. Its main workflow selects a traffic scenario and run mode, controls a SUMO intersection through TraCI, records traffic KPIs, and presents or benchmarks results. The README also documents a Streamlit dashboard with live telemetry, comparison views, fuzzy membership visualization, and a rule explorer. Some subsystem links below rely on README statements because their implementation was not sampled.

Main entry points: [`main.py`](https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/main.py) (CLI Coordinator), [`src/config_loader.py`](https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/src/config_loader.py) (Configuration Manager), [`src/traffic_controller.py`](https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/src/traffic_controller.py) (Adaptive Controller), [`src/experiment_runner.py`](https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/src/experiment_runner.py) (Experiment Runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User Interface"]
  node_dashboard["Streamlit Dashboard<br/>[app.py]"]
end

subgraph group_orchestration["Run Orchestration"]
  node_coordinator["CLI Coordinator<br/>[main.py]"]
  node_configuration["Configuration Manager<br/>[config_loader.py]"]
end

subgraph group_control["Signal Control"]
  node_baseline["Fixed-Time Controller"]
  node_adaptive["Adaptive Controller"]
  node_fis["Mamdani Fuzzy Engine"]
  node_traci["TraCI Manager<br/>[traci_manager.py]"]
end

subgraph group_simulation["Traffic Simulation"]
  node_scenario_config["Simulation Scenarios<br/>[simulation.yaml]"]
  node_fuzzy_config["Fuzzy Settings<br/>[fuzzy.yaml]"]
  node_intersection_assets["Intersection and Routes"]
  node_sumo["SUMO Simulator"]
end

subgraph group_analysis["Metrics and Experiments"]
  node_metrics["Metrics Collector"]
  node_experiments["Experiment Runner"]
  node_results["Run Results"]
end

node_operator(("Operator"))

node_operator -->|"selects and starts"| node_dashboard
node_operator -->|"runs modes"| node_coordinator
node_dashboard -->|"launches subprocess"| node_coordinator
node_dashboard -->|"loads scenarios"| node_configuration
node_dashboard -->|"reads CSVs"| node_results
node_coordinator -->|"loads settings"| node_configuration
node_coordinator -->|"runs baseline"| node_baseline
node_coordinator -->|"runs adaptive"| node_adaptive
node_coordinator -->|"runs benchmarks"| node_experiments
node_coordinator -->|"plots memberships"| node_fis
node_configuration -->|"loads YAML"| node_scenario_config
node_configuration -->|"loads YAML"| node_fuzzy_config
node_configuration -->|"resolves scenario routes"| node_intersection_assets
node_intersection_assets -->|"configures simulation"| node_sumo
node_baseline -->|"reads phase settings"| node_configuration
node_baseline -->|"queries and actuates"| node_traci
node_baseline -->|"records run metrics"| node_metrics
node_adaptive -->|"reads phase settings"| node_configuration
node_adaptive -->|"queries and actuates"| node_traci
node_adaptive -->|"computes green time"| node_fis
node_adaptive -->|"records run metrics"| node_metrics
node_traci -->|"exchanges state and commands"| node_sumo
node_experiments -->|"runs seeded baseline"| node_baseline
node_experiments -->|"runs seeded adaptive"| node_adaptive
node_experiments -->|"generates comparisons"| node_metrics
node_metrics -->|"writes CSVs"| node_results
node_experiments -->|"writes benchmark outputs"| node_results

click node_dashboard "https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/dashboard/app.py"
click node_coordinator "https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/main.py"
click node_configuration "https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/src/config_loader.py"
click node_scenario_config "https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/config/simulation.yaml"
click node_fuzzy_config "https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/config/fuzzy.yaml"
click node_intersection_assets "https://github.com/sujith-mg/fuzzy-traffic-signal-controller/tree/main/sumo_config"
click node_baseline "https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/src/traffic_controller.py"
click node_adaptive "https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/src/traffic_controller.py"
click node_fis "https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/src/fuzzy_controller.py"
click node_traci "https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/src/traci_manager.py"
click node_metrics "https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/src/metrics_collector.py"
click node_experiments "https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/src/experiment_runner.py"
click node_results "https://github.com/sujith-mg/fuzzy-traffic-signal-controller/tree/main/results"

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_dashboard toneBlue
class node_coordinator,node_configuration toneAmber
class node_baseline,node_adaptive,node_fis,node_traci toneMint
class node_scenario_config,node_fuzzy_config,node_intersection_assets,node_sumo toneRose
class node_metrics,node_experiments,node_results,node_operator toneIndigo
```

## Components

### User Interface

- [Streamlit Dashboard](https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/dashboard/app.py): `dashboard/app.py`

### Run Orchestration

- [CLI Coordinator](https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/main.py): `main.py`
- [Configuration Manager](https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/src/config_loader.py): `src/config_loader.py`

### Signal Control

- [Fixed-Time Controller](https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/src/traffic_controller.py): `src/traffic_controller.py`
- [Adaptive Controller](https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/src/traffic_controller.py): `src/traffic_controller.py`
- [Mamdani Fuzzy Engine](https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/src/fuzzy_controller.py): `src/fuzzy_controller.py`
- [TraCI Manager](https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/src/traci_manager.py): `src/traci_manager.py`

### Traffic Simulation

- [Simulation Scenarios](https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/config/simulation.yaml): `config/simulation.yaml`
- [Fuzzy Settings](https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/config/fuzzy.yaml): `config/fuzzy.yaml`
- [Intersection and Routes](https://github.com/sujith-mg/fuzzy-traffic-signal-controller/tree/main/sumo_config): `sumo_config`
- **SUMO Simulator**

### Metrics and Experiments

- [Metrics Collector](https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/src/metrics_collector.py): `src/metrics_collector.py`
- [Experiment Runner](https://github.com/sujith-mg/fuzzy-traffic-signal-controller/blob/main/src/experiment_runner.py): `src/experiment_runner.py`
- [Run Results](https://github.com/sujith-mg/fuzzy-traffic-signal-controller/tree/main/results): `results`

### Other components

- **Operator**

## Connections

- Operator → Streamlit Dashboard: selects and starts (evidence: `README.md`)
- Operator → CLI Coordinator: runs modes (evidence: `README.md`)
- Streamlit Dashboard → CLI Coordinator: launches subprocess (evidence: `README.md`)
- Streamlit Dashboard → Configuration Manager: loads scenarios (evidence: `dashboard/app.py`)
- Streamlit Dashboard → Run Results: reads CSVs (evidence: `dashboard/app.py`)
- CLI Coordinator → Configuration Manager: loads settings (evidence: `main.py`)
- CLI Coordinator → Fixed-Time Controller: runs baseline (evidence: `main.py`)
- CLI Coordinator → Adaptive Controller: runs adaptive (evidence: `main.py`)
- CLI Coordinator → Experiment Runner: runs benchmarks (evidence: `main.py`)
- CLI Coordinator → Mamdani Fuzzy Engine: plots memberships (evidence: `main.py`)
- Configuration Manager → Simulation Scenarios: loads YAML (evidence: `src/config_loader.py`)
- Configuration Manager → Fuzzy Settings: loads YAML (evidence: `src/config_loader.py`)
- Configuration Manager → Intersection and Routes: resolves scenario routes (evidence: `src/config_loader.py`)
- Intersection and Routes → SUMO Simulator: configures simulation (evidence: `README.md`)
- Fixed-Time Controller → Configuration Manager: reads phase settings (evidence: `src/traffic_controller.py`)
- Fixed-Time Controller → TraCI Manager: queries and actuates (evidence: `src/traffic_controller.py`)
- Fixed-Time Controller → Metrics Collector: records run metrics (evidence: `src/traffic_controller.py`)
- Adaptive Controller → Configuration Manager: reads phase settings (evidence: `src/traffic_controller.py`)
- Adaptive Controller → TraCI Manager: queries and actuates (evidence: `src/traffic_controller.py`)
- Adaptive Controller → Mamdani Fuzzy Engine: computes green time (evidence: `src/traffic_controller.py`)
- Adaptive Controller → Metrics Collector: records run metrics (evidence: `src/traffic_controller.py`)
- TraCI Manager → SUMO Simulator: exchanges state and commands (evidence: `README.md`)
- Experiment Runner → Fixed-Time Controller: runs seeded baseline (evidence: `src/experiment_runner.py`)
- Experiment Runner → Adaptive Controller: runs seeded adaptive (evidence: `src/experiment_runner.py`)
- Experiment Runner → Metrics Collector: generates comparisons (evidence: `src/experiment_runner.py`)
- Metrics Collector → Run Results: writes CSVs
- Experiment Runner → Run Results: writes benchmark outputs (evidence: `src/experiment_runner.py`)
