sumo_runner
Runs SUMO traffic simulation using TraCI with network and route files, and captures vehicle positions for replay visualization.
Instructions
[Step 5/5] Run SUMO traffic simulation using TraCI.
Executes the simulation with the generated network and routes.
Captures vehicle position frames for post-simulation replay visualization.
Previous step: route_generate() to get .rou.xml file.
=== PARAMETERS ===
- net_file (REQUIRED): SUMO network file (.net.xml, from net_convert)
- route_file: Route file (.rou.xml, from route_generate) — preferred over trip_file
- trip_file: Trip file (.trips.xml) — use only if route_file is unavailable
- duration: Simulation duration in seconds (default: 3600 = 1 hour)
- additional_files: List of additional XML files (e.g., traffic light programs)
- policy_type: Set to "baseline" to exclude additional files
=== RETURNS ===
- output_files: List of result file paths [tripinfo, edgedata, edgedata_emission]
- summary_xml: Path to summary.xml file. ALWAYS pass this to xml_to_sqlite_tool(summary_xml=...) for dashboard time-series charts.
- replay_file: JSON file for web visualization replay
- simulation_time: Wall-clock execution time in seconds
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| duration | No | ||
| net_file | Yes | ||
| trip_file | No | ||
| output_dir | No | output/simulations | |
| route_file | No | ||
| policy_type | No | ||
| additional_files | No |