Interface for lane-change models. More...

#include <MSAbstractLaneChangeModel.h>

Inheritance diagram for MSAbstractLaneChangeModel:

Collaboration diagram for MSAbstractLaneChangeModel:

Data Structures
class	MSLCMessager
	A class responsible for exchanging messages between cars involved in lane-change interaction. More...

struct	StateAndDist

Public Member Functions
bool	alreadyChanged () const
	reset the flag whether a vehicle already moved to false

double	calcAngleOffset ()
	return the angle offset during a continuous change maneuver

virtual void	changed ()=0

void	changedToOpposite ()
	called when a vehicle changes between lanes in opposite directions

virtual int	checkChangeBeforeCommitting (const MSVehicle *veh, int state) const
	Informs the vehicle that it is about to be moved on an adjacent lane. The method can be used to re-evaluate the state of the vehicle and potentially abort the lane change. By default, if the method is not overridden by the lane change model implementation, nothing is altered and the vehicle will perform the lane change.

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.

void	cleanupShadowLane ()

void	cleanupTargetLane ()

void	clearGapsAtLCInit ()

void	clearNeighbors ()
	Clear info on neighboring vehicle from previous step.

virtual double	computeSpeedLat (double latDist, double &maneuverDist, bool urgent) const
	decides the next lateral speed depending on the remaining lane change distance to be covered and updates maneuverDist according to lateral safety constraints.

virtual bool	debugVehicle () const
	whether the current vehicles shall be debugged

virtual StateAndDist	decideDirection (StateAndDist sd1, StateAndDist sd2) const
	decide in which direction to move in case both directions are desirable

MSLane *	determineTargetLane (int &targetDir) const

void	endLaneChangeManeuver (const MSMoveReminder::Notification reason=MSMoveReminder::NOTIFICATION_LANE_CHANGE)

virtual double	estimateLCDuration (const double speed, const double remainingManeuverDist, const double decel, bool urgent) const
	Calculates the maximal time needed to complete a lane change maneuver if lcMaxSpeedLatFactor and lcMaxSpeedStanding are set and the vehicle breaks not harder than decel. LC when the vehicle starts breaking now. If lcMaxSpeedStanding==0 the completion may be impossible,.

double	getAccelerationLat () const
	return the lateral speed of the current lane change maneuver

double	getAngleOffset () const
	return the angle offset resulting from lane change and sigma

virtual double	getAssumedDecelForLaneChangeDuration () const
	Returns a deceleration value which is used for the estimation of the duration of a lane change.

int &	getCanceledState (const int dir)

double	getCommittedSpeed () const

virtual LatAlignmentDefinition	getDesiredAlignment () const

virtual double	getExtraReservation (int) const
	reserve extra space for unseen blockers when more tnan one lane change is required

const std::shared_ptr< MSLeaderDistanceInfo >	getFollowers (const int dir)
	Returns the neighboring, lc-relevant followers for the last step in the requested direction.

double	getForwardPos () const
	get vehicle position relative to the forward direction lane

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

double	getLaneChangeCompletion () const
	Get the current lane change completion ratio.

int	getLaneChangeDirection () const
	return the direction of the current lane change maneuver

SUMOTime	getLastLaneChangeOffset () const

const std::shared_ptr< MSLeaderDistanceInfo >	getLeaders (const int dir)
	Returns the neighboring, lc-relevant leaders for the last step in the requested direction.

double	getManeuverDist () const
	Returns the remaining unblocked distance for the current maneuver. (only used by sublane model)

virtual LaneChangeModel	getModelID () const =0
	Returns the model's ID;.

int	getNormalizedLaneIndex ()
	brief return lane index that treats opposite lanes like normal lanes to the left of the forward lanes

virtual double	getOppositeSafetyFactor () const
	return factor for modifying the safety constraints for opposite-diretction overtaking of the car-following model

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

double	getPreviousManeuverDist () const

int	getPrevState () const

virtual double	getSafetyFactor () const
	return factor for modifying the safety constraints of the car-following model

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

int	getShadowDirection () const
	return the direction in which the current shadow lane lies

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

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

MSLane *	getShadowLane () const
	Returns the lane the vehicle's shadow is on during continuous/sublane lane change.

MSLane *	getShadowLane (const MSLane *lane) const
	return the shadow lane for the given lane

MSLane *	getShadowLane (const MSLane *lane, double posLat) const
	return the shadow lane for the given lane and lateral offset

double	getSpeedLat () const
	return the lateral speed of the current lane change maneuver

double	getStrategicLookahead () const

MSLane *	getTargetLane () const
	Returns the lane the vehicle has committed to enter during a sublane lane change.

bool	hasBlueLight () const

virtual void *	inform (void info, MSVehicle sender)=0

bool	isChangingLanes () const
	return true if the vehicle currently performs a lane change maneuver

bool	isOpposite () const

bool	isStrategicBlocked () const

void	laneChangeOutput (const std::string &tag, MSLane source, MSLane target, int direction, double maneuverDist=0)
	called once the vehicle ends a lane change manoeuvre (non-instant)

virtual void	loadState (const SUMOSAXAttributes &attrs)
	Loads the state of the laneChangeModel from the given attributes.

void	memorizeGapsAtLCInit ()
	Control for resetting the memorized values for LC relevant gaps until the LC output is triggered in the case of continuous LC.

	MSAbstractLaneChangeModel (MSVehicle &v, const LaneChangeModel model)
	Constructor.

bool	pastMidpoint () const
	return whether the vehicle passed the midpoint of a continuous lane change maneuver

virtual double	patchSpeed (const double min, const double wanted, const double max, const MSCFModel &cfModel)=0
	Called to adapt the speed in order to allow a lane change. It uses information on LC-related desired speed-changes from the call to wantsChange() at the end of the previous simulation step.

virtual void	prepareStep ()

void	primaryLaneChanged (MSLane source, MSLane target, int direction)
	called once when the vehicles primary lane changes

SUMOTime	remainingTime () const
	Compute the remaining time until LC completion.

void	removeShadowApproachingInformation () const

void	resetChanged ()
	reset the flag whether a vehicle already moved to false

virtual void	resetSpeedLat ()

virtual void	resetState ()

virtual bool	saveBlockerLength (double, double)
	reserve space at the end of the lane to avoid dead locks

void	saveLCState (const int dir, int stateWithoutTraCI, const int state)

void	saveNeighbors (const int dir, const MSLeaderDistanceInfo &followers, const MSLeaderDistanceInfo &leaders)
	Saves the lane change relevant vehicles, which are currently on neighboring lanes in the given direction (as detected in wantsChangeSublane()). -> SL2015 case.

void	saveNeighbors (const int dir, const std::pair< MSVehicle const, double > &follower, const std::pair< MSVehicle const, double > &leader)
	Saves the lane change relevant vehicles, which are currently on neighboring lanes in the given direction (as detected in wantsChange()). -> LC2013 case.

virtual void	saveState (OutputDevice &out) const
	Save the state of the laneChangeModel.

void	setAngleOffset (const double angleOffset)
	set the angle offset resulting from lane change and sigma

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)

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

void	setPreviousAngleOffset (const double angleOffset)
	set the angle offset of the previous time step

void	setShadowApproachingInformation (MSLink *link) const
	set approach information for the shadow vehicle

void	setShadowPartialOccupator (MSLane *lane)

void	setSpeedLat (double speedLat)
	set the lateral speed and update lateral acceleraton

bool	startLaneChangeManeuver (MSLane source, MSLane target, int direction)
	start the lane change maneuver and return whether it continues

virtual bool	sublaneChangeCompleted (const double latDist) const
	whether the current change completes the manoeuvre

void	unchanged ()

bool	updateCompletion ()

virtual void	updateExpectedSublaneSpeeds (const MSLeaderDistanceInfo &ahead, int sublaneOffset, int laneIndex)
	update expected speeds for each sublane of the current edge

virtual void	updateSafeLatDist (const double travelledLatDist)
	Updates the value of safe lateral distances (in SL2015) during maneuver continuation in non-action steps.

void	updateShadowLane ()

MSLane *	updateTargetLane ()

virtual int	wantsChange (int laneOffset, MSAbstractLaneChangeModel::MSLCMessager &msgPass, int blocked, const std::pair< MSVehicle , double > &leader, const std::pair< MSVehicle , double > &follower, 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.

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	~MSAbstractLaneChangeModel ()
	Destructor.

Static Public Member Functions
static MSAbstractLaneChangeModel *	build (LaneChangeModel lcm, MSVehicle &vehicle)
	Factory method for instantiating new lane changing models.

static bool	haveLCOutput ()
	whether lanechange-output is active

static void	initGlobalOptions (const OptionsCont &oc)
	init global model parameters

static bool	outputLCEnded ()
	whether start of maneuvers shall be recorede

static bool	outputLCStarted ()
	whether start of maneuvers shall be recorede

Static Public Attributes
static const double	NO_NEIGHBOR

static const double	UNDEFINED_LOOKAHEAD

Protected Member Functions
void	addLCSpeedAdvice (const double vSafe, bool ownAdvice=true)
	Takes a vSafe (speed advice for speed in the next simulation step), converts it into an acceleration and stores it into myLCAccelerationAdvices.

virtual bool	avoidOvertakeRight () const

bool	cancelRequest (int state, int laneOffset)
	whether the influencer cancels the given request

virtual bool	congested (const MSVehicle *const neighLeader)

const MSCFModel &	getCarFollowModel () const
	The vehicle's car following model.

double	getMaxSpeedLat2 () const
	return the max of maxSpeedLat and lcMaxSpeedLatStanding

void	initLastLaneChangeOffset (int dir)

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

Protected Attributes
double	myAccelerationLat
	the current lateral acceleration

bool	myAlreadyChanged
	whether the vehicle has already moved this step

double	myAngleOffset
	the current angle offset resulting from lane change and sigma

int	myCanceledStateCenter

int	myCanceledStateLeft

int	myCanceledStateRight

double	myCommittedSpeed
	the speed when committing to a change maneuver

bool	myDontResetLCGaps
	Flag to prevent resetting the memorized values for LC relevant gaps until the LC output is triggered in the case of continuous LC.

std::vector< MSLane * >	myFurtherTargetLanes

bool	myHaveBlueLight
	whether this vehicle is driving with special permissions and behavior

double	myLaneChangeCompletion
	progress of the lane change maneuver 0:started, 1:complete

int	myLaneChangeDirection
	direction of the lane change maneuver -1 means right, 1 means left

double	myLastFollowerGap

double	myLastFollowerSecureGap

double	myLastFollowerSpeed

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

double	myLastLateralGapRight

double	myLastLeaderGap
	the actual minimum longitudinal distances to vehicles on the target lane

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

double	myLastLeaderSpeed
	speeds of surrounding vehicles at the time of lane change

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

double	myLastOrigLeaderSecureGap

double	myLastOrigLeaderSpeed

std::vector< std::pair< double, bool > >	myLCAccelerationAdvices

double	myMaxDistLatStanding

double	myMaxSpeedLatFactor

double	myMaxSpeedLatStanding

const LaneChangeModel	myModel
	the type of this model

std::vector< MSLane * >	myNoPartiallyOccupatedByShadow

double	myOvertakeRightParam

int	myOwnState
	The current state of the vehicle.

std::vector< MSLane * >	myPartiallyOccupatedByShadow
	list of lanes where the shadow vehicle is partial occupator

double	myPreviousAngleOffset
	the angle offset of the previous time step resulting from lane change and sigma

int	myPreviousState
	lane changing state from the previous simulation step

int	myPreviousState2
	lane changing state from step before the previous simulation step

std::pair< int, int >	mySavedStateCenter

std::pair< int, int >	mySavedStateLeft

std::pair< int, int >	mySavedStateRight

std::vector< MSLane * >	myShadowFurtherLanes

std::vector< double >	myShadowFurtherLanesPosLat

MSLane *	myShadowLane
	A lane that is partially occupied by the front of the vehicle but that is not the primary lane.

double	mySigma

double	mySpeedLat
	the current lateral speed

double	myStrategicLookahead

MSLane *	myTargetLane
	The target lane for the vehicle's current maneuver.

MSVehicle &	myVehicle
	The vehicle this lane-changer belongs to.


std::shared_ptr< MSLeaderDistanceInfo >	myLeftFollowers
	Cached info on lc-relevant neighboring vehicles.

std::shared_ptr< MSLeaderDistanceInfo >	myLeftLeaders

std::shared_ptr< MSLeaderDistanceInfo >	myRightFollowers

std::shared_ptr< MSLeaderDistanceInfo >	myRightLeaders

Static Protected Attributes
static bool	myAllowOvertakingRight
	whether overtaking on the right is permitted

static bool	myLCEndedOutput

static bool	myLCOutput
	whether to record lane-changing

static bool	myLCStartedOutput

static bool	myLCXYOutput

Private Member Functions
MSAbstractLaneChangeModel &	operator= (const MSAbstractLaneChangeModel &s)
	Invalidated assignment operator.

Private Attributes
bool	myAmOpposite
	whether the vehicle is driving in the opposite direction

std::vector< MSLink * >	myApproachedByShadow
	links which are approached by the shadow vehicle

SUMOTime	myLastLaneChangeOffset

double	myManeuverDist
	The complete lateral distance the vehicle wants to travel to finish its maneuver Only used by sublane model, currently.

double	myPreviousManeuverDist
	Maneuver distance from the previous simulation step.

Detailed Description

Interface for lane-change models.

Definition at line 47 of file MSAbstractLaneChangeModel.h.

Constructor & Destructor Documentation

◆ MSAbstractLaneChangeModel()

MSAbstractLaneChangeModel::MSAbstractLaneChangeModel	(	MSVehicle &	v,
		const LaneChangeModel	model
	)

Constructor.

Parameters

[in]	v	The vehicle this lane-changer belongs to
[in]	model	The type of lane change model

Definition at line 107 of file MSAbstractLaneChangeModel.cpp.

References LCA_UNKNOWN, and saveLCState().

◆ ~MSAbstractLaneChangeModel()

MSAbstractLaneChangeModel::~MSAbstractLaneChangeModel ( )

virtual

Destructor.

Definition at line 157 of file MSAbstractLaneChangeModel.cpp.

Member Function Documentation

◆ addLCSpeedAdvice()

void MSAbstractLaneChangeModel::addLCSpeedAdvice	(	const double	vSafe,
		bool	ownAdvice = `true`
	)

protected

Takes a vSafe (speed advice for speed in the next simulation step), converts it into an acceleration and stores it into myLCAccelerationAdvices.

Note: This construction was introduced to deal with action step lengths, where operation on the speed in the next sim step had to be replaced by acceleration throughout the next action step.

Definition at line 1103 of file MSAbstractLaneChangeModel.cpp.

References MSVehicle::getSpeed(), myLCAccelerationAdvices, myVehicle, and SPEED2ACCEL.

Referenced by MSLCM_LC2013::_wantsChange(), MSLCM_SL2015::checkStrategicChange(), MSLCM_LC2013::inform(), MSLCM_SL2015::inform(), MSLCM_SL2015::informFollower(), MSLCM_LC2013::informFollower(), MSLCM_SL2015::informLeader(), MSLCM_LC2013::informLeader(), MSLCM_LC2013::slowDownForBlocked(), and MSLCM_SL2015::slowDownForBlocked().

Here is the caller graph for this function:

◆ alreadyChanged()

bool MSAbstractLaneChangeModel::alreadyChanged ( ) const

inline

reset the flag whether a vehicle already moved to false

Definition at line 503 of file MSAbstractLaneChangeModel.h.

References myAlreadyChanged.

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

Here is the caller graph for this function:

◆ avoidOvertakeRight()

bool MSAbstractLaneChangeModel::avoidOvertakeRight ( ) const

protectedvirtual

Definition at line 285 of file MSAbstractLaneChangeModel.cpp.

References MSVehicle::congested(), MSBaseVehicle::getRNG(), MSVehicleType::getVehicleClass(), MSBaseVehicle::getVehicleType(), myAllowOvertakingRight, myOvertakeRightParam, myVehicle, RandHelper::rand(), and SVC_EMERGENCY.

Referenced by MSLCM_LC2013::_wantsChange(), MSLCM_SL2015::checkStrategicChange(), and MSLCM_SL2015::mustOvertakeStopped().

Here is the caller graph for this function:

◆ build()

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

static

Factory method for instantiating new lane changing models.

Parameters

[in]	lcm	The type of model to build
[in]	vehicle	The vehicle for which this model shall be built

Definition at line 82 of file MSAbstractLaneChangeModel.cpp.

References DEFAULT, DK2008, MSGlobals::gLateralResolution, LC2013, LC2013_CC, SL2015, TLF, and toString().

Referenced by MSVehicle::initDevices().

Here is the caller graph for this function:

◆ calcAngleOffset()

double MSAbstractLaneChangeModel::calcAngleOffset ( )

return the angle offset during a continuous change maneuver

Definition at line 745 of file MSAbstractLaneChangeModel.cpp.

References MSBaseVehicle::getLength(), MSVehicle::getSpeed(), M_PI, myAngleOffset, myPreviousAngleOffset, mySpeedLat, myVehicle, and SPEED2DIST.

Referenced by MSVehicle::computeAngle().

Here is the caller graph for this function:

◆ cancelRequest()

bool MSAbstractLaneChangeModel::cancelRequest	(	int	state,
		int	laneOffset
	)

protected

whether the influencer cancels the given request

Definition at line 560 of file MSAbstractLaneChangeModel.cpp.

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

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

Here is the caller graph for this function:

◆ changed()

virtual void MSAbstractLaneChangeModel::changed ( )

pure virtual

Implemented in MSLCM_DK2008, MSLCM_LC2013, and MSLCM_SL2015.

Referenced by primaryLaneChanged().

Here is the caller graph for this function:

◆ changedToOpposite()

void MSAbstractLaneChangeModel::changedToOpposite ( )

called when a vehicle changes between lanes in opposite directions

Definition at line 950 of file MSAbstractLaneChangeModel.cpp.

References myAlreadyChanged, and myAmOpposite.

Referenced by endLaneChangeManeuver(), MSVehicle::executeMove(), and primaryLaneChanged().

Here is the caller graph for this function:

◆ checkChangeBeforeCommitting()

virtual int MSAbstractLaneChangeModel::checkChangeBeforeCommitting	(	const MSVehicle *	veh,
		int	state
	)		const

inlinevirtual

Informs the vehicle that it is about to be moved on an adjacent lane. The method can be used to re-evaluate the state of the vehicle and potentially abort the lane change. By default, if the method is not overridden by the lane change model implementation, nothing is altered and the vehicle will perform the lane change.

Parameters

veh	the lane changing vehicle
state	current lane change state

Returns: the blocked status of the vehicle. If the vehicle should perform the lane change, the method should return 0, corresponding to non-blocked. Otherwise the method should return a non-zero state, corresponding to the type of blockage.

Reimplemented in MSLCM_LC2013_CC.

Definition at line 155 of file MSAbstractLaneChangeModel.h.

References UNUSED_PARAMETER.

Referenced by MSLaneChanger::checkChange().

Here is the caller graph for this function:

◆ checkTraCICommands()

void MSAbstractLaneChangeModel::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.

Definition at line 904 of file MSAbstractLaneChangeModel.cpp.

References gDebugFlag2, Named::getID(), MSVehicle::getInfluencer(), MSVehicle::getLaneChangeModel(), MSVehicle::Influencer::getLatDist(), getOwnState(), MSGlobals::gLateralResolution, MSVehicle::hasInfluencer(), MSVehicle::influenceChangeDecision(), MSVehicle::lateralDistanceToLane(), LCA_LEFT, LCA_RIGHT, LCA_STAY, LCA_TRACI, myOwnState, myVehicle, MSVehicle::Influencer::resetLatDist(), setManeuverDist(), setOwnState(), SIMTIME, and toString().

Referenced by MSLaneChanger::checkTraCICommands().

Here is the caller graph for this function:

◆ cleanupShadowLane()

void MSAbstractLaneChangeModel::cleanupShadowLane ( )

Definition at line 519 of file MSAbstractLaneChangeModel.cpp.

References debugVehicle(), myNoPartiallyOccupatedByShadow, myShadowFurtherLanes, myShadowLane, myVehicle, MSLane::resetPartialOccupation(), and SIMTIME.

Referenced by MSVehicle::cleanupFurtherLanes(), endLaneChangeManeuver(), and MSDevice_Bluelight::notifyMove().

Here is the caller graph for this function:

◆ cleanupTargetLane()

void MSAbstractLaneChangeModel::cleanupTargetLane ( )

Definition at line 538 of file MSAbstractLaneChangeModel.cpp.

References debugVehicle(), myFurtherTargetLanes, myTargetLane, myVehicle, MSLane::resetManeuverReservation(), and SIMTIME.

Referenced by MSVehicle::cleanupFurtherLanes(), endLaneChangeManeuver(), and MSDevice_Bluelight::notifyMove().

Here is the caller graph for this function:

◆ clearGapsAtLCInit()

void MSAbstractLaneChangeModel::clearGapsAtLCInit ( )

Definition at line 329 of file MSAbstractLaneChangeModel.cpp.

References myDontResetLCGaps.

Referenced by laneChangeOutput().

Here is the caller graph for this function:

◆ clearNeighbors()

void MSAbstractLaneChangeModel::clearNeighbors ( )

Clear info on neighboring vehicle from previous step.

Definition at line 230 of file MSAbstractLaneChangeModel.cpp.

References myLeftFollowers, myLeftLeaders, myRightFollowers, and myRightLeaders.

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

Here is the caller graph for this function:

◆ computeSpeedLat()

double MSAbstractLaneChangeModel::computeSpeedLat	(	double	latDist,
		double &	maneuverDist,
		bool	urgent
	)		const

virtual

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_LC2013, and MSLCM_SL2015.

Definition at line 418 of file MSAbstractLaneChangeModel.cpp.

References DIST2SPEED, MSVehicleType::getMaxSpeedLat(), MSBaseVehicle::getVehicleType(), MSGlobals::gLaneChangeDuration, myVehicle, SPEED2DIST, STEPS2TIME, VTYPEPARS_MAXSPEED_LAT_SET, and MSVehicleType::wasSet().

Referenced by MSLCM_LC2013::computeSpeedLat(), MSLaneChangerSublane::continueChangeSublane(), estimateLCDuration(), and updateCompletion().

Here is the caller graph for this function:

◆ congested()

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

protectedvirtual

Definition at line 266 of file MSAbstractLaneChangeModel.cpp.

References MSVehicle::congested(), MSVehicle::getLane(), MSLane::getSpeedLimit(), and myVehicle.

Referenced by MSLCM_DK2008::wantsChangeToLeft(), and MSLCM_DK2008::wantsChangeToRight().

Here is the caller graph for this function:

◆ debugVehicle()

virtual bool MSAbstractLaneChangeModel::debugVehicle ( ) const

inlinevirtual

whether the current vehicles shall be debugged

Reimplemented in MSLCM_LC2013, and MSLCM_SL2015.

Definition at line 393 of file MSAbstractLaneChangeModel.h.

Referenced by MSLaneChangerSublane::change(), cleanupShadowLane(), cleanupTargetLane(), endLaneChangeManeuver(), MSLCHelper::getRoundaboutDistBonus(), getShadowLane(), MSLCM_SL2015::inform(), primaryLaneChanged(), updateShadowLane(), and updateTargetLane().

Here is the caller graph for this function:

◆ decideDirection()

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

inlinevirtual

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

Reimplemented in MSLCM_SL2015.

Definition at line 350 of file MSAbstractLaneChangeModel.h.

References myModel, toString(), and UNUSED_PARAMETER.

Referenced by MSLaneChangerSublane::change().

Here is the caller graph for this function:

◆ determineTargetLane()

MSLane * MSAbstractLaneChangeModel::determineTargetLane ( int & targetDir ) const

Definition at line 713 of file MSAbstractLaneChangeModel.cpp.

References MSVehicle::getLane(), MSVehicle::getLateralPositionOnLane(), MSLane::getParallelLane(), MSBaseVehicle::getWidth(), MSLane::getWidth(), myManeuverDist, myShadowLane, and myVehicle.

Referenced by updateTargetLane().

Here is the caller graph for this function:

◆ endLaneChangeManeuver()

void MSAbstractLaneChangeModel::endLaneChangeManeuver ( const MSMoveReminder::Notification reason = MSMoveReminder::NOTIFICATION_LANE_CHANGE )

Definition at line 460 of file MSAbstractLaneChangeModel.cpp.

References changedToOpposite(), cleanupShadowLane(), cleanupTargetLane(), debugVehicle(), MSVehicle::fixPosition(), Named::getID(), MSBaseVehicle::getNextStop(), MSStop::isOpposite, myAmOpposite, myLaneChangeCompletion, myNoPartiallyOccupatedByShadow, myVehicle, MSMoveReminder::NOTIFICATION_LANE_CHANGE, MSMoveReminder::NOTIFICATION_PARKING, SIMTIME, MSVehicle::switchOffSignal(), UNUSED_PARAMETER, MSVehicle::VEH_SIGNAL_BLINKER_LEFT, and MSVehicle::VEH_SIGNAL_BLINKER_RIGHT.

Referenced by MSVehicleTransfer::add(), MSLaneChanger::continueChange(), MSVehicle::processLaneAdvances(), and updateShadowLane().

Here is the caller graph for this function:

◆ estimateLCDuration()

double MSAbstractLaneChangeModel::estimateLCDuration	(	const double	speed,
		const double	remainingManeuverDist,
		const double	decel,
		bool	urgent
	)		const

virtual

Calculates the maximal time needed to complete a lane change maneuver if lcMaxSpeedLatFactor and lcMaxSpeedStanding are set and the vehicle breaks not harder than decel. LC when the vehicle starts breaking now. If lcMaxSpeedStanding==0 the completion may be impossible,.

Parameters

[in]	speed	Current longitudinal speed of the changing vehicle.
[in]	remainingManeuverDist	dist which is still to be covered until LC is completed
[in]	decel	Maximal assumed deceleration rate applied during the LC.

Returns: maximal LC duration (or -1) if it is possible that it can't be completed.

Note: 1) For the calculation it is assumed that the vehicle starts breaking with decel (>=0) immediately. If lcMaxSpeedStanding==0 the completion may be impossible, and -1 is returned. 2) In case that no maxSpeedLat is used to control lane changing, this is only called prior to a lane change, and the duration is MSGlobals::gLaneChangeDuration.

Definition at line 761 of file MSAbstractLaneChangeModel.cpp.

References computeSpeedLat(), MSVehicle::getAcceleration(), SUMOVTypeParameter::getLCParams(), MSVehicleType::getMaxSpeedLat(), MSVehicleType::getParameter(), MSBaseVehicle::getVehicleType(), MSGlobals::gLaneChangeDuration, myMaxSpeedLatFactor, myMaxSpeedLatStanding, myVehicle, STEPS2TIME, SUMO_ATTR_LCA_MAXSPEEDLATFACTOR, SUMO_ATTR_LCA_MAXSPEEDLATSTANDING, SUMO_const_haltingSpeed, VTYPEPARS_MAXSPEED_LAT_SET, and MSVehicleType::wasSet().

Referenced by MSLaneChanger::checkChange(), and remainingTime().

Here is the caller graph for this function:

◆ getAccelerationLat()

double MSAbstractLaneChangeModel::getAccelerationLat ( ) const

inline

return the lateral speed of the current lane change maneuver

Definition at line 597 of file MSAbstractLaneChangeModel.h.

References myAccelerationLat.

Referenced by MSFCDExport::write().

Here is the caller graph for this function:

◆ getAngleOffset()

double MSAbstractLaneChangeModel::getAngleOffset ( ) const

inline

return the angle offset resulting from lane change and sigma

Definition at line 488 of file MSAbstractLaneChangeModel.h.

References myAngleOffset.

Referenced by MSVehicle::executeMove(), and GUIVehicle::getVisualAngle().

Here is the caller graph for this function:

◆ getAssumedDecelForLaneChangeDuration()

double MSAbstractLaneChangeModel::getAssumedDecelForLaneChangeDuration ( ) const

virtual

Returns a deceleration value which is used for the estimation of the duration of a lane change.

Note: Effective only for continuous lane-changing when using attributes myMaxSpeedLatFactor and myMaxSpeedLatStanding. See #3771

Definition at line 429 of file MSAbstractLaneChangeModel.cpp.

References MSVehicle::getAcceleration(), LC_ASSUMED_DECEL, MAX2(), and myVehicle.

Referenced by MSLaneChanger::checkChange().

Here is the caller graph for this function:

◆ getCanceledState()

int & MSAbstractLaneChangeModel::getCanceledState ( const int dir )

inline

Definition at line 258 of file MSAbstractLaneChangeModel.h.

References myCanceledStateCenter, myCanceledStateLeft, and myCanceledStateRight.

Referenced by MSLCM_LC2013::_wantsChange(), MSLCM_SL2015::_wantsChangeSublane(), cancelRequest(), MSLaneChangerSublane::checkChangeSublane(), MSLCM_SL2015::checkStrategicChange(), prepareStep(), and saveLCState().

Here is the caller graph for this function:

◆ getCarFollowModel()

const MSCFModel & MSAbstractLaneChangeModel::getCarFollowModel ( ) const

inlineprotected

The vehicle's car following model.

Definition at line 748 of file MSAbstractLaneChangeModel.h.

References MSVehicle::getCarFollowModel(), and myVehicle.

Referenced by MSLCM_LC2013::_wantsChange(), MSLCM_LC2013::anticipateFollowSpeed(), MSLCM_SL2015::checkStrategicChange(), MSLCM_DK2008::informBlocker(), MSLCM_LC2013::informFollower(), MSLCM_SL2015::informLeader(), MSLCM_LC2013::informLeader(), predInteraction(), MSLCM_LC2013::slowDownForBlocked(), MSLCM_SL2015::slowDownForBlocked(), MSLCM_SL2015::updateExpectedSublaneSpeeds(), MSLCM_DK2008::wantsChangeToLeft(), and MSLCM_DK2008::wantsChangeToRight().

Here is the caller graph for this function:

◆ getCommittedSpeed()

double MSAbstractLaneChangeModel::getCommittedSpeed ( ) const

inline

Definition at line 583 of file MSAbstractLaneChangeModel.h.

References myCommittedSpeed.

Referenced by MSVehicle::planMoveInternal(), and MSLaneChangerSublane::startChangeSublane().

Here is the caller graph for this function:

◆ getDesiredAlignment()

virtual LatAlignmentDefinition MSAbstractLaneChangeModel::getDesiredAlignment ( ) const

inlinevirtual

Reimplemented in MSLCM_SL2015.

Definition at line 643 of file MSAbstractLaneChangeModel.h.

References MSVehicleType::getPreferredLateralAlignment(), MSBaseVehicle::getVehicleType(), and myVehicle.

Referenced by MSLCM_SL2015::getDesiredAlignment().

Here is the caller graph for this function:

◆ getExtraReservation()

virtual double MSAbstractLaneChangeModel::getExtraReservation ( int ) const

inlinevirtual

reserve extra space for unseen blockers when more tnan one lane change is required

Reimplemented in MSLCM_LC2013, and MSLCM_SL2015.

Definition at line 628 of file MSAbstractLaneChangeModel.h.

Referenced by MSLane::isInsertionSuccess().

Here is the caller graph for this function:

◆ getFollowers()

const std::shared_ptr< MSLeaderDistanceInfo > MSAbstractLaneChangeModel::getFollowers ( const int dir )

Returns the neighboring, lc-relevant followers for the last step in the requested direction.

Definition at line 239 of file MSAbstractLaneChangeModel.cpp.

References myLeftFollowers, and myRightFollowers.

◆ getForwardPos()

double MSAbstractLaneChangeModel::getForwardPos ( ) const

get vehicle position relative to the forward direction lane

Definition at line 1087 of file MSAbstractLaneChangeModel.cpp.

References MSVehicle::getLane(), MSLane::getLength(), MSVehicle::getPositionOnLane(), myAmOpposite, and myVehicle.

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

Here is the caller graph for this function:

◆ getFurtherTargetLanes()

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

inline

Definition at line 436 of file MSAbstractLaneChangeModel.h.

References myFurtherTargetLanes.

Referenced by MSVehicle::getBackPositionOnLane(), and MSVehicle::getLatOffset().

Here is the caller graph for this function:

◆ getLaneChangeCompletion()

double MSAbstractLaneChangeModel::getLaneChangeCompletion ( ) const

inline

Get the current lane change completion ratio.

Definition at line 472 of file MSAbstractLaneChangeModel.h.

References myLaneChangeCompletion.

Referenced by MSLaneChanger::continueChange(), and MSVehicle::planMoveInternal().

Here is the caller graph for this function:

◆ getLaneChangeDirection()

int MSAbstractLaneChangeModel::getLaneChangeDirection ( ) const

inline

return the direction of the current lane change maneuver

Definition at line 477 of file MSAbstractLaneChangeModel.h.

References myLaneChangeDirection.

Referenced by MSLaneChanger::continueChange(), and MSVehicle::setBlinkerInformation().

Here is the caller graph for this function:

◆ getLastLaneChangeOffset()

SUMOTime MSAbstractLaneChangeModel::getLastLaneChangeOffset ( ) const

inline

Definition at line 440 of file MSAbstractLaneChangeModel.h.

References myLastLaneChangeOffset.

◆ getLeaders()

const std::shared_ptr< MSLeaderDistanceInfo > MSAbstractLaneChangeModel::getLeaders ( const int dir )

Returns the neighboring, lc-relevant leaders for the last step in the requested direction.

Definition at line 252 of file MSAbstractLaneChangeModel.cpp.

References myLeftLeaders, and myRightLeaders.

◆ getManeuverDist()

double MSAbstractLaneChangeModel::getManeuverDist ( ) const

Returns the remaining unblocked distance for the current maneuver. (only used by sublane model)

Definition at line 190 of file MSAbstractLaneChangeModel.cpp.

References myManeuverDist.

Referenced by MSLCM_SL2015::_wantsChangeSublane(), MSLaneChangerSublane::change(), MSLCM_SL2015::changed(), MSLaneChangerSublane::continueChangeSublane(), MSVehicle::getLatOffset(), MSLink::getLeaderInfo(), GUIVehicle::getManeuverDist(), MSLeaderInfo::getSubLanes(), MSLaneChangerSublane::startChangeSublane(), updateCompletion(), and MSLCM_SL2015::updateGaps().

Here is the caller graph for this function:

◆ getMaxSpeedLat2()

double MSAbstractLaneChangeModel::getMaxSpeedLat2 ( ) const

protected

return the max of maxSpeedLat and lcMaxSpeedLatStanding

Definition at line 568 of file MSAbstractLaneChangeModel.cpp.

References MSVehicleType::getMaxSpeedLat(), MSBaseVehicle::getVehicleType(), MAX2(), myMaxSpeedLatStanding, and myVehicle.

Referenced by MSLCM_SL2015::checkBlocking().

Here is the caller graph for this function:

◆ getModelID()

virtual LaneChangeModel MSAbstractLaneChangeModel::getModelID ( ) const

pure virtual

Returns the model's ID;.

Returns: The model's ID

Implemented in MSLCM_DK2008, MSLCM_LC2013, MSLCM_LC2013_CC, and MSLCM_SL2015.

◆ getNormalizedLaneIndex()

int MSAbstractLaneChangeModel::getNormalizedLaneIndex ( )

brief return lane index that treats opposite lanes like normal lanes to the left of the forward lanes

Definition at line 1093 of file MSAbstractLaneChangeModel.cpp.

References MSLane::getEdge(), MSLane::getIndex(), MSVehicle::getLane(), MSEdge::getNumLanes(), MSLane::getParallelOpposite(), myAmOpposite, and myVehicle.

Referenced by MSLaneChanger::checkOppositeStop().

Here is the caller graph for this function:

◆ getOppositeSafetyFactor()

virtual double MSAbstractLaneChangeModel::getOppositeSafetyFactor ( ) const

inlinevirtual

return factor for modifying the safety constraints for opposite-diretction overtaking of the car-following model

Reimplemented in MSLCM_LC2013, and MSLCM_SL2015.

Definition at line 388 of file MSAbstractLaneChangeModel.h.

Referenced by MSLaneChanger::changeOpposite(), MSLaneChanger::computeOvertakingTime(), and MSLaneChanger::getColumnleader().

Here is the caller graph for this function:

◆ getOwnState()

int MSAbstractLaneChangeModel::getOwnState ( ) const

inline

Definition at line 195 of file MSAbstractLaneChangeModel.h.

References myOwnState.

Referenced by MSLaneChangerSublane::abortLCManeuver(), MSLaneChanger::applyTraCICommands(), MSLaneChanger::change(), checkTraCICommands(), MSLaneChanger::checkTraCICommands(), MSLaneChangerSublane::continueChangeSublane(), MSLaneChangerSublane::outputLCEnded(), MSLaneChangerSublane::outputLCStarted(), MSVehicle::setBlinkerInformation(), MSLaneChangerSublane::startChangeSublane(), and MSLCHelper::updateBlockerLength().

Here is the caller graph for this function:

◆ getParameter()

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

inlinevirtual

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

Reimplemented in MSLCM_LC2013, and MSLCM_SL2015.

Definition at line 617 of file MSAbstractLaneChangeModel.h.

References myModel, and toString().

Referenced by MSBaseVehicle::getPrefixedParameter().

Here is the caller graph for this function:

◆ getPreviousManeuverDist()

double MSAbstractLaneChangeModel::getPreviousManeuverDist ( ) const

Definition at line 195 of file MSAbstractLaneChangeModel.cpp.

References myPreviousManeuverDist.

Referenced by MSLCM_SL2015::_wantsChangeSublane(), MSLaneChangerSublane::abortLCManeuver(), and MSLaneChangerSublane::startChangeSublane().

Here is the caller graph for this function:

◆ getPrevState()

int MSAbstractLaneChangeModel::getPrevState ( ) const

inline

at the time of this call myPreviousState already holds the new value

Definition at line 199 of file MSAbstractLaneChangeModel.h.

References myPreviousState2.

Referenced by MSLaneChangerSublane::abortLCManeuver(), MSLaneChangerSublane::outputLCStarted(), and MSLaneChangerSublane::startChangeSublane().

Here is the caller graph for this function:

◆ getSafetyFactor()

virtual double MSAbstractLaneChangeModel::getSafetyFactor ( ) const

inlinevirtual

return factor for modifying the safety constraints of the car-following model

Reimplemented in MSLCM_LC2013, and MSLCM_SL2015.

Definition at line 383 of file MSAbstractLaneChangeModel.h.

Referenced by MSLaneChanger::checkChange(), LIBSUMO_NAMESPACE::Vehicle::getNeighbors(), and MSCFModel::getSecureGap().

Here is the caller graph for this function:

◆ getSavedState()

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

inline

Definition at line 215 of file MSAbstractLaneChangeModel.h.

References mySavedStateCenter, mySavedStateLeft, and mySavedStateRight.

◆ getShadowDirection()

int MSAbstractLaneChangeModel::getShadowDirection ( ) const

return the direction in which the current shadow lane lies

Definition at line 643 of file MSAbstractLaneChangeModel.cpp.

References MSLane::getEdge(), MSLane::getIndex(), MSVehicle::getLane(), isChangingLanes(), myAmOpposite, myLaneChangeDirection, myShadowLane, myVehicle, and pastMidpoint().

Referenced by MSVehicle::checkLinkLeaderCurrentAndParallel(), MSVehicle::getCenterOnEdge(), MSVehicle::planMoveInternal(), MSVehicle::processLinkApproaches(), GUIVehicle::selectBlockingFoes(), and MSVehicle::setApproachingForAllLinks().

Here is the caller graph for this function:

◆ getShadowFurtherLanes()

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

inline

Definition at line 421 of file MSAbstractLaneChangeModel.h.

References myShadowFurtherLanes.

Referenced by MSVehicle::getBackPositionOnLane(), MSVehicle::getCenterOnEdge(), and MSVehicle::getLatOffset().

Here is the caller graph for this function:

◆ getShadowFurtherLanesPosLat()

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

inline

Definition at line 425 of file MSAbstractLaneChangeModel.h.

References myShadowFurtherLanesPosLat.

Referenced by MSVehicle::getBackPositionOnLane(), MSVehicle::getCenterOnEdge(), and MSVehicle::getLatOffset().

Here is the caller graph for this function:

◆ getShadowLane() [1/3]

MSLane * MSAbstractLaneChangeModel::getShadowLane ( ) const

inline

Returns the lane the vehicle's shadow is on during continuous/sublane lane change.

Returns: The vehicle's shadow lane

Definition at line 411 of file MSAbstractLaneChangeModel.h.

References myShadowLane.

Referenced by MSVehicle::adaptToLeaders(), MSLaneChangerSublane::addOutsideLeaders(), MSVehicle::brakeForOverlap(), MSVehicle::checkLinkLeader(), MSVehicle::checkLinkLeaderCurrentAndParallel(), MSLCM_SL2015::checkStrategicChange(), MSLaneChanger::computeSafeOppositeLength(), MSLaneChanger::computeSurplusGap(), MSLaneChanger::continueChange(), MSLane::detectCollisionBetween(), MSVehicle::executeMove(), MSLane::executeMovements(), MSVehicle::getBackPosition(), MSVehicle::getBackPositionOnLane(), MSVehicle::getCenterOnEdge(), MSVehicle::getLatOffset(), MSLane::getLeader(), getShadowLane(), MSVehicle::interpolateLateralZ(), MSVehicle::isFrontOnLane(), MSLane::isInsertionSuccess(), MSVehicle::planMoveInternal(), MSVehicle::processLinkApproaches(), GUIVehicle::selectBlockingFoes(), MSVehicle::setApproachingForAllLinks(), MSLaneChangerSublane::startChangeSublane(), MSLaneChangerSublane::updateChanger(), and updateShadowLane().

Here is the caller graph for this function:

◆ getShadowLane() [2/3]

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

return the shadow lane for the given lane

Definition at line 513 of file MSAbstractLaneChangeModel.cpp.

References MSVehicle::getLateralPositionOnLane(), getShadowLane(), and myVehicle.

◆ getShadowLane() [3/3]

MSLane * MSAbstractLaneChangeModel::getShadowLane	(	const MSLane *	lane,
		double	posLat
	)		const

return the shadow lane for the given lane and lateral offset

Definition at line 485 of file MSAbstractLaneChangeModel.cpp.

References debugVehicle(), Named::getID(), MSVehicle::getLateralOverlap(), MSLane::getParallelLane(), isChangingLanes(), myAmOpposite, myLaneChangeCompletion, myLaneChangeDirection, myNoPartiallyOccupatedByShadow, myVehicle, and SIMTIME.

◆ getSpeedLat()

double MSAbstractLaneChangeModel::getSpeedLat ( ) const

inline

return the lateral speed of the current lane change maneuver

Definition at line 588 of file MSAbstractLaneChangeModel.h.

References mySpeedLat.

Referenced by MSLaneChangerSublane::abortLCManeuver(), MSLaneChangerSublane::change(), MSLaneChanger::continueChange(), GUIVehicle::getColorValue(), MSLink::getLeaderInfo(), GUIVehicle::getParameterWindow(), MSLeaderInfo::getSubLanes(), MSFCDExport::write(), and MSXMLRawOut::writeVehicle().

Here is the caller graph for this function:

◆ getStrategicLookahead()

double MSAbstractLaneChangeModel::getStrategicLookahead ( ) const

inline

Definition at line 601 of file MSAbstractLaneChangeModel.h.

References myStrategicLookahead.

Referenced by MSVehicle::updateBestLanes().

Here is the caller graph for this function:

◆ getTargetLane()

MSLane * MSAbstractLaneChangeModel::getTargetLane ( ) const

inline

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

Returns: The vehicle's target lane.

Definition at line 432 of file MSAbstractLaneChangeModel.h.

References myTargetLane.

Referenced by MSVehicle::getBackPositionOnLane(), and MSVehicle::getLatOffset().

Here is the caller graph for this function:

◆ hasBlueLight()

bool MSAbstractLaneChangeModel::hasBlueLight ( ) const

inline

Definition at line 639 of file MSAbstractLaneChangeModel.h.

References myHaveBlueLight.

Referenced by MSLCM_LC2013::anticipateFollowSpeed(), MSVehicle::executeMove(), MSVehicle::isLeader(), MSVehicle::planMoveInternal(), MSLane::resetPartialOccupation(), and MSLCM_SL2015::updateExpectedSublaneSpeeds().

Here is the caller graph for this function:

◆ haveLCOutput()

static bool MSAbstractLaneChangeModel::haveLCOutput ( )

inlinestatic

whether lanechange-output is active

Definition at line 172 of file MSAbstractLaneChangeModel.h.

References myLCOutput.

Referenced by MSLaneChangerSublane::checkChangeToNewLane(), MSLaneChangerSublane::outputLCEnded(), and MSLaneChangerSublane::outputLCStarted().

Here is the caller graph for this function:

◆ inform()

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

pure virtual

Implemented in MSLCM_DK2008, MSLCM_LC2013, and MSLCM_SL2015.

Referenced by MSAbstractLaneChangeModel::MSLCMessager::informLeader(), MSAbstractLaneChangeModel::MSLCMessager::informNeighFollower(), and MSAbstractLaneChangeModel::MSLCMessager::informNeighLeader().

Here is the caller graph for this function:

◆ initGlobalOptions()

void MSAbstractLaneChangeModel::initGlobalOptions ( const OptionsCont & oc )

static

init global model parameters

Definition at line 72 of file MSAbstractLaneChangeModel.cpp.

References OptionsCont::getBool(), OptionsCont::isSet(), myAllowOvertakingRight, myLCEndedOutput, myLCOutput, myLCStartedOutput, and myLCXYOutput.

Referenced by MSFrame::setMSGlobals().

Here is the caller graph for this function:

◆ initLastLaneChangeOffset()

void MSAbstractLaneChangeModel::initLastLaneChangeOffset ( int dir )

protected

Definition at line 573 of file MSAbstractLaneChangeModel.cpp.

References myLastLaneChangeOffset.

Referenced by primaryLaneChanged().

Here is the caller graph for this function:

◆ isChangingLanes()

bool MSAbstractLaneChangeModel::isChangingLanes ( ) const

inline

return true if the vehicle currently performs a lane change maneuver

Definition at line 467 of file MSAbstractLaneChangeModel.h.

References myLaneChangeCompletion.

Referenced by MSLaneChanger::change(), MSLaneChangerSublane::change(), MSVehicle::computeAngle(), MSLCM_LC2013::computeSpeedLat(), MSLaneChanger::continueChange(), MSLane::detectCollisionBetween(), MSVehicle::enterLaneAtLaneChange(), MSVehicle::fixPosition(), MSVehicle::getBackPosition(), MSLane::getLeader(), MSVehicle::getPosition(), getShadowDirection(), getShadowLane(), GUIVehicle::getVisualAngle(), MSVehicle::planMoveInternal(), MSLCM_LC2013::prepareStep(), MSVehicle::processLaneAdvances(), remainingTime(), resetSpeedLat(), MSVehicle::setBlinkerInformation(), and updateShadowLane().

Here is the caller graph for this function:

◆ isOpposite()

bool MSAbstractLaneChangeModel::isOpposite ( ) const

inline

Definition at line 576 of file MSAbstractLaneChangeModel.h.

References myAmOpposite.

Referenced by MSLCM_LC2013::_wantsChange(), MSLCM_SL2015::_wantsChangeSublane(), MSVehicle::adaptToLeaders(), libsumo::Helper::applySubscriptionFilterLateralDistance(), MSLane::appropriate(), MSLaneChanger::avoidDeadlock(), MSLaneChanger::change(), MSLaneChangerSublane::change(), MSLaneChanger::changeOpposite(), MSLaneChanger::checkChange(), MSLaneChangerSublane::checkChangeHelper(), MSLaneChanger::checkChangeOpposite(), MSLaneChangerSublane::checkChangeOpposite(), MSLaneChangerSublane::checkChangeToNewLane(), MSLaneChanger::checkOppositeStop(), MSVehicle::checkRewindLinkLanes(), MSDevice_SSM::classifyEncounter(), MSTrainHelper::computeCarriages(), MSVehicle::computeFurtherLanes(), MSLaneChanger::computeSafeOppositeLength(), MSLaneChanger::computeSurplusGap(), MSLaneChanger::continueChange(), MSLane::detectCollisionBetween(), MSVehicle::enterLaneAtInsertion(), MSVehicle::enterLaneAtMove(), MSVehicle::executeMove(), MSDevice_SSM::findFoeConflictLane(), MSDevice_SSM::findSurroundingVehicles(), MSVehicle::getBackPositionOnLane(), MSLaneChanger::getBestLanesOpposite(), MSVehicle::getCenterOnEdge(), GUIVehicle::getColorValue(), MSLane::getFollowersOnConsecutive(), MSLane::getLeader(), MSLink::getLeaderInfo(), LIBSUMO_NAMESPACE::Vehicle::getNeighbors(), MSLCM_SL2015::getNeighRight(), MSLane::getOppositeFollower(), MSLane::getOppositeLeader(), MSVehicle::getPastLanesUntil(), MSVehicle::getPositionAlongBestLanes(), MSLCHelper::getRoundaboutDistBonus(), GUIBaseVehicle::getScaleValue(), MSVehicle::getUpcomingLanesUntil(), MSLCM_SL2015::getVehicleCenter(), MSLane::handleCollisionBetween(), MSVehicle::handleCollisionStop(), MSVehicle::hasArrivedInternal(), MSLCM_SL2015::informLeader(), MSLCM_LC2013::informLeader(), MSLCM_SL2015::keepLatGap(), MSVehicle::lateralDistanceToLane(), MSVehicle::planMoveInternal(), MSLCM_SL2015::prepareStep(), MSLeaderInfo::removeOpposite(), MSLCM_LC2013::saveBlockerLength(), MSLCM_SL2015::saveBlockerLength(), MSVehicle::setApproachingForAllLinks(), MSLaneChangerSublane::startChangeSublane(), MSVehicle::updateBestLanes(), and MSLCM_SL2015::updateExpectedSublaneSpeeds().

◆ isStrategicBlocked()

bool MSAbstractLaneChangeModel::isStrategicBlocked ( ) const

Returns: whether this vehicle is blocked from performing a strategic change

Definition at line 1068 of file MSAbstractLaneChangeModel.cpp.

References LCA_BLOCKED, LCA_LEFT, LCA_RIGHT, LCA_STRATEGIC, mySavedStateLeft, and mySavedStateRight.

Referenced by MSLink::getLeaderInfo().

Here is the caller graph for this function:

◆ laneChangeOutput()

void MSAbstractLaneChangeModel::laneChangeOutput	(	const std::string &	tag,
		MSLane *	source,
		MSLane *	target,
		int	direction,
		double	maneuverDist = `0`
	)

called once the vehicle ends a lane change manoeuvre (non-instant)

Definition at line 372 of file MSAbstractLaneChangeModel.cpp.

References clearGapsAtLCInit(), OutputDevice::closeTag(), DELTA_T, OutputDevice::getDeviceByOption(), MSVehicleType::getID(), Named::getID(), MSNet::getInstance(), MSBaseVehicle::getParameter(), Parameterised::getParameter(), MSVehicle::getPosition(), MSVehicle::getPositionOnLane(), MSVehicle::getSpeed(), MSBaseVehicle::getVehicleType(), MSGlobals::gLaneChangeDuration, MSGlobals::gLateralResolution, LCA_AMBACKBLOCKER, LCA_AMBACKBLOCKER_STANDING, LCA_AMBLOCKINGFOLLOWER, LCA_AMBLOCKINGLEADER, LCA_LEFT, LCA_MLEFT, LCA_MRIGHT, LCA_RIGHT, myLastFollowerGap, myLastFollowerSecureGap, myLastFollowerSpeed, myLastLateralGapLeft, myLastLateralGapRight, myLastLeaderGap, myLastLeaderSecureGap, myLastLeaderSpeed, myLastOrigLeaderGap, myLastOrigLeaderSecureGap, myLastOrigLeaderSpeed, myLCOutput, myLCXYOutput, myOwnState, myVehicle, NO_NEIGHBOR, OutputDevice::openTag(), SUMO_ATTR_DIR, SUMO_ATTR_FROM, SUMO_ATTR_ID, SUMO_ATTR_POSITION, SUMO_ATTR_SPEED, SUMO_ATTR_TIME, SUMO_ATTR_TO, SUMO_ATTR_TYPE, SUMO_ATTR_X, SUMO_ATTR_Y, time2string(), toString(), OutputDevice::writeAttr(), Position::x(), and Position::y().

Referenced by MSLaneChangerSublane::outputLCEnded(), MSLaneChangerSublane::outputLCStarted(), and primaryLaneChanged().

Here is the caller graph for this function:

◆ loadState()

void MSAbstractLaneChangeModel::loadState ( const SUMOSAXAttributes & attrs )

virtual

Loads the state of the laneChangeModel from the given attributes.

Parameters

[in] attrs XML attributes describing the current state

Definition at line 1123 of file MSAbstractLaneChangeModel.cpp.

References SUMOSAXAttributes::getString(), SUMOSAXAttributes::hasAttribute(), myLaneChangeCompletion, myLaneChangeDirection, mySpeedLat, and SUMO_ATTR_LCSTATE.

Referenced by MSVehicle::loadState().

Here is the caller graph for this function:

◆ memorizeGapsAtLCInit()

void MSAbstractLaneChangeModel::memorizeGapsAtLCInit ( )

Control for resetting the memorized values for LC relevant gaps until the LC output is triggered in the case of continuous LC.

Definition at line 324 of file MSAbstractLaneChangeModel.cpp.

References myDontResetLCGaps.

Referenced by startLaneChangeManeuver().

Here is the caller graph for this function:

◆ operator=()

MSAbstractLaneChangeModel & MSAbstractLaneChangeModel::operator= ( const MSAbstractLaneChangeModel & s )

private

Invalidated assignment operator.

◆ outputLCEnded()

static bool MSAbstractLaneChangeModel::outputLCEnded ( )

inlinestatic

whether start of maneuvers shall be recorede

Definition at line 182 of file MSAbstractLaneChangeModel.h.

References myLCEndedOutput.

Referenced by MSLaneChangerSublane::outputLCEnded().

Here is the caller graph for this function:

◆ outputLCStarted()

static bool MSAbstractLaneChangeModel::outputLCStarted ( )

inlinestatic

whether start of maneuvers shall be recorede

Definition at line 177 of file MSAbstractLaneChangeModel.h.

References myLCStartedOutput.

Referenced by MSLaneChangerSublane::outputLCStarted().

Here is the caller graph for this function:

◆ pastMidpoint()

bool MSAbstractLaneChangeModel::pastMidpoint ( ) const

inline

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

Definition at line 446 of file MSAbstractLaneChangeModel.h.

References myLaneChangeCompletion.

Referenced by getShadowDirection(), and updateCompletion().

Here is the caller graph for this function:

◆ patchSpeed()

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

pure virtual

Called to adapt the speed in order to allow a lane change. It uses information on LC-related desired speed-changes from the call to wantsChange() at the end of the previous simulation step.

It is guaranteed that min<=wanted<=max, but the implementation needs to make sure that the return value is between min and max.

Parameters

min	The minimum resulting speed
wanted	The aspired speed of the car following model
max	The maximum resulting speed
cfModel	The model used

Returns: the new speed of the vehicle as proposed by the lane changer

Implemented in MSLCM_DK2008, MSLCM_LC2013, and MSLCM_SL2015.

Referenced by MSCFModel::finalizeSpeed(), MSCFModel_Daniel1::finalizeSpeed(), and MSCFModel_EIDM::finalizeSpeed().

Here is the caller graph for this function:

◆ predInteraction()

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

protectedvirtual

Definition at line 293 of file MSAbstractLaneChangeModel.cpp.

References getCarFollowModel(), MSVehicle::getSpeed(), MSCFModel::interactionGap(), and myVehicle.

Referenced by MSLCM_DK2008::wantsChangeToLeft(), and MSLCM_DK2008::wantsChangeToRight().

Here is the caller graph for this function:

◆ prepareStep()

void MSAbstractLaneChangeModel::prepareStep ( )

virtual

Reimplemented in MSLCM_DK2008, MSLCM_LC2013, and MSLCM_SL2015.

Definition at line 983 of file MSAbstractLaneChangeModel.cpp.

References getCanceledState(), LCA_NONE, LCA_UNKNOWN, myCommittedSpeed, myDontResetLCGaps, myLastFollowerGap, myLastFollowerSecureGap, myLastFollowerSpeed, myLastLateralGapLeft, myLastLateralGapRight, myLastLeaderGap, myLastLeaderSecureGap, myLastLeaderSpeed, myLastOrigLeaderGap, myLastOrigLeaderSecureGap, myLastOrigLeaderSpeed, NO_NEIGHBOR, and saveLCState().

Referenced by MSVehicle::executeMove(), MSDevice_Bluelight::notifyMove(), MSLCM_DK2008::prepareStep(), MSLCM_LC2013::prepareStep(), and MSLCM_SL2015::prepareStep().

Here is the caller graph for this function:

◆ primaryLaneChanged()

void MSAbstractLaneChangeModel::primaryLaneChanged	(	MSLane *	source,
		MSLane *	target,
		int	direction
	)

called once when the vehicles primary lane changes

Definition at line 334 of file MSAbstractLaneChangeModel.cpp.

References changed(), changedToOpposite(), debugVehicle(), MSLane::enteredByLaneChange(), MSVehicle::enterLaneAtLaneChange(), MSLane::forceVehicleInsertion(), MSLane::getEdge(), Named::getID(), MSVehicle::getLateralPositionOnLane(), MSLane::getOppositePos(), MSVehicle::getPositionOnLane(), MSGlobals::gSublane, initLastLaneChangeOffset(), laneChangeOutput(), MSVehicle::leaveLane(), MSLane::leftByLaneChange(), myAlreadyChanged, myAmOpposite, myVehicle, MSMoveReminder::NOTIFICATION_LANE_CHANGE, MSVehicle::setTentativeLaneAndPosition(), SIMTIME, and MSVehicle::updateDriveItems().

Referenced by MSLaneChanger::continueChange(), and startLaneChangeManeuver().

Here is the caller graph for this function:

◆ remainingTime()

SUMOTime MSAbstractLaneChangeModel::remainingTime ( ) const

Compute the remaining time until LC completion.

Definition at line 868 of file MSAbstractLaneChangeModel.cpp.

References estimateLCDuration(), MSVehicle::getCarFollowModel(), SUMOVTypeParameter::getLCParams(), MSCFModel::getMaxDecel(), MSVehicleType::getMaxSpeedLat(), MSVehicleType::getParameter(), MSVehicle::getSpeed(), MSBaseVehicle::getVehicleType(), MSGlobals::gLaneChangeDuration, isChangingLanes(), LCA_URGENT, myLaneChangeCompletion, myManeuverDist, myOwnState, myVehicle, SUMO_ATTR_LCA_MAXSPEEDLATFACTOR, SUMO_ATTR_LCA_MAXSPEEDLATSTANDING, TIME2STEPS, VTYPEPARS_MAXSPEED_LAT_SET, and MSVehicleType::wasSet().

Referenced by MSVehicle::planMoveInternal().

Here is the caller graph for this function:

◆ removeShadowApproachingInformation()

void MSAbstractLaneChangeModel::removeShadowApproachingInformation ( ) const

Definition at line 893 of file MSAbstractLaneChangeModel.cpp.

References myApproachedByShadow, and myVehicle.

Referenced by MSVehicle::removeApproachingInformation().

Here is the caller graph for this function:

◆ resetChanged()

void MSAbstractLaneChangeModel::resetChanged ( )

inline

reset the flag whether a vehicle already moved to false

Definition at line 508 of file MSAbstractLaneChangeModel.h.

References myAlreadyChanged.

Referenced by MSVehicle::planMove().

Here is the caller graph for this function:

◆ resetSpeedLat()

void MSAbstractLaneChangeModel::resetSpeedLat ( )

virtual

Definition at line 441 of file MSAbstractLaneChangeModel.cpp.

References MSGlobals::gLaneChangeDuration, isChangingLanes(), and setSpeedLat().

Referenced by MSVehicle::executeMove(), MSLCM_DK2008::prepareStep(), and MSLCM_LC2013::prepareStep().

Here is the caller graph for this function:

◆ resetState()

virtual void MSAbstractLaneChangeModel::resetState ( )

inlinevirtual

Reimplemented in MSLCM_LC2013, and MSLCM_SL2015.

Definition at line 380 of file MSAbstractLaneChangeModel.h.

Referenced by MSVehicle::enterLaneAtInsertion().

Here is the caller graph for this function:

◆ saveBlockerLength()

virtual bool MSAbstractLaneChangeModel::saveBlockerLength	(	double	,
		double
	)

inlinevirtual

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

Reimplemented in MSLCM_LC2013, and MSLCM_SL2015.

Definition at line 548 of file MSAbstractLaneChangeModel.h.

Referenced by MSLaneChanger::avoidDeadlock(), MSLaneChanger::resolveDeadlock(), and MSLCHelper::updateBlockerLength().

Here is the caller graph for this function:

◆ saveLCState()

void MSAbstractLaneChangeModel::saveLCState	(	const int	dir,
		int	stateWithoutTraCI,
		const int	state
	)

inline

Definition at line 225 of file MSAbstractLaneChangeModel.h.

References getCanceledState(), LCA_WANTS_LANECHANGE_OR_STAY, mySavedStateCenter, mySavedStateLeft, and mySavedStateRight.

Referenced by MSLaneChanger::checkChange(), MSLaneChangerSublane::checkChangeOpposite(), MSLaneChangerSublane::checkChangeSublane(), MSAbstractLaneChangeModel(), and prepareStep().

Here is the caller graph for this function:

◆ saveNeighbors() [1/2]

void MSAbstractLaneChangeModel::saveNeighbors	(	const int	dir,
		const MSLeaderDistanceInfo &	followers,
		const MSLeaderDistanceInfo &	leaders
	)

Saves the lane change relevant vehicles, which are currently on neighboring lanes in the given direction (as detected in wantsChangeSublane()). -> SL2015 case.

Definition at line 200 of file MSAbstractLaneChangeModel.cpp.

References myLeftFollowers, myLeftLeaders, myRightFollowers, and myRightLeaders.

Referenced by MSLaneChanger::checkChange(), MSLaneChangerSublane::checkChangeOpposite(), and MSLaneChangerSublane::checkChangeSublane().

Here is the caller graph for this function:

◆ saveNeighbors() [2/2]

void MSAbstractLaneChangeModel::saveNeighbors	(	const int	dir,
		const std::pair< MSVehicle *const, double > &	follower,
		const std::pair< MSVehicle *const, double > &	leader
	)

Saves the lane change relevant vehicles, which are currently on neighboring lanes in the given direction (as detected in wantsChange()). -> LC2013 case.

Definition at line 215 of file MSAbstractLaneChangeModel.cpp.

References MSVehicle::getLane(), MSLane::getWidth(), myLeftFollowers, myLeftLeaders, myRightFollowers, myRightLeaders, and myVehicle.

◆ saveState()

void MSAbstractLaneChangeModel::saveState ( OutputDevice & out ) const

virtual

Save the state of the laneChangeModel.

Parameters

[in] out The OutputDevice to write the information into

Definition at line 1110 of file MSAbstractLaneChangeModel.cpp.

References MSGlobals::gLaneChangeDuration, myLaneChangeCompletion, myLaneChangeDirection, mySpeedLat, SUMO_ATTR_LCSTATE, toString(), and OutputDevice::writeAttr().

Referenced by MSVehicle::saveState().

Here is the caller graph for this function:

◆ setAngleOffset()

void MSAbstractLaneChangeModel::setAngleOffset ( const double angleOffset )

inline

set the angle offset resulting from lane change and sigma

Definition at line 493 of file MSAbstractLaneChangeModel.h.

References myAngleOffset.

◆ setFollowerGaps() [1/2]

void MSAbstractLaneChangeModel::setFollowerGaps	(	CLeaderDist	follower,
		double	secGap
	)

Definition at line 956 of file MSAbstractLaneChangeModel.cpp.

References myLastFollowerGap, myLastFollowerSecureGap, and myLastFollowerSpeed.

Referenced by MSLaneChanger::checkChange(), MSLaneChangerSublane::checkChangeToNewLane(), MSLaneChangerSublane::outputLCEnded(), and MSLaneChangerSublane::outputLCStarted().

Here is the caller graph for this function:

◆ setFollowerGaps() [2/2]

void MSAbstractLaneChangeModel::setFollowerGaps ( const MSLeaderDistanceInfo & vehicles )

Definition at line 1007 of file MSAbstractLaneChangeModel.cpp.

References MSVehicle::getCarFollowModel(), MSCFModel::getMaxDecel(), MSVehicleType::getMinGap(), MSCFModel::getSecureGap(), MSVehicle::getSpeed(), MSLeaderInfo::getSubLanes(), MSBaseVehicle::getVehicleType(), myLastFollowerGap, myLastFollowerSecureGap, myLastFollowerSpeed, and myVehicle.

◆ setLeaderGaps() [1/2]

void MSAbstractLaneChangeModel::setLeaderGaps	(	CLeaderDist	leader,
		double	secGap
	)

Definition at line 965 of file MSAbstractLaneChangeModel.cpp.

References MSVehicleType::getMinGap(), MSBaseVehicle::getVehicleType(), myLastLeaderGap, myLastLeaderSecureGap, myLastLeaderSpeed, and myVehicle.

Referenced by MSLaneChanger::checkChange(), MSLaneChangerSublane::checkChangeToNewLane(), MSLaneChangerSublane::outputLCEnded(), and MSLaneChangerSublane::outputLCStarted().

Here is the caller graph for this function:

◆ setLeaderGaps() [2/2]

void MSAbstractLaneChangeModel::setLeaderGaps ( const MSLeaderDistanceInfo & vehicles )

Definition at line 1027 of file MSAbstractLaneChangeModel.cpp.

References MSVehicle::getCarFollowModel(), MSCFModel::getMaxDecel(), MSVehicleType::getMinGap(), MSCFModel::getSecureGap(), MSVehicle::getSpeed(), MSLeaderInfo::getSubLanes(), MSBaseVehicle::getVehicleType(), myLastLeaderGap, myLastLeaderSecureGap, myLastLeaderSpeed, and myVehicle.

◆ setManeuverDist()

void MSAbstractLaneChangeModel::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)

Definition at line 174 of file MSAbstractLaneChangeModel.cpp.

References DEBUG_COND, Named::getID(), myManeuverDist, myPreviousManeuverDist, myVehicle, and SIMTIME.

Referenced by MSLaneChangerSublane::abortLCManeuver(), checkTraCICommands(), MSLaneChangerSublane::startChangeSublane(), and startLaneChangeManeuver().

Here is the caller graph for this function:

◆ setNoShadowPartialOccupator()

void MSAbstractLaneChangeModel::setNoShadowPartialOccupator ( MSLane * lane )

inline

Definition at line 556 of file MSAbstractLaneChangeModel.h.

References myNoPartiallyOccupatedByShadow.

Referenced by MSVehicle::enterLaneAtLaneChange().

Here is the caller graph for this function:

◆ setOrigLeaderGaps() [1/2]

void MSAbstractLaneChangeModel::setOrigLeaderGaps	(	CLeaderDist	leader,
		double	secGap
	)

Definition at line 974 of file MSAbstractLaneChangeModel.cpp.

References MSVehicleType::getMinGap(), MSBaseVehicle::getVehicleType(), myLastOrigLeaderGap, myLastOrigLeaderSecureGap, myLastOrigLeaderSpeed, and myVehicle.

Referenced by MSLaneChanger::checkChange(), MSLaneChangerSublane::checkChangeToNewLane(), MSLaneChangerSublane::outputLCEnded(), and MSLaneChangerSublane::outputLCStarted().

Here is the caller graph for this function:

◆ setOrigLeaderGaps() [2/2]

void MSAbstractLaneChangeModel::setOrigLeaderGaps ( const MSLeaderDistanceInfo & vehicles )

Definition at line 1047 of file MSAbstractLaneChangeModel.cpp.

References MSVehicle::getCarFollowModel(), MSCFModel::getMaxDecel(), MSVehicleType::getMinGap(), MSCFModel::getSecureGap(), MSVehicle::getSpeed(), MSLeaderInfo::getSubLanes(), MSBaseVehicle::getVehicleType(), myLastOrigLeaderGap, myLastOrigLeaderSecureGap, myLastOrigLeaderSpeed, and myVehicle.

◆ setOwnState()

void MSAbstractLaneChangeModel::setOwnState ( const int state )

virtual

Reimplemented in MSLCM_SL2015.

Definition at line 161 of file MSAbstractLaneChangeModel.cpp.

References myOwnState, myPreviousState, and myPreviousState2.

Referenced by MSLaneChanger::change(), MSLaneChangerSublane::change(), MSLaneChanger::checkChangeOpposite(), MSLaneChangerSublane::checkChangeOpposite(), checkTraCICommands(), and MSLCM_SL2015::setOwnState().

Here is the caller graph for this function:

◆ setParameter()

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

inlinevirtual

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

Reimplemented in MSLCM_LC2013, and MSLCM_SL2015.

Definition at line 622 of file MSAbstractLaneChangeModel.h.

References myModel, toString(), and UNUSED_PARAMETER.

Referenced by MSDevice_Bluelight::notifyMove(), and MSDevice_Bluelight::resetVehicle().

Here is the caller graph for this function:

◆ setPreviousAngleOffset()

void MSAbstractLaneChangeModel::setPreviousAngleOffset ( const double angleOffset )

inline

set the angle offset of the previous time step

Definition at line 498 of file MSAbstractLaneChangeModel.h.

References myPreviousAngleOffset.

Referenced by MSVehicle::executeMove().

Here is the caller graph for this function:

◆ setShadowApproachingInformation()

void MSAbstractLaneChangeModel::setShadowApproachingInformation ( MSLink * link ) const

set approach information for the shadow vehicle

Definition at line 887 of file MSAbstractLaneChangeModel.cpp.

References myApproachedByShadow.

Referenced by MSVehicle::setApproachingForAllLinks().

Here is the caller graph for this function:

◆ setShadowPartialOccupator()

void MSAbstractLaneChangeModel::setShadowPartialOccupator ( MSLane * lane )

inline

Definition at line 552 of file MSAbstractLaneChangeModel.h.

References myPartiallyOccupatedByShadow.

◆ setSpeedLat()

void MSAbstractLaneChangeModel::setSpeedLat ( double speedLat )

set the lateral speed and update lateral acceleraton

Definition at line 434 of file MSAbstractLaneChangeModel.cpp.

References myAccelerationLat, mySpeedLat, and SPEED2ACCEL.

Referenced by MSLaneChangerSublane::abortLCManeuver(), MSLaneChangerSublane::checkChangeOpposite(), MSLCM_LC2013::prepareStep(), resetSpeedLat(), MSLaneChangerSublane::startChangeSublane(), and updateCompletion().

Here is the caller graph for this function:

◆ startLaneChangeManeuver()

bool MSAbstractLaneChangeModel::startLaneChangeManeuver	(	MSLane *	source,
		MSLane *	target,
		int	direction
	)

start the lane change maneuver and return whether it continues

Definition at line 306 of file MSAbstractLaneChangeModel.cpp.

References DELTA_T, MSLane::getWidth(), MSGlobals::gLaneChangeDuration, MSGlobals::gLefthand, memorizeGapsAtLCInit(), myLaneChangeCompletion, myLaneChangeDirection, myLCOutput, myVehicle, primaryLaneChanged(), setManeuverDist(), MSVehicle::switchOffSignal(), MSVehicle::switchOnSignal(), MSVehicle::VEH_SIGNAL_BLINKER_LEFT, and MSVehicle::VEH_SIGNAL_BLINKER_RIGHT.

Referenced by MSLaneChanger::applyTraCICommands(), MSLaneChanger::checkChangeOpposite(), MSLaneChangerSublane::checkChangeToNewLane(), and MSLaneChanger::startChange().

Here is the caller graph for this function:

◆ sublaneChangeCompleted()

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

inlinevirtual

whether the current change completes the manoeuvre

Definition at line 567 of file MSAbstractLaneChangeModel.h.

References myModel, toString(), and UNUSED_PARAMETER.

◆ unchanged()

void MSAbstractLaneChangeModel::unchanged ( )

inline

Definition at line 400 of file MSAbstractLaneChangeModel.h.

References DELTA_T, and myLastLaneChangeOffset.

Referenced by MSLaneChanger::registerUnchanged().

Here is the caller graph for this function:

◆ updateCompletion()

bool MSAbstractLaneChangeModel::updateCompletion ( )

Definition at line 449 of file MSAbstractLaneChangeModel.cpp.

References computeSpeedLat(), getManeuverDist(), LCA_URGENT, myLaneChangeCompletion, myManeuverDist, myOwnState, mySpeedLat, pastMidpoint(), setSpeedLat(), and SPEED2DIST.

Referenced by MSLaneChanger::continueChange().

Here is the caller graph for this function:

◆ updateExpectedSublaneSpeeds()

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

inlinevirtual

update expected speeds for each sublane of the current edge

Reimplemented in MSLCM_SL2015.

Definition at line 342 of file MSAbstractLaneChangeModel.h.

References myModel, toString(), and UNUSED_PARAMETER.

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

Here is the caller graph for this function:

◆ updateSafeLatDist()

void MSAbstractLaneChangeModel::updateSafeLatDist ( const double travelledLatDist )

virtual

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

Reimplemented in MSLCM_SL2015.

Definition at line 168 of file MSAbstractLaneChangeModel.cpp.

References UNUSED_PARAMETER.

Referenced by MSLaneChangerSublane::startChangeSublane().

Here is the caller graph for this function:

◆ updateShadowLane()

void MSAbstractLaneChangeModel::updateShadowLane ( )

Definition at line 582 of file MSAbstractLaneChangeModel.cpp.

References debugVehicle(), endLaneChangeManeuver(), MSVehicle::getFurtherLanes(), MSVehicle::getFurtherLanesPosLat(), Named::getID(), Named::getIDSecure(), MSNet::getInstance(), MSVehicle::getLane(), MSVehicle::getLateralOverlap(), MSLane::getLinkTo(), getShadowLane(), MSGlobals::gSublane, isChangingLanes(), myAmOpposite, myShadowFurtherLanes, myShadowFurtherLanesPosLat, myShadowLane, myVehicle, MSLane::resetPartialOccupation(), MSLane::setPartialOccupation(), SIMTIME, time2string(), toString(), MSVehicle::updateFurtherLanes(), and WRITE_WARNING.

Referenced by MSLaneChanger::continueChange(), MSVehicle::enterLaneAtInsertion(), MSVehicle::executeMove(), and MSLaneChangerSublane::startChangeSublane().

Here is the caller graph for this function:

◆ updateTargetLane()

MSLane * MSAbstractLaneChangeModel::updateTargetLane ( )

Definition at line 665 of file MSAbstractLaneChangeModel.cpp.

References debugVehicle(), determineTargetLane(), MSVehicle::getFurtherLanes(), Named::getID(), MSVehicle::getLane(), MSLane::getParallelLane(), myFurtherTargetLanes, myManeuverDist, myTargetLane, myVehicle, MSLane::resetManeuverReservation(), MSLane::setManeuverReservation(), SIMTIME, and toString().

Referenced by MSLaneChangerSublane::abortLCManeuver(), MSVehicle::enterLaneAtInsertion(), MSVehicle::executeMove(), and MSLaneChangerSublane::startChangeSublane().

Here is the caller graph for this function:

◆ wantsChange()

virtual int MSAbstractLaneChangeModel::wantsChange	(	int	laneOffset,
		MSAbstractLaneChangeModel::MSLCMessager &	msgPass,
		int	blocked,
		const std::pair< MSVehicle *, double > &	leader,
		const std::pair< MSVehicle *, double > &	follower,
		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
	)

inlinevirtual

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 in MSLCM_DK2008, MSLCM_LC2013, and MSLCM_SL2015.

Definition at line 284 of file MSAbstractLaneChangeModel.h.

References myModel, toString(), and UNUSED_PARAMETER.

Referenced by MSLaneChanger::checkChange().

Here is the caller graph for this function:

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

inlinevirtual

Reimplemented in MSLCM_SL2015.

Definition at line 309 of file MSAbstractLaneChangeModel.h.

References myModel, toString(), and UNUSED_PARAMETER.

Referenced by MSLaneChangerSublane::checkChangeOpposite(), and MSLaneChangerSublane::checkChangeSublane().

Here is the caller graph for this function:

Field Documentation

◆ myAccelerationLat

double MSAbstractLaneChangeModel::myAccelerationLat

protected

the current lateral acceleration

Definition at line 702 of file MSAbstractLaneChangeModel.h.

Referenced by getAccelerationLat(), and setSpeedLat().

◆ myAllowOvertakingRight

bool MSAbstractLaneChangeModel::myAllowOvertakingRight

staticprotected

whether overtaking on the right is permitted

Definition at line 809 of file MSAbstractLaneChangeModel.h.

Referenced by avoidOvertakeRight(), MSLCM_SL2015::informFollower(), MSLCM_LC2013::informFollower(), MSLCM_SL2015::informLeader(), MSLCM_LC2013::informLeader(), and initGlobalOptions().

◆ myAlreadyChanged

bool MSAbstractLaneChangeModel::myAlreadyChanged

protected

whether the vehicle has already moved this step

Definition at line 720 of file MSAbstractLaneChangeModel.h.

Referenced by alreadyChanged(), changedToOpposite(), primaryLaneChanged(), and resetChanged().

◆ myAmOpposite

bool MSAbstractLaneChangeModel::myAmOpposite

private

whether the vehicle is driving in the opposite direction

Definition at line 828 of file MSAbstractLaneChangeModel.h.

Referenced by changedToOpposite(), endLaneChangeManeuver(), getForwardPos(), getNormalizedLaneIndex(), getShadowDirection(), getShadowLane(), isOpposite(), primaryLaneChanged(), and updateShadowLane().

◆ myAngleOffset

double MSAbstractLaneChangeModel::myAngleOffset

protected

the current angle offset resulting from lane change and sigma

Definition at line 705 of file MSAbstractLaneChangeModel.h.

Referenced by calcAngleOffset(), getAngleOffset(), and setAngleOffset().

◆ myApproachedByShadow

std::vector<MSLink*> MSAbstractLaneChangeModel::myApproachedByShadow

mutableprivate

links which are approached by the shadow vehicle

Definition at line 825 of file MSAbstractLaneChangeModel.h.

Referenced by removeShadowApproachingInformation(), and setShadowApproachingInformation().

◆ myCanceledStateCenter

int MSAbstractLaneChangeModel::myCanceledStateCenter

protected

Definition at line 687 of file MSAbstractLaneChangeModel.h.

Referenced by getCanceledState().

◆ myCanceledStateLeft

int MSAbstractLaneChangeModel::myCanceledStateLeft

protected

Definition at line 688 of file MSAbstractLaneChangeModel.h.

Referenced by getCanceledState().

◆ myCanceledStateRight

int MSAbstractLaneChangeModel::myCanceledStateRight

protected

Definition at line 686 of file MSAbstractLaneChangeModel.h.

Referenced by getCanceledState().

◆ myCommittedSpeed

double MSAbstractLaneChangeModel::myCommittedSpeed

protected

the speed when committing to a change maneuver

Definition at line 711 of file MSAbstractLaneChangeModel.h.

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

◆ myDontResetLCGaps

bool MSAbstractLaneChangeModel::myDontResetLCGaps

protected

Flag to prevent resetting the memorized values for LC relevant gaps until the LC output is triggered in the case of continuous LC.

Definition at line 782 of file MSAbstractLaneChangeModel.h.

Referenced by clearGapsAtLCInit(), memorizeGapsAtLCInit(), and prepareStep().

◆ myFurtherTargetLanes

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

protected

Definition at line 745 of file MSAbstractLaneChangeModel.h.

Referenced by cleanupTargetLane(), getFurtherTargetLanes(), and updateTargetLane().

◆ myHaveBlueLight

bool MSAbstractLaneChangeModel::myHaveBlueLight

protected

whether this vehicle is driving with special permissions and behavior

Definition at line 797 of file MSAbstractLaneChangeModel.h.

Referenced by hasBlueLight().

◆ myLaneChangeCompletion

double MSAbstractLaneChangeModel::myLaneChangeCompletion

protected

progress of the lane change maneuver 0:started, 1:complete

Definition at line 714 of file MSAbstractLaneChangeModel.h.

Referenced by endLaneChangeManeuver(), getLaneChangeCompletion(), getShadowLane(), isChangingLanes(), loadState(), pastMidpoint(), remainingTime(), saveState(), startLaneChangeManeuver(), and updateCompletion().

◆ myLaneChangeDirection

int MSAbstractLaneChangeModel::myLaneChangeDirection

protected

direction of the lane change maneuver -1 means right, 1 means left

Definition at line 717 of file MSAbstractLaneChangeModel.h.

Referenced by getLaneChangeDirection(), getShadowDirection(), getShadowLane(), loadState(), saveState(), and startLaneChangeManeuver().

◆ myLastFollowerGap

double MSAbstractLaneChangeModel::myLastFollowerGap

protected

Definition at line 768 of file MSAbstractLaneChangeModel.h.

Referenced by laneChangeOutput(), prepareStep(), setFollowerGaps(), and setFollowerGaps().

◆ myLastFollowerSecureGap

double MSAbstractLaneChangeModel::myLastFollowerSecureGap

protected

Definition at line 771 of file MSAbstractLaneChangeModel.h.

Referenced by laneChangeOutput(), prepareStep(), setFollowerGaps(), and setFollowerGaps().

◆ myLastFollowerSpeed

double MSAbstractLaneChangeModel::myLastFollowerSpeed

protected

Definition at line 777 of file MSAbstractLaneChangeModel.h.

Referenced by laneChangeOutput(), prepareStep(), setFollowerGaps(), and setFollowerGaps().

◆ myLastLaneChangeOffset

SUMOTime MSAbstractLaneChangeModel::myLastLaneChangeOffset

private

Definition at line 822 of file MSAbstractLaneChangeModel.h.

Referenced by getLastLaneChangeOffset(), initLastLaneChangeOffset(), and unchanged().

◆ myLastLateralGapLeft

double MSAbstractLaneChangeModel::myLastLateralGapLeft

protected

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

Definition at line 763 of file MSAbstractLaneChangeModel.h.

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

◆ myLastLateralGapRight

double MSAbstractLaneChangeModel::myLastLateralGapRight

protected

Definition at line 764 of file MSAbstractLaneChangeModel.h.

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

◆ myLastLeaderGap

double MSAbstractLaneChangeModel::myLastLeaderGap

protected

the actual minimum longitudinal distances to vehicles on the target lane

Definition at line 767 of file MSAbstractLaneChangeModel.h.

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

◆ myLastLeaderSecureGap

double MSAbstractLaneChangeModel::myLastLeaderSecureGap

protected

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

Definition at line 770 of file MSAbstractLaneChangeModel.h.

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

◆ myLastLeaderSpeed

double MSAbstractLaneChangeModel::myLastLeaderSpeed

protected

speeds of surrounding vehicles at the time of lane change

Definition at line 776 of file MSAbstractLaneChangeModel.h.

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

◆ myLastOrigLeaderGap

double MSAbstractLaneChangeModel::myLastOrigLeaderGap

protected

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

Definition at line 773 of file MSAbstractLaneChangeModel.h.

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

◆ myLastOrigLeaderSecureGap

double MSAbstractLaneChangeModel::myLastOrigLeaderSecureGap

protected

Definition at line 774 of file MSAbstractLaneChangeModel.h.

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

◆ myLastOrigLeaderSpeed

double MSAbstractLaneChangeModel::myLastOrigLeaderSpeed

protected

Definition at line 778 of file MSAbstractLaneChangeModel.h.

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

◆ myLCAccelerationAdvices

std::vector<std::pair<double, bool> > MSAbstractLaneChangeModel::myLCAccelerationAdvices

protected

Definition at line 806 of file MSAbstractLaneChangeModel.h.

Referenced by MSLCM_LC2013::_patchSpeed(), MSLCM_SL2015::_patchSpeed(), MSLCM_LC2013::_wantsChange(), addLCSpeedAdvice(), MSLCM_LC2013::changed(), MSLCM_SL2015::changed(), MSLCM_SL2015::checkStrategicChange(), MSLCM_SL2015::informFollower(), MSLCM_LC2013::informFollower(), MSLCM_SL2015::informLeader(), MSLCM_LC2013::informLeader(), MSLCM_LC2013::prepareStep(), MSLCM_SL2015::prepareStep(), MSLCM_LC2013::resetState(), MSLCM_SL2015::resetState(), and MSLCM_LC2013::slowDownForBlocked().

◆ myLCEndedOutput

bool MSAbstractLaneChangeModel::myLCEndedOutput

staticprotected

Definition at line 814 of file MSAbstractLaneChangeModel.h.

Referenced by initGlobalOptions(), and outputLCEnded().

◆ myLCOutput

bool MSAbstractLaneChangeModel::myLCOutput

staticprotected

whether to record lane-changing

Definition at line 812 of file MSAbstractLaneChangeModel.h.

Referenced by haveLCOutput(), initGlobalOptions(), laneChangeOutput(), and startLaneChangeManeuver().

◆ myLCStartedOutput

bool MSAbstractLaneChangeModel::myLCStartedOutput

staticprotected

Definition at line 813 of file MSAbstractLaneChangeModel.h.

Referenced by initGlobalOptions(), and outputLCStarted().

◆ myLCXYOutput

bool MSAbstractLaneChangeModel::myLCXYOutput

staticprotected

Definition at line 815 of file MSAbstractLaneChangeModel.h.

Referenced by initGlobalOptions(), and laneChangeOutput().

◆ myLeftFollowers

std::shared_ptr<MSLeaderDistanceInfo> MSAbstractLaneChangeModel::myLeftFollowers

protected

Cached info on lc-relevant neighboring vehicles.

Definition at line 692 of file MSAbstractLaneChangeModel.h.

Referenced by clearNeighbors(), getFollowers(), saveNeighbors(), and saveNeighbors().

◆ myLeftLeaders

std::shared_ptr<MSLeaderDistanceInfo> MSAbstractLaneChangeModel::myLeftLeaders

protected

Definition at line 693 of file MSAbstractLaneChangeModel.h.

Referenced by clearNeighbors(), getLeaders(), saveNeighbors(), and saveNeighbors().

◆ myManeuverDist

double MSAbstractLaneChangeModel::myManeuverDist

private

The complete lateral distance the vehicle wants to travel to finish its maneuver Only used by sublane model, currently.

Definition at line 832 of file MSAbstractLaneChangeModel.h.

Referenced by determineTargetLane(), getManeuverDist(), remainingTime(), setManeuverDist(), updateCompletion(), and updateTargetLane().

◆ myMaxDistLatStanding

double MSAbstractLaneChangeModel::myMaxDistLatStanding

protected

Definition at line 790 of file MSAbstractLaneChangeModel.h.

Referenced by MSLCM_LC2013::getParameter(), MSLCM_SL2015::getParameter(), MSLCM_SL2015::preventSliding(), MSLCM_LC2013::setParameter(), and MSLCM_SL2015::setParameter().

◆ myMaxSpeedLatFactor

double MSAbstractLaneChangeModel::myMaxSpeedLatFactor

protected

Definition at line 788 of file MSAbstractLaneChangeModel.h.

Referenced by MSLCM_LC2013::computeSpeedLat(), MSLCM_SL2015::computeSpeedLat(), estimateLCDuration(), MSLCM_LC2013::getParameter(), MSLCM_SL2015::getParameter(), MSLCM_SL2015::preventSliding(), MSLCM_LC2013::setParameter(), and MSLCM_SL2015::setParameter().

◆ myMaxSpeedLatStanding

double MSAbstractLaneChangeModel::myMaxSpeedLatStanding

protected

Definition at line 786 of file MSAbstractLaneChangeModel.h.

Referenced by MSLCM_LC2013::computeSpeedLat(), MSLCM_SL2015::computeSpeedLat(), estimateLCDuration(), getMaxSpeedLat2(), MSLCM_LC2013::getParameter(), MSLCM_SL2015::getParameter(), MSLCM_LC2013::setParameter(), and MSLCM_SL2015::setParameter().

◆ myModel

const LaneChangeModel MSAbstractLaneChangeModel::myModel

protected

the type of this model

Definition at line 753 of file MSAbstractLaneChangeModel.h.

Referenced by decideDirection(), getParameter(), MSLCM_LC2013::getParameter(), MSLCM_SL2015::getParameter(), setParameter(), MSLCM_LC2013::setParameter(), MSLCM_SL2015::setParameter(), sublaneChangeCompleted(), updateExpectedSublaneSpeeds(), wantsChange(), and wantsChangeSublane().

◆ myNoPartiallyOccupatedByShadow

std::vector<MSLane*> MSAbstractLaneChangeModel::myNoPartiallyOccupatedByShadow

protected

Definition at line 760 of file MSAbstractLaneChangeModel.h.

Referenced by cleanupShadowLane(), endLaneChangeManeuver(), getShadowLane(), and setNoShadowPartialOccupator().

◆ myOvertakeRightParam

double MSAbstractLaneChangeModel::myOvertakeRightParam

protected

Definition at line 794 of file MSAbstractLaneChangeModel.h.

Referenced by avoidOvertakeRight(), MSLCM_LC2013::getParameter(), and MSLCM_LC2013::setParameter().

◆ myOwnState

int MSAbstractLaneChangeModel::myOwnState

protected

The current state of the vehicle.

Definition at line 677 of file MSAbstractLaneChangeModel.h.

Referenced by MSLCM_LC2013::_patchSpeed(), MSLCM_SL2015::_patchSpeed(), MSLCM_LC2013::_wantsChange(), MSLCM_SL2015::_wantsChangeSublane(), MSLCM_DK2008::amBlockingFollower(), MSLCM_LC2013::amBlockingFollower(), MSLCM_SL2015::amBlockingFollower(), MSLCM_DK2008::amBlockingFollowerNB(), MSLCM_LC2013::amBlockingFollowerNB(), MSLCM_SL2015::amBlockingFollowerNB(), MSLCM_DK2008::amBlockingFollowerPlusNB(), MSLCM_LC2013::amBlockingFollowerPlusNB(), MSLCM_SL2015::amBlockingFollowerPlusNB(), MSLCM_DK2008::amBlockingLeader(), MSLCM_LC2013::amBlockingLeader(), MSLCM_SL2015::amBlockingLeader(), MSLCM_DK2008::changed(), MSLCM_LC2013::changed(), MSLCM_SL2015::changed(), checkTraCICommands(), getOwnState(), MSLCM_DK2008::inform(), MSLCM_LC2013::inform(), MSLCM_SL2015::inform(), laneChangeOutput(), MSLCM_DK2008::patchSpeed(), MSLCM_DK2008::prepareStep(), MSLCM_LC2013::prepareStep(), MSLCM_SL2015::prepareStep(), remainingTime(), MSLCM_LC2013::resetState(), MSLCM_SL2015::resetState(), setOwnState(), updateCompletion(), MSLCM_DK2008::wantsChangeToLeft(), and MSLCM_DK2008::wantsChangeToRight().

◆ myPartiallyOccupatedByShadow

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

protected

list of lanes where the shadow vehicle is partial occupator

Definition at line 756 of file MSAbstractLaneChangeModel.h.

Referenced by setShadowPartialOccupator().

◆ myPreviousAngleOffset

double MSAbstractLaneChangeModel::myPreviousAngleOffset

protected

the angle offset of the previous time step resulting from lane change and sigma

Definition at line 708 of file MSAbstractLaneChangeModel.h.

Referenced by calcAngleOffset(), and setPreviousAngleOffset().

◆ myPreviousManeuverDist

double MSAbstractLaneChangeModel::myPreviousManeuverDist

private

Maneuver distance from the previous simulation step.

Definition at line 835 of file MSAbstractLaneChangeModel.h.

Referenced by getPreviousManeuverDist(), and setManeuverDist().

◆ myPreviousState

int MSAbstractLaneChangeModel::myPreviousState

protected

lane changing state from the previous simulation step

Definition at line 679 of file MSAbstractLaneChangeModel.h.

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

◆ myPreviousState2

int MSAbstractLaneChangeModel::myPreviousState2

protected

lane changing state from step before the previous simulation step

Definition at line 681 of file MSAbstractLaneChangeModel.h.

Referenced by getPrevState(), and setOwnState().

◆ myRightFollowers

std::shared_ptr<MSLeaderDistanceInfo> MSAbstractLaneChangeModel::myRightFollowers

protected

Definition at line 694 of file MSAbstractLaneChangeModel.h.

Referenced by clearNeighbors(), getFollowers(), saveNeighbors(), and saveNeighbors().

◆ myRightLeaders

std::shared_ptr<MSLeaderDistanceInfo> MSAbstractLaneChangeModel::myRightLeaders

protected

Definition at line 695 of file MSAbstractLaneChangeModel.h.

Referenced by clearNeighbors(), getLeaders(), saveNeighbors(), and saveNeighbors().

◆ mySavedStateCenter

std::pair<int, int> MSAbstractLaneChangeModel::mySavedStateCenter

protected

Definition at line 684 of file MSAbstractLaneChangeModel.h.

Referenced by getSavedState(), and saveLCState().

◆ mySavedStateLeft

std::pair<int, int> MSAbstractLaneChangeModel::mySavedStateLeft

protected

Definition at line 685 of file MSAbstractLaneChangeModel.h.

Referenced by getSavedState(), isStrategicBlocked(), and saveLCState().

◆ mySavedStateRight

std::pair<int, int> MSAbstractLaneChangeModel::mySavedStateRight

protected

Definition at line 683 of file MSAbstractLaneChangeModel.h.

Referenced by getSavedState(), isStrategicBlocked(), and saveLCState().

◆ myShadowFurtherLanes

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

protected

Definition at line 726 of file MSAbstractLaneChangeModel.h.

Referenced by cleanupShadowLane(), getShadowFurtherLanes(), and updateShadowLane().

◆ myShadowFurtherLanesPosLat

std::vector<double> MSAbstractLaneChangeModel::myShadowFurtherLanesPosLat

protected

Definition at line 727 of file MSAbstractLaneChangeModel.h.

Referenced by getShadowFurtherLanesPosLat(), and updateShadowLane().

◆ myShadowLane

MSLane* MSAbstractLaneChangeModel::myShadowLane

protected

A lane that is partially occupied by the front of the vehicle but that is not the primary lane.

Definition at line 723 of file MSAbstractLaneChangeModel.h.

Referenced by cleanupShadowLane(), determineTargetLane(), getShadowDirection(), getShadowLane(), and updateShadowLane().

◆ mySigma

double MSAbstractLaneChangeModel::mySigma

protected

Definition at line 792 of file MSAbstractLaneChangeModel.h.

Referenced by MSLCM_SL2015::getLateralDrift(), MSLCM_LC2013::getParameter(), MSLCM_SL2015::getParameter(), MSLCM_LC2013::prepareStep(), MSLCM_SL2015::prepareStep(), MSLCM_LC2013::setParameter(), and MSLCM_SL2015::setParameter().

◆ mySpeedLat

double MSAbstractLaneChangeModel::mySpeedLat

protected

the current lateral speed

Definition at line 699 of file MSAbstractLaneChangeModel.h.

Referenced by calcAngleOffset(), MSLCM_SL2015::computeSpeedLat(), getSpeedLat(), loadState(), saveState(), setSpeedLat(), updateCompletion(), and MSLCM_SL2015::wantsChangeSublane().

◆ myStrategicLookahead

double MSAbstractLaneChangeModel::myStrategicLookahead

protected

Definition at line 784 of file MSAbstractLaneChangeModel.h.

Referenced by MSLCM_LC2013::getParameter(), getStrategicLookahead(), and MSLCM_LC2013::setParameter().

◆ myTargetLane

MSLane* MSAbstractLaneChangeModel::myTargetLane

protected

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 737 of file MSAbstractLaneChangeModel.h.

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

◆ myVehicle

MSVehicle& MSAbstractLaneChangeModel::myVehicle

protected

The vehicle this lane-changer belongs to.

Definition at line 674 of file MSAbstractLaneChangeModel.h.

◆ NO_NEIGHBOR

const double MSAbstractLaneChangeModel::NO_NEIGHBOR

static

Definition at line 647 of file MSAbstractLaneChangeModel.h.

Referenced by MSLaneChanger::checkChange(), MSLCM_SL2015::keepLatGap(), laneChangeOutput(), and prepareStep().

◆ UNDEFINED_LOOKAHEAD

const double MSAbstractLaneChangeModel::UNDEFINED_LOOKAHEAD

static

Definition at line 648 of file MSAbstractLaneChangeModel.h.

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

Data Structures

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Protected Attributes

Static Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ MSAbstractLaneChangeModel()

◆ ~MSAbstractLaneChangeModel()

Member Function Documentation

◆ addLCSpeedAdvice()

◆ alreadyChanged()

◆ avoidOvertakeRight()

◆ build()

◆ calcAngleOffset()

◆ cancelRequest()

◆ changed()

◆ changedToOpposite()

◆ checkChangeBeforeCommitting()

◆ checkTraCICommands()

◆ cleanupShadowLane()

◆ cleanupTargetLane()

◆ clearGapsAtLCInit()

◆ clearNeighbors()

◆ computeSpeedLat()

◆ congested()

◆ debugVehicle()

◆ decideDirection()

◆ determineTargetLane()

◆ endLaneChangeManeuver()

◆ estimateLCDuration()

◆ getAccelerationLat()

◆ getAngleOffset()

◆ getAssumedDecelForLaneChangeDuration()

◆ getCanceledState()

◆ getCarFollowModel()

◆ getCommittedSpeed()

◆ getDesiredAlignment()

◆ getExtraReservation()

◆ getFollowers()

◆ getForwardPos()

◆ getFurtherTargetLanes()

◆ getLaneChangeCompletion()

◆ getLaneChangeDirection()

◆ getLastLaneChangeOffset()

◆ getLeaders()

◆ getManeuverDist()

◆ getMaxSpeedLat2()

◆ getModelID()

◆ getNormalizedLaneIndex()

◆ getOppositeSafetyFactor()

◆ getOwnState()

◆ getParameter()

◆ getPreviousManeuverDist()

◆ getPrevState()

◆ getSafetyFactor()

◆ getSavedState()

◆ getShadowDirection()

◆ getShadowFurtherLanes()

◆ getShadowFurtherLanesPosLat()

◆ getShadowLane() [1/3]

◆ getShadowLane() [2/3]

◆ getShadowLane() [3/3]

◆ getSpeedLat()

◆ getStrategicLookahead()

◆ getTargetLane()

◆ hasBlueLight()

◆ haveLCOutput()

◆ inform()

◆ initGlobalOptions()

◆ initLastLaneChangeOffset()

◆ isChangingLanes()

◆ isOpposite()

◆ isStrategicBlocked()

◆ laneChangeOutput()

◆ loadState()