How akshaysinha07/traffix works
Traffix detects vehicles from video, optionally feeds lane counts into a SUMO simulation, adapts signal timings and coordinates green waves, then exposes simulation metrics and network locations in a dashboard. The dashboard can launch the simulation; the vision API is a separate optional service used by vision-linked mode. Paths and connections reflect the tree, README, and sampled source; wiring for unsampled modules is omitted where uncertain.
Main entry points: sim_engine.py Simulation engine · server.py Dashboard server · vision_api.py Vision API · osm.sumocfg SUMO configuration
Components 19
Vehicle vision
- Vision API
vision_module/vision_api.py - YOLO model
vision_module/yolov8n.pt - Video viewer
vision_module/show_video.py - Model training
vision_module/train.py - Training dataset config
vision_module/dataset.yaml
Traffic simulation
- Simulation engine
simulation_module/sim_engine.py - Green-wave coordination
simulation_module/green_wave.py - Vision route injection
simulation_module/dynamic_routes.py
Dashboard
- Dashboard server
dashboard/server.py - Dashboard UI
dashboard/templates/index.html
Inputs and results
- Traffic video
data/traffic.mp4 - Road network
simulation_module/osm.net.xml - Vehicle routes
simulation_module/osm.rou.xml - SUMO configuration
simulation_module/osm.sumocfg - Simulation results
results.json - Shared configuration
config.py
Other components
- Operator
- SUMO runtime
- Vision HTTP service
Connections 23
- Operator → Vision API: starts service
- Vision API → Traffic video: reads frames
- Vision API → YOLO model: runs inference
- Video viewer → Traffic video: reads frames
- Video viewer → YOLO model: runs inference
- Operator → Video viewer: views detections
- Model training → Training dataset config: loads config
- Model training → YOLO model: fine-tunes model
- Operator → Dashboard UI: uses dashboard
- Dashboard UI → Dashboard server: requests pages
- Dashboard server → Simulation results: reads metrics
- Dashboard server → Road network: reads locations
- Dashboard server → Simulation engine: launches process
- Simulation engine → Shared configuration: loads settings
- Simulation engine → SUMO runtime: starts and controls
- SUMO runtime → SUMO configuration: loads config
- SUMO configuration → Road network: loads network
- SUMO configuration → Vehicle routes: loads routes
- Simulation engine → Green-wave coordination: detects and applies
- Simulation engine → Vision route injection: sets up and injects
- Vision route injection → Vision HTTP service: requests lane counts
- Vision HTTP service → Vision API: serves counts
- Simulation engine → Simulation results: writes metrics