VTypeProbe

Instantiating within the Simulation#

A "vehicle-type probe" is defined the following way within an additional-file: <vTypeProbe id="<ID>" [ type="<VEHICLE_TYPE>" ] period="<OUTPUT_PERIOD>" file="<OUTPUT_FILE>"/>

type names the vehicle type to observe. Only the values of vehicles of this type will be written into the output. If type is empty, the information about all vehicles are included. In contrary to the detectors described above, the values are not aggregated. This means that period does not describe an aggregation interval but the time period between two consecutive times at which the values shall be collected and written.

The following table shows the attributes:

Attribute Name Value Type Description
id id (string) A string holding the id of the detector
period (alias freq) int (time in s) The period with which information shall be written (default: whole simulation time).
file <FILE> The path to the output file. The path may be relative.
type (vehicle type) id The type the vehicles must be of in order to be reported.

Example:

<additional>
    <vTypeProbe id="probe1" type="DEFAULT_VEHTYPE" period="10" file="output.xml"/>
</additional>

This file is then loaded in sumo using the option --additional-files

Generated Output#

The output is divided into timestep-sections:

<timestep time="<COLLECTION_TIME>" id="<DETECTOR_ID>" vtype="<OBSERVED_TYPE>">
    <vehicle id="<VEHICLE_ID>" lane="<LANE_ID>" pos="<POSITION_ON_LANE>" \
        x="<X-COORDINATE>" y="<Y-COORDINATE>" \
        lat="<LAT-COORDINATE>" lon="<LON-COORDINATE>" \
        speed="<VEHICLE_SPEED>"/>
    ... further vehicles ...
</timestep>
... further time steps ...

The values are described in the following table.

Name Type Description
timestep:time (simulation) seconds The time this information describes
timestep:id id The id of the detector
timestep:vtype id The id of the vehicle type observed by this detector
vehicle:id (vehicle) id The id of the described vehicle
lane (lane) id The id of the lane the vehicle was on
pos m The position of the vehicle on lane
x m The x-position of the vehicle within the net
y m The y-position of the vehicle within the net
lat degrees*100,000 The lat-position of the vehicle within the net
lon degrees*100,000 The lon-position of the vehicle within the net
speed m/s The speed of the vehicle within the time step