📁 SUMO Simulation Output Files
Comprehensive documentation of SUMO output file parameters
Organized by category with practical examples.
📝 Output Categories¶
SUMO generates diverse output files for analyzing simulations. Below is a categorized summary of all parameters with examples.
⚙️ Configuration & Precision¶
Parameters controlling output formatting and precision:
| Parameter | Description | Example |
|---|---|---|
--precision 4 |
Sets floating-point precision to 4 digits. | speed="13.2165" (instead of speed="13.22") |
--netstate-dump.precision 3 |
Saves positions with 3 decimal places. | pos="123.456" |
--save-state.precision 0 |
Rounds internal states to integers. | time="35" |
🚗 Vehicle Data¶
Outputs related to vehicle trajectories, emissions, and routes:
Core Vehicle Outputs¶
| Parameter | Description | Example |
|---|---|---|
--tripinfo-output tripinfo.xml |
Trip duration, route distance. | xml <tripinfo id="veh0" depart="0" arrival="50" routeLength="1000"/> |
--vehroute-output routes.xml --vehroute-output.exit-times |
Adds edge exit times. | xml <vehicle id="veh0"><route edges="edge1 edge2"><stop edge="edge1" exitTime="25"/></route></vehicle> |
--fcd-output fcd.xml --fcd-output.acceleration |
Saves acceleration data. | xml <timestep time="1.00"><vehicle id="veh0" accel="2.3"/></timestep> |
Emissions & Energy¶
| Parameter | Description | Example |
|---|---|---|
--emission-output emissions.xml |
CO2 emissions per vehicle. | xml <vehicle id="veh0" CO2="124.5" fuel="0.8"/> |
--battery-output battery.xml |
Battery charge level. | xml <vehicle id="veh0" charge="85.2" power="3.1"/> |
🏗️ Infrastructure Data¶
Outputs for traffic infrastructure:
| Parameter | Description | Example |
|---|---|---|
--chargingstations-output charging.xml |
Charging events. | xml <chargingStation id="cs1" chargingPower="22.0" totalEnergy="150.5"/> |
--overheadwiresegments-output wires.xml |
Power usage per segment. | xml <segment id="wire1" voltage="600" current="120"/> |
📊 Traffic Statistics¶
Aggregated traffic metrics:
| Parameter | Description | Example |
|---|---|---|
--edgedata-output edges.xml |
Edge flow and occupancy. | xml <interval begin="0" end="100"><edge id="edge1" flow="500" occupancy="0.7"/></interval> |
--queue-output queues.xml |
Queues at junctions. | xml <junction id="j0" queueLength="5" time="30"/> |
🔧 Specialized Outputs¶
Niche or experimental outputs:
| Parameter | Description | Example |
|---|---|---|
--collision-output collisions.xml |
Collision coordinates. | xml <collision time="45" vehicles="veh0 veh1" pos="x100,y200"/> |
--lanechange-output lc.xml --lanechange-output.xy |
Lane change coordinates. | xml <laneChange vehicle="veh0" x="150.0" y="300.0" reason="strategic"/> |
🚀 Usage Examples¶
Basic Simulation with Key Outputs¶
sumo -c config.sumocfg \
--tripinfo-output tripinfo.xml \
--emission-output emissions.xml \
--fcd-output fcd.xml
Advanced Scenario with Infrastructure Data¶
sumo -c electric_vehicles.sumocfg \
--battery-output battery.xml \
--chargingstations-output charging.xml \
--elechybrid-output hybrid.xml
Debugging Traffic Flow¶
sumo -c debug.sumocfg \
--edgedata-output edges.xml \
--queue-output queues.xml \
--collision-output collisions.xml