How sujith-mg/fuzzy-traffic-signal-controller works
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 CLI Coordinator · config_loader.py Configuration Manager · traffic_controller.py Adaptive Controller · experiment_runner.py Experiment Runner
Components 15
User Interface
- Streamlit Dashboard
dashboard/app.py
Run Orchestration
- CLI Coordinator
main.py - Configuration Manager
src/config_loader.py
Signal Control
- Fixed-Time Controller
src/traffic_controller.py - Adaptive Controller
src/traffic_controller.py - Mamdani Fuzzy Engine
src/fuzzy_controller.py - TraCI Manager
src/traci_manager.py
Traffic Simulation
- Simulation Scenarios
config/simulation.yaml - Fuzzy Settings
config/fuzzy.yaml - Intersection and Routes
sumo_config - SUMO Simulator
Metrics and Experiments
- Metrics Collector
src/metrics_collector.py - Experiment Runner
src/experiment_runner.py - Run Results
results
Other components
- Operator
Connections 27
- Operator → Streamlit Dashboard: selects and starts
README.md - Operator → CLI Coordinator: runs modes
README.md - Streamlit Dashboard → CLI Coordinator: launches subprocess
README.md - Streamlit Dashboard → Configuration Manager: loads scenarios
dashboard/app.py - Streamlit Dashboard → Run Results: reads CSVs
dashboard/app.py - CLI Coordinator → Configuration Manager: loads settings
main.py - CLI Coordinator → Fixed-Time Controller: runs baseline
main.py - CLI Coordinator → Adaptive Controller: runs adaptive
main.py - CLI Coordinator → Experiment Runner: runs benchmarks
main.py - CLI Coordinator → Mamdani Fuzzy Engine: plots memberships
main.py - Configuration Manager → Simulation Scenarios: loads YAML
src/config_loader.py - Configuration Manager → Fuzzy Settings: loads YAML
src/config_loader.py - Configuration Manager → Intersection and Routes: resolves scenario routes
src/config_loader.py - Intersection and Routes → SUMO Simulator: configures simulation
README.md - Fixed-Time Controller → Configuration Manager: reads phase settings
src/traffic_controller.py - Fixed-Time Controller → TraCI Manager: queries and actuates
src/traffic_controller.py - Fixed-Time Controller → Metrics Collector: records run metrics
src/traffic_controller.py - Adaptive Controller → Configuration Manager: reads phase settings
src/traffic_controller.py - Adaptive Controller → TraCI Manager: queries and actuates
src/traffic_controller.py - Adaptive Controller → Mamdani Fuzzy Engine: computes green time
src/traffic_controller.py - Adaptive Controller → Metrics Collector: records run metrics
src/traffic_controller.py - TraCI Manager → SUMO Simulator: exchanges state and commands
README.md - Experiment Runner → Fixed-Time Controller: runs seeded baseline
src/experiment_runner.py - Experiment Runner → Adaptive Controller: runs seeded adaptive
src/experiment_runner.py - Experiment Runner → Metrics Collector: generates comparisons
src/experiment_runner.py - Metrics Collector → Run Results: writes CSVs
- Experiment Runner → Run Results: writes benchmark outputs
src/experiment_runner.py