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 More...

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

virtual void	changed ()=0

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

void	checkTraCICommands ()
	Check for commands issued for the vehicle via TraCI and apply the appropriate state changes For the sublane case, this includes setting a new maneuver distance if appropriate. More...

void	cleanupShadowLane ()

void	cleanupTargetLane ()

void	clearGapsAtLCInit ()

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

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. More...

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

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

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,. More...

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

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

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

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 More...

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

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

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

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

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

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. More...

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

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

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

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

int	getOwnState () const

virtual std::string	getParameter (const std::string &key) const
	try to retrieve the given parameter from this laneChangeModel. Throw exception for unsupported key More...

double	getPreviousManeuverDist () const

int	getPrevState () const

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

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

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

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

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

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

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

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

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

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

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 More...

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) More...

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

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

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

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

virtual double	patchSpeed (const double min, const double wanted, const double max, const MSCFModel &cfModel)=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. More...

virtual void	prepareStep ()

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

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

void	removeShadowApproachingInformation () const

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

virtual void	resetSpeedLat ()

virtual void	resetState ()

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

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. More...

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. More...

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

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

void	setFollowerGaps (CLeaderDist follower, double secGap)

void	setFollowerGaps (const MSLeaderDistanceInfo &vehicles)

void	setLeaderGaps (CLeaderDist, double secGap)

void	setLeaderGaps (const MSLeaderDistanceInfo &vehicles)

void	setManeuverDist (const double dist)
	Updates the remaining distance for the current maneuver while it is continued within non-action steps (only used by sublane model) More...

void	setNoShadowPartialOccupator (MSLane *lane)

void	setOrigLeaderGaps (CLeaderDist, double secGap)

void	setOrigLeaderGaps (const MSLeaderDistanceInfo &vehicles)

virtual void	setOwnState (const int state)

virtual void	setParameter (const std::string &key, const std::string &value)
	try to set the given parameter for this laneChangeModel. Throw exception for unsupported key More...

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

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

void	setShadowPartialOccupator (MSLane *lane)

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

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

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

void	unchanged ()

bool	updateCompletion ()

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

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

void	updateShadowLane ()

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. More...

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

virtual	~MSAbstractLaneChangeModel ()
	Destructor. More...

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

static bool	haveLCOutput ()
	whether lanechange-output is active More...

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

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

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

Static Public Attributes
static const double	NO_NEIGHBOR

Protected 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. More...

virtual bool	avoidOvertakeRight () const

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

virtual bool	congested (const MSVehicle *const neighLeader)

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

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

void	initLastLaneChangeOffset (int dir)

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

Protected Attributes
double	myAccelerationLat
	the current lateral acceleration More...

bool	myAlreadyChanged
	whether the vehicle has already moved this step More...

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

int	myCanceledStateCenter

int	myCanceledStateLeft

int	myCanceledStateRight

double	myCommittedSpeed
	the speed when committing to a change maneuver More...

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. More...

std::vector< MSLane * >	myFurtherTargetLanes

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

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

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

double	myLastFollowerGap

double	myLastFollowerSecureGap

double	myLastFollowerSpeed

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

double	myLastLateralGapRight

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

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

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

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

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 More...

std::vector< MSLane * >	myNoPartiallyOccupatedByShadow

double	myOvertakeRightParam

int	myOwnState
	The current state of the vehicle. More...

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

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

int	myPreviousState
	lane changing state from the previous simulation step More...

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

std::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. More...

double	mySigma

double	mySpeedLat
	the current lateral speed More...

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

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


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

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 More...

static bool	myLCEndedOutput

static bool	myLCOutput
	whether to record lane-changing More...

static bool	myLCStartedOutput

static bool	myLCXYOutput

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

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

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

SUMOTime	myLastLaneChangeOffset

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

double	myPreviousManeuverDist
	Maneuver distance from the previous simulation step. More...

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

References LCA_UNKNOWN, and saveLCState().

◆ ~MSAbstractLaneChangeModel()

MSAbstractLaneChangeModel::~MSAbstractLaneChangeModel ( )

virtual

Destructor.

Definition at line 152 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 1096 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 489 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 280 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 80 of file MSAbstractLaneChangeModel.cpp.

References DEFAULT, DK2008, MSGlobals::gLateralResolution, LC2013, 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 740 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 555 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_SL2015, MSLCM_LC2013, and MSLCM_DK2008.

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

References myAlreadyChanged, and myAmOpposite.

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

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 897 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 514 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 533 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 324 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 225 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_SL2015, and MSLCM_LC2013.

Definition at line 413 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 261 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_SL2015, and MSLCM_LC2013.

Definition at line 379 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 336 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 708 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 455 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 756 of file MSAbstractLaneChangeModel.cpp.

References computeSpeedLat(), SUMOVTypeParameter::getLCParams(), MSVehicleType::getMaxSpeedLat(), MSVehicleType::getParameter(), MSBaseVehicle::getVehicleType(), MSGlobals::gLaneChangeDuration, myMaxSpeedLatFactor, myMaxSpeedLatStanding, myVehicle, STEPS2TIME, SUMO_ATTR_LCA_MAXSPEEDLATFACTOR, SUMO_ATTR_LCA_MAXSPEEDLATSTANDING, 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 583 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 474 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 424 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 244 of file MSAbstractLaneChangeModel.h.

References myCanceledStateCenter, myCanceledStateLeft, and myCanceledStateRight.

Referenced by MSLCM_LC2013::_wantsChange(), MSLCM_SL2015::_wantsChangeSublane(), cancelRequest(), 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 729 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 569 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 625 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_SL2015, and MSLCM_LC2013.

Definition at line 610 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 234 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 1080 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 422 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 458 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 463 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 426 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 247 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 185 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 563 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_SL2015, MSLCM_LC2013, and MSLCM_DK2008.

◆ 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 1086 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_SL2015, and MSLCM_LC2013.

Definition at line 374 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 181 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_SL2015, and MSLCM_LC2013.

Definition at line 599 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 190 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 185 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_SL2015, and MSLCM_LC2013.

Definition at line 369 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 201 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 638 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 407 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 411 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 397 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 508 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 480 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 574 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:

◆ 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 418 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 621 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 158 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_SL2015, MSLCM_LC2013, and MSLCM_DK2008.

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 70 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 568 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 453 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 562 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 1061 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 367 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 1116 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 319 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 168 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 163 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 432 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_SL2015, MSLCM_LC2013, and MSLCM_DK2008.

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 288 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_SL2015, MSLCM_LC2013, and MSLCM_DK2008.

Definition at line 976 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 329 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 861 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 886 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 494 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 436 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_SL2015, and MSLCM_LC2013.

Definition at line 366 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_SL2015, and MSLCM_LC2013.

Definition at line 534 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 211 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 195 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 210 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 1103 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 479 of file MSAbstractLaneChangeModel.h.

References myAngleOffset.

◆ setFollowerGaps() [1/2]

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

Definition at line 949 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 1000 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 958 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 1020 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 169 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 542 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 967 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 1040 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 156 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_SL2015, and MSLCM_LC2013.

Definition at line 604 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 484 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 880 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 538 of file MSAbstractLaneChangeModel.h.

References myPartiallyOccupatedByShadow.

◆ setSpeedLat()

void MSAbstractLaneChangeModel::setSpeedLat ( double speedLat )

set the lateral speed and update lateral acceleraton

Definition at line 429 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 301 of file MSAbstractLaneChangeModel.cpp.

References DELTA_T, MSLane::getWidth(), MSGlobals::gLaneChangeDuration, 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 553 of file MSAbstractLaneChangeModel.h.

References myModel, toString(), and UNUSED_PARAMETER.

◆ unchanged()

void MSAbstractLaneChangeModel::unchanged ( )

inline

Definition at line 386 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 444 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 328 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 163 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 577 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 660 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_SL2015, MSLCM_LC2013, and MSLCM_DK2008.

Definition at line 270 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 295 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 683 of file MSAbstractLaneChangeModel.h.

Referenced by getAccelerationLat(), and setSpeedLat().

◆ myAllowOvertakingRight

bool MSAbstractLaneChangeModel::myAllowOvertakingRight

staticprotected

whether overtaking on the right is permitted

Definition at line 789 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 701 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 808 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 686 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 805 of file MSAbstractLaneChangeModel.h.

Referenced by removeShadowApproachingInformation(), and setShadowApproachingInformation().

◆ myCanceledStateCenter

int MSAbstractLaneChangeModel::myCanceledStateCenter

protected

Definition at line 668 of file MSAbstractLaneChangeModel.h.

Referenced by getCanceledState().

◆ myCanceledStateLeft

int MSAbstractLaneChangeModel::myCanceledStateLeft

protected

Definition at line 669 of file MSAbstractLaneChangeModel.h.

Referenced by getCanceledState().

◆ myCanceledStateRight

int MSAbstractLaneChangeModel::myCanceledStateRight

protected

Definition at line 667 of file MSAbstractLaneChangeModel.h.

Referenced by getCanceledState().

◆ myCommittedSpeed

double MSAbstractLaneChangeModel::myCommittedSpeed

protected

the speed when committing to a change maneuver

Definition at line 692 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 763 of file MSAbstractLaneChangeModel.h.

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

◆ myFurtherTargetLanes

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

protected

Definition at line 726 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 777 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 695 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 698 of file MSAbstractLaneChangeModel.h.

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

◆ myLastFollowerGap

double MSAbstractLaneChangeModel::myLastFollowerGap

protected

Definition at line 749 of file MSAbstractLaneChangeModel.h.

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

◆ myLastFollowerSecureGap

double MSAbstractLaneChangeModel::myLastFollowerSecureGap

protected

Definition at line 752 of file MSAbstractLaneChangeModel.h.

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

◆ myLastFollowerSpeed

double MSAbstractLaneChangeModel::myLastFollowerSpeed

protected

Definition at line 758 of file MSAbstractLaneChangeModel.h.

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

◆ myLastLaneChangeOffset

SUMOTime MSAbstractLaneChangeModel::myLastLaneChangeOffset

private

Definition at line 802 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 744 of file MSAbstractLaneChangeModel.h.

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

◆ myLastLateralGapRight

double MSAbstractLaneChangeModel::myLastLateralGapRight

protected

Definition at line 745 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 748 of file MSAbstractLaneChangeModel.h.

Referenced by laneChangeOutput(), prepareStep(), 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 751 of file MSAbstractLaneChangeModel.h.

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

◆ myLastLeaderSpeed

double MSAbstractLaneChangeModel::myLastLeaderSpeed

protected

speeds of surrounding vehicles at the time of lane change

Definition at line 757 of file MSAbstractLaneChangeModel.h.

Referenced by laneChangeOutput(), prepareStep(), 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 754 of file MSAbstractLaneChangeModel.h.

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

◆ myLastOrigLeaderSecureGap

double MSAbstractLaneChangeModel::myLastOrigLeaderSecureGap

protected

Definition at line 755 of file MSAbstractLaneChangeModel.h.

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

◆ myLastOrigLeaderSpeed

double MSAbstractLaneChangeModel::myLastOrigLeaderSpeed

protected

Definition at line 759 of file MSAbstractLaneChangeModel.h.

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

◆ myLCAccelerationAdvices

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

protected

Definition at line 786 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 794 of file MSAbstractLaneChangeModel.h.

Referenced by initGlobalOptions(), and outputLCEnded().

◆ myLCOutput

bool MSAbstractLaneChangeModel::myLCOutput

staticprotected

whether to record lane-changing

Definition at line 792 of file MSAbstractLaneChangeModel.h.

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

◆ myLCStartedOutput

bool MSAbstractLaneChangeModel::myLCStartedOutput

staticprotected

Definition at line 793 of file MSAbstractLaneChangeModel.h.

Referenced by initGlobalOptions(), and outputLCStarted().

◆ myLCXYOutput

bool MSAbstractLaneChangeModel::myLCXYOutput

staticprotected

Definition at line 795 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 673 of file MSAbstractLaneChangeModel.h.

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

◆ myLeftLeaders

std::shared_ptr<MSLeaderDistanceInfo> MSAbstractLaneChangeModel::myLeftLeaders

protected

Definition at line 674 of file MSAbstractLaneChangeModel.h.

Referenced by clearNeighbors(), getLeaders(), 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 812 of file MSAbstractLaneChangeModel.h.

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

◆ myMaxDistLatStanding

double MSAbstractLaneChangeModel::myMaxDistLatStanding

protected

Definition at line 770 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 768 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 766 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 734 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 741 of file MSAbstractLaneChangeModel.h.

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

◆ myOvertakeRightParam

double MSAbstractLaneChangeModel::myOvertakeRightParam

protected

Definition at line 774 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 658 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 737 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 689 of file MSAbstractLaneChangeModel.h.

Referenced by calcAngleOffset(), and setPreviousAngleOffset().

◆ myPreviousManeuverDist

double MSAbstractLaneChangeModel::myPreviousManeuverDist

private

Maneuver distance from the previous simulation step.

Definition at line 815 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 660 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 662 of file MSAbstractLaneChangeModel.h.

Referenced by getPrevState(), and setOwnState().

◆ myRightFollowers

std::shared_ptr<MSLeaderDistanceInfo> MSAbstractLaneChangeModel::myRightFollowers

protected

Definition at line 675 of file MSAbstractLaneChangeModel.h.

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

◆ myRightLeaders

std::shared_ptr<MSLeaderDistanceInfo> MSAbstractLaneChangeModel::myRightLeaders

protected

Definition at line 676 of file MSAbstractLaneChangeModel.h.

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

◆ mySavedStateCenter

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

protected

Definition at line 665 of file MSAbstractLaneChangeModel.h.

Referenced by getSavedState(), and saveLCState().

◆ mySavedStateLeft

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

protected

Definition at line 666 of file MSAbstractLaneChangeModel.h.

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

◆ mySavedStateRight

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

protected

Definition at line 664 of file MSAbstractLaneChangeModel.h.

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

◆ myShadowFurtherLanes

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

protected

Definition at line 707 of file MSAbstractLaneChangeModel.h.

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

◆ myShadowFurtherLanesPosLat

std::vector<double> MSAbstractLaneChangeModel::myShadowFurtherLanesPosLat

protected

Definition at line 708 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 704 of file MSAbstractLaneChangeModel.h.

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

◆ mySigma

double MSAbstractLaneChangeModel::mySigma

protected

Definition at line 772 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 680 of file MSAbstractLaneChangeModel.h.

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

◆ 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 718 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 655 of file MSAbstractLaneChangeModel.h.

◆ NO_NEIGHBOR

const double MSAbstractLaneChangeModel::NO_NEIGHBOR

static

Definition at line 629 of file MSAbstractLaneChangeModel.h.

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

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

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

◆ getTargetLane()

◆ hasBlueLight()

◆ haveLCOutput()

◆ inform()

◆ initGlobalOptions()

◆ initLastLaneChangeOffset()

◆ isChangingLanes()

◆ isOpposite()

◆ isStrategicBlocked()

◆ laneChangeOutput()

◆ loadState()

◆ memorizeGapsAtLCInit()

◆ operator=()