How husal10/zuritwinbench works
ZuriTwinBench is a calibrated SUMO digital twin of Zürich’s Langstrasse intersection. Its main workflow uses observed detector and signal data to generate traffic demand, combines that demand with the intersection network, runs a full-day microscopic simulation, and evaluates simulated detector counts against observations. The repository also includes a benchmark scenario and protocol. The excerpts establish the demand-generation, build, simulation-runner, and calibration relationships; links among unsampled SUMO configuration files and runtime components are limited to relationships documented by the README.
Main entry points: demand_generator.py Demand generator · build_network.py Network builder · geh_evaluator.py Calibration evaluator · run_sumo.py TraCI simulation runner
Components 17
Observed Inputs
- Field observations
data/feb04_only.csv - Demand generator
demand/demand_generator.py
Intersection Model
- Network definitions
network - Network builder
build_network.py - Compiled network
simulation/intersection.net.xml
Simulation
- Vehicle flows & routes
simulation/flows.rou.xml - Tram schedules
simulation/trams.rou.xml - Pedestrian schedules
simulation/pedestrians.rou.xml - Detector setup
simulation/detectors.add.xml - SUMO scenario config
simulation/intersection.sumocfg - TraCI simulation runner
simulation/run_sumo.py - Simulated detector counts
simulation/output
Calibration & Benchmark
- Calibration evaluator
calibration/geh_evaluator.py - Calibration report & figures
calibration - Benchmark scenario
benchmark
Other components
- Model user
- SUMO engine
Connections 19
- Model user → Network builder: builds model
README.md - Model user → TraCI simulation runner: runs simulation
README.md - Model user → Calibration evaluator: validates calibration
README.md - Field observations → Demand generator: provides observations
demand/demand_generator.py - Network builder → Demand generator: invokes generator
build_network.py - Network builder → Network definitions: compiles definitions
build_network.py - Demand generator → Vehicle flows & routes: writes flows
demand/demand_generator.py - Demand generator → Tram schedules: writes schedules
demand/demand_generator.py - Demand generator → Pedestrian schedules: writes crossings
demand/demand_generator.py - Demand generator → Detector setup: writes detectors
demand/demand_generator.py - Network builder → Compiled network: generates network
build_network.py - SUMO scenario config → Compiled network: configures scenario
README.md - TraCI simulation runner → SUMO scenario config: loads configuration
simulation/run_sumo.py - TraCI simulation runner → SUMO engine: controls simulation
simulation/run_sumo.py - SUMO engine → Simulated detector counts: writes counts
README.md - Calibration evaluator → Field observations: reads observations
calibration/geh_evaluator.py - Calibration evaluator → Simulated detector counts: reads simulated counts
calibration/geh_evaluator.py - Calibration evaluator → Calibration report & figures: produces metrics
README.md - Model user → Benchmark scenario: uses benchmark
README.md