SUMO
Simulation of Urban MObility

- Home
- Download
- Documentation
- Wiki
- Trac
- Blog
- Contact
- SF-Project

# Simulation/Output/Summary

This output contains the simulation-wide number of vehicles that are loaded, emitted, running, waiting to be inserted, have reached their destination and how long they needed to finish the route. The last value is normalised over all vehicles that have reached their destination so far.

## Instantiating within the Simulation

You can force the simulation to generate this output using --summary <FILE>.

## Generated Output

The information containing all those values is computed for each time step and the output file looks like following:

    <summary>
       <step time="<SIMULATION_TIME>" \
                  loaded="<LOADED_VEHICLE_NUMBER>" \
                  emitted="<EMITTED_VEHICLE_NUMBER>" \
                  running="<RUNNING_VEHICLE_NUMBER>" \
                  waiting="<NUMBER_OF_VEHICLES_WAITING_FOR_EMISSION>" \
                  ended="<ENDED_VEHICLE_NUMBER>" \
                  meanWaitingTime="<MEAN_WAITING_TIME>" \
                  meanTravelTime="<MEAN_TRAVEL_TIME>"/>

       ... further time steps ...

    </summary>

Please note, that in contrary to the example above, for each time step, all those values are reported in one line. A description of the values is given in the table below.

Name | Type | Description
--- | --- | ---
time | (simulation) seconds | The time step described by the entry
loaded | # | Number of vehicles that were loaded into the simulation so far (including reported time step)
emitted | # | Number of vehicles emitted so far (including reported time step)
running | # | Number of vehicles that were running within the reported time step
waiting | # | Number of vehicles which were waiting for emission (could not be emitted) within the reported time step
ended | # | Number of vehicles that have reached their destination so far (including reported time step)
meanWaitingTime | s | The mean time all vehicles up to now and within the reported time step had to wait for being emitted;-1 if no vehicle has been emitted, yet
meanTravelTime | s | The mean travel time of all vehicles that have left the simulation within the previous and the reported time;-1 if no vehicle has been removed from the simulation, yet

This page was last modified on 12 September 2011, at 11:25.