Statistic Output

Instantiating within the Simulation#

Statistic output is activated by setting the simulation option --statistic-output <FILE> on the command line or in a .sumocfg file.

Generated Output#

The generated XML file looks like this:

<statistics>
    <vehicles ''ATTRIBUTES''.../>
    <teleports ''ATTRIBUTES''.../>
    <safety ''ATTRIBUTES''.../>
    <persons ''ATTRIBUTES''.../>
    <vehicleTripStatistics ''ATTRIBUTES''.../>
    <pedestrianStatistics ''ATTRIBUTES''.../>
    <rideStatistics ''ATTRIBUTES''.../>
    <transportStatistics ''ATTRIBUTES''.../>
</statistics>

The following output attributes are generated:

vehicles#

Attribute Name Value Type Description
loaded # Number of vehicles that were loaded into the simulation
inserted # Number of vehicles inserted
running # Number of vehicles that were running
waiting # Number of vehicles which were waiting for insertion (could not be inserted)

teleports#

Attribute Name Value Type Description
total # The total number of teleportations that occured
jam # Number of teleportations due to traffic jam
yield # Number of teleportations due to yield (vehicle is stuck on a low-priority road and did not find a gap in the prioritized traffic)
wrongLane # Number of teleportations due to the vehicle being stuck on a lane which has no connection to the next edge on its route

safety#

Attribute Name Value Type Description
collisions # Number of collisions that occurred
emergencyStops # Number of emergency stops performed

persons#

Attribute Name Value Type Description
loaded # Number of persons that were loaded into the simulation
running # Number of persons that were running
jammed # Number of persons that were jammed during the simulation

vehicleTripStatistics#

Attribute Name Value Type Description
routeLength m The average route length
speed m/s The average trip speed
duration s The average trip duration
waitingTime s The average time spent standing (involuntarily)
timeLoss s The average time lost due to driving slower than desired (includes waitingTime)
departDelay s The average time vehicles had to wait before starting their journeys
departDelayWaiting s The average waiting time of vehicles which could not be inserted due to lack of road space

pedestrianStatistics#

Attribute Name Value Type Description
number # Total number of pedestrian walks
routeLength m The average walk length
duration s The average walk duration
timeLoss s The average time lost due to walking below maximum speed or stopping

rideStatistics#

Attribute Name Value Type Description
number # Total number of rides (Rides are movement using a single mode of transport)
routeLength m The average ride route length
duration s The average total ride duration
bus # Number of rides with a public transport vehicle driving on roads
train # Number of rides with a public transport vehicle driving on rails
taxi # Number of taxi rides
bike # Number of rides with vehicle class bicycle
aborted # Number of rides that could not be completed

transportStatistics#

Attribute Name Value Type Description
number #
routeLength m
duration s
bus #
train #
taxi #
bike #
aborted #