SUMO - Simulation of Urban MObility
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
MSVehicle Class Reference

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

#include <MSVehicle.h>

Inheritance diagram for MSVehicle:
MSBaseVehicle SUMOVehicle GUIVehicle

Data Structures

struct  DriveProcessItem
class  Influencer
 Changes the wished vehicle speed / lanes. More...
struct  LaneQ
 A structure representing the best lanes for continuing the route. More...
class  State
 Container that holds the vehicles driving state (position+speed). More...
struct  Stop
 Definition of vehicle stop (position and duration) More...

Public Types

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

Public Member Functions

void activateReminders (const MSMoveReminder::Notification reason)
 "Activates" all current move reminder
SUMOReal adaptMaxSpeed (SUMOReal referenceSpeed)
 Adapts the current maximum speed using the distribution given in the type.
void addPerson (MSPerson *person)
 Adds a person to this vehicle.
void addReminder (MSMoveReminder *rem)
 Adds a MoveReminder dynamically.
bool addTraciStop (MSLane *lane, SUMOReal pos, SUMOReal radius, SUMOTime duration)
bool congested () const
void enterLaneAtInsertion (MSLane *enteredLane, SUMOReal pos, SUMOReal speed, MSMoveReminder::Notification notification)
 Update when the vehicle enters a new lane in the emit step.
void enterLaneAtLaneChange (MSLane *enteredLane)
 Update when the vehicle enters a new lane in the laneChange step.
bool enterLaneAtMove (MSLane *enteredLane, bool onTeleporting=false)
 Update when the vehicle enters a new lane in the move step.
SUMOReal gap2pred (const MSVehicle &pred) const
 Returns the gap between pred and this vehicle.
const MSCFModelgetCarFollowModel () const
 Returns the vehicle's car following model definition.
MSCFModel::VehicleVariablesgetCarFollowVariables () const
 Returns the vehicle's car following model variables.
SUMOTime getDeparture () const
 Returns this vehicle's real departure time.
const std::vector< MSDevice * > & getDevices () const
 Returns this vehicle's devices.
SUMOReal getDistanceToPosition (SUMOReal destPos, const MSEdge *destEdge)
const MSEdgegetEdge () const
 Returns the edge the vehicle is currently at.
const std::string & getID () const
 Returns the name of the vehicle.
InfluencergetInfluencer ()
 Returns the velocity/lane influencer.
MSAbstractLaneChangeModelgetLaneChangeModel ()
const MSAbstractLaneChangeModelgetLaneChangeModel () const
unsigned int getLaneIndex () const
SUMOReal getMaxSpeed () const
 Returns the current maximum speed.
unsigned int getNumberReroutes () const
 Returns the number of new routes this vehicle got.
const SUMOVehicleParametergetParameter () const
 Returns the vehicle's parameter (including departure definition)
const MSRoutegetRoute () const
 Returns the current route.
SUMOReal getSpeedWithoutTraciInfluence () const
 Returns the uninfluenced velocity.
const MSVehicleTypegetVehicleType () const
 Returns the vehicle's type definition.
bool hasValidRoute (std::string &msg) const
 Validates the current route.
bool knowsEdgeTest (MSEdge &edge) const
void leaveLane (const MSMoveReminder::Notification reason)
 Update of members if vehicle leaves a new lane in the lane change step or at arrival.
bool moveChecked ()
 Moves the vehicle after the responds (right-of-way rules) are known.
bool moveRegardingCritical (SUMOTime t, const MSLane *const lane, const MSVehicle *const pred, const MSVehicle *const neigh, SUMOReal lengthsInFront)
 Moves vehicles which may run out of the lane.
 MSVehicle (SUMOVehicleParameter *pars, const MSRoute *route, const MSVehicleType *type, int vehicleIndex)
 Use this constructor only.
void onDepart ()
 Called when the vehicle is inserted into the network.
SUMOReal processNextStop (SUMOReal currentVelocity)
 Processes stops, returns the velocity needed to reach the stop.
void removeReminder (MSMoveReminder *rem)
 Removes a MoveReminder dynamically.
bool replaceRouteEdges (const MSEdgeVector &edges, bool onInit=false)
 Replaces the current route by the given edges.
void replaceVehicleType (MSVehicleType *type)
 Replaces the current vehicle type by the one given.
void reroute (SUMOTime t, SUMOAbstractRouter< MSEdge, SUMOVehicle > &router, bool withTaz=false)
 Performs a rerouting using the given router.
void setIndividualMaxSpeed (SUMOReal individualMaxSpeed)
void setPreDawdleAcceleration (SUMOReal accel)
const MSEdgesuccEdge (unsigned int nSuccs) const
 Returns the nSuccs'th successor of edge the vehicle is currently at.
void unsetIndividualMaxSpeed (void)
void vsafeCriticalCont (SUMOTime t, SUMOReal boundVSafe)
virtual ~MSVehicle ()
 Destructor.
insertion/removal
void onRemovalFromNet (const MSMoveReminder::Notification reason)
 Called when the vehicle is removed from the network.
interaction with the route
bool ends () const
 Returns the information whether the vehicle should end now.
bool replaceRoute (const MSRoute *route, bool onInit=false)
 Replaces the current route by the given one.
bool willPass (const MSEdge *const edge) const
 Returns whether the vehicle wil pass the given edge.
MSEdgeWeightsStoragegetWeightsStorage ()
 Returns the vehicle's internal edge travel times/efforts container.
state setter/getter
SUMOReal getPositionOnLane () const
 Get the vehicle's position along the lane.
SUMOReal getSpeed () const
 Returns the vehicle's current speed.
SUMOReal getPreDawdleAcceleration () const
 Returns the vehicle's acceleration before dawdling.
Other getter methods
Position getPosition () const
 Return current position (x/y, cartesian)
MSLanegetLane () const
 Returns the lane the vehicle is on.
bool isOnRoad () const
 Returns the information whether the vehicle is on a road (is simulated)
SUMOTime getWaitingTime () const
 Returns the SUMOTime waited (speed was lesser than 0.1m/s)
SUMOReal getWaitingSeconds () const
 Returns the number of seconds waited (speed was lesser than 0.1m/s)
SUMOReal getAngle () const
 Returns the vehicle's direction in degrees.
strategical/tactical lane choosing methods
virtual const std::vector
< LaneQ > & 
getBestLanes (bool forceRebuild=false, MSLane *startLane=0) const
 Returns the description of best lanes to use in order to continue the route.
const std::vector< MSLane * > & getBestLanesContinuation () const
 Returns the subpart of best lanes that describes the vehicle's current lane and their successors.
const std::vector< MSLane * > & getBestLanesContinuation (const MSLane *const l) const
 Returns the subpart of best lanes that describes the given lane and their successors.
vehicle stops definitions and i/o
bool addStop (const SUMOVehicleParameter::Stop &stopPar, SUMOTime untilOffset=0)
 Adds a stop.
bool hasStops () const
 Returns whether the vehicle has to stop somewhere.
bool isStopped () const
 Returns whether the vehicle is at a stop.
bool isParking () const
 Returns whether the vehicle is parking.
Emission retrieval
SUMOReal getHBEFA_CO2Emissions () const
 Returns CO2 emission of the current state.
SUMOReal getHBEFA_COEmissions () const
 Returns CO emission of the current state.
SUMOReal getHBEFA_HCEmissions () const
 Returns HC emission of the current state.
SUMOReal getHBEFA_NOxEmissions () const
 Returns NOx emission of the current state.
SUMOReal getHBEFA_PMxEmissions () const
 Returns PMx emission of the current state.
SUMOReal getHBEFA_FuelConsumption () const
 Returns fuel consumption of the current state.
SUMOReal getHarmonoise_NoiseEmissions () const
 Returns noise emissions of the current state.

Static Public Member Functions

static SUMOReal gap (SUMOReal predPos, SUMOReal predLength, SUMOReal pos)
 Uses the given values to compute the brutto-gap.
static bool overlap (const MSVehicle *veh1, const MSVehicle *veh2)

Protected Types

typedef std::vector
< DriveProcessItem
DriveItemVector

Protected Member Functions

void calculateArrivalPos ()
 (Re-)Calculates the arrival position from the vehicle parameters
void checkRewindLinkLanes (SUMOReal lengthsInFront)
SUMOReal getSpaceTillLastStanding (MSLane *l, bool &foundStopped)
void setBlinkerInformation ()

Protected Attributes

bool myAmOnNet
 Whether the vehicle is on the network (not parking, teleported, vaporized, or arrived)
bool myAmRegisteredAsWaitingForPerson
 Whether this vehicle is registered as waiting for a person (for deadlock-recognition)
SUMOReal myArrivalPos
 the position on the destination lane where the vehicle stops
std::vector< std::vector< LaneQ > > myBestLanes
MSRouteIterator myCurrEdge
 Iterator to current route-edge.
std::vector< LaneQ >::iterator myCurrentLaneInBestLanes
SUMOTime myDeparture
 The real departure time.
std::vector< MSDevice * > myDevices
 The devices this vehicle has.
std::vector< MSLane * > myFurtherLanes
 The information into which lanes the vehicle laps into.
bool myHasIndividualMaxSpeed
 is true if there has an individual speed been set
bool myHaveToWaitOnNextLink
SUMOReal myIndividualMaxSpeed
MSLanemyLane
 The lane the vehicle is on.
MSAbstractLaneChangeModelmyLaneChangeModel
const MSEdgemyLastBestLanesEdge
SUMOTime myLastLaneChangeOffset
 information how long ago the vehicle has performed a lane-change
DriveItemVector myLFLinkLanes
 Container for used Links/visited Lanes during lookForward.
unsigned int myNumberReroutes
 The number of reroutings.
const SUMOVehicleParametermyParameter
 This Vehicle's parameter.
MSDevice_PersonmyPersonDevice
 The passengers this vehicle may have.
SUMOReal myPreDawdleAcceleration
 The current acceleration before dawdling.
SUMOReal myReferenceSpeed
 the speed which served as reference when calculating the individual maxspeed
const MSRoutemyRoute
 This Vehicle's route.
int mySignals
 State of things of the vehicle that can be on or off.
State myState
 This Vehicles driving state (pos and speed)
std::list< StopmyStops
 The vehicle's list of stops.
const MSVehicleTypemyType
 This Vehicle's type.
SUMOTime myWaitingTime
 The time the vehicle waits (is not faster than 0.1m/s) in seconds.

Static Protected Attributes

static std::vector< MSLane * > myEmptyLaneVector

Private Member Functions

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

Private Attributes

MSCFModel::VehicleVariablesmyCFVariables
 The per vehicle variables of the car following model.
MSEdgeWeightsStoragemyEdgeWeights
 The vehicle's knowledge about edge efforts/travel times;.
InfluencermyInfluencer
 An instance of a velicty/lane influencing instance; built in "getInfluencer".

Friends

class MSLaneChanger
 the lane changer sets myLastLaneChangeOffset

Move reminder structures

typedef std::vector< std::pair
< MSMoveReminder *, SUMOReal > > 
MoveReminderCont
 Definition of a move reminder container.
MoveReminderCont myMoveReminders
 Current lane's move reminder.

Interaction with move reminders

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

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...
void switchOnSignal (int signal)
 Switches the given signal on.
void switchOffSignal (int signal)
 Switches the given signal off.
int getSignals () const
 Returns the signals.
bool signalSet (int which) const
 Returns whether the given signal is on.

Detailed Description

Representation of a vehicle in the micro simulation.

Definition at line 78 of file MSVehicle.h.

Member Typedef Documentation

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

Definition at line 976 of file MSVehicle.h.

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

Definition of a move reminder container.

Definition at line 257 of file MSBaseVehicle.h.

Member Enumeration Documentation

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

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

Constructor & Destructor Documentation

MSVehicle::~MSVehicle ( )
virtual
MSVehicle::MSVehicle ( )
private

invalidated default constructor

MSVehicle::MSVehicle ( const MSVehicle )
private

invalidated copy constructor

Member Function Documentation

void MSVehicle::activateReminders ( const MSMoveReminder::Notification  reason)
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
See Also
MSMoveReminder
MSMoveReminder::notifyEnter
MSMoveReminder::Notification

Reimplemented from MSBaseVehicle.

Definition at line 1228 of file MSVehicle.cpp.

References getLane(), and MSBaseVehicle::myMoveReminders.

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

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

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

Referenced by enterLaneAtMove().

SUMOReal MSBaseVehicle::adaptMaxSpeed ( SUMOReal  referenceSpeed)
virtualinherited

Adapts the current maximum speed using the distribution given in the type.

Returns
The vehicle's new maximum speed

Implements SUMOVehicle.

Definition at line 123 of file MSBaseVehicle.cpp.

References MSVehicleType::getMaxSpeed(), MSVehicleType::getMaxSpeedWithDeviation(), MSVehicleType::hasSpeedDeviation(), MIN2(), MSBaseVehicle::myHasIndividualMaxSpeed, MSBaseVehicle::myIndividualMaxSpeed, MSBaseVehicle::myReferenceSpeed, and MSBaseVehicle::myType.

void MSVehicle::addPerson ( MSPerson person)
virtual

Adds a person to this vehicle.

The default implementation does nothing since persons are not supported by default

Parameters
[in]personThe person to add

Reimplemented from MSBaseVehicle.

Definition at line 1697 of file MSVehicle.cpp.

References MSDevice_Person::addPerson(), MSDevice_Person::buildVehicleDevices(), MSBaseVehicle::myDevices, MSBaseVehicle::myMoveReminders, myPersonDevice, and myStops.

Referenced by MSPersonControl::boardAnyWaiting().

void MSBaseVehicle::addReminder ( MSMoveReminder rem)
inherited

Adds a MoveReminder dynamically.

Parameters
[in]remthe reminder to add
See Also
MSMoveReminder

Definition at line 252 of file MSBaseVehicle.cpp.

References MSBaseVehicle::myMoveReminders.

Referenced by adaptLaneEntering2MoveReminder(), enterLaneAtInsertion(), and enterLaneAtLaneChange().

bool MSVehicle::addTraciStop ( MSLane lane,
SUMOReal  pos,
SUMOReal  radius,
SUMOTime  duration 
)

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
posposition on the given lane at wich to stop
radiusthe vehicle will stop if it is within the range [pos-radius, pos+radius]
durationafter waiting for the time period duration, the vehicle will continue until the stop is reached again

Definition at line 1757 of file MSVehicle.cpp.

References addStop(), SUMOVehicleParameter::Stop::busstop, SUMOVehicleParameter::Stop::duration, SUMOVehicleParameter::Stop::endPos, MSNet::getBusStopID(), Named::getID(), MSNet::getInstance(), SUMOVehicleParameter::Stop::index, SUMOVehicleParameter::Stop::lane, myStops, SUMOVehicleParameter::Stop::parking, POSITION_EPS, SUMOVehicleParameter::Stop::startPos, STOP_INDEX_END, SUMOVehicleParameter::Stop::triggered, and SUMOVehicleParameter::Stop::until.

bool MSVehicle::congested ( ) const
inline

Returns true if vehicle's speed is below 60km/h. This is only relevant on highways. Overtaking on the right is allowed then.

Definition at line 398 of file MSVehicle.h.

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

Referenced by MSAbstractLaneChangeModel::congested().

bool MSVehicle::ends ( ) const

Returns the information whether the vehicle should end now.

Returns
Whether the route ends

Definition at line 338 of file MSVehicle.cpp.

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

Referenced by enterLaneAtMove(), moveChecked(), and MSLane::setCritical().

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

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

Parameters
[in]enteredLaneThe lane the vehicle enters
[in]posThe position the vehicle was inserted into the lane
[in]speedThe speed with which the vehicle was inserted into the lane
[in]notificationThe cause of insertion (i.e. departure, teleport, parking)

Definition at line 1329 of file MSVehicle.cpp.

References activateReminders(), MSBaseVehicle::addReminder(), MSGlobals::gCheckRoutes, MSBaseVehicle::getID(), MSVehicleType::getLength(), MSLane::getLogicalPredecessorLane(), MSLane::getMoveReminders(), MSBaseVehicle::hasValidRoute(), myAmOnNet, myFurtherLanes, myLane, MSVehicle::State::myPos, MSVehicle::State::mySpeed, myState, MSBaseVehicle::myType, myWaitingTime, and SUMOReal.

Referenced by MSLane::incorporateVehicle().

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

References activateReminders(), adaptLaneEntering2MoveReminder(), MSVehicle::Influencer::checkForLaneChanges(), MSEdge::EDGEFUNCTION_INTERNAL, ends(), getBestLanes(), MSNet::getCurrentTimeStep(), MSLane::getEdge(), MSNet::getInstance(), getLaneIndex(), MSEdge::getPurpose(), myAmOnNet, MSBaseVehicle::myCurrEdge, myInfluencer, myLane, myLaneChangeModel, MSMoveReminder::NOTIFICATION_JUNCTION, and MSAbstractLaneChangeModel::requestLaneChange().

Referenced by MSVehicleTransfer::addVeh(), and moveChecked().

static SUMOReal MSVehicle::gap ( SUMOReal  predPos,
SUMOReal  predLength,
SUMOReal  pos 
)
inlinestatic

Uses the given values to compute the brutto-gap.

Parameters
[in]predPosPosition of the leader
[in]predLengthLength of the leader
[in]posPosition of the follower
Returns
The gap between the leader and the follower

Definition at line 240 of file MSVehicle.h.

Referenced by gap2pred(), MSLane::isInsertionSuccess(), and moveRegardingCritical().

SUMOReal MSVehicle::gap2pred ( const MSVehicle pred) const
inline

Returns the gap between pred and this vehicle.

Assumes both vehicles are on the same or on are on parallel lanes.

Parameters
[in]predThe leader
Returns
The gap between this vehicle and the leader (may be <0)

Definition at line 224 of file MSVehicle.h.

References gap(), MSVehicleType::getLength(), MSVehicleType::getMinGap(), getPositionOnLane(), MSBaseVehicle::getVehicleType(), and SUMOReal.

Referenced by moveRegardingCritical().

const std::vector< MSVehicle::LaneQ > & MSVehicle::getBestLanes ( bool  forceRebuild = false,
MSLane startLane = 0 
) const
virtual

Returns the description of 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 get 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)
Returns
The best lanes structure holding matching the current vehicle position and state ahead

Definition at line 1393 of file MSVehicle.cpp.

References abs, MSEdge::allowedLanes(), MSVehicle::LaneQ::allowsContinuation, ARRIVAL_LANE_GIVEN, SUMOVehicleParameter::arrivalLane, SUMOVehicleParameter::arrivalLaneProcedure, MSVehicle::LaneQ::bestContinuations, MSVehicle::LaneQ::bestLaneOffset, bla, MSRoute::end(), MSLane::getEdge(), MSEdge::getLanes(), MSLane::getLength(), MSVehicleType::getVehicleClass(), GLO_VEHICLE, gSelected, GUISelectedStorage::isSelected(), MSVehicle::LaneQ::lane, MSVehicle::Stop::lane, MSVehicle::LaneQ::length, MSBaseVehicle::myArrivalPos, myBestLanes, MSBaseVehicle::myCurrEdge, myCurrentLaneInBestLanes, myLane, myLastBestLanesEdge, MSBaseVehicle::myParameter, MSBaseVehicle::myRoute, myStops, MSBaseVehicle::myType, MSVehicle::Stop::startPos, and SUMOReal.

Referenced by MSLaneChanger::change(), enterLaneAtMove(), MSEdge::getDepartLane(), MSLane::isInsertionSuccess(), TraCIServerAPI_Vehicle::processGet(), processNextStop(), MSLane::pWagGenericInsertion(), and MSLane::pWagSimpleInsertion().

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

Returns the subpart of best lanes that describes the vehicle's current lane and their successors.

Returns
The best lane information for the vehicle's current lane
Todo:
Describe better

Definition at line 1613 of file MSVehicle.cpp.

References MSEdge::EDGEFUNCTION_INTERNAL, MSLane::getEdge(), MSEdge::getPurpose(), myBestLanes, myEmptyLaneVector, and myLane.

Referenced by MSLane::appropriate(), MSLaneChanger::getRealLeader(), MSLaneChanger::getRealThisLeader(), MSLane::isInsertionSuccess(), MSCFModel_PWag2009::moveHelper(), MSLane::pWagGenericInsertion(), MSLane::pWagSimpleInsertion(), setBlinkerInformation(), and vsafeCriticalCont().

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

Returns the subpart of best lanes that describes the given lane and their successors.

Returns
The best lane information for the given lane
Todo:
Describe better

Definition at line 1622 of file MSVehicle.cpp.

References myBestLanes, and myEmptyLaneVector.

MSCFModel::VehicleVariables* MSVehicle::getCarFollowVariables ( ) const
inline

Returns the vehicle's car following model variables.

Returns
The vehicle's car following model variables

Definition at line 539 of file MSVehicle.h.

References myCFVariables.

Referenced by MSCFModel_Wiedemann::_v(), MSCFModel_IDM::_v(), MSCFModel_PWag2009::moveHelper(), MSCFModel_Wiedemann::moveHelper(), and MSCFModel_IDM::moveHelper().

SUMOTime MSBaseVehicle::getDeparture ( ) const
virtualinherited

Returns this vehicle's real departure time.

Returns
This vehicle's real departure time

Implements SUMOVehicle.

Definition at line 213 of file MSBaseVehicle.cpp.

References MSBaseVehicle::myDeparture.

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

Returns this vehicle's devices.

Returns
This vehicle's devices

Implements SUMOVehicle.

Definition at line 179 of file MSBaseVehicle.h.

References MSBaseVehicle::myDevices.

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

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

Parameters
destPos,:position on the destination edge that shall be reached
destEdge,:destination 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 1634 of file MSVehicle.cpp.

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

const MSEdge * MSBaseVehicle::getEdge ( ) const
virtualinherited

Returns the edge the vehicle is currently at.

Returns
The current edge in the vehicle's route

Implements SUMOVehicle.

Definition at line 147 of file MSBaseVehicle.cpp.

References MSBaseVehicle::myCurrEdge.

Referenced by MSVehicleTransfer::addVeh(), MSVehicleTransfer::checkInsertions(), and TraCIServerAPI_Vehicle::commandDistanceRequest().

SUMOReal MSVehicle::getHarmonoise_NoiseEmissions ( ) const

Returns noise emissions of the current state.

Returns
The noise produced

Definition at line 1691 of file MSVehicle.cpp.

References HelpersHarmonoise::computeNoise(), MSVehicleType::getEmissionClass(), myPreDawdleAcceleration, myState, MSBaseVehicle::myType, and MSVehicle::State::speed().

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

SUMOReal MSVehicle::getHBEFA_CO2Emissions ( ) const

Returns CO2 emission of the current state.

Returns
The current CO2 emission

Definition at line 1655 of file MSVehicle.cpp.

References HelpersHBEFA::computeCO2(), MSVehicleType::getEmissionClass(), myPreDawdleAcceleration, myState, MSBaseVehicle::myType, and MSVehicle::State::speed().

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

SUMOReal MSVehicle::getHBEFA_COEmissions ( ) const

Returns CO emission of the current state.

Returns
The current CO emission

Definition at line 1661 of file MSVehicle.cpp.

References HelpersHBEFA::computeCO(), MSVehicleType::getEmissionClass(), myPreDawdleAcceleration, myState, MSBaseVehicle::myType, and MSVehicle::State::speed().

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

SUMOReal MSVehicle::getHBEFA_FuelConsumption ( ) const

Returns fuel consumption of the current state.

Returns
The current fuel consumption

Definition at line 1685 of file MSVehicle.cpp.

References HelpersHBEFA::computeFuel(), MSVehicleType::getEmissionClass(), myPreDawdleAcceleration, myState, MSBaseVehicle::myType, and MSVehicle::State::speed().

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

SUMOReal MSVehicle::getHBEFA_HCEmissions ( ) const

Returns HC emission of the current state.

Returns
The current HC emission

Definition at line 1667 of file MSVehicle.cpp.

References HelpersHBEFA::computeHC(), MSVehicleType::getEmissionClass(), myPreDawdleAcceleration, myState, MSBaseVehicle::myType, and MSVehicle::State::speed().

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

SUMOReal MSVehicle::getHBEFA_NOxEmissions ( ) const

Returns NOx emission of the current state.

Returns
The current NOx emission

Definition at line 1673 of file MSVehicle.cpp.

References HelpersHBEFA::computeNOx(), MSVehicleType::getEmissionClass(), myPreDawdleAcceleration, myState, MSBaseVehicle::myType, and MSVehicle::State::speed().

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

SUMOReal MSVehicle::getHBEFA_PMxEmissions ( ) const

Returns PMx emission of the current state.

Returns
The current PMx emission

Definition at line 1679 of file MSVehicle.cpp.

References HelpersHBEFA::computePMx(), MSVehicleType::getEmissionClass(), myPreDawdleAcceleration, myState, MSBaseVehicle::myType, and MSVehicle::State::speed().

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

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

References myInfluencer.

const MSAbstractLaneChangeModel & MSVehicle::getLaneChangeModel ( ) const

Definition at line 1387 of file MSVehicle.cpp.

References myLaneChangeModel.

unsigned int MSVehicle::getLaneIndex ( ) const

Definition at line 1749 of file MSVehicle.cpp.

References myLane.

Referenced by enterLaneAtLaneChange(), and enterLaneAtMove().

SUMOReal MSBaseVehicle::getMaxSpeed ( ) const
virtualinherited
unsigned int MSBaseVehicle::getNumberReroutes ( ) const
virtualinherited

Returns the number of new routes this vehicle got.

Returns
the number of new routes this vehicle got

Implements SUMOVehicle.

Definition at line 219 of file MSBaseVehicle.cpp.

References MSBaseVehicle::myNumberReroutes.

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

const SUMOVehicleParameter & MSBaseVehicle::getParameter ( ) const
virtualinherited

Returns the vehicle's parameter (including departure definition)

Returns
The vehicle's parameter

Implements SUMOVehicle.

Definition at line 96 of file MSBaseVehicle.cpp.

References MSBaseVehicle::myParameter.

Referenced by MSPersonControl::boardAnyWaiting(), MSEdge::getDepartLane(), GUIVehicle::getParameterWindow(), MSLane::insertVehicle(), TraCIServerAPI_Vehicle::processGet(), and GUIVehicle::setFunctionalColor().

Position MSVehicle::getPosition ( ) const

Return current position (x/y, cartesian)

If the vehicle's myLane is 0, -1000/-1000 is returned.

Todo:
Recheck myLane usage in this context, think about a proper "invalid" return value
Returns
The current position (in cartesian coordinates)
See Also
myLane

Definition at line 427 of file MSVehicle.cpp.

References MSLane::getShape(), myLane, myState, MSVehicle::State::pos(), and PositionVector::positionAtLengthPosition().

Referenced by TraCIServerAPI_Vehicle::commandDistanceRequest(), enterLaneAtLaneChange(), GUIVehicle::getCenteringBoundary(), moveChecked(), moveRegardingCritical(), and TraCIServerAPI_Vehicle::processGet().

SUMOReal MSVehicle::getPreDawdleAcceleration ( ) const
inlinevirtual

Returns the vehicle's acceleration before dawdling.

Returns
The acceleration before dawdling

Reimplemented from MSBaseVehicle.

Definition at line 306 of file MSVehicle.h.

References myPreDawdleAcceleration.

Referenced by TraCIServerAPI_Vehicle::processGet().

const MSRoute & MSBaseVehicle::getRoute ( ) const
virtualinherited
int MSVehicle::getSignals ( ) const
inline

Returns the signals.

Returns
The signals' states

Definition at line 733 of file MSVehicle.h.

References mySignals.

Referenced by TraCIServerAPI_Vehicle::processGet().

SUMOReal MSVehicle::getSpaceTillLastStanding ( MSLane l,
bool foundStopped 
)
protected
SUMOReal 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 1794 of file MSVehicle.cpp.

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

Referenced by TraCIServerAPI_Vehicle::processGet().

const MSVehicleType & MSBaseVehicle::getVehicleType ( ) const
virtualinherited

Returns the vehicle's type definition.

Returns
The vehicle's type definition

Implements SUMOVehicle.

Definition at line 108 of file MSBaseVehicle.cpp.

References MSBaseVehicle::myType.

Referenced by MSLaneChanger::change(), MSVehicleTransfer::checkInsertions(), checkRewindLinkLanes(), MSLane::detectCollisions(), MSE2Collector::detectorUpdate(), drawAction_drawBlinker(), drawAction_drawVehicleAsBoxPlus(), drawAction_drawVehicleAsPoly(), drawAction_drawVehicleAsTrianglePlus(), drawAction_drawVehicleBlinker(), drawAction_drawVehicleBrakeLight(), GUIVehicle::drawGL(), MSLane::enteredByLaneChange(), enterLaneAtLaneChange(), MSVTypeProbe::execute(), MSLane::freeInsertion(), gap2pred(), MSEdge::getDepartLane(), MSLane::getFollowerOnConsecutive(), MSLane::getLastVehicleInformation(), MSLane::getLeaderOnConsecutive(), MSLaneChanger::getRealFollower(), MSLaneChanger::getRealLeader(), MSLaneChanger::getRealThisLeader(), MSLane::incorporateVehicle(), MSLane::insertVehicle(), MSLane::integrateNewVehicle(), MSLane::isInsertionSuccess(), MSLane::leftByLaneChange(), MSCFModel::leftVehicleVsafe(), MSLane::maxSpeedGapInsertion(), moveChecked(), moveRegardingCritical(), overlap(), MSLCM_DK2004::patchSpeed(), MSAbstractLaneChangeModel::predInteraction(), TraCIServerAPI_Vehicle::processGet(), processNextStop(), MSLane::pWagGenericInsertion(), MSLane::pWagSimpleInsertion(), MSLane::removeVehicle(), MSLane::setCritical(), GUIVehicle::setFunctionalColor(), vsafeCriticalCont(), MSLCM_DK2004::wantsChangeToLeft(), and MSLCM_DK2004::wantsChangeToRight().

SUMOReal 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 359 of file MSVehicle.h.

References myWaitingTime, and STEPS2TIME.

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

SUMOTime MSVehicle::getWaitingTime ( ) const
inline

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

Definition at line 348 of file MSVehicle.h.

References myWaitingTime.

MSEdgeWeightsStorage & MSVehicle::getWeightsStorage ( )

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

References myEdgeWeights.

Referenced by TraCIServerAPI_Vehicle::processGet().

bool MSVehicle::hasStops ( ) const
inline

Returns whether the vehicle has to stop somewhere.

Returns
Whether the vehicle has to stop somewhere

Definition at line 586 of file MSVehicle.h.

References myStops.

bool MSBaseVehicle::hasValidRoute ( std::string &  msg) const
inherited

Validates the current route.

Parameters
[out]msgDescription why the route is not valid (if it is the case)
Returns
Whether the vehicle's current route is valid

Definition at line 230 of file MSBaseVehicle.cpp.

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

Referenced by enterLaneAtInsertion(), and TraCIServerAPI_Vehicle::processGet().

bool MSVehicle::isOnRoad ( ) const
inlinevirtual

Returns the information whether the vehicle is on a road (is simulated)

Returns
Whether the vehicle is simulated

Reimplemented from MSBaseVehicle.

Definition at line 337 of file MSVehicle.h.

References myAmOnNet.

Referenced by TraCIServerAPI_Vehicle::commandDistanceRequest(), MSVTypeProbe::execute(), getDistanceToPosition(), moveChecked(), moveRegardingCritical(), and TraCIServerAPI_Vehicle::processGet().

bool MSVehicle::isParking ( ) const

Returns whether the vehicle is parking.

Returns
whether the vehicle is parking

Definition at line 517 of file MSVehicle.cpp.

References isStopped(), and myStops.

Referenced by MSVehicleTransfer::addVeh(), and MSLane::setCritical().

bool MSVehicle::isStopped ( ) const
virtual

Returns whether the vehicle is at a stop.

Returns
Whether the vehicle has stopped

Implements SUMOVehicle.

Definition at line 511 of file MSVehicle.cpp.

References myStops.

Referenced by isParking().

bool MSVehicle::knowsEdgeTest ( MSEdge edge) const
bool MSVehicle::moveChecked ( )

Moves the vehicle after the responds (right-of-way rules) are known.

In this second step, vehicles are moved. The right-of-way - conditions have been computed and the vehicle knows which intersections may be passed.

The vehicle computes the allowed velocity, first. Then, it is moved along the previously computed links. If the vehicle enters a new lane, it is set in myLane.

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

References ACCEL2SPEED, bla, MSCFModel::brakeGap(), DELTA_T, MSRoute::end(), ends(), enterLaneAtMove(), MSVehicleType::getCarFollowModel(), getCarFollowModel(), MSNet::getCurrentTimeStep(), MSLane::getEdge(), MSCFModel::getHeadwayTime(), MSNet::getInstance(), MSLink::getLane(), MSVehicleType::getLength(), MSLane::getLength(), MSCFModel::getMaxDecel(), MSBaseVehicle::getMaxSpeed(), getPosition(), MSLink::getState(), MSBaseVehicle::getVehicleType(), GLO_VEHICLE, gSelected, MSLink::havePriority(), SUMOVehicleParameter::id, MSVehicle::Influencer::influenceSpeed(), MSLink::isCont(), isOnRoad(), GUISelectedStorage::isSelected(), MSEdge::isVaporizing(), leaveLane(), LINKSTATE_EQUAL, LINKSTATE_TL_GREEN_MAJOR, LINKSTATE_TL_YELLOW_MAJOR, LINKSTATE_TL_YELLOW_MINOR, MAX2(), MSCFModel::maxNextSpeed(), MIN2(), MSCFModel::moveHelper(), MSBaseVehicle::myCurrEdge, myFurtherLanes, myHaveToWaitOnNextLink, myInfluencer, myLane, myLFLinkLanes, MSBaseVehicle::myParameter, MSVehicle::State::myPos, MSBaseVehicle::myRoute, MSVehicle::State::mySpeed, myState, myWaitingTime, MSMoveReminder::NOTIFICATION_JUNCTION, MSLink::opened(), MSVehicle::State::pos(), MSLink::removeApproaching(), MSLane::resetPartialOccupation(), setBlinkerInformation(), MSVehicle::State::speed(), SPEED2DIST, SUMOReal, switchOffSignal(), switchOnSignal(), VEH_SIGNAL_BRAKELIGHT, workOnMoveReminders(), Position::x(), and Position::y().

Referenced by MSLane::setCritical().

bool MSVehicle::moveRegardingCritical ( SUMOTime  t,
const MSLane *const  lane,
const MSVehicle *const  pred,
const MSVehicle *const  neigh,
SUMOReal  lengthsInFront 
)

Moves vehicles which may run out of the lane.

Parameters
[in]laneThe lane the vehicle is on
[in]predThe leader (may be 0)
[in]neighThe neighbor vehicle (may be 0)
[in]lengthsInFrontSum of vehicle lengths in front of the vehicle
Returns
Whether a collision occured (gap2pred(leader)<=0)

Definition at line 605 of file MSVehicle.cpp.

References MSLane::appropriate(), ARRIVAL_SPEED_GIVEN, SUMOVehicleParameter::arrivalSpeed, SUMOVehicleParameter::arrivalSpeedProcedure, bla, MSVehicle::Stop::busstop, checkRewindLinkLanes(), MSRoute::end(), MSVehicle::Stop::endPos, MSCFModel::followSpeed(), MSCFModel::freeSpeed(), gap(), gap2pred(), MSGlobals::gCheck4Accidents, getCarFollowModel(), MSNet::getCurrentTimeStep(), MSLane::getEdge(), MSBaseVehicle::getID(), MSNet::getInstance(), MSBusStop::getLastFreePos(), MSLane::getLength(), MSCFModel::getMaxDecel(), MSLane::getMaxSpeed(), MSVehicleType::getMinGap(), MSLane::getPartialOccupator(), MSLane::getPartialOccupatorEnd(), getPosition(), getSpeed(), MSCFModel::getSpeedAfterMaxDecel(), MSBaseVehicle::getVehicleType(), GLO_VEHICLE, gSelected, SUMOVehicleParameter::id, isOnRoad(), GUISelectedStorage::isSelected(), MSCFModel::leftVehicleVsafe(), MAX2(), MSCFModel::maxNextSpeed(), MIN2(), MSBaseVehicle::myArrivalPos, MSBaseVehicle::myCurrEdge, myLane, myLFLinkLanes, MSBaseVehicle::myParameter, MSVehicle::State::myPos, MSBaseVehicle::myRoute, MSVehicle::State::mySpeed, myState, myStops, MSVehicle::State::pos(), POSITION_EPS, MSVehicle::State::speed(), MSCFModel::stopSpeed(), SUMOReal, toString(), vsafeCriticalCont(), WRITE_WARNING, Position::x(), and Position::y().

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

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

Referenced by traci::TraCIServer::commandAddVehicle().

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

References leaveLane(), myLFLinkLanes, MSVehicle::State::myPos, MSVehicle::State::mySpeed, myState, SPEED2DIST, and workOnMoveReminders().

Referenced by MSVehicleTransfer::addVeh(), and MSLane::setCritical().

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

invalidated assignment operator

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

Returns true if the two vehicles overlap.

Definition at line 388 of file MSVehicle.h.

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

Referenced by MSLaneChanger::overlapWithHopped().

void MSBaseVehicle::removeReminder ( MSMoveReminder rem)
inherited

Removes a MoveReminder dynamically.

Parameters
[in]remthe reminder to remove
See Also
MSMoveReminder

Definition at line 258 of file MSBaseVehicle.cpp.

References MSBaseVehicle::myMoveReminders.

bool MSVehicle::replaceRoute ( const MSRoute route,
bool  onInit = false 
)
virtual

Replaces the current route by the given one.

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

Parameters
[in]routeThe new route to pass
Returns
Whether the new route was accepted

Implements SUMOVehicle.

Definition at line 344 of file MSVehicle.cpp.

References MSRoute::addReference(), MSRoute::begin(), MSBaseVehicle::calculateArrivalPos(), MSRoute::contains(), MSRoute::getEdges(), MSNet::getInstance(), MSNet::informVehicleStateListener(), MSBaseVehicle::myCurrEdge, myLastBestLanesEdge, MSBaseVehicle::myNumberReroutes, MSBaseVehicle::myRoute, myStops, MSRoute::release(), and MSNet::VEHICLE_STATE_NEWROUTE.

bool MSBaseVehicle::replaceRouteEdges ( const MSEdgeVector edges,
bool  onInit = false 
)
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]simTimeThe time at which the route was replaced
Returns
Whether the new route was accepted

Implements SUMOVehicle.

Definition at line 174 of file MSBaseVehicle.cpp.

References MSRoute::addReference(), MSRoute::dictionary(), MSRoute::getColor(), Named::getID(), MSBaseVehicle::getID(), MSBaseVehicle::getNumberReroutes(), MSRoute::getStops(), MSBaseVehicle::myRoute, MSRoute::release(), SUMOVehicle::replaceRoute(), and toString().

Referenced by TraCIServerAPI_Vehicle::processSet(), and MSBaseVehicle::reroute().

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

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

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

Performs a rerouting using the given router.

Tries to find a new route between the current edge and the destination edge, first. Tries to replace the current route by the new one using replaceRoute.

Parameters
[in]tThe time for which the route is computed
[in]routerThe router to use
See Also
replaceRoute

Implements SUMOVehicle.

Definition at line 153 of file MSBaseVehicle.cpp.

References SUMOAbstractRouter< E, V >::compute(), MSEdge::dictionary(), SUMOVehicleParameter::fromTaz, MSBaseVehicle::getID(), MSRoute::getLastEdge(), MSBaseVehicle::myCurrEdge, MSBaseVehicle::myParameter, MSBaseVehicle::myRoute, MSBaseVehicle::replaceRouteEdges(), SUMOVehicleParameter::toTaz, and WRITE_WARNING.

void MSVehicle::setIndividualMaxSpeed ( SUMOReal  individualMaxSpeed)
inline
void MSVehicle::setPreDawdleAcceleration ( SUMOReal  accel)
inline

Definition at line 382 of file MSVehicle.h.

References myPreDawdleAcceleration.

Referenced by MSCFModel_KraussOrig1::moveHelper(), and MSCFModel::moveHelper().

bool MSVehicle::signalSet ( int  which) const
inline

Returns whether the given signal is on.

Parameters
[in]signalThe signal to return the value of
Returns
Whether the given signal is on

Definition at line 742 of file MSVehicle.h.

References mySignals.

Referenced by checkRewindLinkLanes(), drawAction_drawVehicleBlinker(), and drawAction_drawVehicleBrakeLight().

const MSEdge * MSBaseVehicle::succEdge ( unsigned 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 137 of file MSBaseVehicle.cpp.

References MSBaseVehicle::myCurrEdge.

Referenced by MSVehicleTransfer::addVeh(), and MSVehicleTransfer::checkInsertions().

void MSVehicle::switchOffSignal ( int  signal)
inline

Switches the given signal off.

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

Definition at line 725 of file MSVehicle.h.

References mySignals.

Referenced by moveChecked(), and setBlinkerInformation().

void MSVehicle::switchOnSignal ( int  signal)
inline

Switches the given signal on.

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

Definition at line 717 of file MSVehicle.h.

References mySignals.

Referenced by moveChecked(), and setBlinkerInformation().

void MSVehicle::unsetIndividualMaxSpeed ( void  )
inline

Definition at line 378 of file MSVehicle.h.

References MSBaseVehicle::myHasIndividualMaxSpeed.

void MSVehicle::vsafeCriticalCont ( SUMOTime  t,
SUMOReal  boundVSafe 
)
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 382 of file MSVehicle.cpp.

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

void MSVehicle::workOnMoveReminders ( SUMOReal  oldPos,
SUMOReal  newPos,
SUMOReal  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 398 of file MSVehicle.cpp.

References MSBaseVehicle::myMoveReminders.

Referenced by moveChecked(), onRemovalFromNet(), and MSLane::setCritical().

Friends And Related Function Documentation

friend class MSLaneChanger
friend

the lane changer sets myLastLaneChangeOffset

Definition at line 82 of file MSVehicle.h.

Field Documentation

bool MSVehicle::myAmOnNet
protected

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

Definition at line 954 of file MSVehicle.h.

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

bool MSVehicle::myAmRegisteredAsWaitingForPerson
protected

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

Definition at line 957 of file MSVehicle.h.

Referenced by processNextStop().

SUMOReal MSBaseVehicle::myArrivalPos
protectedinherited

the position on the destination lane where the vehicle stops

Definition at line 270 of file MSBaseVehicle.h.

Referenced by MSBaseVehicle::calculateArrivalPos(), ends(), getBestLanes(), moveRegardingCritical(), and vsafeCriticalCont().

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

Definition at line 934 of file MSVehicle.h.

Referenced by GUIVehicle::drawBestLanes(), getBestLanes(), and getBestLanesContinuation().

MSCFModel::VehicleVariables* MSVehicle::myCFVariables
private

The per vehicle variables of the car following model.

Definition at line 987 of file MSVehicle.h.

Referenced by getCarFollowVariables(), and MSVehicle().

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

Definition at line 935 of file MSVehicle.h.

Referenced by getBestLanes().

SUMOTime MSBaseVehicle::myDeparture
protectedinherited

The real departure time.

Definition at line 267 of file MSBaseVehicle.h.

Referenced by MSBaseVehicle::getDeparture(), and MSBaseVehicle::onDepart().

std::vector<MSDevice*> MSBaseVehicle::myDevices
protectedinherited
MSEdgeWeightsStorage* MSVehicle::myEdgeWeights
private

The vehicle's knowledge about edge efforts/travel times;.

See Also
MSEdgeWeightsStorage

Definition at line 984 of file MSVehicle.h.

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

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

Definition at line 936 of file MSVehicle.h.

Referenced by getBestLanesContinuation().

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

The information into which lanes the vehicle laps into.

Definition at line 948 of file MSVehicle.h.

Referenced by enterLaneAtInsertion(), getAngle(), leaveLane(), moveChecked(), and ~MSVehicle().

bool MSBaseVehicle::myHasIndividualMaxSpeed
protectedinherited

is true if there has an individual speed been set

Definition at line 248 of file MSBaseVehicle.h.

Referenced by MSBaseVehicle::adaptMaxSpeed(), MSBaseVehicle::getMaxSpeed(), setIndividualMaxSpeed(), and unsetIndividualMaxSpeed().

bool MSVehicle::myHaveToWaitOnNextLink
protected

Definition at line 959 of file MSVehicle.h.

Referenced by checkRewindLinkLanes(), and moveChecked().

SUMOReal MSBaseVehicle::myIndividualMaxSpeed
protectedinherited

An individual speed for an vehicle that is used (iff set) instead of the maximal speed of the vehicle class. NOTE: This is just a little workaround for allowing an external influence on the actual speed

Definition at line 245 of file MSBaseVehicle.h.

Referenced by MSBaseVehicle::adaptMaxSpeed(), MSBaseVehicle::getMaxSpeed(), and setIndividualMaxSpeed().

Influencer* MSVehicle::myInfluencer
private

An instance of a velicty/lane influencing instance; built in "getInfluencer".

Definition at line 991 of file MSVehicle.h.

Referenced by enterLaneAtLaneChange(), enterLaneAtMove(), getInfluencer(), getSpeedWithoutTraciInfluence(), moveChecked(), vsafeCriticalCont(), and ~MSVehicle().

MSAbstractLaneChangeModel* MSVehicle::myLaneChangeModel
protected
const MSEdge* MSVehicle::myLastBestLanesEdge
mutableprotected

Definition at line 933 of file MSVehicle.h.

Referenced by getBestLanes(), and replaceRoute().

SUMOTime MSVehicle::myLastLaneChangeOffset
protected

information how long ago the vehicle has performed a lane-change

Definition at line 913 of file MSVehicle.h.

Referenced by MSLaneChanger::change(), and GUIVehicle::getLastLaneChangeOffset().

DriveItemVector MSVehicle::myLFLinkLanes
protected

Container for used Links/visited Lanes during lookForward.

Definition at line 979 of file MSVehicle.h.

Referenced by checkRewindLinkLanes(), GUIVehicle::drawGLAdditional(), moveChecked(), moveRegardingCritical(), onRemovalFromNet(), vsafeCriticalCont(), and ~MSVehicle().

unsigned int MSBaseVehicle::myNumberReroutes
protectedinherited

The number of reroutings.

Definition at line 273 of file MSBaseVehicle.h.

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

MSDevice_Person* MSVehicle::myPersonDevice
protected

The passengers this vehicle may have.

Definition at line 942 of file MSVehicle.h.

Referenced by addPerson().

SUMOReal MSBaseVehicle::myReferenceSpeed
protectedinherited

the speed which served as reference when calculating the individual maxspeed

Definition at line 251 of file MSBaseVehicle.h.

Referenced by MSBaseVehicle::adaptMaxSpeed().

int MSVehicle::mySignals
protected

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

Definition at line 951 of file MSVehicle.h.

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

std::list<Stop> MSVehicle::myStops
protected
SUMOTime MSVehicle::myWaitingTime
protected

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

Definition at line 916 of file MSVehicle.h.

Referenced by enterLaneAtInsertion(), getWaitingSeconds(), getWaitingTime(), moveChecked(), and processNextStop().


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