Simulation/Output/Lanechange

generated on 2017-12-19 09:15:31.963846 from the wiki page for Simulation/Output/Lanechange for SUMO 0.32.0

The lanechange-output tracks all events where a vehicle changes laterally from one lane to another (define as the moment where the center line of the vehicle enters the new lane). It also contains the dominant reason for that change maneuver.

Instantiating within the Simulation

The simulation is forced to generate this output using the option --lanechange-output <FILE>. <FILE> is the name of the file the output will be written to. Any other file with this name will be overwritten, the destination folder must exist.

Generated Output

The generated XML file looks like this: 

<lanechanges>
  <change id="<VEHICLE_ID>" time="<TIME_STAMP>" from="<SOURCE_LANE>" to="<DESTINATION_LANE>" reason="<CHANGE_REASON>"/>
  ...

</lanechanges>
Name Type Description
id id The id of the vehicle
type id The type id of the vehicle
time seconds The time at which the change took place
from id The id of the source lane
to id The id of the destination lane
pos float m The position where the lane-change took place (offset from lane start)
reason string The reason for changing (see below)
dir int The direction of the change (difference in lane indices when staying within one edge)
speed double The current speed of the vehicle
leaderGap double The longitudinal gap to the nearest leader on the target lane (bumper to bumper) or 'None' if there was no leader.
leaderSecureGap double The required longitudinal gap to the nearest leader to fulfill deceleration constraints or 'None' if there was no leader.
followerGap double The lateral gap to the nearest follower on the target lane (bumper to bumper) or 'None' if there was no follower.
followerSecureGap double The required longitudinal gap to the nearest follower to fulfill deceleration constraints or 'None' if there was no follower.
latGap double The lateral gap to the nearest neighbour on the target lane or 'None' if there was no neighbor. (only when using the sublane-model)

Lane Changing Reasons

The reason may be one of

  • speedGain
  • strategic
  • cooperative
  • keepRight
  • sublane
  • traci

A reason may be further qualified by the addition of the string |urgent.

This page was last modified on 10 October 2017, at 12:50.