SUMO - Simulation of Urban MObility
MSVehicle Class Reference

Representation of a vehicle in the micro simulation. More...

#include <MSVehicle.h>

Inheritance diagram for MSVehicle:
Inheritance graph
Collaboration diagram for MSVehicle:
Collaboration graph

Data Structures

struct  DriveProcessItem
 Drive process items represent bounds on the safe velocity corresponding to the upcoming links. More...
 
class  Influencer
 Changes the wished vehicle speed / lanes. More...
 
struct  LaneQ
 A structure representing the best lanes for continuing the current route starting at 'lane'. More...
 
class  State
 Container that holds the vehicles driving state (position+speed). More...
 
class  Stop
 Definition of vehicle stop (position and duration) More...
 
class  WaitingTimeCollector
 Stores the waiting intervals over the previous seconds (memory is to be specified in ms.). More...
 

Public Types

enum  ChangeRequest { REQUEST_NONE, REQUEST_LEFT, REQUEST_RIGHT, REQUEST_HOLD }
 Requests set via TraCI. More...
 

Public Member Functions

void activateReminders (const MSMoveReminder::Notification reason, const MSLane *enteredLane=0)
 "Activates" all current move reminder More...
 
void addReminder (MSMoveReminder *rem)
 Adds a MoveReminder dynamically. More...
 
void addStops (const bool ignoreStopErrors)
 Adds stops to the built vehicle. More...
 
bool addTraciStop (MSLane *const lane, const double startPos, const double endPos, const SUMOTime duration, const SUMOTime until, const bool parking, const bool triggered, const bool containerTriggered, std::string &errorMsg)
 
bool addTraciStopAtStoppingPlace (const std::string &stopId, const SUMOTime duration, const SUMOTime until, const bool parking, const bool triggered, const bool containerTriggered, const SumoXMLTag stoppingPlaceType, std::string &errorMsg)
 
bool checkActionStep (const SUMOTime t)
 Returns whether the vehicle is supposed to take action in the current simulation step Updates myActionStep and myLastActionTime in case that the current simstep is an action step. More...
 
double computeAngle () const
 compute the current vehicle angle More...
 
bool congested () const
 
void createDevice (const std::string &deviceName)
 create device of the given type More...
 
void enterLaneAtInsertion (MSLane *enteredLane, double pos, double speed, double posLat, MSMoveReminder::Notification notification)
 Update when the vehicle enters a new lane in the emit step. More...
 
void enterLaneAtLaneChange (MSLane *enteredLane)
 Update when the vehicle enters a new lane in the laneChange step. More...
 
bool enterLaneAtMove (MSLane *enteredLane, bool onTeleporting=false)
 Update when the vehicle enters a new lane in the move step. More...
 
bool executeMove ()
 Executes planned vehicle movements with regards to right-of-way. More...
 
void fixPosition ()
 repair errors in vehicle position after changing between internal edges More...
 
virtual double getArrivalPos () const
 Returns this vehicle's desired arrivalPos for its current route (may change on reroute) More...
 
PositionVector getBoundingBox () const
 get bounding rectangle More...
 
PositionVector getBoundingPoly () const
 get bounding polygon More...
 
const MSCFModelgetCarFollowModel () const
 Returns the vehicle's car following model definition. More...
 
MSCFModel::VehicleVariablesgetCarFollowVariables () const
 Returns the vehicle's car following model variables. More...
 
double getChosenSpeedFactor () const
 Returns the precomputed factor by which the driver wants to be faster than the speed limit. More...
 
const MSRouteIteratorgetCurrentRouteEdge () const
 Returns an iterator pointing to the current edge in this vehicles route. More...
 
double getDeltaPos (double accel)
 calculates the distance covered in the next integration step given an acceleration and assuming the current velocity. (gives different results for different integration methods, e.g., euler vs. ballistic) More...
 
SUMOTime getDepartDelay () const
 Returns the depart delay. More...
 
double getDepartPos () const
 Returns this vehicle's real departure position. More...
 
SUMOTime getDeparture () const
 Returns this vehicle's real departure time. More...
 
MSDevicegetDevice (const std::type_info &type) const
 Returns a device of the given type if it exists or 0. More...
 
std::string getDeviceParameter (const std::string &deviceName, const std::string &key) const
 try to retrieve the given parameter from any of the vehicles devices, raise InvalidArgument if no device parameter by that name exists More...
 
const std::vector< MSDevice * > & getDevices () const
 Returns this vehicle's devices. More...
 
double getDistanceToPosition (double destPos, const MSEdge *destEdge) const
 
const MSEdgegetEdge () const
 Returns the edge the vehicle is currently at. More...
 
const std::vector< MSLane * > & getFurtherLanes () const
 
const std::vector< double > & getFurtherLanesPosLat () const
 
const std::string & getID () const
 Returns the name of the vehicle. More...
 
double getImpatience () const
 Returns this vehicles impatience. More...
 
InfluencergetInfluencer ()
 Returns the velocity/lane influencer. More...
 
const InfluencergetInfluencer () const
 
MSAbstractLaneChangeModelgetLaneChangeModel ()
 
const MSAbstractLaneChangeModelgetLaneChangeModel () const
 
int getLaneIndex () const
 
std::pair< const MSVehicle *const, double > getLeader (double dist=0) const
 Returns the leader of the vehicle looking for a fixed distance. More...
 
double getLength () const
 Returns the vehicle's length. More...
 
double getMaxSpeed () const
 Returns the maximum speed. More...
 
StopgetNextStop ()
 
int getNumberReroutes () const
 Returns the number of new routes this vehicle got. More...
 
const SUMOVehicleParametergetParameter () const
 Returns the vehicle's parameter (including departure definition) More...
 
const MSRoutegetRoute () const
 Returns the current route. More...
 
double getSafeFollowSpeed (const std::pair< const MSVehicle *, double > leaderInfo, const double seen, const MSLane *const lane, double distToCrossing) const
 compute safe speed for following the given leader More...
 
MSVehicleTypegetSingularType ()
 Replaces the current vehicle type with a new one used by this vehicle only. More...
 
double getSpeedWithoutTraciInfluence () const
 Returns the uninfluenced velocity. More...
 
double getTimeGapOnLane () const
 Returns the time gap in seconds to the leader of the vehicle on the same lane. More...
 
SUMOVehicleClass getVClass () const
 Returns the vehicle's access class. More...
 
const MSVehicleTypegetVehicleType () const
 Returns the vehicle's type definition. More...
 
double getWidth () const
 Returns the vehicle's width. More...
 
bool hasDeparted () const
 Returns whether this vehicle has already departed. More...
 
bool hasDevice (const std::string &deviceName) const
 check whether the vehicle is equiped with a device of the given type More...
 
bool hasInfluencer () const
 
bool hasValidRoute (std::string &msg, const MSRoute *route=0) const
 Validates the current or given route. More...
 
int influenceChangeDecision (int state)
 allow TraCI to influence a lane change decision More...
 
virtual bool isSelected () const
 whether this vehicle is selected in the GUI More...
 
void leaveLane (const MSMoveReminder::Notification reason, const MSLane *approachedLane=0)
 Update of members if vehicle leaves a new lane in the lane change step or at arrival. More...
 
 MSVehicle (SUMOVehicleParameter *pars, const MSRoute *route, MSVehicleType *type, const double speedFactor)
 Constructor. More...
 
void onDepart ()
 Called when the vehicle is inserted into the network. More...
 
bool onFurtherEdge (const MSEdge *edge) const
 whether this vehicle has its back (and no its front) on the given edge More...
 
bool passingMinor () const
 decide whether the vehicle is passing a minor link or has comitted to do so More...
 
void planMove (const SUMOTime t, const MSLeaderInfo &ahead, const double lengthsInFront)
 Compute safe velocities for the upcoming lanes based on positions and speeds from the last time step. Also registers ApproachingVehicleInformation for all links. More...
 
double processNextStop (double currentVelocity)
 Processes stops, returns the velocity needed to reach the stop. More...
 
void removeReminder (MSMoveReminder *rem)
 Removes a MoveReminder dynamically. More...
 
bool replaceRouteEdges (ConstMSEdgeVector &edges, bool onInit=false, bool check=false, bool removeStops=true)
 Replaces the current route by the given edges. More...
 
void replaceVehicleType (MSVehicleType *type)
 Replaces the current vehicle type by the one given. More...
 
void reroute (SUMOTime t, SUMOAbstractRouter< MSEdge, SUMOVehicle > &router, const bool onInit=false, const bool withTaz=false)
 Performs a rerouting using the given router. More...
 
void resetActionOffset (const SUMOTime timeUntilNextAction=0)
 Resets the action offset for the vehicle. More...
 
bool resumeFromStopping ()
 
void setAngle (double angle, bool straightenFurther=false)
 Set a custom vehicle angle in rad, optionally updates furtherLanePosLat. More...
 
virtual void setArrivalPos (double arrivalPos)
 Sets this vehicle's desired arrivalPos for its current route. More...
 
void setChosenSpeedFactor (const double factor)
 Returns the precomputed factor by which the driver wants to be faster than the speed limit. More...
 
void setDeviceParameter (const std::string &deviceName, const std::string &key, const std::string &value)
 try to set the given parameter from any of the vehicles devices, raise InvalidArgument if no device parameter by that name exists More...
 
void setRemoteState (Position xyPos)
 sets position outside the road network More...
 
void setTentativeLaneAndPosition (MSLane *lane, double pos, double posLat=0)
 set tentative lane and position during insertion to ensure that all cfmodels work (some of them require veh->getLane() to return a valid lane) Once the vehicle is sucessfully inserted the lane is set again (see enterLaneAtInsertion) More...
 
const MSEdgesuccEdge (int nSuccs) const
 Returns the nSuccs'th successor of edge the vehicle is currently at. More...
 
bool unsafeLinkAhead (const MSLane *lane) const
 whether the vehicle may safely move to the given lane with regard to upcoming links More...
 
void updateActionOffset (const SUMOTime oldActionStepLength, const SUMOTime newActionStepLength)
 Process an updated action step length value (only affects the vehicle's action offset, The actionStepLength is stored in the (singular) vtype) More...
 
void updateDriveItems ()
 Check whether the drive items (myLFLinkLanes) are up to date, and update them if required. More...
 
double updateFurtherLanes (std::vector< MSLane *> &furtherLanes, std::vector< double > &furtherLanesPosLat, const std::vector< MSLane *> &passedLanes)
 update a vector of further lanes and return the new backPos More...
 
virtual ~MSVehicle ()
 Destructor. More...
 
insertion/removal
void onRemovalFromNet (const MSMoveReminder::Notification reason)
 Called when the vehicle is removed from the network. More...
 
interaction with the route
bool hasArrived () const
 Returns whether this vehicle has already arived (reached the arrivalPosition on its final edge) More...
 
bool replaceRoute (const MSRoute *route, bool onInit=false, int offset=0, bool addStops=true, bool removeStops=true)
 Replaces the current route by the given one. More...
 
bool willPass (const MSEdge *const edge) const
 Returns whether the vehicle wil pass the given edge. More...
 
int getRoutePosition () const
 
void resetRoutePosition (int index)
 
const MSEdgeWeightsStoragegetWeightsStorage () const
 Returns the vehicle's internal edge travel times/efforts container. More...
 
MSEdgeWeightsStoragegetWeightsStorage ()
 
state setter/getter
double getPositionOnLane () const
 Get the vehicle's position along the lane. More...
 
double getLastStepDist () const
 Get the distance the vehicle covered in the previous timestep. More...
 
double getPositionOnLane (const MSLane *lane) const
 Get the vehicle's front position relative to the given lane. More...
 
double getBackPositionOnLane (const MSLane *lane) const
 Get the vehicle's position relative to the given lane. More...
 
double getBackPositionOnLane () const
 Get the vehicle's position relative to its current lane. More...
 
double getLateralPositionOnLane () const
 Get the vehicle's lateral position on the lane. More...
 
double getRightSideOnLane () const
 Get the vehicle's lateral position on the lane: More...
 
double lateralDistanceToLane (const int offset) const
 Get the minimal lateral distance required to move fully onto the lane at given offset. More...
 
double getLateralOverlap () const
 return the amount by which the vehicle extends laterally outside it's primary lane More...
 
double getLateralOverlap (double posLat) const
 
double getRightSideOnEdge (const MSLane *lane=0) const
 Get the vehicle's lateral position on the edge of the given lane (or its current edge if lane == 0) More...
 
double getCenterOnEdge (const MSLane *lane=0) const
 Get the vehicle's lateral position on the edge of the given lane (or its current edge if lane == 0) More...
 
double getLatOffset (const MSLane *lane) const
 Get the offset that that must be added to interpret myState.myPosLat for the given lane. More...
 
double getSpeed () const
 Returns the vehicle's current speed. More...
 
double getPreviousSpeed () const
 Returns the vehicle's speed before the previous time step. More...
 
double getAcceleration () const
 Returns the vehicle's acceleration in m/s (this is computed as the last step's mean acceleration in case that a stop occurs within the middle of the time-step) More...
 
SUMOTime getActionStepLength () const
 Returns the vehicle's action step length in millisecs, i.e. the interval between two action points. More...
 
double getActionStepLengthSecs () const
 Returns the vehicle's action step length in secs, i.e. the interval between two action points. More...
 
SUMOTime getLastActionTime () const
 Returns the time of the vehicle's last action point. More...
 
Other getter methods
double getSlope () const
 Returns the slope of the road at vehicle's position. More...
 
Position getPosition (const double offset=0) const
 Return current position (x/y, cartesian) More...
 
Position getPositionAlongBestLanes (double offset) const
 Return the (x,y)-position, which the vehicle would reach if it continued along its best continuation lanes from the current for a distance of offset m. More...
 
MSLanegetLane () const
 Returns the lane the vehicle is on. More...
 
double getMaxSpeedOnLane () const
 Returns the maximal speed for the vehicle on its current lane (including speed factor and deviation, i.e., not necessarily the allowed speed limit) More...
 
bool isOnRoad () const
 Returns the information whether the vehicle is on a road (is simulated) More...
 
bool isActive () const
 Returns whether the current simulation step is an action point for the vehicle. More...
 
bool isActionStep (SUMOTime t) const
 Returns whether the next simulation step will be an action point for the vehicle. More...
 
bool isFrontOnLane (const MSLane *lane) const
 Returns the information whether the front of the vehicle is on the given lane. More...
 
const MSEdgegetRerouteOrigin () const
 Returns the starting point for reroutes (usually the current edge) More...
 
SUMOTime getWaitingTime () const
 Returns the SUMOTime waited (speed was lesser than 0.1m/s) More...
 
SUMOTime getTimeLoss () const
 Returns the SUMOTime lost (speed was lesser maximum speed) More...
 
SUMOTime getAccumulatedWaitingTime () const
 Returns the SUMOTime waited (speed was lesser than 0.1m/s) within the last t millisecs. More...
 
double getWaitingSeconds () const
 Returns the number of seconds waited (speed was lesser than 0.1m/s) More...
 
double getAccumulatedWaitingSeconds () const
 Returns the number of seconds waited (speed was lesser than 0.1m/s) within the last millisecs. More...
 
double getTimeLossSeconds () const
 Returns the time loss in seconds. More...
 
double getAngle () const
 Returns the vehicle's direction in radians. More...
 
Position getVelocityVector () const
 Returns the vehicle's direction in radians. More...
 
strategical/tactical lane choosing methods
const std::vector< LaneQ > & getBestLanes () const
 Returns the description of best lanes to use in order to continue the route. More...
 
void updateBestLanes (bool forceRebuild=false, const MSLane *startLane=0)
 computes the best lanes to use in order to continue the route More...
 
const std::vector< MSLane * > & getBestLanesContinuation () const
 Returns the best sequence of lanes to continue the route starting at myLane. More...
 
const std::vector< MSLane * > & getBestLanesContinuation (const MSLane *const l) const
 Returns the best sequence of lanes to continue the route starting at the given lane. More...
 
int getBestLaneOffset () const
 
void adaptBestLanesOccupation (int laneIndex, double density)
 update occupation from MSLaneChanger More...
 
vehicle stops definitions and i/o
bool addStop (const SUMOVehicleParameter::Stop &stopPar, std::string &errorMsg, SUMOTime untilOffset=0, bool collision=false, MSRouteIterator *searchStart=0)
 Adds a stop. More...
 
bool replaceParkingArea (MSParkingArea *parkingArea, std::string &errorMsg)
 replace the current parking area stop with a new stop with merge duration More...
 
MSParkingAreagetNextParkingArea ()
 get the current parking area stop More...
 
bool hasStops () const
 Returns whether the vehicle has to stop somewhere. More...
 
bool isStopped () const
 Returns whether the vehicle is at a stop. More...
 
bool isStoppedOnLane () const
 
bool keepStopping (bool afterProcessing=false) const
 Returns whether the vehicle is stopped and must continue to do so. More...
 
SUMOTime collisionStopTime () const
 Returns the remaining time a vehicle needs to stop due to a collision. A negative value indicates that the vehicle is not stopping due to a collision (or at all) More...
 
bool isParking () const
 Returns whether the vehicle is parking. More...
 
bool isRemoteControlled () const
 Returns the information whether the vehicle is fully controlled via TraCI. More...
 
bool wasRemoteControlled (SUMOTime lookBack=DELTA_T) const
 Returns the information whether the vehicle is fully controlled via TraCI within the lookBack time. More...
 
double nextStopDist () const
 return the distance to the next stop or doubleMax if there is none. More...
 
bool isStoppedTriggered () const
 Returns whether the vehicle is on a triggered stop. More...
 
bool isStoppedInRange (double pos) const
 return whether the given position is within range of the current stop More...
 
Emission retrieval
double getCO2Emissions () const
 Returns CO2 emission of the current state. More...
 
double getCOEmissions () const
 Returns CO emission of the current state. More...
 
double getHCEmissions () const
 Returns HC emission of the current state. More...
 
double getNOxEmissions () const
 Returns NOx emission of the current state. More...
 
double getPMxEmissions () const
 Returns PMx emission of the current state. More...
 
double getFuelConsumption () const
 Returns fuel consumption of the current state. More...
 
double getElectricityConsumption () const
 Returns electricity consumption of the current state. More...
 
double getHarmonoise_NoiseEmissions () const
 Returns noise emissions of the current state. More...
 
Interaction with persons
void addPerson (MSTransportable *person)
 Adds a passenger. More...
 
Interaction with containers
void addContainer (MSTransportable *container)
 Adds a container. More...
 
void removeTransportable (MSTransportable *t)
 removes a person or container More...
 
const std::vector< MSTransportable * > & getPersons () const
 retrieve riding persons More...
 
const std::vector< MSTransportable * > & getContainers () const
 retrieve riding containers More...
 
int getPersonNumber () const
 Returns the number of persons. More...
 
int getContainerNumber () const
 Returns the number of containers. More...
 
state io
void saveState (OutputDevice &out)
 Saves the states of a vehicle. More...
 
void loadState (const SUMOSAXAttributes &attrs, const SUMOTime offset)
 Loads the state of this vehicle from the given description. More...
 

Static Public Member Functions

static int nextLinkPriority (const std::vector< MSLane *> &conts)
 get a numerical value for the priority of the upcoming link More...
 
static bool overlap (const MSVehicle *veh1, const MSVehicle *veh2)
 

Protected Types

typedef std::vector< DriveProcessItemDriveItemVector
 Container for used Links/visited Lanes during planMove() and executeMove. More...
 

Protected Member Functions

void adaptToLeader (const std::pair< const MSVehicle *, double > leaderInfo, const double seen, DriveProcessItem *const lastLink, const MSLane *const lane, double &v, double &vLinkPass, double distToCrossing=-1) const
 
void adaptToLeaders (const MSLeaderInfo &ahead, double latOffset, const double seen, DriveProcessItem *const lastLink, const MSLane *const lane, double &v, double &vLinkPass) const
 
void calculateArrivalParams ()
 (Re-)Calculates the arrival position and lane from the vehicle parameters More...
 
void checkLinkLeader (const MSLink *link, const MSLane *lane, double seen, DriveProcessItem *const lastLink, double &v, double &vLinkPass, double &vLinkWait, bool &setRequest, bool isShadowLink=false) const
 checks for link leaders on the given link More...
 
void checkRewindLinkLanes (const double lengthsInFront, DriveItemVector &lfLinks) const
 
virtual void drawOutsideNetwork (bool)
 register vehicle for drawing while outside the network More...
 
double estimateLeaveSpeed (const MSLink *const link, const double vLinkPass) const
 estimate leaving speed when accelerating across a link More...
 
const MSLanegetBackLane () const
 
const Position getBackPosition () const
 
double getSpaceTillLastStanding (const MSLane *l, bool &foundStopped) const
 
const ConstMSEdgeVector getStopEdges () const
 Returns the list of still pending stop edges. More...
 
bool ignoreRed (const MSLink *link, bool canBrake) const
 decide whether a red (or yellow light) may be ignore More...
 
bool keepClear (const MSLink *link) const
 decide whether the given link must be kept clear More...
 
void planMoveInternal (const SUMOTime t, MSLeaderInfo ahead, DriveItemVector &lfLinks, double &myStopDist) const
 
void processLaneAdvances (std::vector< MSLane *> &passedLanes, bool &moved, std::string &emergencyReason)
 This method checks if the vehicle has advanced over one or several lanes along its route and triggers the corresponding actions for the lanes and the vehicle. and adapts the given in/out parameters to the appropriate values. More...
 
void processLinkAproaches (double &vSafe, double &vSafeMin, double &vSafeMinDist)
 This method iterates through the driveprocess items for the vehicle and adapts the given in/out parameters to the appropriate values. More...
 
void processTraCISpeedControl (double vSafe, double &vNext)
 Check for speed advices from the traci client and adjust the speed vNext in the current (euler) / after the current (ballistic) simstep accordingly. More...
 
void removeApproachingInformation (DriveItemVector &lfLinks) const
 unregister approach from all upcoming links More...
 
void removePassedDriveItems ()
 Erase passed drive items from myLFLinkLanes (and unregister approaching information for corresponding links). Further, myNextDriveItem is reset. More...
 
void setBlinkerInformation ()
 sets the blue flashing light for emergency vehicles More...
 
void setBrakingSignals (double vNext)
 sets the braking lights on/off More...
 
void setEmergencyBlueLight (SUMOTime currentTime)
 sets the blue flashing light for emergency vehicles More...
 
void updateOccupancyAndCurrentBestLane (const MSLane *startLane)
 updates LaneQ::nextOccupation and myCurrentLaneInBestLanes More...
 
void updateState (double vNext)
 updates the vehicles state, given a next value for its speed. This value can be negative in case of the ballistic update to indicate a stop within the next timestep. (You can call this a 'hack' to emulate reasoning based on accelerations: The assumed constant acceleration a within the next time step is then a = (vNext - vCurrent)/TS ) More...
 
void updateTimeLoss (double vNext)
 Updates the vehicle's time loss. More...
 
void updateWaitingTime (double vNext)
 Updates the vehicle's waiting time counters (accumulated and consecutive) More...
 
Position validatePosition (Position result, double offset=0) const
 ensure that a vehicle-relative position is not invalid More...
 

Protected Attributes

double myAcceleration
 The current acceleration after dawdling in m/s. More...
 
bool myActionStep
 The flag myActionStep indicates whether the current time step is an action point for the vehicle. More...
 
bool myAmOnNet
 Whether the vehicle is on the network (not parking, teleported, vaporized, or arrived) More...
 
bool myAmRegisteredAsWaitingForContainer
 Whether this vehicle is registered as waiting for a container (for deadlock-recognition) More...
 
bool myAmRegisteredAsWaitingForPerson
 Whether this vehicle is registered as waiting for a person (for deadlock-recognition) More...
 
double myAngle
 the angle in radians ( More...
 
int myArrivalLane
 The destination lane where the vehicle stops. More...
 
double myArrivalPos
 The position on the destination lane where the vehicle stops. More...
 
std::vector< std::vector< LaneQ > > myBestLanes
 
Position myCachedPosition
 
double myChosenSpeedFactor
 A precomputed factor by which the driver wants to be faster than the speed limit. More...
 
SUMOTime myCollisionImmunity
 amount of time for which the vehicle is immune from collisions More...
 
MSDevice_TransportablemyContainerDevice
 The containers this vehicle may have. More...
 
MSRouteIterator myCurrEdge
 Iterator to current route-edge. More...
 
std::vector< LaneQ >::iterator myCurrentLaneInBestLanes
 
double myDepartPos
 The real depart position. More...
 
SUMOTime myDeparture
 The real departure time. More...
 
std::vector< MSDevice * > myDevices
 The devices this vehicle has. More...
 
std::vector< MSLane * > myFurtherLanes
 The information into which lanes the vehicle laps into. More...
 
std::vector< double > myFurtherLanesPosLat
 lateral positions on further lanes More...
 
bool myHaveToWaitOnNextLink
 
MSLanemyLane
 The lane the vehicle is on. More...
 
MSAbstractLaneChangeModelmyLaneChangeModel
 
SUMOTime myLastActionTime
 Action offset (actions are taken at time myActionOffset + N*getActionStepLength()) Initialized to 0, to be set at insertion. More...
 
const MSEdgemyLastBestLanesEdge
 
const MSLanemyLastBestLanesInternalLane
 
DriveItemVector myLFLinkLanes
 
DriveItemVector::iterator myNextDriveItem
 iterator pointing to the next item in myLFLinkLanes More...
 
int myNumberReroutes
 The number of reroutings. More...
 
const SUMOVehicleParametermyParameter
 This vehicle's parameter. More...
 
MSDevice_TransportablemyPersonDevice
 The passengers this vehicle may have. More...
 
const MSRoutemyRoute
 This vehicle's route. More...
 
int mySignals
 State of things of the vehicle that can be on or off. More...
 
State myState
 This Vehicles driving state (pos and speed) More...
 
double myStopDist
 distance to the next stop or -1 if there is none More...
 
std::list< StopmyStops
 The vehicle's list of stops. More...
 
double myTimeLoss
 the time loss in seconds due to driving with less than maximum speed More...
 
MSVehicleTypemyType
 This vehicle's type. More...
 
SUMOTime myWaitingTime
 The time the vehicle waits (is not faster than 0.1m/s) in seconds. More...
 
WaitingTimeCollector myWaitingTimeCollector
 

Static Protected Attributes

static std::vector< MSLane * > myEmptyLaneVector
 
static std::vector< MSTransportable * > myEmptyTransportableVector
 
static const SUMOTime NOT_YET_DEPARTED = SUMOTime_MAX
 

Private Member Functions

MSEdgeWeightsStorage_getWeightsStorage () const
 
 MSVehicle ()
 invalidated default constructor More...
 
 MSVehicle (const MSVehicle &)
 invalidated copy constructor More...
 
MSVehicleoperator= (const MSVehicle &)
 invalidated assignment operator More...
 

Private Attributes

MSCFModel::VehicleVariablesmyCFVariables
 The per vehicle variables of the car following model. More...
 
MSEdgeWeightsStoragemyEdgeWeights
 
InfluencermyInfluencer
 An instance of a velocity/lane influencing instance; built in "getInfluencer". More...
 

Friends

class MSLaneChanger
 the lane changer sets myLastLaneChangeOffset More...
 
class MSLaneChangerSublane
 

Move reminder structures

typedef std::vector< std::pair< MSMoveReminder *, double > > MoveReminderCont
 Definition of a move reminder container. More...
 
MoveReminderCont myMoveReminders
 Currently relevant move reminders. More...
 

Interaction with move reminders

void workOnMoveReminders (double oldPos, double newPos, double newSpeed)
 Processes active move reminder. More...
 
void adaptLaneEntering2MoveReminder (const MSLane &enteredLane)
 Adapts the vehicle's entering of a new lane. More...
 

Access to bool signals

enum  Signalling {
  VEH_SIGNAL_NONE = 0, VEH_SIGNAL_BLINKER_RIGHT = 1, VEH_SIGNAL_BLINKER_LEFT = 2, VEH_SIGNAL_BLINKER_EMERGENCY = 4,
  VEH_SIGNAL_BRAKELIGHT = 8, VEH_SIGNAL_FRONTLIGHT = 16, VEH_SIGNAL_FOGLIGHT = 32, VEH_SIGNAL_HIGHBEAM = 64,
  VEH_SIGNAL_BACKDRIVE = 128, VEH_SIGNAL_WIPER = 256, VEH_SIGNAL_DOOR_OPEN_LEFT = 512, VEH_SIGNAL_DOOR_OPEN_RIGHT = 1024,
  VEH_SIGNAL_EMERGENCY_BLUE = 2048, VEH_SIGNAL_EMERGENCY_RED = 4096, VEH_SIGNAL_EMERGENCY_YELLOW = 8192
}
 Some boolean values which describe the state of some vehicle parts. More...
 
enum  LaneChangeMode { LC_NEVER = 0, LC_NOCONFLICT = 1, LC_ALWAYS = 2 }
 modes for resolving conflicts between external control (traci) and vehicle control over lane changing. Each level of the lane-changing hierarchy (strategic, cooperative, speedGain, keepRight) can be controlled separately More...
 
enum  TraciLaneChangePriority { LCP_ALWAYS = 0, LCP_NOOVERLAP = 1, LCP_URGENT = 2, LCP_OPPORTUNISTIC = 3 }
 modes for prioritizing traci lane change requests More...
 
void switchOnSignal (int signal)
 Switches the given signal on. More...
 
void switchOffSignal (int signal)
 Switches the given signal off. More...
 
int getSignals () const
 Returns the signals. More...
 
bool signalSet (int which) const
 Returns whether the given signal is on. More...
 

Detailed Description

Representation of a vehicle in the micro simulation.

Definition at line 83 of file MSVehicle.h.

Member Typedef Documentation

◆ DriveItemVector

typedef std::vector< DriveProcessItem > MSVehicle::DriveItemVector
protected

Container for used Links/visited Lanes during planMove() and executeMove.

Definition at line 1813 of file MSVehicle.h.

◆ MoveReminderCont

typedef std::vector< std::pair<MSMoveReminder*, double> > MSBaseVehicle::MoveReminderCont
protectedinherited

Definition of a move reminder container.

Definition at line 468 of file MSBaseVehicle.h.

Member Enumeration Documentation

◆ ChangeRequest

Requests set via TraCI.

Enumerator
REQUEST_NONE 

vehicle doesn't want to change

REQUEST_LEFT 

vehicle want's to change to left lane

REQUEST_RIGHT 

vehicle want's to change to right lane

REQUEST_HOLD 

vehicle want's to keep the current lane

Definition at line 222 of file MSVehicle.h.

◆ LaneChangeMode

modes for resolving conflicts between external control (traci) and vehicle control over lane changing. Each level of the lane-changing hierarchy (strategic, cooperative, speedGain, keepRight) can be controlled separately

Enumerator
LC_NEVER 
LC_NOCONFLICT 
LC_ALWAYS 

Definition at line 1196 of file MSVehicle.h.

◆ Signalling

Some boolean values which describe the state of some vehicle parts.

Enumerator
VEH_SIGNAL_NONE 

Everything is switched off.

VEH_SIGNAL_BLINKER_RIGHT 

Right blinker lights are switched on.

VEH_SIGNAL_BLINKER_LEFT 

Left blinker lights are switched on.

VEH_SIGNAL_BLINKER_EMERGENCY 

Blinker lights on both sides are switched on.

VEH_SIGNAL_BRAKELIGHT 

The brake lights are on.

VEH_SIGNAL_FRONTLIGHT 

The front lights are on (no visualisation)

VEH_SIGNAL_FOGLIGHT 

The fog lights are on (no visualisation)

VEH_SIGNAL_HIGHBEAM 

The high beam lights are on (no visualisation)

VEH_SIGNAL_BACKDRIVE 

The backwards driving lights are on (no visualisation)

VEH_SIGNAL_WIPER 

The wipers are on.

VEH_SIGNAL_DOOR_OPEN_LEFT 

One of the left doors is opened.

VEH_SIGNAL_DOOR_OPEN_RIGHT 

One of the right doors is opened.

VEH_SIGNAL_EMERGENCY_BLUE 

A blue emergency light is on.

VEH_SIGNAL_EMERGENCY_RED 

A red emergency light is on.

VEH_SIGNAL_EMERGENCY_YELLOW 

A yellow emergency light is on.

Definition at line 1158 of file MSVehicle.h.

◆ TraciLaneChangePriority

modes for prioritizing traci lane change requests

Enumerator
LCP_ALWAYS 
LCP_NOOVERLAP 
LCP_URGENT 
LCP_OPPORTUNISTIC 

Definition at line 1204 of file MSVehicle.h.

Constructor & Destructor Documentation

◆ MSVehicle() [1/3]

MSVehicle::MSVehicle ( SUMOVehicleParameter pars,
const MSRoute route,
MSVehicleType type,
const double  speedFactor 
)

◆ ~MSVehicle()

◆ MSVehicle() [2/3]

MSVehicle::MSVehicle ( )
private

invalidated default constructor

◆ MSVehicle() [3/3]

MSVehicle::MSVehicle ( const MSVehicle )
private

invalidated copy constructor

Member Function Documentation

◆ _getWeightsStorage()

MSEdgeWeightsStorage & MSVehicle::_getWeightsStorage ( ) const
private

Definition at line 829 of file MSVehicle.cpp.

References myEdgeWeights.

Referenced by getWeightsStorage().

◆ activateReminders()

void MSVehicle::activateReminders ( const MSMoveReminder::Notification  reason,
const MSLane enteredLane = 0 
)
virtual

"Activates" all current move reminder

For all move reminder stored in "myMoveReminders", their method "MSMoveReminder::notifyEnter" is called.

Parameters
[in]reasonThe reason for changing the reminders' states
[in]enteredLaneThe lane, which is entered (if applicable)
See also
MSMoveReminder
MSMoveReminder::notifyEnter
MSMoveReminder::Notification

Reimplemented from MSBaseVehicle.

Definition at line 3445 of file MSVehicle.cpp.

References MSBaseVehicle::myMoveReminders.

Referenced by congested(), enterLaneAtInsertion(), enterLaneAtLaneChange(), enterLaneAtMove(), and processNextStop().

◆ adaptBestLanesOccupation()

void MSVehicle::adaptBestLanesOccupation ( int  laneIndex,
double  density 
)

update occupation from MSLaneChanger

Definition at line 4065 of file MSVehicle.cpp.

References myBestLanes.

Referenced by MSLaneChangerSublane::change(), and MSLaneChanger::change().

◆ adaptLaneEntering2MoveReminder()

void MSVehicle::adaptLaneEntering2MoveReminder ( const MSLane enteredLane)
protected

Adapts the vehicle's entering of a new lane.

All offsets already stored in "myOldLaneMoveReminderOffsets" are increased by the length that has been left. All still active move reminders from "myMoveReminders" are put into "myOldLaneMoveReminders" and the offset to the last lane is added to "myOldLaneMoveReminderOffsets" for each of these.

Move reminder from the given lane are set into "myMoveReminders".

"myLane" must still be the left lane!

Parameters
[in]enteredLane
See also
MSMoveReminder
MSLane::getMoveReminder

Definition at line 868 of file MSVehicle.cpp.

References MSBaseVehicle::addReminder(), MSLane::getLength(), MSLane::getMoveReminders(), myLane, and MSBaseVehicle::myMoveReminders.

Referenced by enterLaneAtMove(), and hasInfluencer().

◆ adaptToLeader()

void MSVehicle::adaptToLeader ( const std::pair< const MSVehicle *, double >  leaderInfo,
const double  seen,
DriveProcessItem *const  lastLink,
const MSLane *const  lane,
double &  v,
double &  vLinkPass,
double  distToCrossing = -1 
) const
protected

◆ adaptToLeaders()

void MSVehicle::adaptToLeaders ( const MSLeaderInfo ahead,
double  latOffset,
const double  seen,
DriveProcessItem *const  lastLink,
const MSLane *const  lane,
double &  v,
double &  vLinkPass 
) const
protected

◆ addContainer()

void MSVehicle::addContainer ( MSTransportable container)
virtual

◆ addPerson()

void MSVehicle::addPerson ( MSTransportable person)
virtual

◆ addReminder()

void MSBaseVehicle::addReminder ( MSMoveReminder rem)
inherited

Adds a MoveReminder dynamically.

Parameters
[in]remthe reminder to add
See also
MSMoveReminder

Definition at line 349 of file MSBaseVehicle.cpp.

References MSBaseVehicle::myMoveReminders.

Referenced by adaptLaneEntering2MoveReminder(), MESegment::addReminders(), enterLaneAtInsertion(), enterLaneAtLaneChange(), MSBaseVehicle::getDevices(), and processNextStop().

◆ addStop()

bool MSVehicle::addStop ( const SUMOVehicleParameter::Stop stopPar,
std::string &  errorMsg,
SUMOTime  untilOffset = 0,
bool  collision = false,
MSRouteIterator searchStart = 0 
)
virtual

Adds a stop.

The stop is put into the sorted list.

Parameters
[in]stopThe stop to add
Returns
Whether the stop could be added

Implements SUMOVehicle.

Definition at line 1103 of file MSVehicle.cpp.

References MSLane::allowsVehicleClass(), SUMOVehicleParameter::Stop::awaitedContainers, SUMOVehicleParameter::Stop::awaitedPersons, SUMOVehicleParameter::Stop::busstop, MSVehicle::Stop::busstop, SUMOVehicleParameter::Stop::chargingStation, MSVehicle::Stop::chargingStation, MSVehicle::Stop::collision, SUMOVehicleParameter::Stop::containerstop, MSVehicle::Stop::containerstop, SUMOVehicleParameter::Stop::containerTriggered, MSVehicle::Stop::containerTriggered, DEPART_POS_BASE, DEPART_POS_DEFAULT, DEPART_POS_GIVEN, SUMOVehicleParameter::departPos, SUMOVehicleParameter::departPosProcedure, MSLane::dictionary(), SUMOVehicleParameter::Stop::duration, MSVehicle::Stop::duration, MSVehicle::Stop::edge, MSRoute::end(), SUMOVehicleParameter::Stop::endPos, getCarFollowModel(), MSLane::getEdge(), Named::getID(), MSNet::getInstance(), MSVehicleType::getLength(), MSBaseVehicle::getLength(), MSLane::getLength(), MSLane::getNextNormal(), MSEdge::getNormalBefore(), MSNet::getStoppingPlace(), MSVehicleType::getVehicleClass(), MSBaseVehicle::getVehicleType(), MSBaseVehicle::hasDeparted(), SUMOVehicleParameter::id, SUMOVehicleParameter::Stop::index, MSEdge::isInternal(), SUMOVehicleParameter::Stop::lane, MSVehicle::Stop::lane, MIN2(), MSBaseVehicle::myCurrEdge, MSBaseVehicle::myParameter, MSVehicle::State::myPos, MSBaseVehicle::myRoute, MSVehicle::State::mySpeed, myState, myStops, MSBaseVehicle::myType, MSVehicle::Stop::numExpectedContainer, MSVehicle::Stop::numExpectedPerson, SUMOVehicleParameter::Stop::parkingarea, MSVehicle::Stop::parkingarea, MSVehicle::Stop::pars, POSITION_EPS, MSVehicle::Stop::reached, SUMOVehicleParameter::Stop::startPos, STOP_INDEX_END, STOP_INDEX_FIT, SUMO_TAG_BUS_STOP, SUMO_TAG_CHARGING_STATION, SUMO_TAG_CONTAINER_STOP, SUMO_TAG_PARKING_AREA, MSVehicle::Stop::timeToBoardNextPerson, MSVehicle::Stop::timeToLoadNextContainer, SUMOVehicleParameter::Stop::triggered, MSVehicle::Stop::triggered, and SUMOVehicleParameter::Stop::until.

Referenced by addTraciStop(), addTraciStopAtStoppingPlace(), MSLane::handleCollisionBetween(), replaceParkingArea(), and replaceRoute().

◆ addStops()

void MSBaseVehicle::addStops ( const bool  ignoreStopErrors)
inherited

Adds stops to the built vehicle.

This code needs to be separated from the MSBaseVehicle constructor since it is not allowed to call virtual functions from a constructor

Parameters
[in]ignoreStopErrorswhether invalid stops trigger a warning only

Definition at line 473 of file MSBaseVehicle.cpp.

References SUMOVehicle::addStop(), SUMOVehicleParameter::depart, MSRoute::getStops(), MSBaseVehicle::myParameter, MSBaseVehicle::myRoute, SUMOVehicleParameter::repetitionOffset, SUMOVehicleParameter::repetitionsDone, SUMOVehicleParameter::stops, and WRITE_WARNING.

Referenced by MEVehicleControl::buildVehicle(), GUIMEVehicleControl::buildVehicle(), GUIVehicleControl::buildVehicle(), MSVehicleControl::buildVehicle(), MEVehicle::getBlockTimeSeconds(), replaceRoute(), and MSBaseVehicle::setChosenSpeedFactor().

◆ addTraciStop()

bool MSVehicle::addTraciStop ( MSLane *const  lane,
const double  startPos,
const double  endPos,
const SUMOTime  duration,
const SUMOTime  until,
const bool  parking,
const bool  triggered,
const bool  containerTriggered,
std::string &  errorMsg 
)

schedule a new stop for the vehicle; each time a stop is reached, the vehicle will wait for the given duration before continuing on its route

Parameters
lanelane on wich to stop
startPosstart position on the given lane at wich to stop
endPosend position on the given lane at wich to stop
durationwaiting time duration
untiltime step at which the stop shall end
parkinga flag indicating whether the traci stop is used for parking or not
triggereda flag indicating whether the traci stop is triggered or not
containerTriggereda flag indicating whether the traci stop is triggered by a container or not

XXX handle stops added out of order

Definition at line 4626 of file MSVehicle.cpp.

References addStop(), SUMOVehicleParameter::Stop::containerTriggered, SUMOVehicleParameter::Stop::duration, SUMOVehicleParameter::Stop::endPos, Named::getID(), SUMOVehicleParameter::Stop::index, SUMOVehicleParameter::Stop::lane, myLane, MSBaseVehicle::myParameter, myStops, SUMOVehicleParameter::Stop::parametersSet, SUMOVehicleParameter::Stop::parking, POSITION_EPS, SUMOVehicleParameter::Stop::startPos, STOP_CONTAINER_TRIGGER_SET, STOP_END_SET, STOP_INDEX_FIT, STOP_PARKING_SET, STOP_START_SET, STOP_TRIGGER_SET, SUMOVehicleParameter::stops, SUMOVehicleParameter::Stop::triggered, SUMOVehicleParameter::Stop::until, and updateBestLanes().

Referenced by libsumo::Vehicle::setStop(), and signalSet().

◆ addTraciStopAtStoppingPlace()

bool MSVehicle::addTraciStopAtStoppingPlace ( const std::string &  stopId,
const SUMOTime  duration,
const SUMOTime  until,
const bool  parking,
const bool  triggered,
const bool  containerTriggered,
const SumoXMLTag  stoppingPlaceType,
std::string &  errorMsg 
)

schedule a new stop for the vehicle; each time a stop is reached, the vehicle will wait for the given duration before continuing on its route

Parameters
stopIdbus or container stop id
durationwaiting time duration
untiltime step at which the stop shall end
parkinga flag indicating whether the traci stop is used for parking or not
triggereda flag indicating whether the traci stop is triggered or not
containerTriggereda flag indicating whether the traci stop is triggered by a container or not
stoppingPlaceTypea flag indicating the type of stopping place

Definition at line 4675 of file MSVehicle.cpp.

References addStop(), SUMOVehicleParameter::Stop::busstop, SUMOVehicleParameter::Stop::chargingStation, SUMOVehicleParameter::Stop::containerstop, SUMOVehicleParameter::Stop::containerTriggered, SUMOVehicleParameter::Stop::duration, SUMOVehicleParameter::Stop::endPos, MSStoppingPlace::getBeginLanePosition(), MSStoppingPlace::getEndLanePosition(), Named::getID(), MSBaseVehicle::getID(), MSNet::getInstance(), MSStoppingPlace::getLane(), MSNet::getStoppingPlace(), SUMOVehicleParameter::Stop::index, SUMOVehicleParameter::Stop::lane, myLane, myStops, SUMOVehicleParameter::Stop::parametersSet, SUMOVehicleParameter::Stop::parking, SUMOVehicleParameter::Stop::parkingarea, SUMOVehicleParameter::Stop::startPos, STOP_CONTAINER_TRIGGER_SET, STOP_INDEX_FIT, STOP_PARKING_SET, STOP_TRIGGER_SET, SUMO_TAG_BUS_STOP, SUMO_TAG_CHARGING_STATION, SUMO_TAG_CONTAINER_STOP, SUMO_TAG_PARKING_AREA, toString(), SUMOVehicleParameter::Stop::triggered, SUMOVehicleParameter::Stop::until, and updateBestLanes().

Referenced by libsumo::Vehicle::setStop(), and signalSet().

◆ calculateArrivalParams()

◆ checkActionStep()

bool MSVehicle::checkActionStep ( const SUMOTime  t)

Returns whether the vehicle is supposed to take action in the current simulation step Updates myActionStep and myLastActionTime in case that the current simstep is an action step.

Parameters
[in]t

Definition at line 1604 of file MSVehicle.cpp.

References isActionStep(), myActionStep, and myLastActionTime.

Referenced by planMove().

◆ checkLinkLeader()

◆ checkRewindLinkLanes()

void MSVehicle::checkRewindLinkLanes ( const double  lengthsInFront,
DriveItemVector lfLinks 
) const
protected
Todo:
: documentation

XXX backward compatibility: why should partial occupators be treated differently here? XXX MAX2 redundant?

XXX spaceTillLastStanding should already be covered by getPartialOccupatorEnd()

XXX why not check BRAKELIGHT?

Definition at line 3229 of file MSVehicle.cpp.

References ACCEL2SPEED, MSVehicle::DriveProcessItem::availableSpace, MSCFModel::brakeGap(), DEBUG_COND, getBackPositionOnLane(), MSLane::getBruttoVehLenSum(), getCarFollowModel(), MSLane::getEdge(), MSCFModel::getHeadwayTime(), Named::getID(), MSBaseVehicle::getID(), MSBaseVehicle::getImpatience(), MSLink::getLane(), getLaneChangeModel(), MSLane::getLastAnyVehicle(), getLateralPositionOnLane(), MSVehicle::DriveProcessItem::getLeaveSpeed(), MSVehicleType::getLength(), MSLane::getLength(), MSVehicleType::getLengthWithGap(), MSCFModel::getMaxDecel(), MSVehicleType::getMinGap(), MSLink::getParallelLink(), MSVehicle::Influencer::getRespectJunctionPriority(), MSAbstractLaneChangeModel::getShadowLane(), getSpaceTillLastStanding(), getSpeed(), MSLane::getVehicleNumber(), MSBaseVehicle::getVehicleType(), MSLink::getViaLane(), MSLink::getViaLaneOrLane(), getWaitingTime(), MSGlobals::gUsingInternalLanes, MSVehicle::DriveProcessItem::hadVehicle, MSLink::havePriority(), MSLink::isCont(), isFrontOnLane(), MSEdge::isInternal(), MSAbstractLaneChangeModel::isOpposite(), MSEdge::isRoundabout(), keepClear(), LINKSTATE_ALLWAY_STOP, MAX2(), MSVehicle::DriveProcessItem::myArrivalSpeed, MSVehicle::DriveProcessItem::myArrivalTime, myHaveToWaitOnNextLink, myInfluencer, myLane, MSVehicle::DriveProcessItem::myLink, MSVehicle::State::mySpeed, myState, MSLink::opened(), RandHelper::rand(), MSLink::setApproaching(), MSAbstractLaneChangeModel::setShadowApproachingInformation(), signalSet(), SIMTIME, and VEH_SIGNAL_BRAKELIGHT.

Referenced by planMove().

◆ collisionStopTime()

SUMOTime MSVehicle::collisionStopTime ( ) const

Returns the remaining time a vehicle needs to stop due to a collision. A negative value indicates that the vehicle is not stopping due to a collision (or at all)

Definition at line 1352 of file MSVehicle.cpp.

References MAX2(), myCollisionImmunity, and myStops.

Referenced by MSLane::executeMovements(), MSLane::handleCollisionBetween(), and hasStops().

◆ computeAngle()

◆ congested()

◆ createDevice()

◆ drawOutsideNetwork()

virtual void MSVehicle::drawOutsideNetwork ( bool  )
inlineprotectedvirtual

register vehicle for drawing while outside the network

Reimplemented in GUIVehicle.

Definition at line 1669 of file MSVehicle.h.

Referenced by MSVehicle::Influencer::postProcessRemoteControl().

◆ enterLaneAtInsertion()

void MSVehicle::enterLaneAtInsertion ( MSLane enteredLane,
double  pos,
double  speed,
double  posLat,
MSMoveReminder::Notification  notification 
)

◆ enterLaneAtLaneChange()

◆ enterLaneAtMove()

bool MSVehicle::enterLaneAtMove ( MSLane enteredLane,
bool  onTeleporting = false 
)

Update when the vehicle enters a new lane in the move step.

Parameters
[in]enteredLaneThe lane the vehicle enters
[in]onTeleportingWhether the lane was entered while being teleported
Returns
Whether the vehicle's route has ended (due to vaporization, or because the destination was reached)

Definition at line 3478 of file MSVehicle.cpp.

References activateReminders(), adaptLaneEntering2MoveReminder(), MSLane::getEdge(), Named::getID(), hasArrived(), Position::INVALID, MSEdge::isInternal(), myAmOnNet, myCachedPosition, MSBaseVehicle::myCurrEdge, myLane, myLastBestLanesEdge, MSBaseVehicle::myParameter, MSVehicle::State::myPos, myState, MSMoveReminder::NOTIFICATION_JUNCTION, MSMoveReminder::NOTIFICATION_TELEPORT, and SUMOVehicleParameter::via.

Referenced by MSVehicleTransfer::add(), MSVehicleTransfer::checkInsertions(), congested(), libsumo::Vehicle::moveTo(), and processLaneAdvances().

◆ estimateLeaveSpeed()

double MSVehicle::estimateLeaveSpeed ( const MSLink *const  link,
const double  vLinkPass 
) const
inlineprotected

◆ executeMove()

bool MSVehicle::executeMove ( )

Executes planned vehicle movements with regards to right-of-way.

This method goes through all DriveProcessItems in myLFLinkLanes in order to find a speed that is safe for all upcoming links.

Using this speed the position is updated and the vehicle is moved to the next lane (myLane is updated) if the end of the current lane is reached (this may happen multiple times in this method)

The vehicle also sets the lanes it is in-lapping into and informs them about it.

Returns
Whether the vehicle has moved to the next edge

Definition at line 2819 of file MSVehicle.cpp.

References ACCEL2SPEED, MSAbstractLaneChangeModel::changedToOpposite(), computeAngle(), DEBUG_COND, DELTA_T, gDebugFlag1, getBackLane(), getCarFollowModel(), MSNet::getCurrentTimeStep(), MSLane::getEdge(), Named::getID(), MSBaseVehicle::getID(), MSNet::getInstance(), getLaneChangeModel(), getLateralOverlap(), getLateralPositionOnLane(), MSLane::getLength(), MSLane::getOpposite(), MSLane::getOppositePos(), getPositionOnLane(), getSpeed(), MSVehicleType::getVehicleClass(), MSNet::getVehicleControl(), MSGlobals::gSemiImplicitEulerUpdate, hasArrived(), Position::INVALID, MSEdge::isVaporizing(), MAX2(), myAcceleration, myActionStep, myAngle, MSVehicle::State::myBackPos, myCachedPosition, myCollisionImmunity, myFurtherLanes, myFurtherLanesPosLat, myLane, MSVehicle::State::myLastCoveredDist, myLFLinkLanes, myNextDriveItem, MSVehicle::State::myPos, MSVehicle::State::mySpeed, myState, MSBaseVehicle::myType, NUMERICAL_EPS, POSITION_EPS, MSAbstractLaneChangeModel::prepareStep(), processLaneAdvances(), processLinkAproaches(), processTraCISpeedControl(), MSVehicleControl::registerEmergencyStop(), removeApproachingInformation(), setBlinkerInformation(), setBrakingSignals(), setEmergencyBlueLight(), SIMTIME, SPEED2ACCEL, SVC_EMERGENCY, time2string(), toString(), TS, updateBestLanes(), updateFurtherLanes(), MSAbstractLaneChangeModel::updateShadowLane(), updateState(), MSAbstractLaneChangeModel::updateTargetLane(), updateTimeLoss(), updateWaitingTime(), workOnMoveReminders(), and WRITE_WARNING.

Referenced by MSLane::executeMovements().

◆ fixPosition()

void MSVehicle::fixPosition ( )

repair errors in vehicle position after changing between internal edges

Definition at line 4073 of file MSVehicle.cpp.

References getLaneChangeModel(), MSGlobals::gLaneChangeDuration, MSVehicle::State::myPosLat, and myState.

Referenced by MSAbstractLaneChangeModel::endLaneChangeManeuver().

◆ getAcceleration()

double MSVehicle::getAcceleration ( ) const
inlinevirtual

Returns the vehicle's acceleration in m/s (this is computed as the last step's mean acceleration in case that a stop occurs within the middle of the time-step)

Returns
The acceleration

Reimplemented from MSBaseVehicle.

Definition at line 499 of file MSVehicle.h.

References myAcceleration.

Referenced by MSLCM_SL2015::checkBlockingVehicles(), MSLaneChanger::checkChange(), MSLCM_SL2015::commitManoeuvre(), MSDevice_SSM::estimateConflictTimes(), GUIVehicle::getColorValue(), GUIVehicle::getParameterWindow(), MSLCM_SL2015::updateExpectedSublaneSpeeds(), and MSBatteryExport::write().

◆ getAccumulatedWaitingSeconds()

double MSVehicle::getAccumulatedWaitingSeconds ( ) const
inline

Returns the number of seconds waited (speed was lesser than 0.1m/s) within the last millisecs.

Returns
The time the vehicle was standing within the last t millisecs

Definition at line 670 of file MSVehicle.h.

References getAccumulatedWaitingTime(), and STEPS2TIME.

Referenced by libsumo::Vehicle::getAccumulatedWaitingTime(), GUIVehicle::getColorValue(), GUIVehicle::getParameterWindow(), and keepClear().

◆ getAccumulatedWaitingTime()

SUMOTime MSVehicle::getAccumulatedWaitingTime ( ) const
inlinevirtual

Returns the SUMOTime waited (speed was lesser than 0.1m/s) within the last t millisecs.

Returns
The time the vehicle was standing within the configured memory interval

Implements SUMOVehicle.

Definition at line 650 of file MSVehicle.h.

References MSVehicle::WaitingTimeCollector::cumulatedWaitingTime(), MSGlobals::gWaitingTimeMemory, and myWaitingTimeCollector.

Referenced by getAccumulatedWaitingSeconds().

◆ getActionStepLength()

SUMOTime MSVehicle::getActionStepLength ( ) const
inline

Returns the vehicle's action step length in millisecs, i.e. the interval between two action points.

Returns
The current action step length in ms.

Definition at line 508 of file MSVehicle.h.

References MSVehicleType::getActionStepLength(), and MSBaseVehicle::myType.

Referenced by MSLeaderInfo::getSubLanes(), isActionStep(), processNextStop(), and libsumo::Vehicle::setActionStepLength().

◆ getActionStepLengthSecs()

◆ getAngle()

double MSVehicle::getAngle ( ) const
inlinevirtual

Returns the vehicle's direction in radians.

Returns
The vehicle's current angle

Implements SUMOVehicle.

Definition at line 684 of file MSVehicle.h.

References myAngle.

Referenced by libsumo::Vehicle::getAngle(), GUIVehicle::getAngle(), MSTransportable::Stage_Driving::getAngle(), and MSLaneChangerSublane::startChangeSublane().

◆ getArrivalPos()

virtual double MSBaseVehicle::getArrivalPos ( ) const
inlinevirtualinherited

Returns this vehicle's desired arrivalPos for its current route (may change on reroute)

Returns
This vehicle's real arrivalPos

Implements SUMOVehicle.

Definition at line 269 of file MSBaseVehicle.h.

References MSBaseVehicle::myArrivalPos.

Referenced by MSLCM_SL2015::_wantsChangeSublane().

◆ getBackLane()

const MSLane * MSVehicle::getBackLane ( ) const
protected

Definition at line 3044 of file MSVehicle.cpp.

References myFurtherLanes, and myLane.

Referenced by estimateLeaveSpeed(), and executeMove().

◆ getBackPosition()

◆ getBackPositionOnLane() [1/2]

double MSVehicle::getBackPositionOnLane ( const MSLane lane) const
virtual

Get the vehicle's position relative to the given lane.

Returns
The back position of the vehicle (in m from the given lane's begin)
Note
It is assumed that this function is only called for a vehicle that has a relation to the lane which makes it 'directly' relevant for car-following behavior on that lane, i.e., either it occupies part of the lanes surface (regular or partial vehicle for the lane), or (for the sublane model) it issued a maneuver reservation for a lane change.

Implements SUMOVehicle.

Definition at line 3120 of file MSVehicle.cpp.

References DEBUG_COND, getFurtherLanes(), MSAbstractLaneChangeModel::getFurtherTargetLanes(), Named::getID(), MSBaseVehicle::getID(), Named::getIDSecure(), MSNet::getInstance(), getLaneChangeModel(), MSVehicleType::getLength(), MSAbstractLaneChangeModel::getShadowFurtherLanes(), MSVehicle::State::myBackPos, myFurtherLanes, myFurtherLanesPosLat, myLane, MSVehicle::State::myPos, myState, MSBaseVehicle::myType, SIMTIME, time2string(), toString(), and WRITE_WARNING.

Referenced by adaptToLeaders(), MSLaneChangerSublane::checkChangeSublane(), MSLaneChangerSublane::checkChangeToNewLane(), checkRewindLinkLanes(), MSDevice_SSM::classifyEncounter(), MSLane::detectCollisionBetween(), MSLane::detectCollisions(), MSLane::freeInsertion(), MSLane::getCriticalLeader(), MSLane::getLeader(), getLeader(), MSLink::getLeaderInfo(), MSLane::getLeaderOnConsecutive(), MSLaneChangerSublane::getLeaders(), MSLane::getLeadersOnConsecutive(), MSLane::getOppositeFollower(), MSLaneChanger::getRealFollower(), MSLaneChanger::getRealLeader(), MSLane::isInsertionSuccess(), MSLane::lastInsertion(), MSLink::maybeOccupied(), MSPModel_Striping::moveInDirectionOnLane(), MSLane::vehicle_position_sorter::operator()(), MSLane::vehicle_natural_position_sorter::operator()(), MSLaneChangerSublane::outputLCEnded(), MSLaneChangerSublane::outputLCStarted(), and MSLane::safeInsertionSpeed().

◆ getBackPositionOnLane() [2/2]

double MSVehicle::getBackPositionOnLane ( ) const
inline

Get the vehicle's position relative to its current lane.

Returns
The back position of the vehicle (in m from the current lane's begin)

Definition at line 431 of file MSVehicle.h.

References myLane.

Referenced by getBackPosition(), getLastStepDist(), and getPositionOnLane().

◆ getBestLaneOffset()

int MSVehicle::getBestLaneOffset ( ) const

Definition at line 4055 of file MSVehicle.cpp.

References myBestLanes.

Referenced by MSLCM_LC2013::changed(), MSLCM_SL2015::changed(), and GUIVehicle::getColorValue().

◆ getBestLanes()

const std::vector< MSVehicle::LaneQ > & MSVehicle::getBestLanes ( ) const

Returns the description of best lanes to use in order to continue the route.

Returns
The LaneQ for all lanes of the current edge

Definition at line 3686 of file MSVehicle.cpp.

References myBestLanes.

Referenced by MSLane::appropriate(), MSLaneChanger::change(), MSLaneChanger::changeOpposite(), MSLaneChangerSublane::checkChangeHelper(), libsumo::Vehicle::getBestLanes(), MSEdge::getDepartLane(), and MSLCM_SL2015::updateExpectedSublaneSpeeds().

◆ getBestLanesContinuation() [1/2]

◆ getBestLanesContinuation() [2/2]

const std::vector< MSLane * > & MSVehicle::getBestLanesContinuation ( const MSLane *const  l) const

Returns the best sequence of lanes to continue the route starting at the given lane.

Returns
The bestContinuations of the LaneQ for the given lane (see LaneQ)

Definition at line 4035 of file MSVehicle.cpp.

References MSLane::getEdge(), MSLane::getLinkCont(), MSEdge::isInternal(), myBestLanes, and myEmptyLaneVector.

◆ getBoundingBox()

◆ getBoundingPoly()

◆ getCarFollowModel()

const MSCFModel& MSVehicle::getCarFollowModel ( ) const
inline

Returns the vehicle's car following model definition.

This is simply a wrapper around the vehicle type's car-following model retrieval for a shorter access.

Returns
The vehicle's car following model definition

Definition at line 882 of file MSVehicle.h.

References MSVehicleType::getCarFollowModel(), and MSBaseVehicle::myType.

Referenced by MSLCM_LC2013::_wantsChange(), MSLCM_SL2015::_wantsChangeSublane(), MSLCM_LC2013::adaptSpeedToPedestrians(), MSPModel_Striping::addCrossingVehs(), MSCriticalFollowerDistanceInfo::addFollower(), addStop(), MSLaneChanger::changeOpposite(), MSLCM_SL2015::checkBlockingVehicles(), MSLaneChanger::checkChange(), MSLane::checkFailure(), MSLane::checkForPedestrians(), checkRewindLinkLanes(), MSLCM_SL2015::checkStrategicChange(), MSLCM_SL2015::commitFollowSpeed(), MSLCM_SL2015::commitManoeuvre(), MSLaneChanger::computeOvertakingTime(), MSLink::couldBrakeForLeader(), MSDevice_SSM::estimateConflictTimes(), estimateLeaveSpeed(), executeMove(), MSLane::freeInsertion(), MSLane::getCriticalLeader(), MSLane::getLeader(), getLeader(), MSLane::getLeaderOnConsecutive(), MSLaneChangerSublane::getLeaders(), MSLane::getLeadersOnConsecutive(), MSLane::getMissingRearGap(), MSLaneChanger::getRealLeader(), getRerouteOrigin(), getSafeFollowSpeed(), GUIVehicle::getTypeParameterWindow(), MSLink::getZipperSpeed(), MSLane::handleCollisionBetween(), MSLCM_DK2008::informBlocker(), MSLCM_LC2013::informFollower(), MSLCM_SL2015::informFollower(), MSLCM_LC2013::informLeader(), MSLCM_SL2015::informLeader(), MSLCM_SL2015::informLeaders(), MSLane::isInsertionSuccess(), MSLane::lastInsertion(), MSLink::maybeOccupied(), MSLCM_LC2013::overtakeDistance(), MSLCM_DK2008::patchSpeed(), planMoveInternal(), processLinkAproaches(), processNextStop(), processTraCISpeedControl(), MSLane::safeInsertionSpeed(), MSLCM_SL2015::saveBlockerLength(), MSLCM_LC2013::saveBlockerLength(), GUIVehicle::selectBlockingFoes(), MSAbstractLaneChangeModel::setFollowerGaps(), MSAbstractLaneChangeModel::setLeaderGaps(), MSAbstractLaneChangeModel::setOrigLeaderGaps(), MSLCM_LC2013::slowDownForBlocked(), MSLCM_SL2015::slowDownForBlocked(), unsafeLinkAhead(), MSLCM_SL2015::updateExpectedSublaneSpeeds(), MSLCM_DK2008::wantsChangeToLeft(), and MSLCM_DK2008::wantsChangeToRight().

◆ getCarFollowVariables()

◆ getCenterOnEdge()

◆ getChosenSpeedFactor()

double MSBaseVehicle::getChosenSpeedFactor ( ) const
inlinevirtualinherited

Returns the precomputed factor by which the driver wants to be faster than the speed limit.

Returns
Speed limit factor

Implements SUMOVehicle.

Definition at line 377 of file MSBaseVehicle.h.

References MSBaseVehicle::myChosenSpeedFactor.

Referenced by GUIMEVehicle::getParameterWindow(), GUIVehicle::getParameterWindow(), and libsumo::Vehicle::getSpeedFactor().

◆ getCO2Emissions()

double MSVehicle::getCO2Emissions ( ) const

◆ getCOEmissions()

double MSVehicle::getCOEmissions ( ) const

◆ getContainerNumber()

int MSVehicle::getContainerNumber ( ) const

◆ getContainers()

const std::vector< MSTransportable * > & MSVehicle::getContainers ( ) const

◆ getCurrentRouteEdge()

const MSRouteIterator& MSBaseVehicle::getCurrentRouteEdge ( ) const
inlinevirtualinherited

Returns an iterator pointing to the current edge in this vehicles route.

Returns
The current route pointer

Implements SUMOVehicle.

Definition at line 192 of file MSBaseVehicle.h.

References MSBaseVehicle::getAcceleration(), MSBaseVehicle::getSlope(), MSBaseVehicle::myCurrEdge, MSBaseVehicle::onDepart(), MSBaseVehicle::replaceRouteEdges(), and MSBaseVehicle::reroute().

Referenced by MSDevice_SSM::findSurroundingVehicles(), libsumo::Vehicle::getDistance(), and libsumo::Vehicle::moveToXY().

◆ getDeltaPos()

double MSVehicle::getDeltaPos ( double  accel)

calculates the distance covered in the next integration step given an acceleration and assuming the current velocity. (gives different results for different integration methods, e.g., euler vs. ballistic)

Parameters
[in]accelthe assumed acceleration
Returns
distance covered in next integration step

Definition at line 2248 of file MSVehicle.cpp.

References ACCEL2SPEED, MSGlobals::gSemiImplicitEulerUpdate, MAX2(), MSVehicle::State::mySpeed, myState, and SPEED2DIST.

Referenced by updateState().

◆ getDepartDelay()

SUMOTime MSBaseVehicle::getDepartDelay ( ) const
inlinevirtualinherited

◆ getDepartPos()

double MSBaseVehicle::getDepartPos ( ) const
inlinevirtualinherited

Returns this vehicle's real departure position.

Returns
This vehicle's real departure position

Implements SUMOVehicle.

Definition at line 261 of file MSBaseVehicle.h.

References MSBaseVehicle::myDepartPos.

Referenced by libsumo::Vehicle::getDistance().

◆ getDeparture()

SUMOTime MSBaseVehicle::getDeparture ( ) const
inlinevirtualinherited

Returns this vehicle's real departure time.

Returns
This vehicle's real departure time

Implements SUMOVehicle.

Definition at line 248 of file MSBaseVehicle.h.

References MSBaseVehicle::myDeparture.

Referenced by MSBaseVehicle::getDepartDelay(), and MSVehicle::Influencer::postProcessRemoteControl().

◆ getDevice()

MSDevice * MSBaseVehicle::getDevice ( const std::type_info &  type) const
virtualinherited

Returns a device of the given type if it exists or 0.

Implements SUMOVehicle.

Definition at line 447 of file MSBaseVehicle.cpp.

References MSBaseVehicle::myDevices.

Referenced by MSBaseVehicle::createDevice(), GUIBaseVehicle::drawOnPos(), resumeFromStopping(), MSBaseVehicle::setChosenSpeedFactor(), and MSBatteryExport::write().

◆ getDeviceParameter()

std::string MSBaseVehicle::getDeviceParameter ( const std::string &  deviceName,
const std::string &  key 
) const
inherited

try to retrieve the given parameter from any of the vehicles devices, raise InvalidArgument if no device parameter by that name exists

Definition at line 527 of file MSBaseVehicle.cpp.

References MSBaseVehicle::myDevices.

Referenced by libsumo::Vehicle::getParameter().

◆ getDevices()

const std::vector<MSDevice*>& MSBaseVehicle::getDevices ( ) const
inlinevirtualinherited

◆ getDistanceToPosition()

double MSVehicle::getDistanceToPosition ( double  destPos,
const MSEdge destEdge 
) const

Compute distance that will be covered, if the vehicle moves to a given position on its route, starting at its current position.

Parameters
destPosposition on the destination edge that shall be reached
destEdgedestination edge that shall be reached
Returns
distance from the vehicles current position to the destination position, or a near infinite real value if the destination position is not contained within the vehicles route or the vehicle is not active

Definition at line 4081 of file MSVehicle.cpp.

References MSRoute::getDistanceBetween(), MSLane::getEdge(), MSLane::getLength(), getPositionOnLane(), isOnRoad(), MSBaseVehicle::myCurrEdge, myLane, and MSBaseVehicle::myRoute.

Referenced by MSVehicle::Influencer::implicitDeltaPosRemote(), MSVehicle::Influencer::implicitSpeedRemote(), and nextStopDist().

◆ getEdge()

◆ getElectricityConsumption()

double MSVehicle::getElectricityConsumption ( ) const

◆ getFuelConsumption()

double MSVehicle::getFuelConsumption ( ) const

◆ getFurtherLanes()

const std::vector<MSLane*>& MSVehicle::getFurtherLanes ( ) const
inline

◆ getFurtherLanesPosLat()

const std::vector<double>& MSVehicle::getFurtherLanesPosLat ( ) const
inline

Definition at line 784 of file MSVehicle.h.

References myFurtherLanesPosLat, and onFurtherEdge().

Referenced by MSAbstractLaneChangeModel::updateShadowLane().

◆ getHarmonoise_NoiseEmissions()

double MSVehicle::getHarmonoise_NoiseEmissions ( ) const

◆ getHCEmissions()

double MSVehicle::getHCEmissions ( ) const

◆ getID()

const std::string & MSBaseVehicle::getID ( ) const
virtualinherited

Returns the name of the vehicle.

Implements SUMOVehicle.

Definition at line 121 of file MSBaseVehicle.cpp.

References SUMOVehicleParameter::id, and MSBaseVehicle::myParameter.

Referenced by MSLCM_LC2013::_patchSpeed(), MSLCM_SL2015::_patchSpeed(), MSLCM_LC2013::_wantsChange(), MSLCM_SL2015::_wantsChangeSublane(), MSLaneChangerSublane::abortLCManeuver(), adaptToLeader(), adaptToLeaders(), MSVehicleTransfer::add(), MSBaseVehicle::addContainer(), MSPModel_Striping::addCrossingVehs(), MSLCM_SL2015::addLCSpeedAdvice(), MSBaseVehicle::addPerson(), addTraciStopAtStoppingPlace(), MSBaseVehicle::calculateArrivalParams(), MSLaneChangerSublane::change(), MSLaneChanger::change(), MSLCM_SL2015::changed(), MSLaneChanger::changeOpposite(), MELoop::changeSegment(), libsumo::Vehicle::changeTarget(), MSLaneChanger::checkChange(), MSLaneChangerSublane::checkChangeSublane(), MSLane::checkFailure(), MSLane::checkForPedestrians(), MSVehicleTransfer::checkInsertions(), checkLinkLeader(), checkRewindLinkLanes(), MSLCM_SL2015::checkStrategicChange(), MSLaneChanger::checkTraCICommands(), MSAbstractLaneChangeModel::checkTraCICommands(), MSDevice_SSM::classifyEncounter(), MSLCM_SL2015::commitManoeuvre(), computeAngle(), MSLCM_SL2015::computeSpeedLat(), MSDevice_SSM::computeSSMs(), MSLaneChanger::continueChange(), MSLaneChangerSublane::continueChangeSublane(), MSLCM_SL2015::decideDirection(), MSLane::detectCollisionBetween(), MSLane::detectCollisions(), MSLane::detectPedestrianJunctionCollision(), MSDevice_SSM::Encounter::Encounter(), MSCalibrator::execute(), executeMove(), MSLane::executeMovements(), MSLaneChanger::findCandidate(), MSDevice_SSM::findFoeConflictLane(), MSDevice_SSM::findSurroundingVehicles(), getBackPosition(), getBackPositionOnLane(), getCenterOnEdge(), MSLane::getFirstVehicleInformation(), MSLane::getFollower(), MSLane::getFollowersOnConsecutive(), MSLane::getLastVehicleInformation(), getLatOffset(), MSLane::getLeader(), MSLink::getLeaderInfo(), MSLane::getLeaderOnConsecutive(), MSLaneChangerSublane::getLeaders(), MSLane::getLeadersOnConsecutive(), MSLane::getOppositeFollower(), MSLane::getOppositeLeader(), GUIMEVehicle::getParameterWindow(), GUIVehicle::getParameterWindow(), MSLane::getPartialBehind(), MSLaneChanger::getRealFollower(), MSLaneChanger::getRealLeader(), MSAbstractLaneChangeModel::getShadowLane(), MSBaseVehicle::getSingularType(), MSDevice_SSM::getUpstreamVehicles(), MSLane::handleCollisionBetween(), ignoreRed(), MSLCM_LC2013::inform(), MSLCM_SL2015::inform(), MSLCM_LC2013::informFollower(), MSLCM_SL2015::informFollower(), MSLCM_LC2013::informLeader(), MSLCM_SL2015::informLeader(), MESegment::initialise(), MSPedestrianPushButton::isActiveForEdge(), MSLane::isInsertionSuccess(), MSAbstractLaneChangeModel::laneChangeOutput(), lateralDistanceToLane(), leaveLane(), MSCFModel_Daniel1::moveHelper(), MSCFModel_KraussOrig1::moveHelper(), MSCFModel_Krauss::moveHelper(), MSCFModel_SmartSK::moveHelper(), MSPModel_Striping::moveInDirectionOnLane(), libsumo::Vehicle::moveToXY(), MSLCM_LC2013::MSLCM_LC2013(), MSCalibrator::VehicleRemover::notifyEnter(), onRemovalFromNet(), MSLaneChangerSublane::outputLCStarted(), MSLCM_LC2013::patchSpeed(), MSLCM_SL2015::patchSpeed(), planMove(), planMoveInternal(), MSLCM_SL2015::prepareStep(), processLaneAdvances(), processLinkAproaches(), processNextStop(), removePassedDriveItems(), MSBaseVehicle::replaceRouteEdges(), MSBaseVehicle::reroute(), MSLane::resetManeuverReservation(), MSLane::resetPartialOccupation(), libsumo::Vehicle::resume(), MSLCM_SL2015::saveBlockerLength(), MSLCM_LC2013::saveBlockerLength(), MSBaseVehicle::saveState(), MSCalibrator::scheduleRemoval(), GUIVehicle::selectBlockingFoes(), setAngle(), MSAbstractLaneChangeModel::setManeuverDist(), MSLane::setManeuverReservation(), MSLCM_SL2015::setOwnState(), MSLane::setPartialOccupation(), libsumo::Helper::setRemoteControlled(), libsumo::Vehicle::setRoute(), libsumo::Vehicle::setRouteID(), MSLCM_LC2013::slowDownForBlocked(), MSLCM_SL2015::slowDownForBlocked(), MSLaneChangerSublane::startChangeSublane(), MELoop::teleportVehicle(), METriggeredCalibrator::tryEmit(), updateBestLanes(), updateDriveItems(), MSLCM_SL2015::updateExpectedSublaneSpeeds(), MSLCM_SL2015::updateGaps(), MSAbstractLaneChangeModel::updateShadowLane(), updateState(), MSAbstractLaneChangeModel::updateTargetLane(), MSLCM_LC2013::wantsChange(), MSLCM_SL2015::wantsChange(), MSLCM_SL2015::wantsChangeSublane(), MSBatteryExport::write(), and MSXMLRawOut::writeVehicle().

◆ getImpatience()

◆ getInfluencer() [1/2]

◆ getInfluencer() [2/2]

const MSVehicle::Influencer * MSVehicle::getInfluencer ( ) const

Definition at line 4821 of file MSVehicle.cpp.

References myInfluencer.

◆ getLane()

MSLane* MSVehicle::getLane ( ) const
inlinevirtual

Returns the lane the vehicle is on.

Returns
The vehicle's current lane

Implements SUMOVehicle.

Definition at line 564 of file MSVehicle.h.

References myLane.

Referenced by MSLCM_LC2013::_patchSpeed(), MSLCM_LC2013::_wantsChange(), MSLCM_SL2015::_wantsChangeSublane(), adaptToLeaders(), MSLaneChangerSublane::change(), MSLaneChanger::changeOpposite(), MSLCM_SL2015::checkBlocking(), MSLaneChanger::checkChange(), MSLaneChangerSublane::checkChangeSublane(), MSLaneChangerSublane::checkChangeToNewLane(), MSVehicleTransfer::checkInsertions(), checkLinkLeader(), MSLCM_SL2015::checkStrategicChange(), MSDevice_SSM::classifyEncounter(), MSLCM_SL2015::commitManoeuvre(), MSLaneChanger::computeOvertakingTime(), MSLCM_SL2015::computeSpeedGain(), MSAbstractLaneChangeModel::congested(), MSLane::detectCollisionBetween(), MSLane::detectCollisions(), MSAbstractLaneChangeModel::determineTargetLane(), MSVTypeProbe::execute(), MSLane::executeMovements(), MSDevice_SSM::findFoeConflictLane(), MSDevice_SSM::findSurroundingVehicles(), MSCFModel_IDM::followSpeed(), libsumo::Vehicle::getAllowedSpeed(), GUIVehicle::getColorValue(), libsumo::Vehicle::getDistance(), libsumo::Vehicle::getDrivingDistance(), MSLane::getFollowersOnConsecutive(), libsumo::Vehicle::getLaneID(), libsumo::Vehicle::getLaneIndex(), MSLink::getLeaderInfo(), MSLaneChangerSublane::getLeaders(), libsumo::Vehicle::getNextTLS(), getPositionAlongBestLanes(), libsumo::Vehicle::getRoadID(), MSLCM_LC2013::getRoundaboutAheadInfo(), MSAbstractLaneChangeModel::getShadowDirection(), MSVTKExport::getSpeed(), MSLCM_SL2015::getSublaneWidth(), MSLink::getZipperSpeed(), MSLane::handleCollisionBetween(), MSLCM_LC2013::informFollower(), MSLane::integrateNewVehicle(), MSCFModel_IDM::interactionGap(), MSCFModel::interactionGap(), MSJunction::isLeader(), MSLCM_SL2015::keepLatGap(), MSCFModel_KraussOrig1::moveHelper(), MSCFModel_Daniel1::moveHelper(), MSCFModel_Krauss::moveHelper(), MSCFModel_SmartSK::moveHelper(), MSCFModel_IDM::moveHelper(), libsumo::Vehicle::moveTo(), libsumo::Vehicle::moveToXY(), MSDevice_BTreceiver::notifyEnter(), MSDevice_BTsender::notifyEnter(), MSDevice_BTreceiver::notifyLeave(), MSDevice_BTsender::notifyLeave(), MSDevice_BTsender::notifyMove(), MSDevice_BTreceiver::notifyMove(), MSLCM_DK2008::patchSpeed(), MSLCM_LC2013::patchSpeed(), MSLCM_SL2015::patchSpeed(), planMoveInternal(), MSVehicle::Influencer::postProcessRemoteControl(), MSLCM_SL2015::prepareStep(), TraCIServerAPI_Vehicle::processSet(), MSVehicleTransfer::remove(), MSCalibrator::removePending(), MSLane::removeVehicle(), setBlinkerInformation(), libsumo::Vehicle::setRoute(), libsumo::Vehicle::setRouteID(), MSLaneChangerSublane::startChangeSublane(), MSCFModel_IDM::stopSpeed(), MSLCM_SL2015::updateCFRelated(), MSLaneChangerSublane::updateChanger(), updateDriveItems(), MSLCM_SL2015::updateExpectedSublaneSpeeds(), MSAbstractLaneChangeModel::updateShadowLane(), MSAbstractLaneChangeModel::updateTargetLane(), MSLCM_LC2013::wantsChange(), MSLCM_SL2015::wantsChange(), MSLCM_SL2015::wantsChangeSublane(), MSLCM_DK2008::wantsChangeToLeft(), MSLCM_DK2008::wantsChangeToRight(), MSBatteryExport::write(), MSEmissionExport::write(), MSFCDExport::write(), MSQueueExport::writeLane(), and MSFullExport::writeVehicles().

◆ getLaneChangeModel() [1/2]

MSAbstractLaneChangeModel & MSVehicle::getLaneChangeModel ( )

Definition at line 3674 of file MSVehicle.cpp.

References myLaneChangeModel.

Referenced by MSLaneChangerSublane::abortLCManeuver(), MSVehicleTransfer::add(), MSLaneChanger::applyTraCICommands(), MSLaneChangerSublane::change(), MSLaneChanger::change(), MSLaneChanger::changeOpposite(), MSLaneChanger::checkChange(), MSLaneChangerSublane::checkChangeSublane(), MSLaneChangerSublane::checkChangeToNewLane(), checkLinkLeader(), checkRewindLinkLanes(), MSLaneChanger::checkTraCICommands(), MSAbstractLaneChangeModel::checkTraCICommands(), computeAngle(), congested(), MSLaneChanger::continueChange(), MSLaneChangerSublane::continueChangeSublane(), MSLane::detectCollisionBetween(), MSLane::detectCollisions(), enterLaneAtInsertion(), executeMove(), fixPosition(), getBackPosition(), getBackPositionOnLane(), getCenterOnEdge(), libsumo::Vehicle::getLaneChangeState(), GUIVehicle::getLastLaneChangeOffset(), getLatOffset(), MSLink::getLeaderInfo(), GUIVehicle::getManeuverDist(), MSLane::getOppositeFollower(), MSLane::getOppositeLeader(), libsumo::Vehicle::getParameter(), GUIVehicle::getParameterWindow(), getPosition(), MSLeaderInfo::getSubLanes(), MSLCM_SL2015::inform(), MSAbstractLaneChangeModel::MSLCMessager::informLeader(), MSAbstractLaneChangeModel::MSLCMessager::informNeighFollower(), MSAbstractLaneChangeModel::MSLCMessager::informNeighLeader(), isFrontOnLane(), MSLane::isInsertionSuccess(), MSCFModel_Rail::moveHelper(), MSCFModel_Daniel1::moveHelper(), MSCFModel_Krauss::moveHelper(), MSCFModel_KraussOrig1::moveHelper(), MSCFModel_KraussX::moveHelper(), MSCFModel_SmartSK::moveHelper(), MSCFModel::moveHelper(), MSLaneChangerSublane::outputLCEnded(), MSLaneChangerSublane::outputLCStarted(), planMove(), planMoveInternal(), processLaneAdvances(), processLinkAproaches(), MSLaneChanger::registerUnchanged(), removeApproachingInformation(), MSLCM_SL2015::saveBlockerLength(), MSLCM_LC2013::saveBlockerLength(), GUIVehicle::selectBlockingFoes(), setBlinkerInformation(), libsumo::Vehicle::setParameter(), MSLaneChanger::startChange(), MSLaneChangerSublane::startChangeSublane(), updateBestLanes(), MSLaneChangerSublane::updateChanger(), MSLCM_SL2015::updateGaps(), and updateState().

◆ getLaneChangeModel() [2/2]

const MSAbstractLaneChangeModel & MSVehicle::getLaneChangeModel ( ) const

Definition at line 3680 of file MSVehicle.cpp.

References myLaneChangeModel.

◆ getLaneIndex()

int MSVehicle::getLaneIndex ( ) const

◆ getLastActionTime()

SUMOTime MSVehicle::getLastActionTime ( ) const
inline

Returns the time of the vehicle's last action point.

Returns
The time of the last action point

Definition at line 524 of file MSVehicle.h.

References getPosition(), getPositionAlongBestLanes(), getSlope(), and myLastActionTime.

◆ getLastStepDist()

double MSVehicle::getLastStepDist ( ) const
inline

Get the distance the vehicle covered in the previous timestep.

Returns
The distance covered in the last timestep (in m)

Definition at line 409 of file MSVehicle.h.

References getBackPositionOnLane(), getPositionOnLane(), MSVehicle::State::lastCoveredDist(), and myState.

Referenced by MSDevice_SSM::checkConflictEntryAndExit(), and MSDevice_SSM::updatePassedEncounter().

◆ getLateralOverlap() [1/2]

double MSVehicle::getLateralOverlap ( ) const

return the amount by which the vehicle extends laterally outside it's primary lane

Definition at line 4495 of file MSVehicle.cpp.

References getLateralPositionOnLane().

Referenced by MSLCM_SL2015::checkStrategicChange(), executeMove(), getLateralPositionOnLane(), MSAbstractLaneChangeModel::getShadowLane(), planMoveInternal(), and MSAbstractLaneChangeModel::updateShadowLane().

◆ getLateralOverlap() [2/2]

double MSVehicle::getLateralOverlap ( double  posLat) const

◆ getLateralPositionOnLane()

double MSVehicle::getLateralPositionOnLane ( ) const
inlinevirtual

Get the vehicle's lateral position on the lane.

Returns
The lateral position of the vehicle (in m relative to the centerline of the lane)

Reimplemented from MSBaseVehicle.

Definition at line 439 of file MSVehicle.h.

References getCenterOnEdge(), getLateralOverlap(), getLatOffset(), getRightSideOnEdge(), getRightSideOnLane(), lateralDistanceToLane(), MSVehicle::State::myPosLat, myState, and MSVehicle::State::posLat().

Referenced by MSLCM_SL2015::_wantsChangeSublane(), MSLaneChangerSublane::checkChangeToNewLane(), MSLane::checkForPedestrians(), MSVehicleTransfer::checkInsertions(), checkRewindLinkLanes(), MSLCM_SL2015::checkStrategicChange(), MSDevice_SSM::classifyEncounter(), MSLaneChanger::continueChange(), MSAbstractLaneChangeModel::determineTargetLane(), executeMove(), MSLane::getCriticalLeader(), libsumo::Vehicle::getLateralLanePosition(), getLateralOverlap(), MSLink::getLeaderInfo(), MSLane::getLeaderOnConsecutive(), MSLane::getLeadersOnConsecutive(), GUIVehicle::getParameterWindow(), getPosition(), getPositionAlongBestLanes(), MSAbstractLaneChangeModel::getShadowLane(), MSLeaderInfo::getSubLanes(), MSLCM_SL2015::keepLatGap(), lateralDistanceToLane(), MSLane::loadState(), MSPModel_Striping::moveInDirectionOnLane(), MSLane::vehicle_natural_position_sorter::operator()(), planMove(), processLinkAproaches(), GUIVehicle::selectBlockingFoes(), setAngle(), MSLaneChangerSublane::startChangeSublane(), validatePosition(), MSLCM_LC2013::wantsChange(), MSLCM_SL2015::wantsChange(), MSLCM_SL2015::wantsChangeSublane(), and MSXMLRawOut::writeVehicle().

◆ getLatOffset()

◆ getLeader()

std::pair< const MSVehicle *const, double > MSVehicle::getLeader ( double  dist = 0) const

Returns the leader of the vehicle looking for a fixed distance.

If the distance is not given it is calculated from the brake gap. The gap returned does not include the minGap.

Parameters
distup to which distance to look for a leader
Returns
The leading vehicle together with the gap; (0, -1) if no leader was found.

Definition at line 4098 of file MSVehicle.cpp.

References MSCFModel::brakeGap(), getBackPositionOnLane(), getBestLanesContinuation(), getCarFollowModel(), MSLane::getLeaderOnConsecutive(), MSLane::getLength(), MSVehicleType::getMinGap(), getPositionOnLane(), getSpeed(), MSLane::getVehiclesSecure(), MSBaseVehicle::getVehicleType(), myLane, and MSLane::releaseVehicles().

Referenced by libsumo::Vehicle::getLeader(), getTimeGapOnLane(), and nextStopDist().

◆ getLength()

◆ getMaxSpeed()

◆ getMaxSpeedOnLane()

double MSVehicle::getMaxSpeedOnLane ( ) const
inline

Returns the maximal speed for the vehicle on its current lane (including speed factor and deviation, i.e., not necessarily the allowed speed limit)

Returns
The vehicle's max speed

Definition at line 574 of file MSVehicle.h.

References MSVehicleType::getMaxSpeed(), MSLane::getVehicleMaxSpeed(), myLane, and MSBaseVehicle::myType.

Referenced by MSDevice_SSM::estimateConflictTimes(), MSLCM_LC2013::informFollower(), MSCFModel_Rail::moveHelper(), MSCFModel_KraussX::moveHelper(), and MSCFModel::moveHelper().

◆ getNextParkingArea()

MSParkingArea * MSVehicle::getNextParkingArea ( )
virtual

get the current parking area stop

Implements SUMOVehicle.

Definition at line 1318 of file MSVehicle.cpp.

References myStops, MSVehicle::Stop::parkingarea, and MSVehicle::Stop::reached.

◆ getNextStop()

MSVehicle::Stop & MSVehicle::getNextStop ( )

returns the next imminent stop in the stop queue

Returns
the upcoming stop

Definition at line 4806 of file MSVehicle.cpp.

References myStops.

Referenced by libsumo::Vehicle::getStopState(), MSLane::isInsertionSuccess(), libsumo::Vehicle::resume(), and signalSet().

◆ getNOxEmissions()

double MSVehicle::getNOxEmissions ( ) const

◆ getNumberReroutes()

int MSBaseVehicle::getNumberReroutes ( ) const
inlinevirtualinherited

Returns the number of new routes this vehicle got.

Returns
the number of new routes this vehicle got

Implements SUMOVehicle.

Definition at line 291 of file MSBaseVehicle.h.

References MSBaseVehicle::getImpatience(), and MSBaseVehicle::myNumberReroutes.

Referenced by GUIBaseVehicle::drawGLAdditional(), GUIMEVehicle::getColorValue(), GUIVehicle::getColorValue(), and MSBaseVehicle::replaceRouteEdges().

◆ getParameter()

◆ getPersonNumber()

int MSVehicle::getPersonNumber ( ) const

◆ getPersons()

const std::vector< MSTransportable * > & MSVehicle::getPersons ( ) const

◆ getPMxEmissions()

double MSVehicle::getPMxEmissions ( ) const

◆ getPosition()

◆ getPositionAlongBestLanes()

Position MSVehicle::getPositionAlongBestLanes ( double  offset) const

Return the (x,y)-position, which the vehicle would reach if it continued along its best continuation lanes from the current for a distance of offset m.

Parameters
offset
Returns
(x,y)-Position
See also
getPosition()

Definition at line 933 of file MSVehicle.cpp.

References MSLane::geometryPositionAtOffset(), getBestLanesContinuation(), getLane(), getLateralPositionOnLane(), MSLane::getLength(), MSLane::getLinkCont(), MSLane::getLinkTo(), MSLink::getViaLaneOrLane(), MSGlobals::gUsingInternalLanes, Position::INVALID, MSLane::isInternal(), MSVehicle::State::myPos, and myState.

Referenced by MSDevice_SSM::determineConflictPoint(), and getLastActionTime().

◆ getPositionOnLane() [1/2]

double MSVehicle::getPositionOnLane ( ) const
inlinevirtual

Get the vehicle's position along the lane.

Returns
The position of the vehicle (in m from the lane's begin)

Implements SUMOVehicle.

Definition at line 402 of file MSVehicle.h.

References MSVehicle::State::myPos, and myState.

Referenced by MSLCM_LC2013::_wantsChange(), MSLCM_SL2015::_wantsChangeSublane(), MSLCM_LC2013::adaptSpeedToPedestrians(), adaptToLeaders(), MSLaneChanger::changeOpposite(), MSLaneChanger::checkChange(), MSVehicleTransfer::checkInsertions(), MSLCM_SL2015::checkStrategicChange(), MSDevice_SSM::classifyEncounter(), computeAngle(), MSLane::detectCollisionBetween(), MSLane::detectCollisions(), executeMove(), MSLane::executeMovements(), MSLaneChanger::findCandidate(), MSDevice_SSM::findFoeConflictLane(), MSDevice_SSM::findSurroundingVehicles(), MSLane::freeInsertion(), MSLane::getBruttoOccupancy(), MSLaneChanger::getCloserFollower(), MSEdge::getDepartPosBound(), libsumo::Vehicle::getDistance(), getDistanceToPosition(), libsumo::Vehicle::getDrivingDistance(), libsumo::Vehicle::getDrivingDistance2D(), MSLane::getFirstAnyVehicle(), MSLane::getFirstVehicleInformation(), MSLane::getFollower(), MSLane::getFollowersOnConsecutive(), MSEdge::getFreeLane(), libsumo::Vehicle::getLanePosition(), getLastStepDist(), MSLane::getLastVehicleInformation(), MSLane::getLeader(), getLeader(), MSLaneChangerSublane::getLeaders(), MSLane::getNettoOccupancy(), libsumo::Vehicle::getNextTLS(), MSLane::getOppositeFollower(), MSLane::getOppositeLeader(), GUIVehicle::getParameterWindow(), MSLane::getPartialBehind(), getPosition(), MSLaneChanger::getRealFollower(), MSLaneChanger::getRealLeader(), MSLCM_LC2013::getRoundaboutAheadInfo(), getSlope(), MSVTKExport::getSpeed(), MSDevice_SSM::getUpstreamVehicles(), MSLane::handleCollisionBetween(), MSLane::isInsertionSuccess(), MSAbstractLaneChangeModel::laneChangeOutput(), MSVehicleTransfer::loadState(), MSLane::loadState(), libsumo::Vehicle::moveToXY(), MSLane::VehPosition::operator()(), MSLCM_LC2013::patchSpeed(), MSLCM_SL2015::patchSpeed(), planMove(), planMoveInternal(), processLinkAproaches(), MSCalibrator::remainingVehicleCapacity(), GUIVehicle::selectBlockingFoes(), setBlinkerInformation(), MSLCM_LC2013::slowDownForBlocked(), MSLCM_SL2015::slowDownForBlocked(), MSLaneChangerSublane::startChangeSublane(), unsafeLinkAhead(), MSLCM_SL2015::updateCFRelated(), MSLCM_SL2015::updateExpectedSublaneSpeeds(), MSLane::updateLeaderInfo(), MSLCM_LC2013::wantsChange(), MSLCM_SL2015::wantsChange(), MSLCM_SL2015::wantsChangeSublane(), MSLCM_DK2008::wantsChangeToLeft(), MSLCM_DK2008::wantsChangeToRight(), MSBatteryExport::write(), and MSQueueExport::writeLane().

◆ getPositionOnLane() [2/2]

double MSVehicle::getPositionOnLane ( const MSLane lane) const

Get the vehicle's front position relative to the given lane.

Returns
The front position of the vehicle (in m from the given lane's begin)

Definition at line 3196 of file MSVehicle.cpp.

References getBackPositionOnLane(), MSVehicleType::getLength(), and MSBaseVehicle::myType.

◆ getPreviousSpeed()

double MSVehicle::getPreviousSpeed ( ) const
inlinevirtual

Returns the vehicle's speed before the previous time step.

Returns
The vehicle's speed before the previous time step

Reimplemented from MSBaseVehicle.

Definition at line 490 of file MSVehicle.h.

References MSVehicle::State::myPreviousSpeed, and myState.

Referenced by MSDevice_SSM::checkConflictEntryAndExit().

◆ getRerouteOrigin()

const MSEdge * MSVehicle::getRerouteOrigin ( ) const
virtual

Returns the starting point for reroutes (usually the current edge)

This differs from *myCurrEdge only if the vehicle is on an internal edge or very close to the junction

Returns
The rerouting start point

Reimplemented from MSBaseVehicle.

Definition at line 1011 of file MSVehicle.cpp.

References MSCFModel::brakeGap(), MSRoute::end(), getCarFollowModel(), MSLane::getLength(), MSLane::getNextNormal(), MSBaseVehicle::myCurrEdge, myLane, MSVehicle::State::myPos, MSBaseVehicle::myRoute, MSVehicle::State::mySpeed, and myState.

Referenced by libsumo::Vehicle::changeTarget(), and isActionStep().

◆ getRightSideOnEdge()

double MSVehicle::getRightSideOnEdge ( const MSLane lane = 0) const

Get the vehicle's lateral position on the edge of the given lane (or its current edge if lane == 0)

Returns
The lateral position of the vehicle (in m distance between right side of vehicle and ride side of edge

Definition at line 4337 of file MSVehicle.cpp.

References getCenterOnEdge(), MSBaseVehicle::getVehicleType(), and MSVehicleType::getWidth().

Referenced by MSLCM_SL2015::checkBlockingVehicles(), MSLane::detectCollisions(), getLateralPositionOnLane(), GUIVehicle::getLeftSideOnEdge(), GUIVehicle::getRightSideOnEdge2(), and GUIVehicle::getRightSublaneOnEdge().

◆ getRightSideOnLane()

double MSVehicle::getRightSideOnLane ( ) const

Get the vehicle's lateral position on the lane:

Returns
The lateral position of the vehicle (in m distance between right side of vehicle and ride side of the lane it is on

Definition at line 4331 of file MSVehicle.cpp.

References MSBaseVehicle::getVehicleType(), MSVehicleType::getWidth(), MSLane::getWidth(), myLane, MSVehicle::State::myPosLat, and myState.

Referenced by MSLCM_LC2013::adaptSpeedToPedestrians(), MSLane::checkForPedestrians(), getLateralPositionOnLane(), and planMoveInternal().

◆ getRoute()

◆ getRoutePosition()

◆ getSafeFollowSpeed()

double MSVehicle::getSafeFollowSpeed ( const std::pair< const MSVehicle *, double >  leaderInfo,
const double  seen,
const MSLane *const  lane,
double  distToCrossing 
) const

◆ getSignals()

int MSVehicle::getSignals ( ) const
inline

Returns the signals.

Returns
The signals' states

Definition at line 1231 of file MSVehicle.h.

References mySignals.

Referenced by libsumo::Vehicle::getSignalStates(), and MSFCDExport::write().

◆ getSingularType()

◆ getSlope()

◆ getSpaceTillLastStanding()

double MSVehicle::getSpaceTillLastStanding ( const MSLane l,
bool &  foundStopped 
) const
protected

◆ getSpeed()

double MSVehicle::getSpeed ( ) const
inlinevirtual

Returns the vehicle's current speed.

Returns
The vehicle's speed

Implements SUMOVehicle.

Definition at line 482 of file MSVehicle.h.

References MSVehicle::State::mySpeed, and myState.

Referenced by MSLCM_LC2013::_patchSpeed(), MSLCM_SL2015::_patchSpeed(), MSCFModel_Wiedemann::_v(), MSLCM_LC2013::_wantsChange(), MSLCM_SL2015::_wantsChangeSublane(), MSLCM_LC2013::adaptSpeedToPedestrians(), MSPModel_Striping::addCrossingVehs(), MSCriticalFollowerDistanceInfo::addFollower(), MSLCM_SL2015::addLCSpeedAdvice(), MSLCM_LC2013::addLCSpeedAdvice(), MSLaneChanger::changeOpposite(), MSLCM_SL2015::checkBlockingVehicles(), MSLaneChanger::checkChange(), MSDevice_SSM::checkConflictEntryAndExit(), GUIApplicationWindow::checkGamingEvents(), checkRewindLinkLanes(), MSLCM_SL2015::checkStrategicChange(), MSLCM_SL2015::commitFollowSpeed(), MSLCM_SL2015::commitManoeuvre(), MSDevice_SSM::computeDRAC(), MSLaneChanger::computeOvertakingTime(), MSLink::couldBrakeForLeader(), MSDevice_SSM::determineTTCandDRAC(), MSDevice_SSM::estimateConflictTimes(), executeMove(), MSLane::forceVehicleInsertion(), MSLane::freeInsertion(), GUIVehicle::getColorValue(), MSLane::getCriticalLeader(), MSLane::getLeader(), getLeader(), MSLaneChangerSublane::getLeaders(), MSLane::getMissingRearGap(), GUIVehicle::getParameterWindow(), MSLaneChanger::getRealLeader(), getSafeFollowSpeed(), libsumo::Vehicle::getSpeed(), MSVTKExport::getSpeed(), getTimeGapOnLane(), MSLink::getZipperSpeed(), MSLane::handleCollisionBetween(), MSLCM_DK2008::informBlocker(), MSLCM_LC2013::informFollower(), MSLCM_SL2015::informFollower(), MSLCM_LC2013::informLeader(), MSLCM_SL2015::informLeader(), MSLCM_SL2015::informLeaders(), MSCFModel_IDM::interactionGap(), MSCFModel::interactionGap(), MSLane::isInsertionSuccess(), MSAbstractLaneChangeModel::laneChangeOutput(), MSLane::lastInsertion(), MSVehicleTransfer::loadState(), MSLane::loadState(), MSLink::maybeOccupied(), MSCFModel_Rail::moveHelper(), MSCFModel_Daniel1::moveHelper(), MSCFModel_PWag2009::moveHelper(), MSCFModel_KraussOrig1::moveHelper(), MSCFModel_Krauss::moveHelper(), MSCFModel_KraussX::moveHelper(), MSCFModel_SmartSK::moveHelper(), MSCFModel_Wiedemann::moveHelper(), MSCFModel::moveHelper(), MSPModel_Striping::moveInDirectionOnLane(), MSLCM_LC2013::overtakeDistance(), MSLCM_DK2008::patchSpeed(), MSLCM_LC2013::patchSpeed(), MSLCM_SL2015::patchSpeed(), planMove(), planMoveInternal(), MSAbstractLaneChangeModel::predInteraction(), processLinkAproaches(), processNextStop(), MSLane::safeInsertionSpeed(), MSLCM_SL2015::saveBlockerLength(), MSLCM_LC2013::saveBlockerLength(), setBrakingSignals(), MSAbstractLaneChangeModel::setFollowerGaps(), MSAbstractLaneChangeModel::setLeaderGaps(), MSAbstractLaneChangeModel::setOrigLeaderGaps(), libsumo::Vehicle::slowDown(), MSLCM_LC2013::slowDownForBlocked(), MSLCM_SL2015::slowDownForBlocked(), MSLaneChangerSublane::startChangeSublane(), unsafeLinkAhead(), MSLCM_SL2015::updateCFRelated(), MSLCM_SL2015::updateExpectedSublaneSpeeds(), MSLCM_SL2015::updateGaps(), MSLCM_LC2013::wantsChange(), MSLCM_SL2015::wantsChange(), MSLCM_SL2015::wantsChangeSublane(), MSLCM_DK2008::wantsChangeToLeft(), MSLCM_DK2008::wantsChangeToRight(), MSBatteryExport::write(), and MSQueueExport::writeLane().

◆ getSpeedWithoutTraciInfluence()

double MSVehicle::getSpeedWithoutTraciInfluence ( ) const

Returns the uninfluenced velocity.

If no influencer exists (myInfluencer==0) the vehicle's current speed is returned. Otherwise the speed returned from myInfluencer->getOriginalSpeed().

Returns
The vehicle's velocity as it would without an influence
See also
Influencer::getOriginalSpeed

Definition at line 4827 of file MSVehicle.cpp.

References MSVehicle::Influencer::getOriginalSpeed(), myInfluencer, MSVehicle::State::mySpeed, and myState.

Referenced by libsumo::Vehicle::getSpeedWithoutTraCI(), and signalSet().

◆ getStopEdges()

const ConstMSEdgeVector MSVehicle::getStopEdges ( ) const
protectedvirtual

Returns the list of still pending stop edges.

Implements MSBaseVehicle.

Definition at line 1594 of file MSVehicle.cpp.

References myStops.

Referenced by hasInfluencer().

◆ getTimeGapOnLane()

double MSVehicle::getTimeGapOnLane ( ) const

Returns the time gap in seconds to the leader of the vehicle on the same lane.

If the distance is too big -1 is returned. The gap returned takes the minGap into account.

Returns
The time gap in seconds; -1 if no leader was found or speed is 0.

Definition at line 4127 of file MSVehicle.cpp.

References getLeader(), getSpeed(), and MSBaseVehicle::getVehicleType().

Referenced by GUIVehicle::getColorValue(), GUIVehicle::getParameterWindow(), and nextStopDist().

◆ getTimeLoss()

SUMOTime MSVehicle::getTimeLoss ( ) const
inline

Returns the SUMOTime lost (speed was lesser maximum speed)

Note
Intentional stopping does not count towards this time.
speedFactor is included so time loss can never be negative. The value is that of a driver who compares his travel time when the road is clear (which includes speed factor) with the actual travel time.
includes time lost due to low departSpeed and decelerating/accelerating for planned stops
Returns
The time the vehicle lost due to various effects

Definition at line 641 of file MSVehicle.h.

References myTimeLoss, and TIME2STEPS.

◆ getTimeLossSeconds()

double MSVehicle::getTimeLossSeconds ( ) const
inline

Returns the time loss in seconds.

Definition at line 676 of file MSVehicle.h.

References myTimeLoss.

Referenced by GUIVehicle::getColorValue(), and GUIVehicle::getParameterWindow().

◆ getVClass()

SUMOVehicleClass MSBaseVehicle::getVClass ( ) const
inlinevirtualinherited

◆ getVehicleType()

const MSVehicleType& MSBaseVehicle::getVehicleType ( ) const
inlinevirtualinherited

Returns the vehicle's type definition.

Returns
The vehicle's type definition

Implements SUMOVehicle.

Definition at line 115 of file MSBaseVehicle.h.

References MSBaseVehicle::myType.

Referenced by MSLCM_LC2013::_patchSpeed(), MSLCM_SL2015::_patchSpeed(), MSLCM_LC2013::_wantsChange(), MSLCM_SL2015::_wantsChangeSublane(), MSLCM_LC2013::adaptSpeedToPedestrians(), adaptToLeaders(), MSPModel_Striping::addCrossingVehs(), addStop(), MSLane::basePos(), MSTransportableControl::boardAnyWaiting(), MSLaneChanger::change(), MSLaneChanger::changeOpposite(), MSLCM_SL2015::checkBlocking(), MSLaneChanger::checkChange(), MSLaneChangerSublane::checkChangeToNewLane(), MSLane::checkFailure(), MSLane::checkForPedestrians(), GUIApplicationWindow::checkGamingEvents(), MSVehicleTransfer::checkInsertions(), checkRewindLinkLanes(), MSLCM_SL2015::checkStrategicChange(), MSDevice_SSM::classifyEncounter(), MSLCM_SL2015::commitManoeuvre(), MSLaneChanger::computeOvertakingTime(), MSLCM_SL2015::computeSpeedLat(), MSLane::detectCollisionBetween(), MSLane::detectCollisions(), GUIVehicle::drawAction_drawLinkItems(), GUIVehicle::drawAction_drawRailCarriages(), GUIVehicle::drawAction_drawVehicleBlinker(), GUIVehicle::drawAction_drawVehicleBrakeLight(), GUIEdge::drawMesoVehicles(), MSLane::enteredByLaneChange(), enterLaneAtInsertion(), enterLaneAtLaneChange(), MSDevice_SSM::estimateConflictTimes(), MEVehicle::estimateLeaveSpeed(), estimateLeaveSpeed(), MSLane::executeMovements(), MSLane::freeInsertion(), MEVehicle::getBackPositionOnLane(), MSLane::getBruttoOccupancy(), GUIBaseVehicle::getCenteringBoundary(), MSLane::getCriticalLeader(), MSEdge::getDepartLane(), MSEdge::getDepartPosBound(), MSLane::getDepartPosLat(), MSLane::getFollower(), MSLane::getFollowersOnConsecutive(), MSBaseVehicle::getImpatience(), getLateralOverlap(), MSLane::getLeader(), getLeader(), MSLink::getLeaderInfo(), MSLane::getLeaderOnConsecutive(), MSLaneChangerSublane::getLeaders(), MSLane::getLeadersOnConsecutive(), GUIVehicle::getLeftSideOnEdge(), MSLane::getNettoOccupancy(), MSLane::getOppositeFollower(), MSLane::getOppositeLeader(), MSLaneChanger::getRealFollower(), MSLaneChanger::getRealLeader(), getRightSideOnEdge(), getRightSideOnLane(), MSLeaderInfo::getSubLanes(), getTimeGapOnLane(), MESegment::getTimeHeadway(), libsumo::Vehicle::getTypeID(), libsumo::Vehicle::getVehicleType(), GUIBaseVehicle::getVType(), MSLCM_SL2015::getWidth(), MSLink::getZipperSpeed(), MSLane::handleCollisionBetween(), MESegment::hasSpaceFor(), ignoreRed(), MSLane::incorporateVehicle(), MSLCM_SL2015::informFollower(), MSLCM_SL2015::informLeader(), MSLCM_SL2015::informLeaders(), MSLane::insertVehicle(), MSLane::integrateNewVehicle(), MSLane::isInsertionSuccess(), MESegment::isOpen(), keepClear(), MSLCM_SL2015::keepLatGap(), MSAbstractLaneChangeModel::laneChangeOutput(), MSLane::lastInsertion(), MSLane::leftByLaneChange(), MSTransportableControl::loadAnyWaiting(), MESegment::loadState(), MSCFModel_Krauss::moveHelper(), MSPModel_Striping::moveInDirectionOnLane(), libsumo::Vehicle::moveToXY(), overlap(), MSLCM_LC2013::overtakeDistance(), MSLCM_DK2008::patchSpeed(), planMoveInternal(), MSVehicle::Influencer::postProcessRemoteControl(), processLinkAproaches(), processNextStop(), processTraCISpeedControl(), MESegment::receive(), MSLaneChanger::ChangeElem::registerHop(), MSLaneChanger::registerUnchanged(), MESegment::removeCar(), MSLane::removeVehicle(), MSLane::safeInsertionSpeed(), MSLCM_SL2015::saveBlockerLength(), MSLCM_LC2013::saveBlockerLength(), MSBaseVehicle::saveState(), GUIVehicle::selectBlockingFoes(), MSVehicleType::setActionStepLength(), MSAbstractLaneChangeModel::setFollowerGaps(), GUIBaseVehicle::setFunctionalColor(), MSAbstractLaneChangeModel::setLeaderGaps(), MSAbstractLaneChangeModel::setOrigLeaderGaps(), setTentativeLaneAndPosition(), MSLCM_LC2013::slowDownForBlocked(), MSLCM_SL2015::slowDownForBlocked(), MSLaneChangerSublane::startChangeSublane(), unsafeLinkAhead(), MSLCM_SL2015::updateCFRelated(), MSLCM_SL2015::updateExpectedSublaneSpeeds(), MSLCM_SL2015::updateGaps(), MSLCM_DK2008::wantsChangeToLeft(), MSLCM_DK2008::wantsChangeToRight(), MSBatteryExport::write(), and MSQueueExport::writeLane().

◆ getVelocityVector()

Position MSVehicle::getVelocityVector ( ) const
inline

Returns the vehicle's direction in radians.

Returns
The vehicle's current angle

Definition at line 692 of file MSVehicle.h.

References computeAngle(), myAngle, myState, setAngle(), and MSVehicle::State::speed().

Referenced by MSDevice_SSM::updateEncounter().

◆ getWaitingSeconds()

double MSVehicle::getWaitingSeconds ( ) const
inline

Returns the number of seconds waited (speed was lesser than 0.1m/s)

The value is reset if the vehicle moves faster than 0.1m/s Intentional stopping does not count towards this time.

Returns
The time the vehicle is standing

Definition at line 660 of file MSVehicle.h.

References myWaitingTime, and STEPS2TIME.

Referenced by GUIVehicle::getColorValue(), GUIVehicle::getParameterWindow(), libsumo::Vehicle::getWaitingTime(), MSLCM_LC2013::informFollower(), MSLCM_SL2015::informFollower(), MSPedestrianPushButton::isActiveForEdge(), MSEmissionExport::write(), MSQueueExport::writeLane(), and MSFullExport::writeVehicles().

◆ getWaitingTime()

SUMOTime MSVehicle::getWaitingTime ( ) const
inlinevirtual

Returns the SUMOTime waited (speed was lesser than 0.1m/s)

The value is reset if the vehicle moves faster than 0.1m/s Intentional stopping does not count towards this time.

Returns
The time the vehicle is standing

Implements SUMOVehicle.

Definition at line 628 of file MSVehicle.h.

References myWaitingTime.

Referenced by checkRewindLinkLanes(), MSLane::executeMovements(), MSLink::getLeaderInfo(), processLinkAproaches(), and GUIVehicle::selectBlockingFoes().

◆ getWeightsStorage() [1/2]

const MSEdgeWeightsStorage & MSVehicle::getWeightsStorage ( ) const

Returns the vehicle's internal edge travel times/efforts container.

If the vehicle does not have such a container, it is built.

Returns
The vehicle's knowledge about edge weights

Definition at line 817 of file MSVehicle.cpp.

References _getWeightsStorage().

Referenced by libsumo::Vehicle::getAdaptedTraveltime(), libsumo::Vehicle::getEffort(), MSNet::getEffort(), MSNet::getTravelTime(), libsumo::Vehicle::setAdaptedTraveltime(), and libsumo::Vehicle::setEffort().

◆ getWeightsStorage() [2/2]

MSEdgeWeightsStorage & MSVehicle::getWeightsStorage ( )

Definition at line 823 of file MSVehicle.cpp.

References _getWeightsStorage().

◆ getWidth()

◆ hasArrived()

bool MSVehicle::hasArrived ( ) const
virtual

Returns whether this vehicle has already arived (reached the arrivalPosition on its final edge)

Reimplemented from MSBaseVehicle.

Definition at line 723 of file MSVehicle.cpp.

References MSRoute::end(), isRemoteControlled(), MSBaseVehicle::myArrivalPos, MSBaseVehicle::myCurrEdge, MSVehicle::State::myPos, MSBaseVehicle::myRoute, myState, myStops, and POSITION_EPS.

Referenced by enterLaneAtMove(), executeMove(), MSLane::executeMovements(), and processLaneAdvances().

◆ hasDeparted()

◆ hasDevice()

bool MSBaseVehicle::hasDevice ( const std::string &  deviceName) const
inherited

check whether the vehicle is equiped with a device of the given type

Definition at line 497 of file MSBaseVehicle.cpp.

References MSBaseVehicle::myDevices.

Referenced by MSBaseVehicle::createDevice(), and libsumo::Vehicle::getParameter().

◆ hasInfluencer()

◆ hasStops()

bool MSVehicle::hasStops ( ) const
inline

Returns whether the vehicle has to stop somewhere.

Returns
Whether the vehicle has to stop somewhere

Definition at line 973 of file MSVehicle.h.

References collisionStopTime(), DELTA_T, isParking(), isRemoteControlled(), isStopped(), isStoppedOnLane(), keepStopping(), myStops, and wasRemoteControlled().

Referenced by GUIVehicle::getStopInfo(), MSLane::isInsertionSuccess(), and libsumo::Vehicle::resume().

◆ hasValidRoute()

bool MSBaseVehicle::hasValidRoute ( std::string &  msg,
const MSRoute route = 0 
) const
virtualinherited

Validates the current or given route.

Parameters
[out]msgDescription why the route is not valid (if it is the case)
[in]routeThe route to check (or 0 if the current route shall be checked)
Returns
Whether the vehicle's current route is valid

Implements SUMOVehicle.

Definition at line 321 of file MSBaseVehicle.cpp.

References MSRoute::begin(), MSRoute::end(), MSVehicleType::getVehicleClass(), MSBaseVehicle::myCurrEdge, MSBaseVehicle::myRoute, and MSBaseVehicle::myType.

Referenced by MSBaseVehicle::getDevices(), MESegment::initialise(), libsumo::Vehicle::isRouteValid(), MSBaseVehicle::MSBaseVehicle(), MSBaseVehicle::replaceRouteEdges(), and libsumo::Vehicle::setRouteID().

◆ ignoreRed()

◆ influenceChangeDecision()

◆ isActionStep()

bool MSVehicle::isActionStep ( SUMOTime  t) const
inline

Returns whether the next simulation step will be an action point for the vehicle.

Returns
Whether the vehicle has scheduled an action point for the next step.

Definition at line 601 of file MSVehicle.h.

References getActionStepLength(), getRerouteOrigin(), isFrontOnLane(), and myLastActionTime.

Referenced by checkActionStep(), and GUIVehicle::getColorValue().

◆ isActive()

bool MSVehicle::isActive ( ) const
inline

Returns whether the current simulation step is an action point for the vehicle.

Returns
Whether the vehicle has an action point in the current step.

Definition at line 594 of file MSVehicle.h.

References myActionStep.

Referenced by MSLaneChangerSublane::change(), MSLaneChanger::change(), MSLaneChangerSublane::checkChangeToNewLane(), GUIVehicle::getColorValue(), and MSLCM_SL2015::setOwnState().

◆ isFrontOnLane()

bool MSVehicle::isFrontOnLane ( const MSLane lane) const
virtual

Returns the information whether the front of the vehicle is on the given lane.

Returns
Whether the vehicle's front is on that lane

Reimplemented from MSBaseVehicle.

Definition at line 3202 of file MSVehicle.cpp.

References getLaneChangeModel(), MSAbstractLaneChangeModel::getShadowLane(), and myLane.

Referenced by checkRewindLinkLanes(), MSLaneChanger::findCandidate(), MSLane::getFirstVehicleInformation(), MSLane::getFollowersOnConsecutive(), MSLink::getLeaderInfo(), MSLane::getLeadersOnConsecutive(), MSLane::getPartialBehind(), MSLane::getPartialBeyond(), and isActionStep().

◆ isOnRoad()

◆ isParking()

bool MSVehicle::isParking ( ) const
virtual

Returns whether the vehicle is parking.

Returns
whether the vehicle is parking

Implements SUMOVehicle.

Definition at line 1358 of file MSVehicle.cpp.

References isStopped(), and myStops.

Referenced by MSVehicleTransfer::add(), computeAngle(), MSLane::executeMovements(), getPosition(), GUIVehicle::getStopInfo(), hasStops(), and libsumo::Vehicle::isVisible().

◆ isRemoteControlled()

bool MSVehicle::isRemoteControlled ( ) const
virtual

Returns the information whether the vehicle is fully controlled via TraCI.

Returns
Whether the vehicle is remote-controlled

Reimplemented from MSBaseVehicle.

Definition at line 4856 of file MSVehicle.cpp.

References MSVehicle::Influencer::isRemoteControlled(), and myInfluencer.

Referenced by MSLaneChangerSublane::change(), MSLaneChanger::change(), MSVehicle::Influencer::getLastAccessTimeStep(), hasArrived(), hasStops(), and processLinkAproaches().

◆ isSelected()

virtual bool MSBaseVehicle::isSelected ( ) const
inlinevirtualinherited

whether this vehicle is selected in the GUI

Implements SUMOVehicle.

Reimplemented in GUIVehicle.

Definition at line 430 of file MSBaseVehicle.h.

References MSBaseVehicle::calculateArrivalParams(), and MSBaseVehicle::getStopEdges().

◆ isStopped()

◆ isStoppedInRange()

bool MSVehicle::isStoppedInRange ( double  pos) const
virtual

return whether the given position is within range of the current stop

Implements SUMOVehicle.

Definition at line 1370 of file MSVehicle.cpp.

References isStopped(), and myStops.

Referenced by nextStopDist().

◆ isStoppedOnLane()

bool MSVehicle::isStoppedOnLane ( ) const

Definition at line 1337 of file MSVehicle.cpp.

References isStopped(), myLane, and myStops.

Referenced by MSLaneChangerSublane::change(), MSLaneChanger::change(), and hasStops().

◆ isStoppedTriggered()

bool MSVehicle::isStoppedTriggered ( ) const
virtual

Returns whether the vehicle is on a triggered stop.

Returns
whether the vehicle is on a triggered stop

Implements SUMOVehicle.

Definition at line 1364 of file MSVehicle.cpp.

References isStopped(), and myStops.

Referenced by keepStopping(), and nextStopDist().

◆ keepClear()

bool MSVehicle::keepClear ( const MSLink link) const
protected

◆ keepStopping()

bool MSVehicle::keepStopping ( bool  afterProcessing = false) const

Returns whether the vehicle is stopped and must continue to do so.

Definition at line 1342 of file MSVehicle.cpp.

References DELTA_T, isStopped(), isStoppedTriggered(), and myStops.

Referenced by MSVehicleTransfer::checkInsertions(), hasStops(), and processNextStop().

◆ lateralDistanceToLane()

double MSVehicle::lateralDistanceToLane ( const int  offset) const

Get the minimal lateral distance required to move fully onto the lane at given offset.

Returns
The lateral distance to be covered to move the vehicle fully onto the lane (in m)

Definition at line 4445 of file MSVehicle.cpp.

References DEBUG_COND, MSBaseVehicle::getID(), getLateralPositionOnLane(), MSLane::getParallelLane(), MSBaseVehicle::getWidth(), MSLane::getWidth(), myLane, NUMERICAL_EPS, and SIMTIME.

Referenced by MSLCM_SL2015::_wantsChangeSublane(), MSAbstractLaneChangeModel::checkTraCICommands(), and getLateralPositionOnLane().

◆ leaveLane()

◆ loadState()

◆ nextLinkPriority()

int MSVehicle::nextLinkPriority ( const std::vector< MSLane *> &  conts)
static

get a numerical value for the priority of the upcoming link

Definition at line 3993 of file MSVehicle.cpp.

References MSLinkContHelper::getConnectingLink(), and MSLink::havePriority().

Referenced by hasInfluencer(), and updateBestLanes().

◆ nextStopDist()

◆ onDepart()

void MSBaseVehicle::onDepart ( )
virtualinherited

Called when the vehicle is inserted into the network.

Sets optional information about departure time, informs the vehicle control about a further running vehicle.

Implements SUMOVehicle.

Definition at line 292 of file MSBaseVehicle.cpp.

References MSNet::getCurrentTimeStep(), MSNet::getInstance(), SUMOVehicle::getPositionOnLane(), MSNet::getVehicleControl(), MSBaseVehicle::myDepartPos, MSBaseVehicle::myDeparture, and MSVehicleControl::vehicleDeparted().

Referenced by enterLaneAtInsertion(), MSBaseVehicle::getCurrentRouteEdge(), MSVehicle::Influencer::postProcessRemoteControl(), and MESegment::receive().

◆ onFurtherEdge()

bool MSVehicle::onFurtherEdge ( const MSEdge edge) const

whether this vehicle has its back (and no its front) on the given edge

Definition at line 4614 of file MSVehicle.cpp.

References myFurtherLanes.

Referenced by getFurtherLanesPosLat().

◆ onRemovalFromNet()

void MSVehicle::onRemovalFromNet ( const MSMoveReminder::Notification  reason)

Called when the vehicle is removed from the network.

Moves along work reminders and informs all devices about quitting. Calls "leaveLane" then.

Parameters
[in]reasonwhy the vehicle leaves (reached its destination, parking, teleport)

Definition at line 709 of file MSVehicle.cpp.

References DEBUG_COND, MSBaseVehicle::getID(), MSVehicleTransfer::getInstance(), leaveLane(), myLFLinkLanes, MSVehicleTransfer::remove(), removeApproachingInformation(), SIMTIME, and toString().

Referenced by MSVehicleTransfer::add(), MSLane::detectCollisions(), MSLane::executeMovements(), libsumo::Vehicle::moveTo(), MSVehicle::Influencer::postProcessRemoteControl(), TraCIServerAPI_Vehicle::processSet(), and MSCalibrator::removePending().

◆ operator=()

MSVehicle& MSVehicle::operator= ( const MSVehicle )
private

invalidated assignment operator

◆ overlap()

static bool MSVehicle::overlap ( const MSVehicle veh1,
const MSVehicle veh2 
)
inlinestatic

Returns true if the two vehicles overlap.

Definition at line 704 of file MSVehicle.h.

References MSVehicleType::getLengthWithGap(), MSBaseVehicle::getVehicleType(), MSVehicle::State::myPos, and myState.

◆ passingMinor()

bool MSVehicle::passingMinor ( ) const

decide whether the vehicle is passing a minor link or has comitted to do so

Definition at line 4916 of file MSVehicle.cpp.

References MSLane::getEdge(), MSLink::getFoeVisibilityDistance(), MSLane::getIncomingLanes(), MSLink::havePriority(), MSEdge::isInternal(), myLane, and myLFLinkLanes.

Referenced by MSCFModel_Krauss::moveHelper(), and signalSet().

◆ planMove()

void MSVehicle::planMove ( const SUMOTime  t,
const MSLeaderInfo ahead,
const double  lengthsInFront 
)

Compute safe velocities for the upcoming lanes based on positions and speeds from the last time step. Also registers ApproachingVehicleInformation for all links.

This method goes through the best continuation lanes of the current lane and computes the safe velocities for passing/stopping at the next link as a DriveProcessItem

Afterwards it checks if any DriveProcessItem should be discarded to avoid blocking a junction (checkRewindLinkLanes).

Finally the ApproachingVehicleInformation is registered for all links that shall be passed

Parameters
[in]tThe current timeStep
[in]aheadThe leaders (may be 0)
[in]lengthsInFrontSum of vehicle lengths in front of the vehicle

Definition at line 1637 of file MSVehicle.cpp.

References checkActionStep(), checkRewindLinkLanes(), DEBUG_COND, Named::getID(), MSBaseVehicle::getID(), getLaneChangeModel(), getLateralPositionOnLane(), getPositionOnLane(), getSpeed(), myLane, myLFLinkLanes, myNextDriveItem, myStopDist, planMoveInternal(), removePassedDriveItems(), MSAbstractLaneChangeModel::resetChanged(), and STEPS2TIME.

◆ planMoveInternal()

void MSVehicle::planMoveInternal ( const SUMOTime  t,
MSLeaderInfo  ahead,
DriveItemVector lfLinks,
double &  myStopDist 
) const
protected
Todo:
: documentation

Definition at line 1706 of file MSVehicle.cpp.

References MSVehicle::DriveProcessItem::adaptLeaveSpeed(), adaptToLeaders(), MSLeaderInfo::addLeader(), ARRIVAL_SPEED_GIVEN, SUMOVehicleParameter::arrivalSpeed, SUMOVehicleParameter::arrivalSpeedProcedure, MSCFModel::brakeGap(), checkLinkLeader(), MSLeaderInfo::clear(), CRLL_LOOK_AHEAD, DEBUG_COND, DELTA_T, DIST_TO_STOPLINE_EXPECT_PRIORITY, MSRoute::end(), estimateLeaveSpeed(), MSCFModel::estimateSpeedAfterDistance(), MSCFModel::freeSpeed(), getBestLanesContinuation(), getCarFollowModel(), MSAbstractLaneChangeModel::getCommittedSpeed(), MSLane::getEdge(), MSVehicle::Stop::getEndPos(), Named::getID(), MSBaseVehicle::getID(), MSLane::getIncomingLanes(), MSNet::getInstance(), getLane(), getLaneChangeModel(), MSLane::getLastVehicleInformation(), getLateralOverlap(), MSVehicleType::getLength(), MSLane::getLength(), MSLane::getLinkCont(), MSCFModel::getMaxAccel(), MSCFModel::getMaxDecel(), MSCFModel::getMinimalArrivalSpeed(), MSCFModel::getMinimalArrivalSpeedEuler(), MSCFModel::getMinimalArrivalTime(), MSPModel::getModel(), MSLane::getOpposite(), MSLane::getOppositeLeader(), MSLane::getParallelLane(), MSLink::getParallelLink(), MSBaseVehicle::getParameter(), MSEdge::getPersons(), getPositionOnLane(), MSLane::getRightSideOnEdge(), getRightSideOnLane(), MSAbstractLaneChangeModel::getShadowLane(), getSpeed(), MSLane::getVehicleMaxSpeed(), MSLane::getVehicleNumber(), MSBaseVehicle::getVehicleType(), MSVehicleType::getWidth(), MSBaseVehicle::getWidth(), MSEdge::getWidth(), MSGlobals::gSemiImplicitEulerUpdate, MSGlobals::gUsingInternalLanes, MSPModel::hasPedestrians(), ignoreRed(), MSVehicle::Influencer::influenceSpeed(), MSEdge::isFringe(), MSEdge::isInternal(), MSLane::isLinkEnd(), MSAbstractLaneChangeModel::isOpposite(), LINKDIR_LEFT, LINKDIR_RIGHT, MAX2(), MSCFModel::maximumSafeStopSpeed(), MSCFModel::maxNextSpeed(), MIN2(), MSCFModel::minNextSpeed(), MSBaseVehicle::myArrivalPos, MSBaseVehicle::myCurrEdge, myInfluencer, myLane, MSBaseVehicle::myParameter, MSVehicle::State::myPos, MSBaseVehicle::myRoute, MSVehicle::State::mySpeed, myState, myStops, MSPModel::nextBlocking(), NUMERICAL_EPS, POSITION_EPS, removeApproachingInformation(), SIMTIME, SPEED2DIST, STEPS2TIME, MSCFModel::stopSpeed(), MSLane::succLinkSec(), SUMO_ATTR_JM_DRIVE_RED_SPEED, TIME2STEPS, and toString().

Referenced by planMove().

◆ processLaneAdvances()

void MSVehicle::processLaneAdvances ( std::vector< MSLane *> &  passedLanes,
bool &  moved,
std::string &  emergencyReason 
)
protected

This method checks if the vehicle has advanced over one or several lanes along its route and triggers the corresponding actions for the lanes and the vehicle. and adapts the given in/out parameters to the appropriate values.

Parameters
[out]passedLanesLanes, which the vehicle touched at some moment of the executed simstep
[out]movedWhether the vehicle did move to another lane
[out]emergencyReasonReason for a possible emergency stop

Definition at line 2719 of file MSVehicle.cpp.

References DEBUG_COND, MSRoute::end(), MSAbstractLaneChangeModel::endLaneChangeManeuver(), enterLaneAtMove(), MSLink::getDirection(), MSLane::getEdge(), MSVehicle::Influencer::getEmergencyBrakeRedLight(), MSBaseVehicle::getID(), MSNet::getInstance(), getLaneChangeModel(), MSLane::getLength(), MSLink::getViaLane(), MSLink::getViaLaneOrLane(), MSGlobals::gUsingInternalLanes, hasArrived(), MSLink::haveRed(), ignoreRed(), MSEdge::isVaporizing(), leaveLane(), LINKDIR_LEFT, LINKDIR_RIGHT, MSBaseVehicle::myCurrEdge, myFurtherLanes, myInfluencer, myLane, myLFLinkLanes, myNextDriveItem, MSVehicle::State::myPos, MSBaseVehicle::myRoute, myState, MSMoveReminder::NOTIFICATION_JUNCTION, MSMoveReminder::NOTIFICATION_VAPORIZED, NUMERICAL_EPS, MSLink::passedJunction(), time2string(), and WRITE_WARNING.

Referenced by executeMove(), and hasInfluencer().

◆ processLinkAproaches()

◆ processNextStop()

double MSVehicle::processNextStop ( double  currentVelocity)

Processes stops, returns the velocity needed to reach the stop.

Returns
The velocity in dependance to the next/current stop
Todo:
Describe more detailed
See also
Stop
MSStoppingPlace
MSStoppingPlace

Definition at line 1376 of file MSVehicle.cpp.

References activateReminders(), MSStopOut::active(), MSBaseVehicle::addReminder(), MSVehicleControl::addWaiting(), MSTransportableControl::boardAnyWaiting(), MSVehicle::Stop::busstop, MSVehicle::Stop::containerstop, MSVehicle::Stop::containerTriggered, DEBUG_COND, MSVehicle::Stop::duration, MSVehicle::Stop::edge, SUMOVehicleParameter::Stop::endPos, MSParkingArea::enter(), MSStoppingPlace::enter(), getActionStepLength(), MSStoppingPlace::getBeginLanePosition(), MSParkingArea::getCapacity(), getCarFollowModel(), MSNet::getContainerControl(), getContainerNumber(), MSNet::getCurrentTimeStep(), MSLane::getEdge(), MSStoppingPlace::getEndLanePosition(), MSVehicle::Stop::getEndPos(), Named::getID(), MSBaseVehicle::getID(), MSStopOut::getInstance(), MSNet::getInstance(), MSParkingArea::getLastFreePos(), MSStoppingPlace::getLastFreePos(), MSVehicleType::getLength(), MSLane::getLength(), MSVehicleType::getMinGap(), MSLane::getMoveReminders(), MSParkingArea::getOccupancy(), MSNet::getPersonControl(), getPersonNumber(), getSpeed(), MSDevice_Transportable::getTransportables(), MSNet::getVehicleControl(), MSBaseVehicle::getVehicleType(), MSGlobals::gSemiImplicitEulerUpdate, MSNet::hasContainers(), MSNet::hasPersons(), MSNet::informVehicleStateListener(), MSEdge::isInternal(), isOnRoad(), keepStopping(), MSVehicle::Stop::lane, MSTransportableControl::loadAnyWaiting(), MAX2(), myAmRegisteredAsWaitingForContainer, myAmRegisteredAsWaitingForPerson, myContainerDevice, MSBaseVehicle::myCurrEdge, myLane, myPersonDevice, MSVehicle::State::myPos, MSVehicle::State::mySpeed, myState, myStops, MSBaseVehicle::myType, MSMoveReminder::NOTIFICATION_PARKING_REROUTE, NUMERICAL_EPS, MSVehicle::Stop::numExpectedContainer, MSVehicle::Stop::numExpectedPerson, MSVehicle::Stop::parkingarea, MSVehicle::Stop::pars, MSVehicle::State::pos(), MSVehicle::Stop::reached, MSVehicleControl::registerOneWaiting(), MSStoppingPlace::removeTransportable(), resumeFromStopping(), SIMTIME, SUMOVehicleParameter::Stop::startPos, STEPS2TIME, STOPPING_PLACE_OFFSET, MSCFModel::stopSpeed(), MSStopOut::stopStarted(), SUMO_const_haltingSpeed, MSVehicle::Stop::triggered, MSVehicleControl::unregisterOneWaiting(), SUMOVehicleParameter::Stop::until, MSNet::VEHICLE_STATE_STARTING_STOP, and WRITE_WARNING.

Referenced by MSVehicleTransfer::checkInsertions(), MSVehicleTransfer::loadState(), MSLane::loadState(), MSCFModel_Rail::moveHelper(), MSCFModel_KraussOrig1::moveHelper(), MSCFModel_Krauss::moveHelper(), MSCFModel_Daniel1::moveHelper(), MSCFModel_SmartSK::moveHelper(), MSCFModel_KraussX::moveHelper(), MSCFModel::moveHelper(), and nextStopDist().

◆ processTraCISpeedControl()

void MSVehicle::processTraCISpeedControl ( double  vSafe,
double &  vNext 
)
protected

Check for speed advices from the traci client and adjust the speed vNext in the current (euler) / after the current (ballistic) simstep accordingly.

Parameters
[in]vSafeThe maximal safe (or admissible) velocity as determined from stops, junction approaches, car following, lane changing, etc.

Definition at line 2449 of file MSVehicle.cpp.

References MSVehicleType::getCarFollowModel(), getCarFollowModel(), MSNet::getInstance(), MSBaseVehicle::getVehicleType(), MSVehicle::Influencer::implicitSpeedRemote(), MSVehicle::Influencer::influenceSpeed(), MSVehicle::Influencer::isRemoteControlled(), MAX2(), MSCFModel::maxNextSpeed(), myInfluencer, MSVehicle::State::mySpeed, and myState.

Referenced by executeMove(), and hasInfluencer().

◆ removeApproachingInformation()

void MSVehicle::removeApproachingInformation ( DriveItemVector lfLinks) const
protected

unregister approach from all upcoming links

Definition at line 4500 of file MSVehicle.cpp.

References getLaneChangeModel(), and MSAbstractLaneChangeModel::removeShadowApproachingInformation().

Referenced by executeMove(), onRemovalFromNet(), planMoveInternal(), and ~MSVehicle().

◆ removePassedDriveItems()

void MSVehicle::removePassedDriveItems ( )
protected

Erase passed drive items from myLFLinkLanes (and unregister approaching information for corresponding links). Further, myNextDriveItem is reset.

Note
This is called in planMove() if the vehicle has no actionstep. All items until the position myNextDriveItem are deleted. This can happen if myNextDriveItem was increased in processLaneAdvances() of the previous step.

Definition at line 2462 of file MSVehicle.cpp.

References DEBUG_COND, Named::getID(), MSBaseVehicle::getID(), myLFLinkLanes, myNextDriveItem, and SIMTIME.

Referenced by hasInfluencer(), and planMove().

◆ removeReminder()

void MSBaseVehicle::removeReminder ( MSMoveReminder rem)
inherited

Removes a MoveReminder dynamically.

Parameters
[in]remthe reminder to remove
See also
MSMoveReminder

Definition at line 360 of file MSBaseVehicle.cpp.

References MSBaseVehicle::myMoveReminders.

Referenced by MSBaseVehicle::getDevices().

◆ removeTransportable()

void MSVehicle::removeTransportable ( MSTransportable t)

removes a person or container

Definition at line 4217 of file MSVehicle.cpp.

References myContainerDevice, myPersonDevice, and MSDevice_Transportable::removeTransportable().

Referenced by nextStopDist().

◆ replaceParkingArea()

◆ replaceRoute()

bool MSVehicle::replaceRoute ( const MSRoute route,
bool  onInit = false,
int  offset = 0,
bool  addStops = true,
bool  removeStops = true 
)
virtual

Replaces the current route by the given one.

It is possible that the new route is not accepted, if it does not contain the vehicle's current edge.

Parameters
[in]routeThe new route to pass
[in]removeStopsWhether stops should be removed if they do not fit onto the new route
Returns
Whether the new route was accepted

Implements SUMOVehicle.

Definition at line 732 of file MSVehicle.cpp.

References MSRoute::addReference(), addStop(), MSBaseVehicle::addStops(), MSRoute::begin(), MSBaseVehicle::calculateArrivalParams(), MSRoute::contains(), MSGlobals::gCheckRoutes, MSLane::getEdge(), MSRoute::getEdges(), MSNet::getInstance(), MSLane::getOutgoingLanes(), MSRoute::getStops(), MSNet::informVehicleStateListener(), MSEdge::isInternal(), MSBaseVehicle::myCurrEdge, myLane, myLastBestLanesEdge, myLastBestLanesInternalLane, MSBaseVehicle::myNumberReroutes, MSBaseVehicle::myRoute, myStops, MSRoute::release(), updateBestLanes(), MSNet::VEHICLE_STATE_NEWROUTE, and WRITE_WARNING.

Referenced by libsumo::Vehicle::setRouteID().

◆ replaceRouteEdges()

bool MSBaseVehicle::replaceRouteEdges ( ConstMSEdgeVector edges,
bool  onInit = false,
bool  check = false,
bool  removeStops = true 
)
virtualinherited

Replaces the current route by the given edges.

It is possible that the new route is not accepted, if a) it does not contain the vehicle's current edge, or b) something fails on insertion into the routes container (see in-line comments).

Parameters
[in]edgesThe new list of edges to pass
[in]onInitWhether the vehicle starts with this route
[in]checkWhether the route should be checked for validity
[in]removeStopsWhether stops should be removed if they do not fit onto the new route
Returns
Whether the new route was accepted

Implements SUMOVehicle.

Definition at line 227 of file MSBaseVehicle.cpp.

References MSRoute::addReference(), MSRoute::begin(), RGBColor::DEFAULT_COLOR, MSRoute::dictionary(), MSGlobals::gCheckRoutes, MSRoute::getColor(), MSRoute::getEdges(), Named::getID(), MSBaseVehicle::getID(), MSBaseVehicle::getNumberReroutes(), MSBaseVehicle::getRerouteOrigin(), MSBaseVehicle::hasValidRoute(), MSBaseVehicle::myCurrEdge, MSBaseVehicle::myRoute, MSRoute::release(), SUMOVehicle::replaceRoute(), MSRoute::size(), toString(), and WRITE_WARNING.

Referenced by libsumo::Vehicle::changeTarget(), MSBaseVehicle::getCurrentRouteEdge(), MSVehicle::Influencer::postProcessRemoteControl(), MSBaseVehicle::reroute(), and libsumo::Vehicle::setRoute().

◆ replaceVehicleType()

void MSBaseVehicle::replaceVehicleType ( MSVehicleType type)
inherited

Replaces the current vehicle type by the one given.

If the currently used vehicle type is marked as being used by this vehicle only, it is deleted, first. The new, given type is then assigned to "myType".

Parameters
[in]typeThe new vehicle type
See also
MSBaseVehicle::myType

Definition at line 550 of file MSBaseVehicle.cpp.

References MSNet::getInstance(), MSNet::getVehicleControl(), MSVehicleType::isVehicleSpecific(), MSBaseVehicle::myType, and MSVehicleControl::removeVType().

Referenced by MSBaseVehicle::getSingularType(), MSBaseVehicle::setChosenSpeedFactor(), and libsumo::Vehicle::setType().

◆ reroute()

void MSBaseVehicle::reroute ( SUMOTime  t,
SUMOAbstractRouter< MSEdge, SUMOVehicle > &  router,
const bool  onInit = false,
const bool  withTaz = false 
)
virtualinherited

◆ resetActionOffset()

void MSVehicle::resetActionOffset ( const SUMOTime  timeUntilNextAction = 0)

Resets the action offset for the vehicle.

Parameters
[in]timeUntilNextActiontime interval from now for the next action, defaults to 0, which implies an immediate action point in the current step.

Definition at line 1613 of file MSVehicle.cpp.

References MSNet::getCurrentTimeStep(), MSNet::getInstance(), and myLastActionTime.

Referenced by libsumo::Vehicle::setActionStepLength(), MSVehicleType::setActionStepLength(), and updateActionOffset().

◆ resetRoutePosition()

void MSVehicle::resetRoutePosition ( int  index)

◆ resumeFromStopping()

◆ saveState()

◆ setAngle()

void MSVehicle::setAngle ( double  angle,
bool  straightenFurther = false 
)

Set a custom vehicle angle in rad, optionally updates furtherLanePosLat.

Definition at line 1024 of file MSVehicle.cpp.

References DEBUG_COND, MSBaseVehicle::getID(), getLateralPositionOnLane(), myAngle, myFurtherLanesPosLat, and SIMTIME.

Referenced by getVelocityVector(), MSVehicle::Influencer::postProcessRemoteControl(), and MSLaneChangerSublane::startChangeSublane().

◆ setArrivalPos()

virtual void MSBaseVehicle::setArrivalPos ( double  arrivalPos)
inlinevirtualinherited

Sets this vehicle's desired arrivalPos for its current route.

Implements SUMOVehicle.

Definition at line 275 of file MSBaseVehicle.h.

References MSBaseVehicle::hasArrived(), MSBaseVehicle::hasDeparted(), and MSBaseVehicle::myArrivalPos.

◆ setBlinkerInformation()

◆ setBrakingSignals()

void MSVehicle::setBrakingSignals ( double  vNext)
protected

sets the braking lights on/off

Definition at line 2676 of file MSVehicle.cpp.

References ACCEL2SPEED, getSpeed(), isStopped(), SUMO_const_haltingSpeed, switchOffSignal(), switchOnSignal(), and VEH_SIGNAL_BRAKELIGHT.

Referenced by executeMove(), and hasInfluencer().

◆ setChosenSpeedFactor()

void MSBaseVehicle::setChosenSpeedFactor ( const double  factor)
inlinevirtualinherited

Returns the precomputed factor by which the driver wants to be faster than the speed limit.

Returns
Speed limit factor

Implements SUMOVehicle.

Definition at line 384 of file MSBaseVehicle.h.

References MSBaseVehicle::addStops(), MSBaseVehicle::getDevice(), MSBaseVehicle::getSingularType(), MSBaseVehicle::myChosenSpeedFactor, MSBaseVehicle::replaceVehicleType(), and MSBaseVehicle::saveState().

Referenced by TraCIServerAPI_Vehicle::processSet().

◆ setDeviceParameter()

void MSBaseVehicle::setDeviceParameter ( const std::string &  deviceName,
const std::string &  key,
const std::string &  value 
)
inherited

try to set the given parameter from any of the vehicles devices, raise InvalidArgument if no device parameter by that name exists

Definition at line 538 of file MSBaseVehicle.cpp.

References MSBaseVehicle::myDevices.

Referenced by libsumo::Vehicle::setParameter().

◆ setEmergencyBlueLight()

void MSVehicle::setEmergencyBlueLight ( SUMOTime  currentTime)
protected

sets the blue flashing light for emergency vehicles

Definition at line 4302 of file MSVehicle.cpp.

References signalSet(), switchOffSignal(), switchOnSignal(), and VEH_SIGNAL_EMERGENCY_BLUE.

Referenced by executeMove(), and hasInfluencer().

◆ setRemoteState()

void MSVehicle::setRemoteState ( Position  xyPos)

sets position outside the road network

Definition at line 4849 of file MSVehicle.cpp.

References myCachedPosition.

Referenced by hasInfluencer(), and MSVehicle::Influencer::postProcessRemoteControl().

◆ setTentativeLaneAndPosition()

void MSVehicle::setTentativeLaneAndPosition ( MSLane lane,
double  pos,
double  posLat = 0 
)

set tentative lane and position during insertion to ensure that all cfmodels work (some of them require veh->getLane() to return a valid lane) Once the vehicle is sucessfully inserted the lane is set again (see enterLaneAtInsertion)

Definition at line 4321 of file MSVehicle.cpp.

References MSVehicleType::getLength(), MSBaseVehicle::getVehicleType(), MSVehicle::State::myBackPos, myLane, MSVehicle::State::myPos, MSVehicle::State::myPosLat, and myState.

Referenced by congested(), MSLane::freeInsertion(), MSLane::isInsertionSuccess(), MSLane::lastInsertion(), MSVehicleTransfer::loadState(), and libsumo::Vehicle::moveTo().

◆ signalSet()

bool MSVehicle::signalSet ( int  which) const
inline

◆ succEdge()

const MSEdge * MSBaseVehicle::succEdge ( int  nSuccs) const
virtualinherited

Returns the nSuccs'th successor of edge the vehicle is currently at.

If the rest of the route (counted from the current edge) has less than nSuccs edges, 0 is returned.

Parameters
[in]nSuccsThe number of edge to look forward
Returns
The nSuccs'th following edge in the vehicle's route

Implements SUMOVehicle.

Definition at line 139 of file MSBaseVehicle.cpp.

References MSRoute::begin(), MSBaseVehicle::myCurrEdge, and MSBaseVehicle::myRoute.

Referenced by MSVehicleTransfer::add(), MSLane::appropriate(), MSVehicleTransfer::checkInsertions(), MESegment::getLink(), MSBaseVehicle::getVClass(), MSBaseVehicle::hasArrived(), MSPedestrianPushButton::isActiveForEdge(), libsumo::Vehicle::moveTo(), MELoop::nextSegment(), and MESegment::receive().

◆ switchOffSignal()

void MSVehicle::switchOffSignal ( int  signal)
inline

Switches the given signal off.

Parameters
[in]signalThe signal to mark as being switched off

Definition at line 1223 of file MSVehicle.h.

References mySignals.

Referenced by MSAbstractLaneChangeModel::endLaneChangeManeuver(), setBlinkerInformation(), setBrakingSignals(), setEmergencyBlueLight(), libsumo::Vehicle::setSignals(), and MSAbstractLaneChangeModel::startLaneChangeManeuver().

◆ switchOnSignal()

void MSVehicle::switchOnSignal ( int  signal)
inline

Switches the given signal on.

Parameters
[in]signalThe signal to mark as being switched on

Definition at line 1215 of file MSVehicle.h.

References mySignals.

Referenced by setBlinkerInformation(), setBrakingSignals(), setEmergencyBlueLight(), libsumo::Vehicle::setSignals(), and MSAbstractLaneChangeModel::startLaneChangeManeuver().

◆ unsafeLinkAhead()

◆ updateActionOffset()

void MSVehicle::updateActionOffset ( const SUMOTime  oldActionStepLength,
const SUMOTime  newActionStepLength 
)

Process an updated action step length value (only affects the vehicle's action offset, The actionStepLength is stored in the (singular) vtype)

Parameters
[in]oldActionStepLengthThe action step length previous to the update
[in]actionStepLengthThe new action step length (stored in the vehicle's vtype).
Note
The current action step length is updated. This implies an immediate action point, if the new step length is smaller than the length of the currently running action interval (the difference between now and the last action time).

Definition at line 1618 of file MSVehicle.cpp.

References MSNet::getCurrentTimeStep(), MSNet::getInstance(), myLastActionTime, and resetActionOffset().

Referenced by libsumo::Vehicle::setActionStepLength(), and MSVehicleType::setActionStepLength().

◆ updateBestLanes()

void MSVehicle::updateBestLanes ( bool  forceRebuild = false,
const MSLane startLane = 0 
)

computes the best lanes to use in order to continue the route

The information is rebuilt if the vehicle is on a different edge than the one stored in "myLastBestLanesEdge" or "forceRebuild" is true.

Otherwise, only the density changes on the stored lanes are adapted to the container only.

A rebuild must be done if the vehicle leaves a stop; then, another lane may become the best one.

If no starting lane ("startLane") is given, the vehicle's current lane ("myLane") is used as start of bect lanes building.

Parameters
[in]forceRebuildWhether the best lanes container shall be rebuilt even if the vehicle's edge has not changed
[in]startLaneThe lane the process shall start at ("myLane" will be used if ==0)

Definition at line 3692 of file MSVehicle.cpp.

References MSEdge::allowedLanes(), MSVehicle::LaneQ::allowsContinuation, MSLane::allowsVehicleClass(), ARRIVAL_LANE_GIVEN, SUMOVehicleParameter::arrivalLaneProcedure, MSVehicle::LaneQ::bestContinuations, MSVehicle::LaneQ::bestLaneOffset, MSEdge::clear(), MSVehicle::LaneQ::currentLength, DEBUG_COND, MSVehicle::Stop::edge, MSRoute::end(), getBestLanesContinuation(), MSLane::getEdge(), Named::getID(), MSBaseVehicle::getID(), Named::getIDSecure(), getLaneChangeModel(), MSEdge::getLanes(), MSLane::getLength(), MSLane::getLinkCont(), MSLane::getLogicalPredecessorLane(), MSLane::getNextNormal(), MSLane::getOpposite(), MSVehicleType::getVehicleClass(), MSEdge::isInternal(), MSLane::isInternal(), MSVehicle::LaneQ::lane, MSVehicle::Stop::lane, MSVehicle::LaneQ::length, MAX2(), MIN2(), MSBaseVehicle::myArrivalLane, MSBaseVehicle::myArrivalPos, myBestLanes, MSBaseVehicle::myCurrEdge, myCurrentLaneInBestLanes, myLane, myLastBestLanesEdge, myLastBestLanesInternalLane, MSBaseVehicle::myParameter, MSBaseVehicle::myRoute, myStops, MSBaseVehicle::myType, nextLinkPriority(), MSVehicle::LaneQ::nextOccupation, MSVehicle::LaneQ::occupation, MSVehicle::Stop::pars, POSITION_EPS, SIMTIME, SUMOVehicleParameter::Stop::startPos, toString(), and updateOccupancyAndCurrentBestLane().

Referenced by addTraciStop(), addTraciStopAtStoppingPlace(), MSLaneChangerSublane::change(), MSLaneChanger::change(), enterLaneAtLaneChange(), executeMove(), MSLane::forceVehicleInsertion(), MSEdge::getDepartLane(), MSLane::isInsertionSuccess(), MSLane::lastInsertion(), MSLane::loadState(), MSVehicle::Influencer::postProcessRemoteControl(), replaceParkingArea(), replaceRoute(), and resumeFromStopping().

◆ updateDriveItems()

void MSVehicle::updateDriveItems ( )

Check whether the drive items (myLFLinkLanes) are up to date, and update them if required.

Note
This is the case if a lane change was completed. Only the links corresponding to the drive items are updated to the corresponding parallel links.

Definition at line 2516 of file MSVehicle.cpp.

References DEBUG_COND, getBestLanesContinuation(), Named::getID(), MSBaseVehicle::getID(), getLane(), MSLink::getLaneBefore(), MSLane::getLinkTo(), MSLink::getParallelLink(), MSLane::isInternal(), myLane, myLFLinkLanes, myNextDriveItem, MSLink::removeApproaching(), and SIMTIME.

Referenced by congested(), and MSAbstractLaneChangeModel::laneChangeOutput().

◆ updateFurtherLanes()

double MSVehicle::updateFurtherLanes ( std::vector< MSLane *> &  furtherLanes,
std::vector< double > &  furtherLanesPosLat,
const std::vector< MSLane *> &  passedLanes 
)

update a vector of further lanes and return the new backPos

Definition at line 3054 of file MSVehicle.cpp.

References DEBUG_COND, MSBaseVehicle::getLength(), MSVehicle::State::myPos, MSVehicle::State::myPosLat, myState, SIMTIME, and toString().

Referenced by executeMove(), signalSet(), and MSAbstractLaneChangeModel::updateShadowLane().

◆ updateOccupancyAndCurrentBestLane()

void MSVehicle::updateOccupancyAndCurrentBestLane ( const MSLane startLane)
protected

updates LaneQ::nextOccupation and myCurrentLaneInBestLanes

Definition at line 4009 of file MSVehicle.cpp.

References myBestLanes, and myCurrentLaneInBestLanes.

Referenced by hasInfluencer(), and updateBestLanes().

◆ updateState()

void MSVehicle::updateState ( double  vNext)
protected

updates the vehicles state, given a next value for its speed. This value can be negative in case of the ballistic update to indicate a stop within the next timestep. (You can call this a 'hack' to emulate reasoning based on accelerations: The assumed constant acceleration a within the next time step is then a = (vNext - vCurrent)/TS )

Parameters
[in]vNextspeed in the next time step

Definition at line 3000 of file MSVehicle.cpp.

References DEBUG_COND, getDeltaPos(), MSBaseVehicle::getID(), getLaneChangeModel(), MSLane::getOpposite(), MSLane::getOppositePos(), MSGlobals::gSemiImplicitEulerUpdate, MSVehicle::Influencer::implicitDeltaPosRemote(), Position::INVALID, MSVehicle::Influencer::isRemoteControlled(), MAX2(), myAcceleration, myCachedPosition, myInfluencer, myLane, MSVehicle::State::myLastCoveredDist, MSVehicle::State::myPos, MSVehicle::State::myPreviousSpeed, MSVehicle::State::mySpeed, myState, SIMTIME, SPEED2ACCEL, and SPEED2DIST.

Referenced by estimateLeaveSpeed(), and executeMove().

◆ updateTimeLoss()

void MSVehicle::updateTimeLoss ( double  vNext)
protected

Updates the vehicle's time loss.

Definition at line 2707 of file MSVehicle.cpp.

References MSLane::getVehicleMaxSpeed(), isStopped(), myLane, myTimeLoss, and TS.

Referenced by executeMove(), and hasInfluencer().

◆ updateWaitingTime()

void MSVehicle::updateWaitingTime ( double  vNext)
protected

Updates the vehicle's waiting time counters (accumulated and consecutive)

Definition at line 2695 of file MSVehicle.cpp.

References DELTA_T, isStopped(), myWaitingTime, myWaitingTimeCollector, MSVehicle::WaitingTimeCollector::passTime(), and SUMO_const_haltingSpeed.

Referenced by executeMove(), and hasInfluencer().

◆ validatePosition()

Position MSVehicle::validatePosition ( Position  result,
double  offset = 0 
) const
protected

ensure that a vehicle-relative position is not invalid

Definition at line 995 of file MSVehicle.cpp.

References getLateralPositionOnLane(), MSBaseVehicle::getLength(), Position::INVALID, and myFurtherLanes.

Referenced by getPosition(), and hasInfluencer().

◆ wasRemoteControlled()

bool MSVehicle::wasRemoteControlled ( SUMOTime  lookBack = DELTA_T) const

Returns the information whether the vehicle is fully controlled via TraCI within the lookBack time.

Definition at line 4862 of file MSVehicle.cpp.

References MSNet::getCurrentTimeStep(), MSNet::getInstance(), MSVehicle::Influencer::getLastAccessTimeStep(), and myInfluencer.

Referenced by hasStops(), and libsumo::Vehicle::isVisible().

◆ willPass()

bool MSVehicle::willPass ( const MSEdge *const  edge) const

Returns whether the vehicle wil pass the given edge.

Parameters
[in]Theedge to find in the vehicle's current route
Returns
Whether the given edge will be passed by the vehicle
Todo:
Move to MSRoute?

Definition at line 796 of file MSVehicle.cpp.

References MSRoute::end(), MSBaseVehicle::myCurrEdge, and MSBaseVehicle::myRoute.

Referenced by libsumo::Vehicle::moveTo().

◆ workOnMoveReminders()

void MSVehicle::workOnMoveReminders ( double  oldPos,
double  newPos,
double  newSpeed 
)

Processes active move reminder.

This method goes through all active move reminder, both those for the current lane, stored in "myMoveReminders" and those of prior lanes stored in "myOldLaneMoveReminders" calling "MSMoveReminder::notifyMove".

When processing move reminder from "myOldLaneMoveReminders", the offsets (prior lane lengths) are used, which are stored in "myOldLaneMoveReminderOffsets".

Each move reminder which is no longer active is removed from the container.

Parameters
[in]oldPosThe position the vehicle had before it has moved
[in]newPosThe position the vehicle has after it has moved
[in]newSpeedThe vehicle's speed within this move
See also
MSMoveReminder

Definition at line 839 of file MSVehicle.cpp.

References MAX2(), and MSBaseVehicle::myMoveReminders.

Referenced by executeMove().

Friends And Related Function Documentation

◆ MSLaneChanger

friend class MSLaneChanger
friend

the lane changer sets myLastLaneChangeOffset

Definition at line 87 of file MSVehicle.h.

◆ MSLaneChangerSublane

friend class MSLaneChangerSublane
friend

Definition at line 88 of file MSVehicle.h.

Field Documentation

◆ myAcceleration

double MSVehicle::myAcceleration
protected

◆ myActionStep

bool MSVehicle::myActionStep
protected

The flag myActionStep indicates whether the current time step is an action point for the vehicle.

Definition at line 1682 of file MSVehicle.h.

Referenced by checkActionStep(), executeMove(), and isActive().

◆ myAmOnNet

bool MSVehicle::myAmOnNet
protected

Whether the vehicle is on the network (not parking, teleported, vaporized, or arrived)

Definition at line 1733 of file MSVehicle.h.

Referenced by enterLaneAtInsertion(), enterLaneAtLaneChange(), enterLaneAtMove(), isOnRoad(), and leaveLane().

◆ myAmRegisteredAsWaitingForContainer

bool MSVehicle::myAmRegisteredAsWaitingForContainer
protected

Whether this vehicle is registered as waiting for a container (for deadlock-recognition)

Definition at line 1739 of file MSVehicle.h.

Referenced by processNextStop(), and resumeFromStopping().

◆ myAmRegisteredAsWaitingForPerson

bool MSVehicle::myAmRegisteredAsWaitingForPerson
protected

Whether this vehicle is registered as waiting for a person (for deadlock-recognition)

Definition at line 1736 of file MSVehicle.h.

Referenced by processNextStop(), and resumeFromStopping().

◆ myAngle

double MSVehicle::myAngle
protected

the angle in radians (

Todo:
consider moving this into myState)

Definition at line 1744 of file MSVehicle.h.

Referenced by MSLaneChanger::continueChange(), enterLaneAtInsertion(), enterLaneAtLaneChange(), executeMove(), getAngle(), getVelocityVector(), and setAngle().

◆ myArrivalLane

int MSBaseVehicle::myArrivalLane
protectedinherited

The destination lane where the vehicle stops.

Definition at line 487 of file MSBaseVehicle.h.

Referenced by MSBaseVehicle::calculateArrivalParams(), and updateBestLanes().

◆ myArrivalPos

double MSBaseVehicle::myArrivalPos
protectedinherited

◆ myBestLanes

std::vector<std::vector<LaneQ> > MSVehicle::myBestLanes
protected

◆ myCachedPosition

◆ myCFVariables

MSCFModel::VehicleVariables* MSVehicle::myCFVariables
private

The per vehicle variables of the car following model.

Definition at line 1906 of file MSVehicle.h.

Referenced by getCarFollowVariables(), and MSVehicle().

◆ myChosenSpeedFactor

double MSBaseVehicle::myChosenSpeedFactor
protectedinherited

A precomputed factor by which the driver wants to be faster than the speed limit.

Definition at line 457 of file MSBaseVehicle.h.

Referenced by MSBaseVehicle::getChosenSpeedFactor(), and MSBaseVehicle::setChosenSpeedFactor().

◆ myCollisionImmunity

SUMOTime MSVehicle::myCollisionImmunity
protected

amount of time for which the vehicle is immune from collisions

Definition at line 1750 of file MSVehicle.h.

Referenced by collisionStopTime(), executeMove(), and resumeFromStopping().

◆ myContainerDevice

MSDevice_Transportable* MSVehicle::myContainerDevice
protected

◆ myCurrEdge

◆ myCurrentLaneInBestLanes

std::vector<LaneQ>::iterator MSVehicle::myCurrentLaneInBestLanes
protected

Definition at line 1707 of file MSVehicle.h.

Referenced by updateBestLanes(), and updateOccupancyAndCurrentBestLane().

◆ myDepartPos

double MSBaseVehicle::myDepartPos
protectedinherited

The real depart position.

Definition at line 481 of file MSBaseVehicle.h.

Referenced by MSBaseVehicle::getDepartPos(), loadState(), MSBaseVehicle::onDepart(), and saveState().

◆ myDeparture

SUMOTime MSBaseVehicle::myDeparture
protectedinherited

◆ myDevices

◆ myEdgeWeights

MSEdgeWeightsStorage* MSVehicle::myEdgeWeights
mutableprivate

Definition at line 1903 of file MSVehicle.h.

Referenced by _getWeightsStorage(), and ~MSVehicle().

◆ myEmptyLaneVector

std::vector< MSLane * > MSVehicle::myEmptyLaneVector
staticprotected

Definition at line 1709 of file MSVehicle.h.

Referenced by getBestLanesContinuation().

◆ myEmptyTransportableVector

std::vector< MSTransportable * > MSVehicle::myEmptyTransportableVector
staticprotected

Definition at line 1710 of file MSVehicle.h.

Referenced by getContainers(), and getPersons().

◆ myFurtherLanes

◆ myFurtherLanesPosLat

std::vector<double> MSVehicle::myFurtherLanesPosLat
protected

◆ myHaveToWaitOnNextLink

bool MSVehicle::myHaveToWaitOnNextLink
protected

Definition at line 1741 of file MSVehicle.h.

Referenced by checkRewindLinkLanes(), and processLinkAproaches().

◆ myInfluencer

◆ myLane

◆ myLaneChangeModel

MSAbstractLaneChangeModel* MSVehicle::myLaneChangeModel
protected

◆ myLastActionTime

SUMOTime MSVehicle::myLastActionTime
protected

Action offset (actions are taken at time myActionOffset + N*getActionStepLength()) Initialized to 0, to be set at insertion.

Definition at line 1685 of file MSVehicle.h.

Referenced by checkActionStep(), enterLaneAtInsertion(), getLastActionTime(), isActionStep(), loadState(), resetActionOffset(), saveState(), and updateActionOffset().

◆ myLastBestLanesEdge

const MSEdge* MSVehicle::myLastBestLanesEdge
protected

Definition at line 1694 of file MSVehicle.h.

Referenced by enterLaneAtMove(), replaceRoute(), and updateBestLanes().

◆ myLastBestLanesInternalLane

const MSLane* MSVehicle::myLastBestLanesInternalLane
protected

Definition at line 1695 of file MSVehicle.h.

Referenced by replaceRoute(), and updateBestLanes().

◆ myLFLinkLanes

◆ myMoveReminders

◆ myNextDriveItem

DriveItemVector::iterator MSVehicle::myNextDriveItem
protected

iterator pointing to the next item in myLFLinkLanes

Note
This is updated whenever the vehicle advances to a subsequent lane (see processLaneAdvances()) and used for inter-actionpoint actualization of myLFLinkLanes (i.e. deletion of passed items) in planMove().

Definition at line 1820 of file MSVehicle.h.

Referenced by executeMove(), MSVehicle(), planMove(), processLaneAdvances(), removePassedDriveItems(), and updateDriveItems().

◆ myNumberReroutes

int MSBaseVehicle::myNumberReroutes
protectedinherited

The number of reroutings.

Definition at line 490 of file MSBaseVehicle.h.

Referenced by MSBaseVehicle::getNumberReroutes(), replaceRoute(), and MEVehicle::replaceRoute().

◆ myParameter

◆ myPersonDevice

MSDevice_Transportable* MSVehicle::myPersonDevice
protected

◆ myRoute

◆ mySignals

int MSVehicle::mySignals
protected

State of things of the vehicle that can be on or off.

Definition at line 1730 of file MSVehicle.h.

Referenced by getSignals(), setBlinkerInformation(), signalSet(), switchOffSignal(), and switchOnSignal().

◆ myState

◆ myStopDist

double MSVehicle::myStopDist
protected

distance to the next stop or -1 if there is none

Definition at line 1747 of file MSVehicle.h.

Referenced by nextStopDist(), and planMove().

◆ myStops

◆ myTimeLoss

double MSVehicle::myTimeLoss
protected

the time loss in seconds due to driving with less than maximum speed

Definition at line 1676 of file MSVehicle.h.

Referenced by getTimeLoss(), getTimeLossSeconds(), and updateTimeLoss().

◆ myType

◆ myWaitingTime

SUMOTime MSVehicle::myWaitingTime
protected

The time the vehicle waits (is not faster than 0.1m/s) in seconds.

Definition at line 1669 of file MSVehicle.h.

Referenced by getWaitingSeconds(), getWaitingTime(), leaveLane(), loadState(), resumeFromStopping(), saveState(), and updateWaitingTime().

◆ myWaitingTimeCollector

WaitingTimeCollector MSVehicle::myWaitingTimeCollector
protected

Definition at line 1673 of file MSVehicle.h.

Referenced by getAccumulatedWaitingTime(), and updateWaitingTime().

◆ NOT_YET_DEPARTED

const SUMOTime MSBaseVehicle::NOT_YET_DEPARTED = SUMOTime_MAX
staticprotectedinherited

The documentation for this class was generated from the following files: