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
 
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...
 
struct  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...
 
typedef Named::NamedLikeComparatorIdLess< SUMOVehicleComparatorIdLess
 

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)
 
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 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...
 
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...
 
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...
 
bool knowsEdgeTest (MSEdge &edge) const
 
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, const 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...
 
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 addStops=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...
 
bool resumeFromStopping ()
 
void setAngle (double angle)
 Set a custom vehicle angle in rad. 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 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...
 
void setVTDState (Position xyPos)
 sets position outside the road network 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...
 
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)
 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 getLateralOverlap () const
 return the amount by which the vehicle extends laterally outside it's primary lane More...
 
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...
 
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...
 
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 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 (SUMOTime t=MSGlobals::gWaitingTimeMemory) 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)
 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...
 
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 lookForward. 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) 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...
 
void planMoveInternal (const SUMOTime t, MSLeaderInfo ahead, DriveItemVector &lfLinks, double &myStopDist) const
 
void removeApproachingInformation (DriveItemVector &lfLinks) const
 unregister approach from all upcoming links More...
 
void setBlinkerInformation ()
 
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...
 

Protected Attributes

double myAcceleration
 The current acceleration after dawdling in m/s. 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
 
bool myHaveToWaitOnNextLink
 
MSLanemyLane
 The lane the vehicle is on. More...
 
MSAbstractLaneChangeModelmyLaneChangeModel
 
const MSEdgemyLastBestLanesEdge
 
const MSLanemyLastBestLanesInternalLane
 
DriveItemVector myLFLinkLanes
 
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...
 
SUMOTime myTimeLoss
 the time loss due to writing with less than maximum speed More...
 
const 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

◆ ComparatorIdLess

◆ DriveItemVector

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

Container for used Links/visited Lanes during lookForward.

Definition at line 1626 of file MSVehicle.h.

◆ MoveReminderCont

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

Definition of a move reminder container.

Definition at line 427 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 1105 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 1067 of file MSVehicle.h.

◆ TraciLaneChangePriority

modes for prioritizing traci lane change requests

Enumerator
LCP_ALWAYS 
LCP_NOOVERLAP 
LCP_URGENT 
LCP_OPPORTUNISTIC 

Definition at line 1113 of file MSVehicle.h.

Constructor & Destructor Documentation

◆ MSVehicle() [1/3]

MSVehicle::MSVehicle ( SUMOVehicleParameter pars,
const MSRoute route,
const 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 705 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 2699 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 3315 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 744 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 334 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 
)
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 893 of file MSVehicle.cpp.

References MSLane::allowsVehicleClass(), SUMOVehicleParameter::Stop::awaitedContainers, MSVehicle::Stop::awaitedContainers, SUMOVehicleParameter::Stop::awaitedPersons, MSVehicle::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, MSVehicle::Stop::endPos, MSNet::getBusStop(), getCarFollowModel(), MSNet::getChargingStation(), MSNet::getContainerStop(), MSLane::getEdge(), Named::getID(), MSNet::getInstance(), MSVehicleType::getLength(), MSLane::getLength(), MSNet::getParkingArea(), MSVehicleType::getVehicleClass(), MSBaseVehicle::getVehicleType(), MSBaseVehicle::hasDeparted(), SUMOVehicleParameter::id, SUMOVehicleParameter::Stop::index, SUMOVehicleParameter::Stop::lane, MSVehicle::Stop::lane, MIN2(), MSBaseVehicle::myCurrEdge, MSBaseVehicle::myParameter, MSVehicle::State::myPos, MSBaseVehicle::myRoute, MSVehicle::State::mySpeed, myState, myStops, MSBaseVehicle::myType, SUMOVehicleParameter::Stop::parking, MSVehicle::Stop::parking, SUMOVehicleParameter::Stop::parkingarea, MSVehicle::Stop::parkingarea, POSITION_EPS, MSVehicle::Stop::reached, SUMOVehicleParameter::Stop::startPos, MSVehicle::Stop::startPos, STOP_INDEX_END, STOP_INDEX_FIT, MSVehicle::Stop::timeToBoardNextPerson, MSVehicle::Stop::timeToLoadNextContainer, SUMOVehicleParameter::Stop::triggered, MSVehicle::Stop::triggered, SUMOVehicleParameter::Stop::until, and MSVehicle::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 455 of file MSBaseVehicle.cpp.

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

Referenced by MEVehicleControl::buildVehicle(), GUIMEVehicleControl::buildVehicle(), GUIVehicleControl::buildVehicle(), MSVehicleControl::buildVehicle(), MEVehicle::getBlockTimeSeconds(), MSBaseVehicle::getCurrentRouteEdge(), MSBaseVehicle::replaceRouteEdges(), 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

Definition at line 3814 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::parking, POSITION_EPS, SUMOVehicleParameter::Stop::startPos, STOP_INDEX_FIT, SUMOVehicleParameter::stops, SUMOVehicleParameter::Stop::triggered, SUMOVehicleParameter::Stop::until, and updateBestLanes().

Referenced by TraCI_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 3850 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(), MSNet::getBusStop(), MSNet::getChargingStation(), MSNet::getContainerStop(), MSStoppingPlace::getEndLanePosition(), Named::getID(), MSBaseVehicle::getID(), MSNet::getInstance(), MSStoppingPlace::getLane(), MSNet::getParkingArea(), SUMOVehicleParameter::Stop::index, SUMOVehicleParameter::Stop::lane, myLane, MSBaseVehicle::myParameter, myStops, SUMOVehicleParameter::Stop::parking, SUMOVehicleParameter::Stop::parkingarea, SUMOVehicleParameter::Stop::startPos, STOP_INDEX_FIT, SUMOVehicleParameter::stops, 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 TraCI_Vehicle::setStop(), and signalSet().

◆ calculateArrivalParams()

◆ checkLinkLeader()

void MSVehicle::checkLinkLeader ( const MSLink link,
const MSLane lane,
double  seen,
DriveProcessItem *const  lastLink,
double &  v,
double &  vLinkPass,
double &  vLinkWait,
bool &  setRequest 
) const
protected

◆ 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 2492 of file MSVehicle.cpp.

References ACCEL2SPEED, MSVehicle::DriveProcessItem::availableSpace, MSCFModel::brakeGap(), DEBUG_COND, MSEdge::EDGEFUNCTION_INTERNAL, gDebugSelectedVehicle, 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(), MSEdge::getPurpose(), MSVehicle::Influencer::getRespectJunctionPriority(), MSAbstractLaneChangeModel::getShadowLane(), getSpaceTillLastStanding(), getSpeed(), MSLane::getVehicleNumber(), MSBaseVehicle::getVehicleType(), MSLink::getViaLane(), getWaitingTime(), MSGlobals::gUsingInternalLanes, MSVehicle::DriveProcessItem::hadVehicle, MSLink::hasFoes(), MSLink::havePriority(), MSLink::isCont(), isFrontOnLane(), MSAbstractLaneChangeModel::isOpposite(), MSEdge::isRoundabout(), MSLink::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 1121 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 1496 of file MSVehicle.h.

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

◆ 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 2732 of file MSVehicle.cpp.

References activateReminders(), adaptLaneEntering2MoveReminder(), MSEdge::EDGEFUNCTION_INTERNAL, MSLane::getEdge(), MSEdge::getPurpose(), hasArrived(), Position::INVALID, myAmOnNet, myCachedPosition, MSBaseVehicle::myCurrEdge, myLane, myLastBestLanesEdge, MSVehicle::State::myPos, myState, MSMoveReminder::NOTIFICATION_JUNCTION, and MSMoveReminder::NOTIFICATION_TELEPORT.

Referenced by MSVehicleTransfer::add(), MSVehicleTransfer::checkInsertions(), congested(), executeMove(), and TraCIServerAPI_Vehicle::processSet().

◆ 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 1880 of file MSVehicle.cpp.

References ACCEL2SPEED, MSCFModel::brakeGap(), MSAbstractLaneChangeModel::changedToOpposite(), computeAngle(), DEBUG_COND, DELTA_T, DIST2SPEED, MSRoute::end(), MSAbstractLaneChangeModel::endLaneChangeManeuver(), enterLaneAtMove(), gDebugSelectedVehicle, getBackLane(), MSVehicleType::getCarFollowModel(), getCarFollowModel(), MSNet::getCurrentTimeStep(), MSLink::getDirection(), MSLane::getEdge(), MSVehicle::Influencer::getEmergencyBrakeRedLight(), Named::getID(), MSBaseVehicle::getID(), MSBaseVehicle::getImpatience(), MSNet::getInstance(), getLaneChangeModel(), getLateralOverlap(), getLateralPositionOnLane(), MSVehicleType::getLength(), MSLane::getLength(), MSCFModel::getMaxDecel(), MSLane::getOpposite(), MSLane::getOppositePos(), MSLink::getParallelLink(), getPositionOnLane(), MSVehicle::Influencer::getRespectJunctionPriority(), MSAbstractLaneChangeModel::getShadowDirection(), MSAbstractLaneChangeModel::getShadowLane(), getSpeed(), MSLink::getState(), MSVehicleType::getVehicleClass(), MSNet::getVehicleControl(), MSLane::getVehicleMaxSpeed(), MSBaseVehicle::getVehicleType(), MSLink::getViaLane(), MSLink::getViaLaneOrLane(), getWaitingTime(), MSLane::getWidth(), MSGlobals::gSemiImplicitEulerUpdate, MSGlobals::gUsingInternalLanes, hasArrived(), MSVehicle::Influencer::implicitSpeedVTD(), MSVehicle::Influencer::influenceSpeed(), Position::INVALID, isRemoteControlled(), MSEdge::isRoundabout(), isStopped(), MSEdge::isVaporizing(), MSVehicle::Influencer::isVTDControlled(), leaveLane(), LINKDIR_LEFT, LINKDIR_RIGHT, LINKSTATE_EQUAL, LINKSTATE_TL_RED, LINKSTATE_TL_YELLOW_MAJOR, LINKSTATE_TL_YELLOW_MINOR, LINKSTATE_ZIPPER, max, MAX2(), MSCFModel::maxNextSpeed(), MIN2(), MSCFModel::moveHelper(), myAcceleration, myAngle, MSVehicle::State::myBackPos, myCachedPosition, myCollisionImmunity, MSBaseVehicle::myCurrEdge, myFurtherLanes, myFurtherLanesPosLat, myHaveToWaitOnNextLink, myInfluencer, myLane, MSVehicle::State::myLastCoveredDist, myLFLinkLanes, MSVehicle::State::myPos, MSBaseVehicle::myRoute, MSVehicle::State::mySpeed, myState, myTimeLoss, MSBaseVehicle::myType, myWaitingTime, myWaitingTimeCollector, MSMoveReminder::NOTIFICATION_JUNCTION, MSMoveReminder::NOTIFICATION_VAPORIZED, NUMERICAL_EPS, MSLink::opened(), MSLink::passedJunction(), MSVehicle::WaitingTimeCollector::passTime(), POSITION_EPS, MSAbstractLaneChangeModel::prepareStep(), MSVehicleControl::registerEmergencyStop(), setBlinkerInformation(), setEmergencyBlueLight(), SIMTIME, SUMO_const_haltingSpeed, SVC_EMERGENCY, switchOffSignal(), switchOnSignal(), TIME2STEPS, time2string(), toString(), TS, updateBestLanes(), updateFurtherLanes(), MSAbstractLaneChangeModel::updateShadowLane(), updateState(), VEH_SIGNAL_BRAKELIGHT, 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 3323 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 459 of file MSVehicle.h.

References getPosition(), getSlope(), and myAcceleration.

Referenced by GUIVehicle::getColorValue(), GUIVehicle::getParameterWindow(), 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 580 of file MSVehicle.h.

References getAccumulatedWaitingTime(), and STEPS2TIME.

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

◆ getAccumulatedWaitingTime()

SUMOTime MSVehicle::getAccumulatedWaitingTime ( SUMOTime  t = MSGlobals::gWaitingTimeMemory) const
inline

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

Parameters
[in]tspecifies the length of the interval over which the cumulated waiting time is to be summed up (defaults to and must not exceed MSGlobals::gWaitingTimeMemory)
Returns
The time the vehicle was standing within the last t millisecs

Definition at line 559 of file MSVehicle.h.

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

Referenced by getAccumulatedWaitingSeconds().

◆ getAngle()

double MSVehicle::getAngle ( ) const
inlinevirtual

Returns the vehicle's direction in radians.

Returns
The vehicle's current angle

Implements SUMOVehicle.

Definition at line 594 of file MSVehicle.h.

References myAngle.

Referenced by GUIVehicle::getAngle(), TraCI_Vehicle::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 270 of file MSBaseVehicle.h.

References MSBaseVehicle::myArrivalPos.

Referenced by MSLCM_SL2015::_wantsChangeSublane().

◆ getBackLane()

const MSLane * MSVehicle::getBackLane ( ) const
protected

Definition at line 2337 of file MSVehicle.cpp.

References myFurtherLanes, and myLane.

Referenced by estimateLeaveSpeed(), and executeMove().

◆ getBackPosition()

◆ getBackPositionOnLane() [1/2]

◆ 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 399 of file MSVehicle.h.

References myLane.

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

◆ getBestLaneOffset()

int MSVehicle::getBestLaneOffset ( ) const

Definition at line 3305 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 2933 of file MSVehicle.cpp.

References myBestLanes.

Referenced by MSLane::appropriate(), MSLaneChanger::change(), MSLaneChanger::changeOpposite(), MSLaneChangerSublane::checkChangeHelper(), TraCI_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 3285 of file MSVehicle.cpp.

References MSEdge::EDGEFUNCTION_INTERNAL, MSLane::getEdge(), MSLane::getLinkCont(), MSEdge::getPurpose(), 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 796 of file MSVehicle.h.

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

Referenced by MSLCM_LC2013::_wantsChange(), MSLCM_SL2015::_wantsChangeSublane(), MSCriticalFollowerDistanceInfo::addFollower(), addStop(), MSLaneChanger::changeOpposite(), MSLCM_SL2015::checkBlockingVehicles(), MSLaneChanger::checkChange(), MSLane::checkFailure(), checkRewindLinkLanes(), MSLCM_SL2015::checkStrategicChange(), MSLaneChanger::computeOvertakingTime(), MSLink::couldBrakeForLeader(), 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(), MSLane::isInsertionSuccess(), MSLane::lastInsertion(), MSLink::maybeOccupied(), MSLCM_LC2013::overtakeDistance(), MSLCM_DK2008::patchSpeed(), planMoveInternal(), processNextStop(), MSLane::safeInsertionSpeed(), MSLCM_SL2015::saveBlockerLength(), MSLCM_LC2013::saveBlockerLength(), GUIVehicle::selectBlockingFoes(), MSLCM_LC2013::slowDownForBlocked(), MSLCM_SL2015::slowDownForBlocked(), unsafeLinkAhead(), MSLCM_SL2015::updateExpectedSublaneSpeeds(), MSLCM_DK2008::wantsChangeToLeft(), and MSLCM_DK2008::wantsChangeToRight().

◆ getCarFollowVariables()

◆ getCenterOnEdge()

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

◆ 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 361 of file MSBaseVehicle.h.

References MSBaseVehicle::myChosenSpeedFactor.

Referenced by GUIMEVehicle::getParameterWindow(), GUIVehicle::getParameterWindow(), and TraCI_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

◆ 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 1858 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 262 of file MSBaseVehicle.h.

References MSBaseVehicle::myDepartPos.

Referenced by TraCI_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 249 of file MSBaseVehicle.h.

References MSBaseVehicle::myDeparture.

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

◆ 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 432 of file MSBaseVehicle.cpp.

References MSBaseVehicle::myDevices.

Referenced by MSBaseVehicle::createDevice(), GUIBaseVehicle::drawOnPos(), 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 508 of file MSBaseVehicle.cpp.

References MSBaseVehicle::myDevices.

Referenced by TraCI_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 3331 of file MSVehicle.cpp.

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

Referenced by MSVehicle::Influencer::implicitDeltaPosVTD(), MSVehicle::Influencer::implicitSpeedVTD(), and nextStopDist().

◆ getEdge()

◆ getElectricityConsumption()

double MSVehicle::getElectricityConsumption ( ) const

◆ getFuelConsumption()

double MSVehicle::getFuelConsumption ( ) const

◆ getFurtherLanes()

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

Definition at line 683 of file MSVehicle.h.

References myFurtherLanes.

Referenced by MSAbstractLaneChangeModel::updateShadowLane().

◆ getFurtherLanesPosLat()

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

Definition at line 687 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 120 of file MSBaseVehicle.cpp.

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

Referenced by MSLCM_LC2013::_patchSpeed(), MSLCM_SL2015::_patchSpeed(), MSLCM_LC2013::_wantsChange(), MSLCM_SL2015::_wantsChangeSublane(), adaptToLeader(), adaptToLeaders(), MSVehicleTransfer::add(), addTraciStopAtStoppingPlace(), MSBaseVehicle::calculateArrivalParams(), MSLaneChangerSublane::change(), MSLaneChanger::change(), MSLCM_SL2015::changed(), MSLaneChanger::changeOpposite(), MELoop::changeSegment(), MSLaneChanger::checkChange(), MSLaneChangerSublane::checkChangeSublane(), MSLane::checkFailure(), MSVehicleTransfer::checkInsertions(), checkRewindLinkLanes(), MSLCM_SL2015::checkStrategicChange(), MSAbstractLaneChangeModel::cleanupShadowLane(), MSDevice_SSM::closeEncounter(), computeAngle(), MSDevice_SSM::computeSSMs(), MSLaneChanger::continueChange(), MSLCM_SL2015::decideDirection(), MSLane::detectCollisionBetween(), MSDevice_SSM::Encounter::Encounter(), MSCalibrator::execute(), executeMove(), MSLane::executeMovements(), 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(), MSDevice_SSM::getUpstreamVehicles(), MSLane::handleCollisionBetween(), MSLCM_LC2013::inform(), MSLCM_SL2015::inform(), MSLCM_LC2013::informFollower(), MSLCM_SL2015::informFollower(), MSLCM_LC2013::informLeader(), MSLCM_SL2015::informLeader(), MESegment::initialise(), MSPedestrianPushButton::isActiveForEdge(), MSLane::isInsertionSuccess(), leaveLane(), MSCFModel_Daniel1::moveHelper(), MSCFModel_SmartSK::moveHelper(), MSCFModel_KraussOrig1::moveHelper(), MSLCM_LC2013::MSLCM_LC2013(), MSCalibrator::VehicleRemover::notifyEnter(), MSLCM_DK2008::patchSpeed(), MSLCM_LC2013::patchSpeed(), MSLCM_SL2015::patchSpeed(), planMove(), planMoveInternal(), MSAbstractLaneChangeModel::primaryLaneChanged(), processNextStop(), TraCIServerAPI_Vehicle::processSet(), MSDevice_SSM::qualifiesAsConflict(), MSBaseVehicle::replaceRouteEdges(), MSBaseVehicle::reroute(), MSLane::resetPartialOccupation(), TraCI_Vehicle::resume(), MSLCM_SL2015::saveBlockerLength(), MSLCM_LC2013::saveBlockerLength(), MSBaseVehicle::saveState(), MSCalibrator::scheduleRemoval(), GUIVehicle::selectBlockingFoes(), MSBaseVehicle::setDeviceParameter(), MSLCM_SL2015::setOwnState(), MSLane::setPartialOccupation(), TraCIServer::setVTDControlled(), MSLCM_LC2013::slowDownForBlocked(), MSLCM_SL2015::slowDownForBlocked(), MELoop::teleportVehicle(), METriggeredCalibrator::tryEmit(), updateBestLanes(), MSDevice_SSM::updateEncounter(), MSLCM_SL2015::updateGaps(), MSAbstractLaneChangeModel::updateShadowLane(), MSLCM_LC2013::wantsChange(), MSLCM_SL2015::wantsChange(), MSLCM_SL2015::wantsChangeSublane(), MSLCM_DK2008::wantsChangeToLeft(), MSLCM_DK2008::wantsChangeToRight(), MSBatteryExport::write(), MSDevice_SSM::writeOutConflict(), MSXMLRawOut::writeVehicle(), and MSDevice_SSM::Encounter::~Encounter().

◆ getImpatience()

◆ getInfluencer() [1/2]

MSVehicle::Influencer & MSVehicle::getInfluencer ( )

Returns the velocity/lane influencer.

If no influencer was existing before, one is built, first

Returns
Reference to this vehicle's speed influencer

Definition at line 3993 of file MSVehicle.cpp.

References myInfluencer.

Referenced by MSLCM_LC2013::_wantsChange(), MSLCM_SL2015::_wantsChangeSublane(), MSLane::detectCollisionBetween(), TraCI_Vehicle::getSpeedMode(), MSLane::handleCollisionBetween(), influenceChangeDecision(), MSLCM_SL2015::keepLatGap(), TraCIServerAPI_Vehicle::processSet(), MSAbstractLaneChangeModel::setOwnState(), and TraCIServer::setVTDControlled().

◆ getInfluencer() [2/2]

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

Definition at line 4002 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 488 of file MSVehicle.h.

References myLane.

Referenced by MSLCM_LC2013::_patchSpeed(), MSLCM_LC2013::_wantsChange(), MSLCM_SL2015::_wantsChangeSublane(), adaptToLeaders(), MSVehicleTransfer::add(), MSLaneChangerSublane::change(), MSLaneChanger::changeOpposite(), MSLCM_SL2015::checkBlocking(), MSLaneChanger::checkChange(), MSLaneChangerSublane::checkChangeSublane(), MSVehicleTransfer::checkInsertions(), checkLinkLeader(), MSLCM_SL2015::checkStrategicChange(), MSLaneChanger::computeOvertakingTime(), MSAbstractLaneChangeModel::congested(), MSLane::detectCollisionBetween(), MSLane::detectCollisions(), MSVTypeProbe::execute(), MSLane::executeMovements(), MSDevice_SSM::findFoeConflictLane(), MSDevice_SSM::findSurroundingVehicles(), MSCFModel_IDM::followSpeed(), TraCI_Vehicle::getAllowedSpeed(), GUIVehicle::getColorValue(), TraCI_Vehicle::getDistance(), MSLane::getFollowersOnConsecutive(), TraCI_Vehicle::getLaneID(), TraCI_Vehicle::getLaneIndex(), MSLaneChangerSublane::getLeaders(), TraCI_Vehicle::getNextTLS(), TraCI_Vehicle::getRoadID(), MSLCM_LC2013::getRoundaboutAheadInfo(), MSAbstractLaneChangeModel::getShadowDirection(), MSVTKExport::getSpeed(), MSLink::getZipperSpeed(), MSLane::handleCollisionBetween(), MSLCM_LC2013::informFollower(), MSLane::integrateNewVehicle(), MSCFModel_IDM::interactionGap(), MSCFModel::interactionGap(), MSJunction::isLeader(), MSLCM_SL2015::keepLatGap(), MSCFModel_Daniel1::moveHelper(), MSCFModel_SmartSK::moveHelper(), MSCFModel_KraussOrig1::moveHelper(), MSCFModel_IDM::moveHelper(), MSDevice_BTreceiver::notifyEnter(), MSDevice_BTsender::notifyEnter(), MSDevice_BTreceiver::notifyLeave(), MSDevice_BTsender::notifyLeave(), MSDevice_BTreceiver::notifyMove(), MSDevice_BTsender::notifyMove(), MSLCM_DK2008::patchSpeed(), MSLCM_LC2013::patchSpeed(), MSLCM_SL2015::patchSpeed(), planMoveInternal(), MSVehicle::Influencer::postProcessVTD(), MSLCM_SL2015::prepareStep(), TraCIServerAPI_Vehicle::processSet(), MSVehicleTransfer::remove(), MSCalibrator::removePending(), MSLane::removeVehicle(), setBlinkerInformation(), MSLaneChangerSublane::startChangeSublane(), MSCFModel_IDM::stopSpeed(), MSLaneChangerSublane::updateChanger(), MSDevice_SSM::updateEncounter(), MSLCM_SL2015::updateExpectedSublaneSpeeds(), MSAbstractLaneChangeModel::updateShadowLane(), TraCIServerAPI_Vehicle::vtdMap(), 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 2921 of file MSVehicle.cpp.

References myLaneChangeModel.

Referenced by MSVehicleTransfer::add(), MSLaneChangerSublane::change(), MSLaneChanger::change(), MSLaneChanger::changeOpposite(), MSLaneChanger::checkChange(), MSLaneChangerSublane::checkChangeSublane(), checkRewindLinkLanes(), computeAngle(), congested(), MSLaneChanger::continueChange(), MSLane::detectCollisionBetween(), MSLane::detectCollisions(), enterLaneAtInsertion(), executeMove(), fixPosition(), getBackPosition(), getBackPositionOnLane(), getCenterOnEdge(), TraCI_Vehicle::getLaneChangeState(), GUIVehicle::getLastLaneChangeOffset(), getLatOffset(), MSLink::getLeaderInfo(), MSLane::getOppositeFollower(), MSLane::getOppositeLeader(), TraCI_Vehicle::getParameter(), GUIVehicle::getParameterWindow(), getPosition(), MSAbstractLaneChangeModel::MSLCMessager::informLeader(), MSAbstractLaneChangeModel::MSLCMessager::informNeighFollower(), MSAbstractLaneChangeModel::MSLCMessager::informNeighLeader(), isFrontOnLane(), MSCFModel_Rail::moveHelper(), MSCFModel_Daniel1::moveHelper(), MSCFModel_SmartSK::moveHelper(), MSCFModel_KraussOrig1::moveHelper(), MSCFModel_KraussX::moveHelper(), MSCFModel::moveHelper(), planMove(), planMoveInternal(), MSLaneChanger::registerUnchanged(), removeApproachingInformation(), MSLCM_SL2015::saveBlockerLength(), MSLCM_LC2013::saveBlockerLength(), GUIVehicle::selectBlockingFoes(), setBlinkerInformation(), TraCI_Vehicle::setParameter(), MSLaneChanger::startChange(), MSLaneChangerSublane::startChangeSublane(), updateBestLanes(), MSLaneChangerSublane::updateChanger(), and updateState().

◆ getLaneChangeModel() [2/2]

const MSAbstractLaneChangeModel & MSVehicle::getLaneChangeModel ( ) const

Definition at line 2927 of file MSVehicle.cpp.

References myLaneChangeModel.

◆ getLaneIndex()

int MSVehicle::getLaneIndex ( ) const

◆ 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 382 of file MSVehicle.h.

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

◆ getLateralOverlap()

double MSVehicle::getLateralOverlap ( ) const

◆ getLateralPositionOnLane()

◆ 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 3348 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 TraCI_Vehicle::getLeader(), getTimeGapOnLane(), and nextStopDist().

◆ getMaxSpeed()

double MSBaseVehicle::getMaxSpeed ( ) const
virtualinherited

◆ 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 498 of file MSVehicle.h.

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

Referenced by 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 1101 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 3987 of file MSVehicle.cpp.

References myStops.

Referenced by TraCI_Vehicle::getStopState(), MSLane::isInsertionSuccess(), TraCI_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 292 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()

◆ 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 375 of file MSVehicle.h.

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

Referenced by MSLCM_LC2013::_wantsChange(), MSLCM_SL2015::_wantsChangeSublane(), adaptToLeaders(), MSLaneChanger::changeOpposite(), MSLaneChanger::checkChange(), MSVehicleTransfer::checkInsertions(), MSLCM_SL2015::checkStrategicChange(), computeAngle(), MSLane::detectCollisionBetween(), MSLane::detectCollisions(), executeMove(), MSLane::executeMovements(), MSDevice_SSM::findFoeConflictLane(), MSDevice_SSM::findSurroundingVehicles(), MSLane::freeInsertion(), MSLane::getBruttoOccupancy(), MSLaneChanger::getCloserFollower(), MSEdge::getDepartPosBound(), TraCI_Vehicle::getDistance(), getDistanceToPosition(), TraCI_Vehicle::getDrivingDistance(), TraCI_Vehicle::getDrivingDistance2D(), MSLane::getFirstAnyVehicle(), MSLane::getFirstVehicleInformation(), MSLane::getFollower(), MSLane::getFollowersOnConsecutive(), MSEdge::getFreeLane(), TraCI_Vehicle::getLanePosition(), getLastStepDist(), MSLane::getLastVehicleInformation(), MSLane::getLeader(), getLeader(), MSLaneChangerSublane::getLeaders(), MSLane::getNettoOccupancy(), TraCI_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(), MSVehicleTransfer::loadState(), MSLane::loadState(), MSLane::VehPosition::operator()(), MSLCM_LC2013::patchSpeed(), MSLCM_SL2015::patchSpeed(), planMove(), planMoveInternal(), MSCalibrator::remainingVehicleCapacity(), MSLane::safeInsertionSpeed(), GUIVehicle::selectBlockingFoes(), setBlinkerInformation(), MSLCM_LC2013::slowDownForBlocked(), MSLCM_SL2015::slowDownForBlocked(), MSLaneChangerSublane::startChangeSublane(), unsafeLinkAhead(), MSLCM_SL2015::updateExpectedSublaneSpeeds(), TraCIServerAPI_Vehicle::vtdMap(), 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 2459 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 450 of file MSVehicle.h.

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

◆ 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 809 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 isOnRoad(), and TraCIServerAPI_Vehicle::processSet().

◆ 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 3600 of file MSVehicle.cpp.

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

Referenced by MSLCM_SL2015::_wantsChangeSublane(), MSLCM_SL2015::checkBlockingVehicles(), and getLateralPositionOnLane().

◆ 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 3594 of file MSVehicle.cpp.

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

Referenced by getLateralPositionOnLane().

◆ getRoute()

◆ getRoutePosition()

◆ getSafeFollowSpeed()

double MSVehicle::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

Definition at line 1838 of file MSVehicle.cpp.

References MSCFModel::followSpeed(), getCarFollowModel(), MSLane::getLength(), getSpeed(), MAX2(), POSITION_EPS, and MSCFModel::stopSpeed().

Referenced by adaptToLeader(), MSLane::getCriticalLeader(), and hasInfluencer().

◆ getSignals()

int MSVehicle::getSignals ( ) const
inline

Returns the signals.

Returns
The signals' states

Definition at line 1140 of file MSVehicle.h.

References mySignals.

Referenced by TraCI_Vehicle::getSignalStates(), and MSFCDExport::write().

◆ 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 442 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(), MSCriticalFollowerDistanceInfo::addFollower(), MSLaneChanger::changeOpposite(), MSLCM_SL2015::checkBlockingVehicles(), MSLaneChanger::checkChange(), GUIApplicationWindow::checkGamingEvents(), checkRewindLinkLanes(), MSLCM_SL2015::checkStrategicChange(), MSLaneChanger::computeOvertakingTime(), MSLink::couldBrakeForLeader(), executeMove(), MSLane::forceVehicleInsertion(), MSLane::freeInsertion(), GUIVehicle::getColorValue(), MSLane::getCriticalLeader(), MSLane::getLeader(), getLeader(), MSLaneChangerSublane::getLeaders(), MSLane::getMissingRearGap(), GUIVehicle::getParameterWindow(), MSLaneChanger::getRealLeader(), getSafeFollowSpeed(), MSVTKExport::getSpeed(), TraCI_Vehicle::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(), MSLane::lastInsertion(), MSVehicleTransfer::loadState(), MSLane::loadState(), MSLink::maybeOccupied(), MSCFModel_Rail::moveHelper(), MSCFModel_Daniel1::moveHelper(), MSCFModel_SmartSK::moveHelper(), MSCFModel_PWag2009::moveHelper(), MSCFModel_KraussOrig1::moveHelper(), MSCFModel_KraussX::moveHelper(), MSCFModel_Wiedemann::moveHelper(), MSCFModel::moveHelper(), MSLCM_LC2013::overtakeDistance(), MSLCM_DK2008::patchSpeed(), MSLCM_LC2013::patchSpeed(), MSLCM_SL2015::patchSpeed(), planMove(), planMoveInternal(), MSAbstractLaneChangeModel::predInteraction(), MSAbstractLaneChangeModel::primaryLaneChanged(), processNextStop(), TraCIServerAPI_Vehicle::processSet(), MSLane::safeInsertionSpeed(), MSLCM_SL2015::saveBlockerLength(), MSLCM_LC2013::saveBlockerLength(), MSLCM_LC2013::slowDownForBlocked(), MSLCM_SL2015::slowDownForBlocked(), MSLaneChangerSublane::startChangeSublane(), unsafeLinkAhead(), 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 4008 of file MSVehicle.cpp.

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

Referenced by TraCI_Vehicle::getSpeedWithoutTraCI(), and signalSet().

◆ getStopEdges()

const ConstMSEdgeVector MSVehicle::getStopEdges ( ) const
protectedvirtual

Returns the list of still pending stop edges.

Implements MSBaseVehicle.

Definition at line 1353 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 3377 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 549 of file MSVehicle.h.

References myTimeLoss.

◆ getTimeLossSeconds()

double MSVehicle::getTimeLossSeconds ( ) const
inline

Returns the time loss in seconds.

Definition at line 586 of file MSVehicle.h.

References myTimeLoss, and STEPS2TIME.

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 116 of file MSBaseVehicle.h.

References MSBaseVehicle::myType.

Referenced by MSLCM_LC2013::_patchSpeed(), MSLCM_SL2015::_patchSpeed(), MSLCM_LC2013::_wantsChange(), MSLCM_SL2015::_wantsChangeSublane(), adaptToLeaders(), addStop(), MSLane::basePos(), MSTransportableControl::boardAnyWaiting(), MSLaneChanger::change(), MSLaneChanger::changeOpposite(), MSLCM_SL2015::checkBlocking(), MSLCM_SL2015::checkBlockingVehicles(), MSLaneChanger::checkChange(), MSLane::checkFailure(), GUIApplicationWindow::checkGamingEvents(), MSVehicleTransfer::checkInsertions(), checkRewindLinkLanes(), MSLaneChanger::computeOvertakingTime(), MSLaneChanger::continueChange(), MSLane::detectCollisionBetween(), GUIVehicle::drawAction_drawLinkItems(), GUIVehicle::drawAction_drawRailCarriages(), GUIVehicle::drawAction_drawVehicleBlinker(), GUIVehicle::drawAction_drawVehicleBrakeLight(), GUIEdge::drawMesoVehicles(), MSLane::enteredByLaneChange(), enterLaneAtInsertion(), enterLaneAtLaneChange(), MEVehicle::estimateLeaveSpeed(), estimateLeaveSpeed(), executeMove(), MSLane::executeMovements(), MSLane::freeInsertion(), MEVehicle::getBackPositionOnLane(), MSLane::getBruttoOccupancy(), GUIBaseVehicle::getCenteringBoundary(), MSLane::getCriticalLeader(), MSEdge::getDepartLane(), MSEdge::getDepartPosBound(), MSLane::getFollower(), MSLane::getFollowersOnConsecutive(), MSBaseVehicle::getImpatience(), getLateralOverlap(), MSLane::getLeader(), getLeader(), MSLink::getLeaderInfo(), MSLane::getLeaderOnConsecutive(), MSLaneChangerSublane::getLeaders(), MSLane::getLeadersOnConsecutive(), MSLane::getNettoOccupancy(), MSLane::getOppositeFollower(), MSLane::getOppositeLeader(), MSLaneChanger::getRealFollower(), MSLaneChanger::getRealLeader(), getRightSideOnEdge(), getRightSideOnLane(), MSLeaderInfo::getSubLanes(), getTimeGapOnLane(), MESegment::getTimeHeadway(), TraCI_Vehicle::getTypeID(), TraCI_Vehicle::getVehicleType(), GUIBaseVehicle::getVType(), MSLink::getZipperSpeed(), MSLane::handleCollisionBetween(), MESegment::hasSpaceFor(), MSLane::incorporateVehicle(), MSLCM_SL2015::informFollower(), MSLCM_SL2015::informLeader(), MSLane::insertVehicle(), MSLane::integrateNewVehicle(), MSLane::isInsertionSuccess(), MESegment::isOpen(), MSLCM_SL2015::keepLatGap(), MSLane::lastInsertion(), MSLane::leftByLaneChange(), MSTransportableControl::loadAnyWaiting(), MESegment::loadState(), overlap(), MSLCM_LC2013::overtakeDistance(), MSLCM_DK2008::patchSpeed(), planMoveInternal(), MSVehicle::Influencer::postProcessVTD(), processNextStop(), TraCIServerAPI_Vehicle::processSet(), MESegment::receive(), MSLaneChanger::registerUnchanged(), MESegment::removeCar(), MSLane::removeVehicle(), MSLane::safeInsertionSpeed(), MSLCM_SL2015::saveBlockerLength(), MSLCM_LC2013::saveBlockerLength(), MSBaseVehicle::saveState(), GUIVehicle::selectBlockingFoes(), GUIBaseVehicle::setFunctionalColor(), setTentativeLaneAndPosition(), MSLCM_LC2013::slowDownForBlocked(), MSLCM_SL2015::slowDownForBlocked(), MSLaneChanger::startChange(), MSLaneChangerSublane::startChangeSublane(), unsafeLinkAhead(), MSLCM_SL2015::updateExpectedSublaneSpeeds(), updateFurtherLanes(), 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 602 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 570 of file MSVehicle.h.

References myWaitingTime, and STEPS2TIME.

Referenced by GUIVehicle::getColorValue(), GUIVehicle::getParameterWindow(), TraCI_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 536 of file MSVehicle.h.

References myWaitingTime.

Referenced by checkRewindLinkLanes(), executeMove(), MSLane::executeMovements(), MSLink::getLeaderInfo(), 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 693 of file MSVehicle.cpp.

References _getWeightsStorage().

Referenced by TraCI_Vehicle::getAdaptedTraveltime(), TraCI_Vehicle::getEffort(), MSNet::getEffort(), MSNet::getTravelTime(), and TraCIServerAPI_Vehicle::processSet().

◆ getWeightsStorage() [2/2]

MSEdgeWeightsStorage & MSVehicle::getWeightsStorage ( )

Definition at line 699 of file MSVehicle.cpp.

References _getWeightsStorage().

◆ 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 607 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(), and MSLane::executeMovements().

◆ hasDeparted()

bool MSBaseVehicle::hasDeparted ( ) const
virtualinherited

◆ 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 478 of file MSBaseVehicle.cpp.

References MSBaseVehicle::myDevices.

Referenced by MSBaseVehicle::createDevice(), and TraCI_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 887 of file MSVehicle.h.

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

Referenced by MSLane::isInsertionSuccess(), and TraCI_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 306 of file MSBaseVehicle.cpp.

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

Referenced by MSBaseVehicle::getDevices(), MESegment::initialise(), TraCI_Vehicle::isRouteValid(), MSBaseVehicle::MSBaseVehicle(), TraCIServerAPI_Vehicle::processSet(), and MSBaseVehicle::replaceRouteEdges().

◆ influenceChangeDecision()

◆ 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 2465 of file MSVehicle.cpp.

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

Referenced by checkRewindLinkLanes(), MSLane::getFirstVehicleInformation(), MSLane::getFollowersOnConsecutive(), MSLink::getLeaderInfo(), MSLane::getLeadersOnConsecutive(), MSLane::getPartialBehind(), and isOnRoad().

◆ isOnRoad()

◆ isParking()

bool MSVehicle::isParking ( ) const
virtual

Returns whether the vehicle is parking.

Returns
whether the vehicle is parking

Implements SUMOVehicle.

Definition at line 1127 of file MSVehicle.cpp.

References isStopped(), and myStops.

Referenced by MSVehicleTransfer::add(), computeAngle(), MSLane::executeMovements(), getPosition(), GUIVehicle::getStopInfo(), hasStops(), and TraCI_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 4037 of file MSVehicle.cpp.

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

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

◆ isSelected()

virtual bool MSVehicle::isSelected ( ) const
inlinevirtual

whether this vehicle is selected in the GUI

Reimplemented in GUIVehicle.

Definition at line 810 of file MSVehicle.h.

◆ isStopped()

bool MSVehicle::isStopped ( ) const
virtual

Returns whether the vehicle is at a stop.

Returns
Whether the vehicle has stopped

Implements SUMOVehicle.

Definition at line 1115 of file MSVehicle.cpp.

References myStops.

Referenced by MSLaneChanger::changeOpposite(), executeMove(), MSLane::executeMovements(), GUIVehicle::getStopInfo(), TraCI_Vehicle::getStopState(), hasStops(), MSLCM_LC2013::informLeader(), isParking(), isStoppedInRange(), isStoppedTriggered(), and resumeFromStopping().

◆ isStoppedInRange()

bool MSVehicle::isStoppedInRange ( double  pos) const

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

Definition at line 1139 of file MSVehicle.cpp.

References isStopped(), and myStops.

Referenced by MSVehicleControl::getWaitingVehicle(), and nextStopDist().

◆ 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 1133 of file MSVehicle.cpp.

References isStopped(), and myStops.

Referenced by nextStopDist().

◆ knowsEdgeTest()

bool MSVehicle::knowsEdgeTest ( MSEdge edge) const

Referenced by nextStopDist().

◆ 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 3243 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 279 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::postProcessVTD(), 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 3802 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 598 of file MSVehicle.cpp.

References MSVehicleTransfer::getInstance(), leaveLane(), myLFLinkLanes, MSVehicleTransfer::remove(), and removeApproachingInformation().

Referenced by MSVehicleTransfer::add(), MSLane::detectCollisions(), MSLane::executeMovements(), MSVehicle::Influencer::postProcessVTD(), 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 614 of file MSVehicle.h.

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

◆ 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 1363 of file MSVehicle.cpp.

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

◆ planMoveInternal()

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

Definition at line 1414 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, MSEdge::EDGEFUNCTION_INTERNAL, MSRoute::end(), estimateLeaveSpeed(), MSCFModel::estimateSpeedAfterDistance(), MSCFModel::freeSpeed(), gDebugFlag1, gDebugSelectedVehicle, getBestLanesContinuation(), getCarFollowModel(), MSLane::getEdge(), MSVehicle::Influencer::getEmergencyBrakeRedLight(), MSVehicle::Stop::getEndPos(), MSBaseVehicle::getID(), MSLane::getIncomingLanes(), MSNet::getInstance(), getLane(), getLaneChangeModel(), MSLane::getLastVehicleInformation(), getLateralOverlap(), MSVehicleType::getLength(), MSLane::getLength(), MSCFModel::getMaxAccel(), MSCFModel::getMaxDecel(), MSCFModel::getMinimalArrivalSpeed(), MSCFModel::getMinimalArrivalSpeedEuler(), MSCFModel::getMinimalArrivalTime(), MSLane::getOpposite(), MSLane::getOppositeLeader(), MSLane::getParallelLane(), MSLink::getParallelLink(), getPositionOnLane(), MSEdge::getPurpose(), MSLane::getRightSideOnEdge(), MSAbstractLaneChangeModel::getShadowLane(), getSpeed(), MSCFModel::getSpeedAfterMaxDecel(), MSLane::getVehicleMaxSpeed(), MSLane::getVehicleNumber(), MSBaseVehicle::getVehicleType(), MSVehicleType::getWidth(), MSEdge::getWidth(), MSGlobals::gSemiImplicitEulerUpdate, MSGlobals::gUsingInternalLanes, MSVehicle::Influencer::influenceSpeed(), MSEdge::isInternal(), MSLane::isLinkEnd(), MSAbstractLaneChangeModel::isOpposite(), LINKDIR_LEFT, LINKDIR_RIGHT, LINKSTATE_TL_RED, LINKSTATE_TL_REDYELLOW, LINKSTATE_TL_YELLOW_MAJOR, LINKSTATE_TL_YELLOW_MINOR, max, MAX2(), MSCFModel::maximumSafeStopSpeed(), MSCFModel::maxNextSpeed(), MIN2(), MSBaseVehicle::myArrivalPos, MSBaseVehicle::myCurrEdge, myInfluencer, myLane, MSBaseVehicle::myParameter, MSVehicle::State::myPos, MSBaseVehicle::myRoute, MSVehicle::State::mySpeed, myState, myStops, NUMERICAL_EPS, POSITION_EPS, removeApproachingInformation(), SIMTIME, SPEED2DIST, STEPS2TIME, MSCFModel::stopSpeed(), MSLane::succLinkSec(), TIME2STEPS, and toString().

Referenced by planMove().

◆ 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 1145 of file MSVehicle.cpp.

References activateReminders(), MSStopOut::active(), MSBaseVehicle::addReminder(), MSVehicleControl::addWaiting(), MSVehicle::Stop::awaitedContainers, MSVehicle::Stop::awaitedPersons, MSTransportableControl::boardAnyWaiting(), MSVehicle::Stop::busstop, MSVehicle::Stop::collision, MSVehicle::Stop::containerstop, MSVehicle::Stop::containerTriggered, DEBUG_COND, DELTA_T, MSVehicle::Stop::duration, MSVehicle::Stop::edge, MSVehicle::Stop::endPos, MSParkingArea::enter(), MSStoppingPlace::enter(), 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(), 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(), 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::parkingarea, MSVehicle::State::pos(), MSVehicle::Stop::reached, MSVehicleControl::registerOneWaitingForContainer(), MSVehicleControl::registerOneWaitingForPerson(), MSStoppingPlace::removeTransportable(), resumeFromStopping(), SIMTIME, MSVehicle::Stop::startPos, STOPPING_PLACE_OFFSET, MSCFModel::stopSpeed(), MSStopOut::stopStarted(), SUMO_const_haltingSpeed, MSVehicle::Stop::triggered, MSVehicleControl::unregisterOneWaitingForContainer(), MSVehicleControl::unregisterOneWaitingForPerson(), MSVehicle::Stop::until, MSNet::VEHICLE_STATE_STARTING_STOP, and WRITE_WARNING.

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

◆ removeApproachingInformation()

void MSVehicle::removeApproachingInformation ( DriveItemVector lfLinks) const
protected

unregister approach from all upcoming links

Definition at line 3688 of file MSVehicle.cpp.

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

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

◆ removeReminder()

void MSBaseVehicle::removeReminder ( MSMoveReminder rem)
inherited

Removes a MoveReminder dynamically.

Parameters
[in]remthe reminder to remove
See also
MSMoveReminder

Definition at line 345 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 3478 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 
)
virtual

◆ replaceRouteEdges()

bool MSBaseVehicle::replaceRouteEdges ( ConstMSEdgeVector edges,
bool  onInit = false,
bool  check = false,
bool  addStops = 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]addStopsParameter for replaceRoute
Returns
Whether the new route was accepted

Implements SUMOVehicle.

Definition at line 214 of file MSBaseVehicle.cpp.

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

Referenced by MSBaseVehicle::getCurrentRouteEdge(), MSVehicle::Influencer::postProcessVTD(), TraCIServerAPI_Vehicle::processSet(), and MSBaseVehicle::reroute().

◆ replaceVehicleType()

void MSVehicle::replaceVehicleType ( MSVehicleType type)

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
MSVehicle::myType

Definition at line 3572 of file MSVehicle.cpp.

References MSBaseVehicle::myType.

Referenced by TraCIServerAPI_Vehicle::processSet().

◆ reroute()

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

◆ resetRoutePosition()

void MSVehicle::resetRoutePosition ( int  index)

◆ resumeFromStopping()

◆ saveState()

◆ setAngle()

void MSVehicle::setAngle ( double  angle)

Set a custom vehicle angle in rad.

Definition at line 822 of file MSVehicle.cpp.

References myAngle.

Referenced by getVelocityVector(), MSVehicle::Influencer::postProcessVTD(), 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 276 of file MSBaseVehicle.h.

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

◆ setBlinkerInformation()

◆ 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 368 of file MSBaseVehicle.h.

References MSBaseVehicle::addStops(), MSBaseVehicle::calculateArrivalParams(), MSBaseVehicle::getDevice(), MSBaseVehicle::getStopEdges(), MSBaseVehicle::myChosenSpeedFactor, 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

◆ setEmergencyBlueLight()

void MSVehicle::setEmergencyBlueLight ( SUMOTime  currentTime)
protected

sets the blue flashing light for emergency vehicles

Definition at line 3560 of file MSVehicle.cpp.

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

Referenced by executeMove(), and hasInfluencer().

◆ 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 3584 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 TraCIServerAPI_Vehicle::processSet().

◆ setVTDState()

void MSVehicle::setVTDState ( Position  xyPos)

sets position outside the road network

Definition at line 4030 of file MSVehicle.cpp.

References myCachedPosition.

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

◆ 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 138 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(), MELoop::nextSegment(), TraCIServerAPI_Vehicle::processSet(), 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 1132 of file MSVehicle.h.

References mySignals.

Referenced by MSAbstractLaneChangeModel::endLaneChangeManeuver(), executeMove(), TraCIServerAPI_Vehicle::processSet(), setBlinkerInformation(), setEmergencyBlueLight(), 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 1124 of file MSVehicle.h.

References mySignals.

Referenced by executeMove(), TraCIServerAPI_Vehicle::processSet(), setBlinkerInformation(), setEmergencyBlueLight(), and MSAbstractLaneChangeModel::startLaneChangeManeuver().

◆ unsafeLinkAhead()

◆ 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 2939 of file MSVehicle.cpp.

References abs, 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, MSEdge::EDGEFUNCTION_INTERNAL, MSRoute::end(), gDebugSelectedVehicle, getBestLanesContinuation(), MSLane::getEdge(), Named::getID(), MSBaseVehicle::getID(), Named::getIDSecure(), getLaneChangeModel(), MSEdge::getLanes(), MSLane::getLength(), MSEdge::getLength(), MSLane::getLinkCont(), MSLane::getLogicalPredecessorLane(), MSLane::getNextNormal(), MSLane::getOpposite(), MSEdge::getPurpose(), MSVehicleType::getVehicleClass(), 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, POSITION_EPS, SIMTIME, MSVehicle::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::postProcessVTD(), replaceParkingArea(), replaceRoute(), and resumeFromStopping().

◆ updateFurtherLanes()

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

◆ updateOccupancyAndCurrentBestLane()

void MSVehicle::updateOccupancyAndCurrentBestLane ( const MSLane startLane)
protected

updates LaneQ::nextOccupation and myCurrentLaneInBestLanes

Definition at line 3259 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 2290 of file MSVehicle.cpp.

References getDeltaPos(), getLaneChangeModel(), MSLane::getOpposite(), MSLane::getOppositePos(), MSGlobals::gSemiImplicitEulerUpdate, MSVehicle::Influencer::implicitDeltaPosVTD(), Position::INVALID, MSVehicle::Influencer::isVTDControlled(), MAX2(), myAcceleration, myCachedPosition, myInfluencer, myLane, MSVehicle::State::myLastCoveredDist, MSVehicle::State::myPos, MSVehicle::State::myPreviousSpeed, MSVehicle::State::mySpeed, myState, SPEED2ACCEL, and SPEED2DIST.

Referenced by estimateLeaveSpeed(), and executeMove().

◆ 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 4043 of file MSVehicle.cpp.

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

Referenced by hasStops(), and TraCI_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 672 of file MSVehicle.cpp.

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

Referenced by TraCIServerAPI_Vehicle::processSet().

◆ 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 715 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

◆ myAmOnNet

bool MSVehicle::myAmOnNet
protected

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

Definition at line 1551 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 1557 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 1554 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 1562 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 446 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 1705 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 416 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 1568 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 1526 of file MSVehicle.h.

Referenced by updateBestLanes(), and updateOccupancyAndCurrentBestLane().

◆ myDepartPos

double MSBaseVehicle::myDepartPos
protectedinherited

The real depart position.

Definition at line 440 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 1702 of file MSVehicle.h.

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

◆ myEmptyLaneVector

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

Definition at line 1528 of file MSVehicle.h.

Referenced by getBestLanesContinuation().

◆ myEmptyTransportableVector

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

Definition at line 1529 of file MSVehicle.h.

Referenced by getContainers(), and getPersons().

◆ myFurtherLanes

std::vector<MSLane*> MSVehicle::myFurtherLanes
protected

◆ myFurtherLanesPosLat

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

◆ myHaveToWaitOnNextLink

bool MSVehicle::myHaveToWaitOnNextLink
protected

Definition at line 1559 of file MSVehicle.h.

Referenced by checkRewindLinkLanes(), and executeMove().

◆ myInfluencer

Influencer* MSVehicle::myInfluencer
private

◆ myLane

◆ myLaneChangeModel

MSAbstractLaneChangeModel* MSVehicle::myLaneChangeModel
protected

◆ myLastBestLanesEdge

const MSEdge* MSVehicle::myLastBestLanesEdge
protected

Definition at line 1513 of file MSVehicle.h.

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

◆ myLastBestLanesInternalLane

const MSLane* MSVehicle::myLastBestLanesInternalLane
protected

Definition at line 1514 of file MSVehicle.h.

Referenced by replaceRoute(), and updateBestLanes().

◆ myLFLinkLanes

◆ myMoveReminders

◆ myNumberReroutes

int MSBaseVehicle::myNumberReroutes
protectedinherited

The number of reroutings.

Definition at line 449 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 1548 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 1565 of file MSVehicle.h.

Referenced by nextStopDist(), and planMove().

◆ myStops

◆ myTimeLoss

SUMOTime MSVehicle::myTimeLoss
protected

the time loss due to writing with less than maximum speed

Definition at line 1503 of file MSVehicle.h.

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

◆ myType

◆ myWaitingTime

SUMOTime MSVehicle::myWaitingTime
protected

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

Definition at line 1496 of file MSVehicle.h.

Referenced by enterLaneAtInsertion(), executeMove(), getWaitingSeconds(), getWaitingTime(), loadState(), resumeFromStopping(), and saveState().

◆ myWaitingTimeCollector

WaitingTimeCollector MSVehicle::myWaitingTimeCollector
protected

Definition at line 1500 of file MSVehicle.h.

Referenced by executeMove(), and getAccumulatedWaitingTime().

◆ NOT_YET_DEPARTED

const SUMOTime MSBaseVehicle::NOT_YET_DEPARTED = SUMOTime_MAX
staticprotectedinherited

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