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

A lane change model developed by J. Erdmann. More...

#include <MSLCM_JE2013.h>

Inheritance diagram for MSLCM_JE2013:
MSAbstractLaneChangeModel

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_CHANGE_TO_HELP = 1 << 23, LCA_AMBACKBLOCKER = 1 << 26, LCA_AMBACKBLOCKER_STANDING = 1 << 27
}
 

Public Member Functions

SUMOReal _patchSpeed (const SUMOReal min, const SUMOReal wanted, const SUMOReal max, const MSCFModel &cfModel)
 
bool alreadyMoved () const
 reset the flag whether a vehicle already moved to false More...
 
void changed ()
 
void continueLaneChangeManeuver (bool moved)
 
void endLaneChangeManeuver ()
 
SUMOReal getLaneChangeCompletion () const
 return whether the vehicle passed the midpoint of a continuous lane change maneuver More...
 
int getLaneChangeDirection () const
 return the direction of the current lane change maneuver More...
 
SUMOTime getLastLaneChangeOffset () const
 
int getOwnState () const
 
MSLanegetShadowLane () const
 Returns the lane the vehicles shadow is on during continuouss lane change. More...
 
void * inform (void *info, MSVehicle *sender)
 
bool isChangingLanes () const
 return true if the vehicle currently performs a lane change maneuver More...
 
bool isLaneChangeMidpointPassed () const
 return whether the vehicle passed the midpoint of a continuous lane change maneuver More...
 
 MSLCM_JE2013 (MSVehicle &v)
 
SUMOReal patchSpeed (const SUMOReal min, const SUMOReal wanted, const SUMOReal max, const MSCFModel &cfModel)
 Called to adapt the speed in order to allow a lane change. More...
 
void prepareStep ()
 
void removeLaneChangeShadow ()
 remove the shadow copy of a lane change maneuver More...
 
void resetMoved ()
 reset the flag whether a vehicle already moved to false More...
 
void setOwnState (int state)
 
bool startLaneChangeManeuver (MSLane *source, MSLane *target, int direction)
 start the lane change maneuver and return whether it continues More...
 
void unchanged ()
 
int wantsChange (int laneOffset, MSAbstractLaneChangeModel::MSLCMessager &msgPass, int blocked, const std::pair< MSVehicle *, SUMOReal > &leader, const std::pair< MSVehicle *, SUMOReal > &neighLead, const std::pair< MSVehicle *, SUMOReal > &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 ~MSLCM_JE2013 ()
 

Static Public Member Functions

static MSAbstractLaneChangeModelbuild (LaneChangeModel lcm, MSVehicle &vehicle)
 Factory method for instantiating new lane changing models. More...
 

Protected Types

typedef std::pair< SUMOReal, intInfo
 information regarding save velocity (unused) and state flags of the ego vehicle More...
 

Protected Member Functions

int _wantsChange (int laneOffset, MSAbstractLaneChangeModel::MSLCMessager &msgPass, int blocked, const std::pair< MSVehicle *, SUMOReal > &leader, const std::pair< MSVehicle *, SUMOReal > &neighLead, const std::pair< MSVehicle *, SUMOReal > &neighFollow, const MSLane &neighLane, const std::vector< MSVehicle::LaneQ > &preb, MSVehicle **lastBlocked, MSVehicle **firstBlocked)
 helper function for doing the actual work More...
 
bool amBlockingFollower ()
 
bool amBlockingFollowerNB ()
 
bool amBlockingFollowerPlusNB ()
 
bool amBlockingLeader ()
 
virtual bool congested (const MSVehicle *const neighLeader)
 
bool currentDistAllows (SUMOReal dist, int laneOffset, SUMOReal lookForwardDist)
 
bool currentDistDisallows (SUMOReal dist, int laneOffset, SUMOReal lookForwardDist)
 
void informFollower (MSAbstractLaneChangeModel::MSLCMessager &msgPass, int blocked, int dir, const std::pair< MSVehicle *, SUMOReal > &neighFollow, SUMOReal remainingSeconds, SUMOReal plannedSpeed)
 decide whether we will try cut in before the follower or allow to be overtaken More...
 
SUMOReal informLeader (MSAbstractLaneChangeModel::MSLCMessager &msgPass, int blocked, int dir, const std::pair< MSVehicle *, SUMOReal > &neighLead, SUMOReal remainingSeconds)
 
void keepRight (MSVehicle *neigh)
 updated myKeepRightProbability and mySpeedGainProbability if the right neighbours are faster More...
 
virtual bool predInteraction (const MSVehicle *const leader)
 
void saveBlockerLength (MSVehicle *blocker, int lcaCounter)
 save space for vehicles which need to counter-lane-change More...
 
void saveBlockerLength (SUMOReal length)
 reserve space at the end of the lane to avoid dead locks More...
 
int slowDownForBlocked (MSVehicle **blocked, int state)
 compute useful slowdowns for blocked vehicles More...
 

Protected Attributes

bool myAlreadyMoved
 whether the vehicle has already moved this step More...
 
const MSCFModelmyCarFollowModel
 The vehicle's car following model. More...
 
bool myDontBrake
 
bool myHaveShadow
 Wether a vehicle shadow exists. More...
 
SUMOReal myKeepRightProbability
 a value for tracking the probability of following the/"Rechtsfahrgebot" (never a positive value) More...
 
SUMOReal 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...
 
bool myLaneChangeMidpointPassed
 whether myLane has already been set to the target of the lane-change maneuver More...
 
SUMOTime myLastLaneChangeOffset
 information how long ago the vehicle has performed a lane-change More...
 
SUMOReal myLeadingBlockerLength
 
SUMOReal myLeftSpace
 
SUMOReal myLookAheadSpeed
 
int myOwnState
 The current state of the vehicle. More...
 
MSLanemyShadowLane
 The lane the vehicle shadow is on during a continuous lane change. More...
 
SUMOReal mySpeedGainProbability
 a value for tracking the probability that a change to the offset with the same sign is beneficial More...
 
MSVehiclemyVehicle
 The vehicle this lane-changer belongs to. More...
 
std::vector< SUMORealmyVSafes
 

Detailed Description

A lane change model developed by J. Erdmann.

Definition at line 45 of file MSLCM_JE2013.h.

Member Typedef Documentation

typedef std::pair<SUMOReal, int> MSLCM_JE2013::Info
protected

information regarding save velocity (unused) and state flags of the ego vehicle

Definition at line 170 of file MSLCM_JE2013.h.

Member Enumeration Documentation

Enumerator
LCA_AMBLOCKINGLEADER 
LCA_AMBLOCKINGFOLLOWER 
LCA_MRIGHT 
LCA_MLEFT 
LCA_AMBLOCKINGFOLLOWER_DONTBRAKE 
LCA_CHANGE_TO_HELP 
LCA_AMBACKBLOCKER 
LCA_AMBACKBLOCKER_STANDING 

Definition at line 48 of file MSLCM_JE2013.h.

Constructor & Destructor Documentation

MSLCM_JE2013::MSLCM_JE2013 ( MSVehicle v)

Definition at line 102 of file MSLCM_JE2013.cpp.

MSLCM_JE2013::~MSLCM_JE2013 ( )
virtual

Definition at line 111 of file MSLCM_JE2013.cpp.

References changed().

Member Function Documentation

int MSLCM_JE2013::_wantsChange ( int  laneOffset,
MSAbstractLaneChangeModel::MSLCMessager msgPass,
int  blocked,
const std::pair< MSVehicle *, SUMOReal > &  leader,
const std::pair< MSVehicle *, SUMOReal > &  neighLead,
const std::pair< MSVehicle *, SUMOReal > &  neighFollow,
const MSLane neighLane,
const std::vector< MSVehicle::LaneQ > &  preb,
MSVehicle **  lastBlocked,
MSVehicle **  firstBlocked 
)
protected

helper function for doing the actual work

we urgently need to change lanes to follow our route

Definition at line 609 of file MSLCM_JE2013.cpp.

References abs, amBlockingFollowerPlusNB(), MSVehicle::LaneQ::bestContinuations, MSVehicle::LaneQ::bestLaneOffset, MSVehicle::Influencer::changeRequestRemainingSeconds(), MSVehicle::congested(), currentDistAllows(), currentDistDisallows(), MSEdge::EDGEFUNCTION_INTERNAL, MSCFModel::followSpeed(), MSGlobals::gDebugFlag2, MSVehicle::getCarFollowModel(), MSNet::getCurrentTimeStep(), MSLane::getEdge(), MSBaseVehicle::getID(), MSVehicle::getInfluencer(), MSNet::getInstance(), MSVehicle::getLane(), MSVehicleType::getLengthWithGap(), MSLane::getLinkCont(), MSCFModel::getMaxDecel(), MSVehicleType::getMaxSpeed(), MSVehicle::getPositionOnLane(), MSEdge::getPurpose(), MSVehicle::getSpeed(), MSLane::getVehicleMaxSpeed(), MSBaseVehicle::getVehicleType(), MSVehicle::influenceChangeDecision(), informFollower(), informLeader(), JAM_FACTOR, keepRight(), LCA_COOPERATIVE, LCA_KEEPRIGHT, LCA_LEFT, LCA_MLEFT, LCA_MRIGHT, LCA_RIGHT, LCA_SPEEDGAIN, LCA_STAY, LCA_STRATEGIC, LCA_TRACI, LCA_URGENT, MSVehicle::LaneQ::length, LOOK_AHEAD_MIN_SPEED, LOOK_AHEAD_SPEED_MEMORY, LOOK_FORWARD_LEFT, LOOK_FORWARD_RIGHT, MAX2(), MIN2(), MIN3(), MSAbstractLaneChangeModel::myCarFollowModel, myKeepRightProbability, myLeadingBlockerLength, myLeftSpace, myLookAheadSpeed, MSAbstractLaneChangeModel::myOwnState, mySpeedGainProbability, MSAbstractLaneChangeModel::myVehicle, myVSafes, MSVehicle::LaneQ::occupation, ROUNDABOUT_DIST_BONUS, saveBlockerLength(), slowDownForBlocked(), STEPS2TIME, SUMO_const_haltingSpeed, SUMOReal, tryID(), TS, and URGENCY.

Referenced by wantsChange().

bool MSAbstractLaneChangeModel::alreadyMoved ( ) const
inlineinherited

reset the flag whether a vehicle already moved to false

Definition at line 273 of file MSAbstractLaneChangeModel.h.

References MSAbstractLaneChangeModel::myAlreadyMoved.

Referenced by MSLane::executeMovements().

bool MSLCM_JE2013::amBlockingFollower ( )
inlineprotected
bool MSLCM_JE2013::amBlockingFollowerNB ( )
inlineprotected
bool MSLCM_JE2013::amBlockingFollowerPlusNB ( )
inlineprotected
bool MSLCM_JE2013::amBlockingLeader ( )
inlineprotected

Definition at line 150 of file MSLCM_JE2013.h.

References LCA_AMBLOCKINGLEADER, and MSAbstractLaneChangeModel::myOwnState.

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 48 of file MSAbstractLaneChangeModel.cpp.

References LCM_DK2008, LCM_JE2013, LCM_LC2013, and toString().

Referenced by MSVehicle::MSVehicle().

bool MSAbstractLaneChangeModel::congested ( const MSVehicle *const  neighLeader)
protectedvirtualinherited
bool MSLCM_JE2013::currentDistAllows ( SUMOReal  dist,
int  laneOffset,
SUMOReal  lookForwardDist 
)
inlineprotected

Definition at line 165 of file MSLCM_JE2013.h.

References abs.

Referenced by _wantsChange().

bool MSLCM_JE2013::currentDistDisallows ( SUMOReal  dist,
int  laneOffset,
SUMOReal  lookForwardDist 
)
inlineprotected

Definition at line 162 of file MSLCM_JE2013.h.

References abs.

Referenced by _wantsChange().

SUMOReal MSAbstractLaneChangeModel::getLaneChangeCompletion ( ) const
inlineinherited

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

Definition at line 258 of file MSAbstractLaneChangeModel.h.

References MSAbstractLaneChangeModel::myLaneChangeCompletion.

Referenced by MSVehicle::getAngle().

int MSAbstractLaneChangeModel::getLaneChangeDirection ( ) const
inlineinherited

return the direction of the current lane change maneuver

Definition at line 268 of file MSAbstractLaneChangeModel.h.

References MSAbstractLaneChangeModel::myLaneChangeDirection.

Referenced by MSVehicle::getAngle().

SUMOTime MSAbstractLaneChangeModel::getLastLaneChangeOffset ( ) const
inlineinherited
int MSAbstractLaneChangeModel::getOwnState ( ) const
inlineinherited
MSLane* MSAbstractLaneChangeModel::getShadowLane ( ) const
inlineinherited

Returns the lane the vehicles shadow is on during continuouss lane change.

Returns
The vehicle's shadow lane

Definition at line 242 of file MSAbstractLaneChangeModel.h.

References MSAbstractLaneChangeModel::myShadowLane.

Referenced by MSLane::executeMovements(), and MSVehicle::getPosition().

bool MSAbstractLaneChangeModel::isChangingLanes ( ) const
inlineinherited
bool MSAbstractLaneChangeModel::isLaneChangeMidpointPassed ( ) const
inlineinherited

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

Definition at line 253 of file MSAbstractLaneChangeModel.h.

References MSAbstractLaneChangeModel::myLaneChangeMidpointPassed.

Referenced by MSVehicle::getAngle(), MSVehicle::getPosition(), and MSVehicle::planMoveInternal().

void MSLCM_JE2013::keepRight ( MSVehicle neigh)
protected

updated myKeepRightProbability and mySpeedGainProbability if the right neighbours are faster

Definition at line 1039 of file MSLCM_JE2013.cpp.

References MSVehicle::getSpeed(), myKeepRightProbability, mySpeedGainProbability, MSAbstractLaneChangeModel::myVehicle, and SUMOReal.

Referenced by _wantsChange().

SUMOReal MSLCM_JE2013::patchSpeed ( const SUMOReal  min,
const SUMOReal  wanted,
const SUMOReal  max,
const MSCFModel cfModel 
)
virtual

Called to adapt the speed in order to allow a lane change.

Parameters
minThe minimum resulting speed
wantedThe aspired speed of the car following model
maxThe maximum resulting speed
cfModelThe model used
Returns
the new speed of the vehicle as proposed by the lane changer

Implements MSAbstractLaneChangeModel.

Definition at line 164 of file MSLCM_JE2013.cpp.

References _patchSpeed(), DEBUG_COND, MSGlobals::gDebugFlag1, Named::getID(), MSBaseVehicle::getID(), MSNet::getInstance(), MSVehicle::getLane(), MSVehicle::getPositionOnLane(), MSVehicle::getSpeed(), MSAbstractLaneChangeModel::myVehicle, STEPS2TIME, SUMOReal, and toString().

void MSLCM_JE2013::prepareStep ( )
virtual
void MSAbstractLaneChangeModel::resetMoved ( )
inlineinherited

reset the flag whether a vehicle already moved to false

Definition at line 278 of file MSAbstractLaneChangeModel.h.

References MSAbstractLaneChangeModel::myAlreadyMoved.

Referenced by MSVehicle::planMove().

void MSLCM_JE2013::saveBlockerLength ( SUMOReal  length)
inlineprotectedvirtual

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

Reimplemented from MSAbstractLaneChangeModel.

Definition at line 143 of file MSLCM_JE2013.h.

References MAX2(), and myLeadingBlockerLength.

void MSAbstractLaneChangeModel::setOwnState ( int  state)
inlineinherited

Definition at line 196 of file MSAbstractLaneChangeModel.h.

References MSAbstractLaneChangeModel::myOwnState.

Referenced by MSLaneChanger::change().

void MSAbstractLaneChangeModel::unchanged ( )
inlineinherited
int MSLCM_JE2013::wantsChange ( int  laneOffset,
MSAbstractLaneChangeModel::MSLCMessager msgPass,
int  blocked,
const std::pair< MSVehicle *, SUMOReal > &  leader,
const std::pair< MSVehicle *, SUMOReal > &  neighLead,
const std::pair< MSVehicle *, SUMOReal > &  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.

Implements MSAbstractLaneChangeModel.

Definition at line 117 of file MSLCM_JE2013.cpp.

References _wantsChange(), DEBUG_COND, MSGlobals::gDebugFlag2, Named::getID(), MSBaseVehicle::getID(), MSNet::getInstance(), MSVehicle::getLane(), MSVehicle::getPositionOnLane(), MSVehicle::getSpeed(), LCA_BLOCKED, LCA_CHANGE_TO_HELP, LCA_COOPERATIVE, LCA_KEEPRIGHT, LCA_OVERLAPPING, LCA_SPEEDGAIN, LCA_STRATEGIC, LCA_TRACI, LCA_URGENT, LCA_WANTS_LANECHANGE, MSAbstractLaneChangeModel::myVehicle, and STEPS2TIME.

Field Documentation

bool MSAbstractLaneChangeModel::myAlreadyMoved
protectedinherited
bool MSLCM_JE2013::myDontBrake
protected

Definition at line 188 of file MSLCM_JE2013.h.

Referenced by _patchSpeed(), changed(), and prepareStep().

bool MSAbstractLaneChangeModel::myHaveShadow
protectedinherited
SUMOReal MSLCM_JE2013::myKeepRightProbability
protected

a value for tracking the probability of following the/"Rechtsfahrgebot" (never a positive value)

Definition at line 178 of file MSLCM_JE2013.h.

Referenced by _wantsChange(), changed(), keepRight(), and prepareStep().

int MSAbstractLaneChangeModel::myLaneChangeDirection
protectedinherited
bool MSAbstractLaneChangeModel::myLaneChangeMidpointPassed
protectedinherited

whether myLane has already been set to the target of the lane-change maneuver

Definition at line 331 of file MSAbstractLaneChangeModel.h.

Referenced by MSAbstractLaneChangeModel::continueLaneChangeManeuver(), MSAbstractLaneChangeModel::isLaneChangeMidpointPassed(), and MSAbstractLaneChangeModel::startLaneChangeManeuver().

SUMOTime MSAbstractLaneChangeModel::myLastLaneChangeOffset
protectedinherited
SUMOReal MSLCM_JE2013::myLeadingBlockerLength
protected
SUMOReal MSLCM_JE2013::myLeftSpace
protected
SUMOReal MSLCM_JE2013::myLookAheadSpeed
protected

Definition at line 185 of file MSLCM_JE2013.h.

Referenced by _wantsChange(), and changed().

SUMOReal MSLCM_JE2013::mySpeedGainProbability
protected

a value for tracking the probability that a change to the offset with the same sign is beneficial

Definition at line 176 of file MSLCM_JE2013.h.

Referenced by _wantsChange(), changed(), keepRight(), and prepareStep().

std::vector<SUMOReal> MSLCM_JE2013::myVSafes
protected

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