SUMO - Simulation of Urban MObility
MSLCM_DK2008 Class Reference

A lane change model developed by D. Krajzewicz between 2004 and 2010. More...

#include <MSLCM_DK2008.h>

Inheritance diagram for MSLCM_DK2008:
Inheritance graph
Collaboration diagram for MSLCM_DK2008:
Collaboration graph

Public Types

enum  MyLCAEnum {
  LCA_AMBLOCKINGLEADER = 1 << 16, LCA_AMBLOCKINGFOLLOWER = 1 << 17, LCA_MRIGHT = 1 << 18, LCA_MLEFT = 1 << 19,
  LCA_AMBLOCKINGFOLLOWER_DONTBRAKE = 1 << 21, LCA_AMBACKBLOCKER = 1 << 26, LCA_AMBACKBLOCKER_STANDING = 1 << 27
}
 

Public Member Functions

bool alreadyChanged () const
 reset the flag whether a vehicle already moved to false More...
 
virtual void changed ()
 
void changedToOpposite ()
 called when a vehicle changes between lanes in opposite directions More...
 
void checkTraCICommands ()
 Check for commands issued for the vehicle via TraCI and apply the appropriate state changes For the sublane case, this includes setting a new maneuver distance if appropriate. More...
 
void cleanupShadowLane ()
 
void cleanupTargetLane ()
 
virtual double computeSpeedLat (double latDist, double &maneuverDist)
 decides the next lateral speed depending on the remaining lane change distance to be covered and updates maneuverDist according to lateral safety constraints. More...
 
virtual bool debugVehicle () const
 whether the current vehicles shall be debugged More...
 
virtual StateAndDist decideDirection (StateAndDist sd1, StateAndDist sd2) const
 decide in which direction to move in case both directions are desirable More...
 
MSLanedetermineTargetLane (int &targetDir) const
 
void endLaneChangeManeuver (const MSMoveReminder::Notification reason=MSMoveReminder::NOTIFICATION_LANE_CHANGE)
 
double getAngleOffset () const
 return the angle offset during a continuous change maneuver More...
 
double getCommittedSpeed () const
 
const std::vector< MSLane * > & getFurtherTargetLanes () const
 
int getLaneChangeDirection () const
 return the direction of the current lane change maneuver More...
 
SUMOTime getLastLaneChangeOffset () const
 
double getManeuverDist () const
 Returns the remaining unblocked distance for the current maneuver. (only used by sublane model) More...
 
int getOwnState () const
 
virtual std::string getParameter (const std::string &key) const
 try to retrieve the given parameter from this laneChangeModel. Throw exception for unsupported key More...
 
int getPrevState () const
 
const std::pair< int, int > & getSavedState (const int dir) const
 
int getShadowDirection () const
 return the direction in which the current shadow lane lies More...
 
const std::vector< MSLane * > & getShadowFurtherLanes () const
 
const std::vector< double > & getShadowFurtherLanesPosLat () const
 
MSLanegetShadowLane () const
 Returns the lane the vehicle's shadow is on during continuous/sublane lane change. More...
 
MSLanegetShadowLane (const MSLane *lane) const
 return the shadow lane for the given lane More...
 
MSLanegetShadowLane (const MSLane *lane, double posLat) const
 return the shadow lane for the given lane and lateral offset More...
 
double getSpeedLat () const
 return the lateral speed of the current lane change maneuver More...
 
MSLanegetTargetLane () const
 Returns the lane the vehicle has committed to enter during a sublane lane change. More...
 
virtual void * inform (void *info, MSVehicle *sender)
 
bool isChangingLanes () const
 return true if the vehicle currently performs a lane change maneuver More...
 
bool isOpposite () const
 
void laneChangeOutput (const std::string &tag, MSLane *source, MSLane *target, int direction)
 called once the vehicle ends a lane change manoeuvre (non-instant) More...
 
 MSLCM_DK2008 (MSVehicle &v)
 
bool pastMidpoint () const
 return whether the vehicle passed the midpoint of a continuous lane change maneuver More...
 
virtual double patchSpeed (const double min, const double wanted, const double max, const MSCFModel &cfModel)
 Called to adapt the speed in order to allow a lane change. More...
 
virtual void prepareStep ()
 
void primaryLaneChanged (MSLane *source, MSLane *target, int direction)
 called once when the vehicles primary lane changes More...
 
SUMOTime remainingTime () const
 return whether the vehicle passed the midpoint of a continuous lane change maneuver More...
 
void removeShadowApproachingInformation () const
 
void resetChanged ()
 reset the flag whether a vehicle already moved to false More...
 
virtual void saveBlockerLength (double length)
 reserve space at the end of the lane to avoid dead locks More...
 
void saveState (const int dir, const int stateWithoutTraCI, const int state)
 
void setFollowerGaps (CLeaderDist follower, double secGap)
 
void setFollowerGaps (const MSLeaderDistanceInfo &vehicles)
 
void setLeaderGaps (CLeaderDist, double secGap)
 
void setLeaderGaps (const MSLeaderDistanceInfo &vehicles)
 
void setManeuverDist (const double dist)
 Updates the remaining distance for the current maneuver while it is continued within non-action steps (only used by sublane model) More...
 
void setNoShadowPartialOccupator (MSLane *lane)
 
void setOrigLeaderGaps (CLeaderDist, double secGap)
 
void setOrigLeaderGaps (const MSLeaderDistanceInfo &vehicles)
 
virtual void setOwnState (const int state)
 
virtual void setParameter (const std::string &key, const std::string &value)
 try to set the given parameter for this laneChangeModel. Throw exception for unsupported key More...
 
void setShadowApproachingInformation (MSLink *link) const
 set approach information for the shadow vehicle More...
 
void setShadowLane (MSLane *lane)
 set the shadow lane More...
 
void setShadowPartialOccupator (MSLane *lane)
 
void setSpeedLat (double speedLat)
 
bool startLaneChangeManeuver (MSLane *source, MSLane *target, int direction)
 start the lane change maneuver and return whether it continues More...
 
virtual bool sublaneChangeCompleted (const double latDist) const
 whether the current change completes the manoeuvre More...
 
void unchanged ()
 
bool updateCompletion ()
 
virtual void updateExpectedSublaneSpeeds (const MSLeaderDistanceInfo &ahead, int sublaneOffset, int laneIndex)
 update expected speeds for each sublane of the current edge More...
 
virtual void updateSafeLatDist (const double travelledLatDist)
 Updates the value of safe lateral distances (in SL2015) during maneuver continuation in non-action steps. More...
 
void updateShadowLane ()
 
void updateTargetLane ()
 
int wantsChange (int laneOffset, MSAbstractLaneChangeModel::MSLCMessager &msgPass, int blocked, const std::pair< MSVehicle *, double > &leader, const std::pair< MSVehicle *, double > &neighLead, const std::pair< MSVehicle *, double > &neighFollow, const MSLane &neighLane, const std::vector< MSVehicle::LaneQ > &preb, MSVehicle **lastBlocked, MSVehicle **firstBlocked)
 Called to examine whether the vehicle wants to change using the given laneOffset. This method gets the information about the surrounding vehicles and whether another lane may be more preferable. More...
 
virtual int wantsChangeSublane (int laneOffset, LaneChangeAction alternatives, const MSLeaderDistanceInfo &leaders, const MSLeaderDistanceInfo &followers, const MSLeaderDistanceInfo &blockers, const MSLeaderDistanceInfo &neighLeaders, const MSLeaderDistanceInfo &neighFollowers, const MSLeaderDistanceInfo &neighBlockers, const MSLane &neighLane, const std::vector< MSVehicle::LaneQ > &preb, MSVehicle **lastBlocked, MSVehicle **firstBlocked, double &latDist, double &targetDistLat, int &blocked)
 
virtual ~MSLCM_DK2008 ()
 

Static Public Member Functions

static MSAbstractLaneChangeModelbuild (LaneChangeModel lcm, MSVehicle &vehicle)
 Factory method for instantiating new lane changing models. More...
 
static bool haveLCOutput ()
 whether lanechange-output is active More...
 
static void initGlobalOptions (const OptionsCont &oc)
 init global model parameters More...
 
static bool outputLCEnded ()
 whether start of maneuvers shall be recorede More...
 
static bool outputLCStarted ()
 whether start of maneuvers shall be recorede More...
 

Static Public Attributes

static const double NO_NEIGHBOR
 

Protected Types

typedef std::pair< double, int > Info
 

Protected Member Functions

bool amBlockingFollower ()
 
bool amBlockingFollowerNB ()
 
bool amBlockingFollowerPlusNB ()
 
bool amBlockingLeader ()
 
bool cancelRequest (int state)
 whether the influencer cancels the given request More...
 
virtual bool congested (const MSVehicle *const neighLeader)
 
bool currentDistAllows (double dist, int laneOffset, double lookForwardDist)
 
bool currentDistDisallows (double dist, int laneOffset, double lookForwardDist)
 
void informBlocker (MSAbstractLaneChangeModel::MSLCMessager &msgPass, int &blocked, int dir, const std::pair< MSVehicle *, double > &neighLead, const std::pair< MSVehicle *, double > &neighFollow)
 
void initLastLaneChangeOffset (int dir)
 
virtual bool predInteraction (const std::pair< MSVehicle *, double > &leader)
 
virtual int wantsChangeToLeft (MSAbstractLaneChangeModel::MSLCMessager &msgPass, int blocked, const std::pair< MSVehicle *, double > &leader, const std::pair< MSVehicle *, double > &neighLead, const std::pair< MSVehicle *, double > &neighFollow, const MSLane &neighLane, const std::vector< MSVehicle::LaneQ > &preb, MSVehicle **lastBlocked, MSVehicle **firstBlocked)
 Called to examine whether the vehicle wants to change to left This method gets the information about the surrounding vehicles and whether another lane may be more preferable. More...
 
virtual int wantsChangeToRight (MSAbstractLaneChangeModel::MSLCMessager &msgPass, int blocked, const std::pair< MSVehicle *, double > &leader, const std::pair< MSVehicle *, double > &neighLead, const std::pair< MSVehicle *, double > &neighFollow, const MSLane &neighLane, const std::vector< MSVehicle::LaneQ > &preb, MSVehicle **lastBlocked, MSVehicle **firstBlocked)
 Called to examine whether the vehicle wants to change to right This method gets the information about the surrounding vehicles and whether another lane may be more preferable. More...
 

Protected Attributes

bool myAlreadyChanged
 whether the vehicle has already moved this step More...
 
const MSCFModelmyCarFollowModel
 The vehicle's car following model. More...
 
double myChangeProbability
 
double myCommittedSpeed
 the speed when committing to a change maneuver More...
 
bool myDontBrake
 
std::vector< MSLane * > myFurtherTargetLanes
 
double myLaneChangeCompletion
 progress of the lane change maneuver 0:started, 1:complete More...
 
int myLaneChangeDirection
 direction of the lane change maneuver -1 means right, 1 means left More...
 
double myLastFollowerGap
 
double myLastFollowerSecureGap
 
double myLastLateralGapLeft
 the minimum lateral gaps to other vehicles that were found when last changing to the left and right More...
 
double myLastLateralGapRight
 
double myLastLeaderGap
 the actual minimum longitudinal distances to vehicles on the target lane More...
 
double myLastLeaderSecureGap
 the minimum longitudinal distances to vehicles on the target lane that would be necessary for stringent security More...
 
double myLastOrigLeaderGap
 acutal and secure distance to closest leader vehicle on the original when performing lane change More...
 
double myLastOrigLeaderSecureGap
 
double myLeadingBlockerLength
 
double myLeftSpace
 
double myManeuverDist
 The complete lateral distance the vehicle wants to travel to finish its maneuver Only used by sublane model, currently. More...
 
const LaneChangeModel myModel
 the type of this model More...
 
std::vector< MSLane * > myNoPartiallyOccupatedByShadow
 
int myOwnState
 The current state of the vehicle. More...
 
std::vector< MSLane * > myPartiallyOccupatedByShadow
 list of lanes where the shadow vehicle is partial occupator More...
 
int myPreviousState
 lane changing state from the previous simulation step More...
 
int myPreviousState2
 lane changing state from step before the previous simulation step More...
 
std::map< int, std::pair< int, int > > mySavedStates
 
std::vector< MSLane * > myShadowFurtherLanes
 
std::vector< double > myShadowFurtherLanesPosLat
 
MSLanemyShadowLane
 A lane that is partially occupied by the front of the vehicle but that is not the primary lane. More...
 
double mySpeedLat
 the current lateral speed More...
 
MSLanemyTargetLane
 The target lane for the vehicle's current maneuver. More...
 
MSVehiclemyVehicle
 The vehicle this lane-changer belongs to. More...
 
std::vector< double > myVSafes
 

Static Protected Attributes

static bool myAllowOvertakingRight
 whether overtaking on the right is permitted More...
 
static bool myLCEndedOutput
 
static bool myLCOutput
 whether to record lane-changing More...
 
static bool myLCStartedOutput
 

Detailed Description

A lane change model developed by D. Krajzewicz between 2004 and 2010.

Definition at line 46 of file MSLCM_DK2008.h.

Member Typedef Documentation

◆ Info

typedef std::pair<double, int> MSLCM_DK2008::Info
protected

Definition at line 152 of file MSLCM_DK2008.h.

Member Enumeration Documentation

◆ MyLCAEnum

Enumerator
LCA_AMBLOCKINGLEADER 
LCA_AMBLOCKINGFOLLOWER 
LCA_MRIGHT 
LCA_MLEFT 
LCA_AMBLOCKINGFOLLOWER_DONTBRAKE 
LCA_AMBACKBLOCKER 
LCA_AMBACKBLOCKER_STANDING 

Definition at line 49 of file MSLCM_DK2008.h.

Constructor & Destructor Documentation

◆ MSLCM_DK2008()

MSLCM_DK2008::MSLCM_DK2008 ( MSVehicle v)

Definition at line 59 of file MSLCM_DK2008.cpp.

◆ ~MSLCM_DK2008()

MSLCM_DK2008::~MSLCM_DK2008 ( )
virtual

Definition at line 64 of file MSLCM_DK2008.cpp.

References changed().

Member Function Documentation

◆ alreadyChanged()

bool MSAbstractLaneChangeModel::alreadyChanged ( ) const
inlineinherited

reset the flag whether a vehicle already moved to false

Definition at line 399 of file MSAbstractLaneChangeModel.h.

References MSAbstractLaneChangeModel::myAlreadyChanged.

Referenced by MSLaneChanger::change().

◆ amBlockingFollower()

bool MSLCM_DK2008::amBlockingFollower ( )
inlineprotected

◆ amBlockingFollowerNB()

bool MSLCM_DK2008::amBlockingFollowerNB ( )
inlineprotected

◆ amBlockingFollowerPlusNB()

bool MSLCM_DK2008::amBlockingFollowerPlusNB ( )
inlineprotected

◆ amBlockingLeader()

bool MSLCM_DK2008::amBlockingLeader ( )
inlineprotected

Definition at line 133 of file MSLCM_DK2008.h.

References LCA_AMBLOCKINGLEADER, and MSAbstractLaneChangeModel::myOwnState.

◆ build()

MSAbstractLaneChangeModel * MSAbstractLaneChangeModel::build ( LaneChangeModel  lcm,
MSVehicle vehicle 
)
staticinherited

Factory method for instantiating new lane changing models.

Parameters
[in]lcmThe type of model to build
[in]vehicleThe vehicle for which this model shall be built

Definition at line 74 of file MSAbstractLaneChangeModel.cpp.

References MSGlobals::gLateralResolution, LCM_DEFAULT, LCM_DK2008, LCM_LC2013, LCM_SL2015, and toString().

Referenced by MSVehicle::MSVehicle(), and MSAbstractLaneChangeModel::StateAndDist::sameDirection().

◆ cancelRequest()

bool MSAbstractLaneChangeModel::cancelRequest ( int  state)
protectedinherited

whether the influencer cancels the given request

Definition at line 347 of file MSAbstractLaneChangeModel.cpp.

References MSVehicle::influenceChangeDecision(), and MSAbstractLaneChangeModel::myVehicle.

Referenced by MSLCM_LC2013::_wantsChange(), and MSLCM_SL2015::_wantsChangeSublane().

◆ changed()

void MSLCM_DK2008::changed ( )
virtual

◆ changedToOpposite()

void MSAbstractLaneChangeModel::changedToOpposite ( )
inherited

◆ checkTraCICommands()

◆ cleanupShadowLane()

◆ cleanupTargetLane()

◆ computeSpeedLat()

virtual double MSAbstractLaneChangeModel::computeSpeedLat ( double  latDist,
double &  maneuverDist 
)
inlinevirtualinherited

decides the next lateral speed depending on the remaining lane change distance to be covered and updates maneuverDist according to lateral safety constraints.

Reimplemented in MSLCM_SL2015.

Definition at line 487 of file MSAbstractLaneChangeModel.h.

References MSAbstractLaneChangeModel::myModel, toString(), and UNUSED_PARAMETER.

Referenced by MSLaneChangerSublane::continueChangeSublane().

◆ congested()

bool MSAbstractLaneChangeModel::congested ( const MSVehicle *const  neighLeader)
protectedvirtualinherited

◆ currentDistAllows()

bool MSLCM_DK2008::currentDistAllows ( double  dist,
int  laneOffset,
double  lookForwardDist 
)
inlineprotected

Definition at line 148 of file MSLCM_DK2008.h.

Referenced by wantsChangeToLeft(), and wantsChangeToRight().

◆ currentDistDisallows()

bool MSLCM_DK2008::currentDistDisallows ( double  dist,
int  laneOffset,
double  lookForwardDist 
)
inlineprotected

Definition at line 145 of file MSLCM_DK2008.h.

Referenced by wantsChangeToLeft(), and wantsChangeToRight().

◆ debugVehicle()

◆ decideDirection()

virtual StateAndDist MSAbstractLaneChangeModel::decideDirection ( StateAndDist  sd1,
StateAndDist  sd2 
) const
inlinevirtualinherited

decide in which direction to move in case both directions are desirable

Reimplemented in MSLCM_SL2015.

Definition at line 287 of file MSAbstractLaneChangeModel.h.

References MSAbstractLaneChangeModel::changed(), MSAbstractLaneChangeModel::inform(), MSAbstractLaneChangeModel::myModel, MSAbstractLaneChangeModel::patchSpeed(), toString(), and UNUSED_PARAMETER.

Referenced by MSLaneChangerSublane::change().

◆ determineTargetLane()

◆ endLaneChangeManeuver()

◆ getAngleOffset()

double MSAbstractLaneChangeModel::getAngleOffset ( ) const
inherited

◆ getCommittedSpeed()

double MSAbstractLaneChangeModel::getCommittedSpeed ( ) const
inlineinherited

◆ getFurtherTargetLanes()

const std::vector<MSLane*>& MSAbstractLaneChangeModel::getFurtherTargetLanes ( ) const
inlineinherited

◆ getLaneChangeDirection()

int MSAbstractLaneChangeModel::getLaneChangeDirection ( ) const
inlineinherited

◆ getLastLaneChangeOffset()

SUMOTime MSAbstractLaneChangeModel::getLastLaneChangeOffset ( ) const
inlineinherited

◆ getManeuverDist()

double MSAbstractLaneChangeModel::getManeuverDist ( ) const
inherited

◆ getOwnState()

◆ getParameter()

virtual std::string MSAbstractLaneChangeModel::getParameter ( const std::string &  key) const
inlinevirtualinherited

try to retrieve the given parameter from this laneChangeModel. Throw exception for unsupported key

Reimplemented in MSLCM_SL2015, and MSLCM_LC2013.

Definition at line 494 of file MSAbstractLaneChangeModel.h.

References MSAbstractLaneChangeModel::myModel, and toString().

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

◆ getPrevState()

int MSAbstractLaneChangeModel::getPrevState ( ) const
inlineinherited

◆ getSavedState()

const std::pair<int, int>& MSAbstractLaneChangeModel::getSavedState ( const int  dir) const
inlineinherited

◆ getShadowDirection()

◆ getShadowFurtherLanes()

const std::vector<MSLane*>& MSAbstractLaneChangeModel::getShadowFurtherLanes ( ) const
inlineinherited

◆ getShadowFurtherLanesPosLat()

const std::vector<double>& MSAbstractLaneChangeModel::getShadowFurtherLanesPosLat ( ) const
inlineinherited

◆ getShadowLane() [1/3]

◆ getShadowLane() [2/3]

MSLane * MSAbstractLaneChangeModel::getShadowLane ( const MSLane lane) const
inherited

◆ getShadowLane() [3/3]

◆ getSpeedLat()

double MSAbstractLaneChangeModel::getSpeedLat ( ) const
inlineinherited

return the lateral speed of the current lane change maneuver

Definition at line 477 of file MSAbstractLaneChangeModel.h.

References MSAbstractLaneChangeModel::mySpeedLat.

Referenced by MSLaneChangerSublane::change(), MSLaneChanger::continueChange(), GUIVehicle::getParameterWindow(), and MSLeaderInfo::getSubLanes().

◆ getTargetLane()

MSLane* MSAbstractLaneChangeModel::getTargetLane ( ) const
inlineinherited

Returns the lane the vehicle has committed to enter during a sublane lane change.

Returns
The vehicle's target lane.

Definition at line 361 of file MSAbstractLaneChangeModel.h.

References MSAbstractLaneChangeModel::myTargetLane.

Referenced by GUIVehicle::getParameterWindow(), and MSLaneChangerSublane::startChangeSublane().

◆ haveLCOutput()

static bool MSAbstractLaneChangeModel::haveLCOutput ( )
inlinestaticinherited

◆ inform()

void * MSLCM_DK2008::inform ( void *  info,
MSVehicle sender 
)
virtual

Implements MSAbstractLaneChangeModel.

Definition at line 588 of file MSLCM_DK2008.cpp.

References MSAbstractLaneChangeModel::myOwnState.

◆ informBlocker()

◆ initGlobalOptions()

◆ initLastLaneChangeOffset()

void MSAbstractLaneChangeModel::initLastLaneChangeOffset ( int  dir)
protectedinherited

◆ isChangingLanes()

◆ isOpposite()

◆ laneChangeOutput()

void MSAbstractLaneChangeModel::laneChangeOutput ( const std::string &  tag,
MSLane source,
MSLane target,
int  direction 
)
inherited

◆ outputLCEnded()

static bool MSAbstractLaneChangeModel::outputLCEnded ( )
inlinestaticinherited

◆ outputLCStarted()

static bool MSAbstractLaneChangeModel::outputLCStarted ( )
inlinestaticinherited

whether start of maneuvers shall be recorede

Definition at line 152 of file MSAbstractLaneChangeModel.h.

References MSAbstractLaneChangeModel::myLCStartedOutput.

Referenced by MSLaneChangerSublane::outputLCStarted().

◆ pastMidpoint()

bool MSAbstractLaneChangeModel::pastMidpoint ( ) const
inlineinherited

◆ patchSpeed()

double MSLCM_DK2008::patchSpeed ( const double  min,
const double  wanted,
const double  max,
const MSCFModel cfModel 
)
virtual

◆ predInteraction()

bool MSAbstractLaneChangeModel::predInteraction ( const std::pair< MSVehicle *, double > &  leader)
protectedvirtualinherited

◆ prepareStep()

◆ primaryLaneChanged()

◆ remainingTime()

SUMOTime MSAbstractLaneChangeModel::remainingTime ( ) const
inherited

return whether the vehicle passed the midpoint of a continuous lane change maneuver

Definition at line 511 of file MSAbstractLaneChangeModel.cpp.

References MSGlobals::gLaneChangeDuration, and MSAbstractLaneChangeModel::myLaneChangeCompletion.

Referenced by MSAbstractLaneChangeModel::pastMidpoint().

◆ removeShadowApproachingInformation()

void MSAbstractLaneChangeModel::removeShadowApproachingInformation ( ) const
inherited

◆ resetChanged()

◆ saveBlockerLength()

virtual void MSAbstractLaneChangeModel::saveBlockerLength ( double  length)
inlinevirtualinherited

reserve space at the end of the lane to avoid dead locks

Reimplemented in MSLCM_LC2013, and MSLCM_SL2015.

Definition at line 440 of file MSAbstractLaneChangeModel.h.

References UNUSED_PARAMETER.

Referenced by MSLCM_LC2013::saveBlockerLength().

◆ saveState()

void MSAbstractLaneChangeModel::saveState ( const int  dir,
const int  stateWithoutTraCI,
const int  state 
)
inlineinherited

◆ setFollowerGaps() [1/2]

◆ setFollowerGaps() [2/2]

◆ setLeaderGaps() [1/2]

◆ setLeaderGaps() [2/2]

◆ setManeuverDist()

void MSAbstractLaneChangeModel::setManeuverDist ( const double  dist)
inherited

◆ setNoShadowPartialOccupator()

void MSAbstractLaneChangeModel::setNoShadowPartialOccupator ( MSLane lane)
inlineinherited

◆ setOrigLeaderGaps() [1/2]

◆ setOrigLeaderGaps() [2/2]

◆ setOwnState()

◆ setParameter()

virtual void MSAbstractLaneChangeModel::setParameter ( const std::string &  key,
const std::string &  value 
)
inlinevirtualinherited

try to set the given parameter for this laneChangeModel. Throw exception for unsupported key

Reimplemented in MSLCM_SL2015, and MSLCM_LC2013.

Definition at line 499 of file MSAbstractLaneChangeModel.h.

References MSAbstractLaneChangeModel::checkTraCICommands(), MSAbstractLaneChangeModel::myModel, toString(), and UNUSED_PARAMETER.

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

◆ setShadowApproachingInformation()

void MSAbstractLaneChangeModel::setShadowApproachingInformation ( MSLink link) const
inherited

set approach information for the shadow vehicle

Definition at line 517 of file MSAbstractLaneChangeModel.cpp.

References MSAbstractLaneChangeModel::myApproachedByShadow.

Referenced by MSVehicle::checkRewindLinkLanes(), and MSAbstractLaneChangeModel::sublaneChangeCompleted().

◆ setShadowLane()

void MSAbstractLaneChangeModel::setShadowLane ( MSLane lane)
inlineinherited

set the shadow lane

Definition at line 346 of file MSAbstractLaneChangeModel.h.

References MSAbstractLaneChangeModel::myShadowLane.

◆ setShadowPartialOccupator()

void MSAbstractLaneChangeModel::setShadowPartialOccupator ( MSLane lane)
inlineinherited

◆ setSpeedLat()

void MSAbstractLaneChangeModel::setSpeedLat ( double  speedLat)
inlineinherited

◆ startLaneChangeManeuver()

◆ sublaneChangeCompleted()

virtual bool MSAbstractLaneChangeModel::sublaneChangeCompleted ( const double  latDist) const
inlinevirtualinherited

◆ unchanged()

void MSAbstractLaneChangeModel::unchanged ( )
inlineinherited

◆ updateCompletion()

◆ updateExpectedSublaneSpeeds()

virtual void MSAbstractLaneChangeModel::updateExpectedSublaneSpeeds ( const MSLeaderDistanceInfo ahead,
int  sublaneOffset,
int  laneIndex 
)
inlinevirtualinherited

update expected speeds for each sublane of the current edge

Reimplemented in MSLCM_SL2015.

Definition at line 279 of file MSAbstractLaneChangeModel.h.

References MSAbstractLaneChangeModel::myModel, toString(), and UNUSED_PARAMETER.

Referenced by MSLaneChangerSublane::change().

◆ updateSafeLatDist()

void MSAbstractLaneChangeModel::updateSafeLatDist ( const double  travelledLatDist)
virtualinherited

Updates the value of safe lateral distances (in SL2015) during maneuver continuation in non-action steps.

Reimplemented in MSLCM_SL2015.

Definition at line 136 of file MSAbstractLaneChangeModel.cpp.

References UNUSED_PARAMETER.

Referenced by MSAbstractLaneChangeModel::getPrevState(), and MSLaneChangerSublane::startChangeSublane().

◆ updateShadowLane()

◆ updateTargetLane()

◆ wantsChange()

int MSLCM_DK2008::wantsChange ( int  laneOffset,
MSAbstractLaneChangeModel::MSLCMessager msgPass,
int  blocked,
const std::pair< MSVehicle *, double > &  leader,
const std::pair< MSVehicle *, double > &  neighLead,
const std::pair< MSVehicle *, double > &  neighFollow,
const MSLane neighLane,
const std::vector< MSVehicle::LaneQ > &  preb,
MSVehicle **  lastBlocked,
MSVehicle **  firstBlocked 
)
virtual

Called to examine whether the vehicle wants to change using the given laneOffset. This method gets the information about the surrounding vehicles and whether another lane may be more preferable.

Reimplemented from MSAbstractLaneChangeModel.

Definition at line 69 of file MSLCM_DK2008.cpp.

References UNUSED_PARAMETER, wantsChangeToLeft(), and wantsChangeToRight().

◆ wantsChangeSublane()

virtual int MSAbstractLaneChangeModel::wantsChangeSublane ( int  laneOffset,
LaneChangeAction  alternatives,
const MSLeaderDistanceInfo leaders,
const MSLeaderDistanceInfo followers,
const MSLeaderDistanceInfo blockers,
const MSLeaderDistanceInfo neighLeaders,
const MSLeaderDistanceInfo neighFollowers,
const MSLeaderDistanceInfo neighBlockers,
const MSLane neighLane,
const std::vector< MSVehicle::LaneQ > &  preb,
MSVehicle **  lastBlocked,
MSVehicle **  firstBlocked,
double &  latDist,
double &  targetDistLat,
int &  blocked 
)
inlinevirtualinherited

◆ wantsChangeToLeft()

int MSLCM_DK2008::wantsChangeToLeft ( MSAbstractLaneChangeModel::MSLCMessager msgPass,
int  blocked,
const std::pair< MSVehicle *, double > &  leader,
const std::pair< MSVehicle *, double > &  neighLead,
const std::pair< MSVehicle *, double > &  neighFollow,
const MSLane neighLane,
const std::vector< MSVehicle::LaneQ > &  preb,
MSVehicle **  lastBlocked,
MSVehicle **  firstBlocked 
)
protectedvirtual

Called to examine whether the vehicle wants to change to left This method gets the information about the surrounding vehicles and whether another lane may be more preferable.

!!

Definition at line 295 of file MSLCM_DK2008.cpp.

References ACCEL2SPEED, amBlockingFollowerPlusNB(), MSVehicle::LaneQ::bestLaneOffset, MSAbstractLaneChangeModel::congested(), currentDistAllows(), currentDistDisallows(), MSCFModel::followSpeed(), MSVehicle::getCarFollowModel(), MSLane::getEdge(), MSVehicle::getLane(), MSLane::getLength(), MSVehicleType::getLengthWithGap(), MSLane::getLinkCont(), MSCFModel::getMaxDecel(), MSVehicleType::getMaxSpeed(), MSVehicleType::getMinGap(), MSVehicle::getPositionOnLane(), MSVehicle::getSpeed(), MSLane::getVehicleMaxSpeed(), MSBaseVehicle::getVehicleType(), informBlocker(), MSEdge::isInternal(), JAM_FACTOR2, MSVehicle::LaneQ::lane, LCA_AMBACKBLOCKER, LCA_AMBACKBLOCKER_STANDING, LCA_AMBLOCKINGFOLLOWER_DONTBRAKE, LCA_BLOCKED, LCA_COOPERATIVE, LCA_LEFT, LCA_MLEFT, LCA_RIGHT, LCA_SPEEDGAIN, LCA_STAY, LCA_STRATEGIC, LCA_URGENT, MSVehicle::LaneQ::length, LOOK_FORWARD_FAR, LOOK_FORWARD_NEAR, LOOK_FORWARD_SPEED_DIVIDER, MAX2(), MIN2(), MSAbstractLaneChangeModel::myCarFollowModel, myChangeProbability, myDontBrake, myLeadingBlockerLength, myLeftSpace, MSAbstractLaneChangeModel::myOwnState, MSAbstractLaneChangeModel::myVehicle, myVSafes, MSVehicle::LaneQ::occupation, MSAbstractLaneChangeModel::predInteraction(), SUMO_const_haltingSpeed, TS, and UNUSED_PARAMETER.

Referenced by wantsChange().

◆ wantsChangeToRight()

int MSLCM_DK2008::wantsChangeToRight ( MSAbstractLaneChangeModel::MSLCMessager msgPass,
int  blocked,
const std::pair< MSVehicle *, double > &  leader,
const std::pair< MSVehicle *, double > &  neighLead,
const std::pair< MSVehicle *, double > &  neighFollow,
const MSLane neighLane,
const std::vector< MSVehicle::LaneQ > &  preb,
MSVehicle **  lastBlocked,
MSVehicle **  firstBlocked 
)
protectedvirtual

Called to examine whether the vehicle wants to change to right This method gets the information about the surrounding vehicles and whether another lane may be more preferable.

!!

Definition at line 88 of file MSLCM_DK2008.cpp.

References ACCEL2SPEED, amBlockingFollowerPlusNB(), MSVehicle::LaneQ::bestLaneOffset, MSAbstractLaneChangeModel::congested(), currentDistAllows(), currentDistDisallows(), MSCFModel::followSpeed(), MSVehicle::getCarFollowModel(), MSLane::getEdge(), MSVehicle::getLane(), MSLane::getLength(), MSVehicleType::getLengthWithGap(), MSLane::getLinkCont(), MSCFModel::getMaxDecel(), MSVehicleType::getMaxSpeed(), MSVehicleType::getMinGap(), MSVehicle::getPositionOnLane(), MSVehicle::getSpeed(), MSLane::getSpeedLimit(), MSLane::getVehicleMaxSpeed(), MSBaseVehicle::getVehicleType(), informBlocker(), MSEdge::isInternal(), JAM_FACTOR2, MSVehicle::LaneQ::lane, LCA_AMBACKBLOCKER, LCA_AMBACKBLOCKER_STANDING, LCA_AMBLOCKINGFOLLOWER_DONTBRAKE, LCA_BLOCKED, LCA_COOPERATIVE, LCA_LEFT, LCA_MRIGHT, LCA_RIGHT, LCA_SPEEDGAIN, LCA_STAY, LCA_STRATEGIC, LCA_URGENT, MSVehicle::LaneQ::length, LOOK_FORWARD_FAR, LOOK_FORWARD_NEAR, LOOK_FORWARD_SPEED_DIVIDER, MAX2(), MIN2(), MSAbstractLaneChangeModel::myCarFollowModel, myChangeProbability, myDontBrake, myLeadingBlockerLength, myLeftSpace, MSAbstractLaneChangeModel::myOwnState, MSAbstractLaneChangeModel::myVehicle, myVSafes, MSVehicle::LaneQ::occupation, MSAbstractLaneChangeModel::predInteraction(), SUMO_const_haltingSpeed, TS, and UNUSED_PARAMETER.

Referenced by wantsChange().

Field Documentation

◆ myAllowOvertakingRight

bool MSAbstractLaneChangeModel::myAllowOvertakingRight
staticprotectedinherited

◆ myAlreadyChanged

bool MSAbstractLaneChangeModel::myAlreadyChanged
protectedinherited

◆ myCarFollowModel

◆ myChangeProbability

double MSLCM_DK2008::myChangeProbability
protected

Definition at line 157 of file MSLCM_DK2008.h.

Referenced by changed(), prepareStep(), wantsChangeToLeft(), and wantsChangeToRight().

◆ myCommittedSpeed

double MSAbstractLaneChangeModel::myCommittedSpeed
protectedinherited

the speed when committing to a change maneuver

Definition at line 537 of file MSAbstractLaneChangeModel.h.

Referenced by MSLCM_SL2015::commitManoeuvre(), MSAbstractLaneChangeModel::getCommittedSpeed(), and MSAbstractLaneChangeModel::prepareStep().

◆ myDontBrake

bool MSLCM_DK2008::myDontBrake
protected

◆ myFurtherTargetLanes

std::vector<MSLane*> MSAbstractLaneChangeModel::myFurtherTargetLanes
protectedinherited

◆ myLaneChangeCompletion

◆ myLaneChangeDirection

int MSAbstractLaneChangeModel::myLaneChangeDirection
protectedinherited

◆ myLastFollowerGap

double MSAbstractLaneChangeModel::myLastFollowerGap
protectedinherited

◆ myLastFollowerSecureGap

double MSAbstractLaneChangeModel::myLastFollowerSecureGap
protectedinherited

◆ myLastLateralGapLeft

double MSAbstractLaneChangeModel::myLastLateralGapLeft
protectedinherited

the minimum lateral gaps to other vehicles that were found when last changing to the left and right

Definition at line 591 of file MSAbstractLaneChangeModel.h.

Referenced by MSLCM_SL2015::keepLatGap(), MSAbstractLaneChangeModel::laneChangeOutput(), MSAbstractLaneChangeModel::prepareStep(), and MSLCM_SL2015::updateGaps().

◆ myLastLateralGapRight

double MSAbstractLaneChangeModel::myLastLateralGapRight
protectedinherited

◆ myLastLeaderGap

double MSAbstractLaneChangeModel::myLastLeaderGap
protectedinherited

the actual minimum longitudinal distances to vehicles on the target lane

Definition at line 595 of file MSAbstractLaneChangeModel.h.

Referenced by MSAbstractLaneChangeModel::laneChangeOutput(), MSAbstractLaneChangeModel::prepareStep(), and MSAbstractLaneChangeModel::setLeaderGaps().

◆ myLastLeaderSecureGap

double MSAbstractLaneChangeModel::myLastLeaderSecureGap
protectedinherited

the minimum longitudinal distances to vehicles on the target lane that would be necessary for stringent security

Definition at line 598 of file MSAbstractLaneChangeModel.h.

Referenced by MSAbstractLaneChangeModel::laneChangeOutput(), MSAbstractLaneChangeModel::prepareStep(), and MSAbstractLaneChangeModel::setLeaderGaps().

◆ myLastOrigLeaderGap

double MSAbstractLaneChangeModel::myLastOrigLeaderGap
protectedinherited

acutal and secure distance to closest leader vehicle on the original when performing lane change

Definition at line 601 of file MSAbstractLaneChangeModel.h.

Referenced by MSAbstractLaneChangeModel::laneChangeOutput(), MSAbstractLaneChangeModel::prepareStep(), and MSAbstractLaneChangeModel::setOrigLeaderGaps().

◆ myLastOrigLeaderSecureGap

double MSAbstractLaneChangeModel::myLastOrigLeaderSecureGap
protectedinherited

◆ myLCEndedOutput

bool MSAbstractLaneChangeModel::myLCEndedOutput
staticprotectedinherited

◆ myLCOutput

bool MSAbstractLaneChangeModel::myLCOutput
staticprotectedinherited

◆ myLCStartedOutput

bool MSAbstractLaneChangeModel::myLCStartedOutput
staticprotectedinherited

◆ myLeadingBlockerLength

double MSLCM_DK2008::myLeadingBlockerLength
protected

◆ myLeftSpace

double MSLCM_DK2008::myLeftSpace
protected

◆ myManeuverDist

double MSAbstractLaneChangeModel::myManeuverDist
protectedinherited

◆ myModel

◆ myNoPartiallyOccupatedByShadow

◆ myOwnState

◆ myPartiallyOccupatedByShadow

std::vector<MSLane*> MSAbstractLaneChangeModel::myPartiallyOccupatedByShadow
protectedinherited

list of lanes where the shadow vehicle is partial occupator

Definition at line 584 of file MSAbstractLaneChangeModel.h.

Referenced by MSAbstractLaneChangeModel::setShadowPartialOccupator().

◆ myPreviousState

int MSAbstractLaneChangeModel::myPreviousState
protectedinherited

lane changing state from the previous simulation step

Definition at line 527 of file MSAbstractLaneChangeModel.h.

Referenced by MSLCM_SL2015::_wantsChangeSublane(), and MSAbstractLaneChangeModel::setOwnState().

◆ myPreviousState2

int MSAbstractLaneChangeModel::myPreviousState2
protectedinherited

lane changing state from step before the previous simulation step

Definition at line 529 of file MSAbstractLaneChangeModel.h.

Referenced by MSAbstractLaneChangeModel::getPrevState(), and MSAbstractLaneChangeModel::setOwnState().

◆ mySavedStates

std::map<int, std::pair<int, int> > MSAbstractLaneChangeModel::mySavedStates
protectedinherited

◆ myShadowFurtherLanes

std::vector<MSLane*> MSAbstractLaneChangeModel::myShadowFurtherLanes
protectedinherited

◆ myShadowFurtherLanesPosLat

std::vector<double> MSAbstractLaneChangeModel::myShadowFurtherLanesPosLat
protectedinherited

◆ myShadowLane

MSLane* MSAbstractLaneChangeModel::myShadowLane
protectedinherited

◆ mySpeedLat

◆ myTargetLane

MSLane* MSAbstractLaneChangeModel::myTargetLane
protectedinherited

The target lane for the vehicle's current maneuver.

Note
This is used by the sublane model to register the vehicle at lanes, it will reach within the current action step, so vehicles on that lane may react to the started lc-maneuver during the car-following process. If the shadow lane is the same as the lc maneuver target, myTargetLane is set to nullptr. The current shadow lanes and further lanes should always be updated before updating the target lane.

Definition at line 567 of file MSAbstractLaneChangeModel.h.

Referenced by MSAbstractLaneChangeModel::cleanupTargetLane(), MSAbstractLaneChangeModel::getTargetLane(), and MSAbstractLaneChangeModel::updateTargetLane().

◆ myVehicle

MSVehicle& MSAbstractLaneChangeModel::myVehicle
protectedinherited

The vehicle this lane-changer belongs to.

Definition at line 522 of file MSAbstractLaneChangeModel.h.

Referenced by MSLCM_LC2013::_patchSpeed(), MSLCM_SL2015::_patchSpeed(), MSLCM_LC2013::_wantsChange(), MSLCM_SL2015::_wantsChangeSublane(), MSLCM_LC2013::adaptSpeedToPedestrians(), MSLCM_SL2015::addLCSpeedAdvice(), MSLCM_LC2013::addLCSpeedAdvice(), MSAbstractLaneChangeModel::cancelRequest(), MSLCM_LC2013::changed(), MSLCM_SL2015::changed(), MSLCM_SL2015::checkBlocking(), MSLCM_SL2015::checkStrategicChange(), MSAbstractLaneChangeModel::checkTraCICommands(), MSAbstractLaneChangeModel::cleanupShadowLane(), MSAbstractLaneChangeModel::cleanupTargetLane(), MSLCM_SL2015::commitFollowSpeed(), MSLCM_SL2015::commitManoeuvre(), MSLCM_SL2015::computeSpeedGain(), MSLCM_SL2015::computeSpeedLat(), MSAbstractLaneChangeModel::congested(), MSLCM_SL2015::decideDirection(), MSAbstractLaneChangeModel::determineTargetLane(), MSAbstractLaneChangeModel::endLaneChangeManeuver(), MSLCM_LC2013::getRoundaboutAheadInfo(), MSAbstractLaneChangeModel::getShadowDirection(), MSAbstractLaneChangeModel::getShadowLane(), MSLCM_SL2015::getSublaneWidth(), MSLCM_SL2015::getWidth(), MSLCM_LC2013::inform(), MSLCM_SL2015::inform(), informBlocker(), MSLCM_LC2013::informFollower(), MSLCM_SL2015::informFollower(), MSLCM_LC2013::informLeader(), MSLCM_SL2015::informLeader(), MSLCM_SL2015::informLeaders(), MSLCM_SL2015::keepLatGap(), MSAbstractLaneChangeModel::laneChangeOutput(), MSLCM_SL2015::msg(), MSLCM_LC2013::MSLCM_LC2013(), patchSpeed(), MSLCM_LC2013::patchSpeed(), MSLCM_SL2015::patchSpeed(), MSAbstractLaneChangeModel::predInteraction(), MSLCM_SL2015::prepareStep(), MSAbstractLaneChangeModel::primaryLaneChanged(), MSAbstractLaneChangeModel::removeShadowApproachingInformation(), MSLCM_SL2015::saveBlockerLength(), MSLCM_LC2013::saveBlockerLength(), MSAbstractLaneChangeModel::setFollowerGaps(), MSAbstractLaneChangeModel::setLeaderGaps(), MSAbstractLaneChangeModel::setManeuverDist(), MSAbstractLaneChangeModel::setOrigLeaderGaps(), MSLCM_SL2015::setOwnState(), MSLCM_LC2013::slowDownForBlocked(), MSLCM_SL2015::slowDownForBlocked(), MSAbstractLaneChangeModel::startLaneChangeManeuver(), MSLCM_SL2015::updateCFRelated(), MSLCM_SL2015::updateExpectedSublaneSpeeds(), MSLCM_SL2015::updateGaps(), MSAbstractLaneChangeModel::updateShadowLane(), MSAbstractLaneChangeModel::updateTargetLane(), MSLCM_LC2013::wantsChange(), MSLCM_SL2015::wantsChange(), MSLCM_SL2015::wantsChangeSublane(), wantsChangeToLeft(), and wantsChangeToRight().

◆ myVSafes

std::vector<double> MSLCM_DK2008::myVSafes
protected

◆ NO_NEIGHBOR

const double MSAbstractLaneChangeModel::NO_NEIGHBOR
staticinherited

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