#include <MSLink.h>

Collaboration diagram for MSLink:

Data Structures
struct	ApproachingVehicleInformation
	A structure holding the information about vehicles approaching a link. More...

struct	LinkLeader

Public Types
typedef std::vector< LinkLeader >	LinkLeaders

Public Member Functions
void	addBlockedLink (MSLink *link)

void	addWalkingAreaFoe (const MSLane *lane)
	add walkingarea as foe More...

bool	blockedAtTime (SUMOTime arrivalTime, SUMOTime leaveTime, double arrivalSpeed, double leaveSpeed, bool sameTargetLane, double impatience, double decel, SUMOTime waitingTime, std::vector< const SUMOVehicle * > collectFoes=0, const SUMOVehicle ego=0) const
	Returns the information whether this link is blocked Valid after the vehicles have set their requests. More...

bool	fromInternalLane () const
	return whether the fromLane of this link is an internal lane More...

ApproachingVehicleInformation	getApproaching (const SUMOVehicle *veh) const

const std::map< const SUMOVehicle *, ApproachingVehicleInformation > &	getApproaching () const
	return all approaching vehicles More...

MSLink *	getCorrespondingExitLink () const
	returns the corresponding exit link for entryLinks to a junction. More...

LinkDirection	getDirection () const
	Returns the direction the vehicle passing this link take. More...

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

const std::vector< MSLink * > &	getFoeLinks () const

double	getFoeVisibilityDistance () const
	Returns the distance on the approaching lane from which an approaching vehicle is able to see all relevant foes and may accelerate if the link is minor and no foe is approaching. More...

double	getGreenFraction () const
	Returns the average proportion of green time to cycle time. More...

int	getIndex () const
	Returns the respond index (for visualization) More...

const MSLane *	getInternalLaneBefore () const
	return myInternalLaneBefore (always 0 when compiled without internal lanes) More...

double	getInternalLengthsAfter () const
	Returns the cumulative length of all internal lanes after this link. More...

double	getInternalLengthsBefore () const
	Returns the cumulative length of all internal lanes before this link. More...

MSJunction *	getJunction () const

MSLane *	getLane () const
	Returns the connected lane. More...

const MSLane *	getLaneBefore () const
	return the internalLaneBefore if it exists and the laneBefore otherwise More...

SUMOTime	getLastStateChange () const

LinkLeaders	getLeaderInfo (const MSVehicle ego, double dist, std::vector< const MSPerson > *collectBlockers=0, bool isShadowLink=false) const
	Returns all potential link leaders (vehicles on foeLanes) Valid during the planMove() phase. More...

SUMOTime	getLeaveTime (const SUMOTime arrivalTime, const double arrivalSpeed, const double leaveSpeed, const double vehicleLength) const
	return the expected time at which the given vehicle will clear the link More...

double	getLength () const
	Returns the length of this link. More...

double	getLengthBeforeCrossing (const MSLane *foeLane) const
	Returns the internal length from the beginning of the link's internal lane before to the crossing with the given foe lane if applicable, if the lane is no foe lane to the link, INVALID_DOUBLE is returned. More...

double	getLengthsBeforeCrossing (const MSLane *foeLane) const
	Returns the sum of the lengths along internal lanes following this link to the crossing with the given foe lane, if the lane is no foe lane to any of the internal lanes, INVALID_DOUBLE is returned. More...

const std::vector< std::pair< double, double > > &	getLengthsBehindCrossing () const

SUMOTime	getMesoTLSPenalty () const
	Returns the time penalty for passing a tls-controlled link (meso) More...

MSLink *	getParallelLink (int direction) const
	return the link that is parallel to this lane or 0 More...

LinkState	getState () const
	Returns the current state of the link. More...

int	getTLIndex () const
	Returns the TLS index. More...

const MSTrafficLightLogic *	getTLLogic () const
	Returns the TLS index. More...

MSLane *	getViaLane () const
	Returns the following inner lane. More...

MSLane *	getViaLaneOrLane () const
	return the via lane if it exists and the lane otherwise More...

const MSLane *	getWalkingAreaFoe ()
	get walkingarea as foe More...

double	getZipperSpeed (const MSVehicle ego, const double dist, double vSafe, SUMOTime arrivalTime, std::vector< const SUMOVehicle > *collectFoes) const
	return the speed at which ego vehicle must approach the zipper link More...

bool	hasApproachingFoe (SUMOTime arrivalTime, SUMOTime leaveTime, double speed, double decel) const
	Returns the information whether a vehicle is approaching on one of the link's foe streams. More...

bool	hasFoes () const
	Returns whether this link belongs to a junction where more than one edge is incoming. More...

bool	havePriority () const
	Returns whether this link is a major link. More...

bool	haveRed () const
	Returns whether this link is blocked by a red (or redyellow) traffic light. More...

bool	haveYellow () const

void	initParallelLinks ()
	initialize parallel links (to be called after all links are loaded) More...

bool	isBlockingAnyone () const

bool	isCont () const

bool	isExitLink () const
	return whether the fromLane of this link is an internal lane and toLane is a normal lane More...

bool	isInternalJunctionLink () const
	return whether the fromLane and the toLane of this link are internal lanes More...

bool	isLeader (const MSVehicle ego, const MSVehicle foe) const

bool	isTLSControlled () const

bool	keepClear () const
	whether the junction after this link must be kept clear More...

bool	lastWasContMajor () const
	whether this is a link past an internal junction which currently has priority More...

	MSLink (MSLane predLane, MSLane succLane, MSLane via, LinkDirection dir, LinkState state, double length, double foeVisibilityDistance, bool keepClear, MSTrafficLightLogic logic, int tlLinkIdx)
	Constructor for simulation which uses internal lanes. More...

bool	opened (SUMOTime arrivalTime, double arrivalSpeed, double leaveSpeed, double vehicleLength, double impatience, double decel, SUMOTime waitingTime, double posLat=0, std::vector< const SUMOVehicle * > collectFoes=0, bool ignoreRed=false, const SUMOVehicle ego=0) const
	Returns the information whether the link may be passed. More...

void	passedJunction (const MSVehicle *vehicle)
	erase vehicle from myLinkLeaders of this links junction More...

void	removeApproaching (const SUMOVehicle *veh)
	removes the vehicle from myApproachingVehicles More...

void	setApproaching (const SUMOVehicle *approaching, const SUMOTime arrivalTime, const double arrivalSpeed, const double leaveSpeed, const bool setRequest, const SUMOTime arrivalTimeBraking, const double arrivalSpeedBraking, const SUMOTime waitingTime, double dist)
	Sets the information about an approaching vehicle. More...

void	setGreenFraction (const double fraction)
	Sets the green fraction for passing a tls-controlled link (meso) More...

void	setMesoTLSPenalty (const SUMOTime penalty)
	Sets the time penalty for passing a tls-controlled link (meso) More...

void	setRequestInformation (int index, bool hasFoes, bool isCont, const std::vector< MSLink * > &foeLinks, const std::vector< MSLane * > &foeLanes, MSLane *internalLaneBefore=0)
	Sets the request information. More...

void	setTLState (LinkState state, SUMOTime t)
	Sets the current tl-state. More...

bool	willHaveBlockedFoe () const

void	writeApproaching (OutputDevice &od, const std::string fromLaneID) const
	write information about all approaching vehicles to the given output device More...

	~MSLink ()
	Destructor. More...

Static Public Attributes
static const double	ZIPPER_ADAPT_DIST

Private Member Functions
bool	blockedByFoe (const SUMOVehicle *veh, const ApproachingVehicleInformation &avi, SUMOTime arrivalTime, SUMOTime leaveTime, double arrivalSpeed, double leaveSpeed, bool sameTargetLane, double impatience, double decel, SUMOTime waitingTime) const

MSLink *	computeParallelLink (int direction)

	MSLink (const MSLink &s)
	invalidated copy constructor More...

MSLink &	operator= (const MSLink &s)
	invalidated assignment operator More...

Static Private Member Functions
static bool	couldBrakeForLeader (double followDist, double leaderDist, const MSVehicle follow, const MSVehicle leader)
	whether fllower could stay behind leader (possibly by braking) More...

static bool	maybeOccupied (MSLane *lane)
	returns whether the given lane may still be occupied by a vehicle currently on it More...

static bool	unsafeMergeSpeeds (double leaderSpeed, double followerSpeed, double leaderDecel, double followerDecel)
	return whether the given vehicles may NOT merge safely More...

Private Attributes
bool	myAmCont

std::map< const SUMOVehicle *, ApproachingVehicleInformation >	myApproachingVehicles

std::set< MSLink * >	myBlockedFoeLinks

LinkDirection	myDirection
	An abstract (hopefully human readable) definition of the link's direction. More...

std::vector< const MSLane * >	myFoeLanes

std::vector< MSLink * >	myFoeLinks

double	myFoeVisibilityDistance
	distance from which an approaching vehicle is able to see all relevant foes and may accelerate if the link is minor and no foe is approaching. Defaults to 4.5m. More...

double	myGreenFraction
	green fraction at tls for mesoscopic simulation More...

bool	myHasFoes
	Whether any foe links exist. More...

int	myIndex
	The position within this respond. More...

MSLane *const	myInternalLane
	The following junction-internal lane if used. More...

const MSLane *	myInternalLaneBefore

MSJunction *	myJunction
	the junction to which this link belongs More...

bool	myKeepClear

MSLane *	myLane
	The lane behind the junction approached by this link. More...

MSLane *	myLaneBefore
	The lane approaching this link. More...

SUMOTime	myLastStateChange
	The time of the last state change. More...

double	myLength
	The length of the link. More...

std::vector< std::pair< double, double > >	myLengthsBehindCrossing

const MSTrafficLightLogic *	myLogic
	the controlling logic or 0 More...

SUMOTime	myMesoTLSPenalty
	penalty time at tls for mesoscopic simulation More...

MSLink *	myParallelLeft

MSLink *	myParallelRight

LinkState	myState
	The state of the link. More...

std::vector< MSLane * >	mySublaneFoeLanes

std::vector< MSLink * >	mySublaneFoeLinks

const int	myTLIndex
	the traffic light index More...

const MSLane *	myWalkingAreaFoe

Static Private Attributes
static const SUMOTime	myLookaheadTime = TIME2STEPS(1)

static const SUMOTime	myLookaheadTimeZipper = TIME2STEPS(4)

Detailed Description

Definition at line 77 of file MSLink.h.

Member Typedef Documentation

typedef std::vector<LinkLeader> MSLink::LinkLeaders

Definition at line 95 of file MSLink.h.

Constructor & Destructor Documentation

MSLink::MSLink	(	MSLane *	predLane,
		MSLane *	succLane,
		MSLane *	via,
		LinkDirection	dir,
		LinkState	state,
		double	length,
		double	foeVisibilityDistance,
		bool	keepClear,
		MSTrafficLightLogic *	logic,
		int	tlLinkIdx
	)

Constructor for simulation which uses internal lanes.

Parameters

[in]	succLane	The lane approached by this link
[in]	via	The lane to use within the junction
[in]	dir	The direction of this link
[in]	state	The state of this link
[in]	length	The length of this link

Definition at line 68 of file MSLink.cpp.

MSLink::~MSLink ( )

Destructor.

Definition at line 93 of file MSLink.cpp.

MSLink::MSLink ( const MSLink & s )

private

invalidated copy constructor

Member Function Documentation

void MSLink::addBlockedLink ( MSLink * link )

Definition at line 271 of file MSLink.cpp.

References myBlockedFoeLinks.

Referenced by getWalkingAreaFoe().

void MSLink::addWalkingAreaFoe ( const MSLane * lane )

inline

add walkingarea as foe

Definition at line 176 of file MSLink.h.

References myWalkingAreaFoe.

Referenced by MSRightOfWayJunction::postloadInit().

bool MSLink::blockedAtTime	(	SUMOTime	arrivalTime,
		SUMOTime	leaveTime,
		double	arrivalSpeed,
		double	leaveSpeed,
		bool	sameTargetLane,
		double	impatience,
		double	decel,
		SUMOTime	waitingTime,
		std::vector< const SUMOVehicle * > *	collectFoes = `0`,
		const SUMOVehicle *	ego = `0`
	)		const

Returns the information whether this link is blocked Valid after the vehicles have set their requests.

Parameters

[in]	arrivalTime	The arrivalTime of the vehicle who checks for an approaching foe
[in]	leaveTime	The leaveTime of the vehicle who checks for an approaching foe
[in]	arrivalSpeed	The speed with which the checking vehicle plans to arrive at the link
[in]	leaveSpeed	The speed with which the checking vehicle plans to leave the link
[in]	sameTargetLane	Whether the link that calls this method has the same target lane as this link
[in]	impatience	The impatience of the checking vehicle
[in]	decel	The maximum deceleration of the checking vehicle
[in]	waitingTime	The waiting time of the checking vehicle
[in]	collectFoes	If a vector is passed the return value is always False, instead all blocking foes are collected and inserted into this vector

Returns: Whether this link is blocked

Note: Since this needs to be called without a SUMOVehicle (TraCI), we cannot simply pass the checking vehicle itself

Definition at line 396 of file MSLink.cpp.

References blockedByFoe(), and myApproachingVehicles.

Referenced by getApproaching().

bool MSLink::blockedByFoe	(	const SUMOVehicle *	veh,
		const ApproachingVehicleInformation &	avi,
		SUMOTime	arrivalTime,
		SUMOTime	leaveTime,
		double	arrivalSpeed,
		double	leaveSpeed,
		bool	sameTargetLane,
		double	impatience,
		double	decel,
		SUMOTime	waitingTime
	)		const

private

MSLink * MSLink::computeParallelLink ( int direction )

private

Definition at line 925 of file MSLink.cpp.

References MSLinkContHelper::getConnectingLink(), getLaneBefore(), MSLane::getParallelLane(), and getViaLaneOrLane().

Referenced by initParallelLinks(), and unsafeMergeSpeeds().

bool MSLink::couldBrakeForLeader	(	double	followDist,
		double	leaderDist,
		const MSVehicle *	follow,
		const MSVehicle *	leader
	)

staticprivate

whether fllower could stay behind leader (possibly by braking)

Definition at line 1033 of file MSLink.cpp.

References MSVehicle::getCarFollowModel(), MSCFModel::getMaxDecel(), and MSVehicle::getSpeed().

Referenced by getZipperSpeed(), and unsafeMergeSpeeds().

bool MSLink::fromInternalLane ( ) const

return whether the fromLane of this link is an internal lane

Definition at line 700 of file MSLink.cpp.

References isExitLink(), and isInternalJunctionLink().

Referenced by getLeaderInfo(), keepClear(), and setRequestInformation().

MSLink::ApproachingVehicleInformation MSLink::getApproaching ( const SUMOVehicle * veh ) const

Definition at line 295 of file MSLink.cpp.

References myApproachingVehicles.

Referenced by MSRailSignal::getAppropriateState(), and getZipperSpeed().

const std::map<const SUMOVehicle*, ApproachingVehicleInformation>& MSLink::getApproaching ( ) const

inline

return all approaching vehicles

Definition at line 205 of file MSLink.h.

References blockedAtTime(), myApproachingVehicles, and opened().

Referenced by getWalkingAreaFoe().

MSLink * MSLink::getCorrespondingExitLink ( ) const

returns the corresponding exit link for entryLinks to a junction.

Definition at line 683 of file MSLink.cpp.

References MSLane::getLinkCont(), getViaLane(), and myInternalLane.

Referenced by MSDevice_SSM::classifyEncounter(), and keepClear().

LinkDirection MSLink::getDirection ( ) const

Returns the direction the vehicle passing this link take.

Returns: The direction of this link

Definition at line 510 of file MSLink.cpp.

References myDirection.

Referenced by MSLaneChanger::changeOpposite(), MSVehicle::executeMove(), getLastStateChange(), and TraCI_Lane::getLinks().

const std::vector<const MSLane*>& MSLink::getFoeLanes ( ) const

inline

Definition at line 488 of file MSLink.h.

References myFoeLanes.

Referenced by GUILane::debugDrawFoeIntersections().

const std::vector<MSLink*>& MSLink::getFoeLinks ( ) const

inline

Definition at line 496 of file MSLink.h.

References initParallelLinks(), and myFoeLinks.

Referenced by MSDevice_SSM::classifyEncounter(), and MSLane::incoming_lane_priority_sorter::operator()().

double MSLink::getFoeVisibilityDistance ( ) const

inline

Returns the distance on the approaching lane from which an approaching vehicle is able to see all relevant foes and may accelerate if the link is minor and no foe is approaching.

Returns: The foe-visibility-distance

Definition at line 358 of file MSLink.h.

References myFoeVisibilityDistance.

Referenced by MSVehicle::executeMove().

double MSLink::getGreenFraction ( ) const

inline

Returns the average proportion of green time to cycle time.

Definition at line 474 of file MSLink.h.

References myGreenFraction.

Referenced by MESegment::getTLSCapacity().

int MSLink::getIndex ( ) const

inline

Returns the respond index (for visualization)

Returns: The respond index for this link

Definition at line 307 of file MSLink.h.

References myIndex.

Referenced by GUILane::drawLinkNo(), and getLeaderInfo().

const MSLane * MSLink::getInternalLaneBefore ( ) const

return myInternalLaneBefore (always 0 when compiled without internal lanes)

Definition at line 954 of file MSLink.cpp.

References myInternalLaneBefore.

Referenced by MSDevice_SSM::classifyEncounter(), isExitLink(), isInternalJunctionLink(), and keepClear().

double MSLink::getInternalLengthsAfter ( ) const

Returns the cumulative length of all internal lanes after this link.

Returns: sum of the lengths of all internal lanes following this link

Definition at line 581 of file MSLink.cpp.

References MSLane::getLength(), MSLane::getLinkCont(), MSLane::isInternal(), and myInternalLane.

Referenced by MSDevice_SSM::classifyEncounter(), MSLCM_LC2013::distanceAlongNextRoundabout(), MSDevice_SSM::findFoeConflictLane(), MSDevice_SSM::findSurroundingVehicles(), MSLCM_LC2013::getRoundaboutAheadInfo(), and keepClear().

double MSLink::getInternalLengthsBefore ( ) const

Returns the cumulative length of all internal lanes before this link.

Returns: sum of the lengths of all internal lanes before this link

Definition at line 593 of file MSLink.cpp.

References MSLane::getIncomingLanes(), MSLane::getLength(), MSLane::isInternal(), and myInternalLane.

Referenced by keepClear().

MSJunction* MSLink::getJunction ( ) const

inline

Definition at line 261 of file MSLink.h.

References myJunction.

MSLane * MSLink::getLane ( ) const

Returns the connected lane.

Returns: The lane approached by this link

Definition at line 525 of file MSLink.cpp.

References myLane.

Referenced by MSVehicle::checkRewindLinkLanes(), MSDevice_SSM::classifyEncounter(), Command_SaveTLSSwitches::execute(), MSLinkContHelper::getConnectingLink(), MSLinkContHelper::getInternalFollowingEdge(), MSEdge::getInternalFollowingEdge(), MSLinkContHelper::getInternalFollowingLane(), getLastStateChange(), TraCI_Lane::getLinks(), MSPModel_Striping::getNextWalkingArea(), MSRailSignal::init(), MESegment::limitedControlOverride(), opened(), MSLane::outgoing_lane_priority_sorter::operator()(), MSRightOfWayJunction::postloadInit(), TraCIServerAPI_TLS::processGet(), and writeApproaching().

const MSLane * MSLink::getLaneBefore ( ) const

return the internalLaneBefore if it exists and the laneBefore otherwise

Definition at line 901 of file MSLink.cpp.

References myInternalLaneBefore, and myLaneBefore.

Referenced by computeParallelLink(), getLengthBeforeCrossing(), MSRailSignal::init(), and keepClear().

SUMOTime MSLink::getLastStateChange ( ) const

inline

Definition at line 276 of file MSLink.h.

References getDirection(), getLane(), myLastStateChange, and setTLState().

Referenced by MSPModel_Striping::PState::ignoreRed(), and MSVehicle::ignoreRed().

MSLink::LinkLeaders MSLink::getLeaderInfo	(	const MSVehicle *	ego,
		double	dist,
		std::vector< const MSPerson * > *	collectBlockers = `0`,
		bool	isShadowLink = `false`
	)		const

Returns all potential link leaders (vehicles on foeLanes) Valid during the planMove() phase.

Parameters

[in]	ego	The ego vehicle that is looking for leaders
[in]	dist	The distance of the vehicle who is asking about the leader to this link
[out]	blocking	Return blocking pedestrians if a vector is given
[in]	isShadowLink	whether this link is a shadowLink for ego

Returns: The all vehicles on foeLanes and their (virtual) distances to the asking vehicle

Todo:: consider lateral position (depending on whether the crossing is encountered on the way in or out)

Definition at line 705 of file MSLink.cpp.

References MSLane::anyVehiclesBegin(), MSLane::anyVehiclesEnd(), MSPModel::blockedAtDist(), Position::distanceTo2D(), fromInternalLane(), gDebugFlag1, MSVehicle::getBackPositionOnLane(), MSLane::getEdge(), Named::getID(), MSBaseVehicle::getID(), getIndex(), MSLane::getIndex(), SUMOVTypeParameter::getJMParam(), MSVehicle::getLane(), MSVehicle::getLaneChangeModel(), MSVehicle::getLateralPositionOnLane(), MSVehicle::getLatOffset(), MSVehicleType::getLength(), MSBaseVehicle::getLength(), MSLane::getLength(), MSLane::getLinkCont(), MSLane::getLogicalPredecessorLane(), MSVehicleType::getMinGap(), MSPModel::getModel(), MSVehicleType::getParameter(), MSEdge::getPersons(), MSTransportable::getPosition(), MSVehicle::getPosition(), MSBaseVehicle::getVehicleType(), MSTransportable::getVehicleType(), getViaLaneOrLane(), MSVehicle::getWaitingTime(), MSVehicleType::getWidth(), MSLane::getWidth(), MSGlobals::gIgnoreJunctionBlocker, MSGlobals::gLateralResolution, MSVehicle::isFrontOnLane(), MSAbstractLaneChangeModel::isOpposite(), MSVehicle::isStopped(), JM_CROSSING_GAP_DEFAULT, max, MAX2(), MIN2(), myFoeLanes, myInternalLaneBefore, myLane, myLaneBefore, myLengthsBehindCrossing, mySublaneFoeLanes, myWalkingAreaFoe, MSPModel::SAFETY_GAP, SIMTIME, and SUMO_ATTR_JM_CROSSING_GAP.

Referenced by MSVehicle::checkLinkLeader(), and keepClear().

SUMOTime MSLink::getLeaveTime	(	const SUMOTime	arrivalTime,
		const double	arrivalSpeed,
		const double	leaveSpeed,
		const double	vehicleLength
	)		const

return the expected time at which the given vehicle will clear the link

Definition at line 306 of file MSLink.cpp.

References getLength(), MAX2(), NUMERICAL_EPS, and TIME2STEPS.

Referenced by keepClear(), opened(), and setApproaching().

double MSLink::getLength ( ) const

inline

Returns the length of this link.

Returns: The length of this link

Definition at line 347 of file MSLink.h.

References myLength.

Referenced by MEVehicle::estimateLeaveSpeed(), MSVehicle::estimateLeaveSpeed(), getLeaveTime(), TraCI_Lane::getLinks(), MSE2Collector::initAuxiliaries(), MSE2Collector::recalculateDetectorLength(), and MSE2Collector::selectLanes().

double MSLink::getLengthBeforeCrossing ( const MSLane * foeLane ) const

Returns the internal length from the beginning of the link's internal lane before to the crossing with the given foe lane if applicable, if the lane is no foe lane to the link, INVALID_DOUBLE is returned.

See also: getLengthsBeforeCrossing()

Definition at line 636 of file MSLink.cpp.

References MSLane::getEntryLink(), Named::getID(), getLaneBefore(), MSLane::getLength(), INVALID_DOUBLE, myFoeLanes, myInternalLaneBefore, and myLengthsBehindCrossing.

Referenced by getLengthsBeforeCrossing(), and keepClear().

double MSLink::getLengthsBeforeCrossing ( const MSLane * foeLane ) const

Returns the sum of the lengths along internal lanes following this link to the crossing with the given foe lane, if the lane is no foe lane to any of the internal lanes, INVALID_DOUBLE is returned.

See also: getLengthBeforeCrossing()

Definition at line 610 of file MSLink.cpp.

References MSLane::getLength(), getLengthBeforeCrossing(), MSLane::getLinkCont(), getViaLane(), INVALID_DOUBLE, and myInternalLane.

Referenced by MSDevice_SSM::classifyEncounter(), and keepClear().

const std::vector<std::pair<double, double> >& MSLink::getLengthsBehindCrossing ( ) const

inline

Definition at line 492 of file MSLink.h.

References myLengthsBehindCrossing.

Referenced by GUILane::debugDrawFoeIntersections().

SUMOTime MSLink::getMesoTLSPenalty ( ) const

inline

Returns the time penalty for passing a tls-controlled link (meso)

Definition at line 469 of file MSLink.h.

References myMesoTLSPenalty.

Referenced by MESegment::getLinkPenalty(), MESegment::getMaxPenaltySeconds(), and MSEdge::recalcCache().

MSLink * MSLink::getParallelLink ( int direction ) const

return the link that is parallel to this lane or 0

Definition at line 912 of file MSLink.cpp.

References myParallelLeft, and myParallelRight.

Referenced by MSVehicle::checkRewindLinkLanes(), MSVehicle::executeMove(), keepClear(), MSVehicle::planMoveInternal(), and GUIVehicle::selectBlockingFoes().

LinkState MSLink::getState ( ) const

inline

Returns the current state of the link.

Returns: The current state of this link

Definition at line 270 of file MSLink.h.

References myState.

Referenced by MSEdge::allowsLaneChanging(), MSLaneChanger::changeOpposite(), GUILane::drawLinkRule(), Command_SaveTLCoupledLaneDet::execute(), MSVehicle::executeMove(), MSLane::getIncomingLinkState(), TraCI_Lane::getLinks(), MSVehicle::ignoreRed(), and MELoop::setApproaching().

int MSLink::getTLIndex ( ) const

inline

Returns the TLS index.

Definition at line 312 of file MSLink.h.

References myTLIndex.

const MSTrafficLightLogic* MSLink::getTLLogic ( ) const

inline

Returns the TLS index.

Definition at line 317 of file MSLink.h.

References myLogic.

Referenced by MSVehicle::ignoreRed().

MSLane * MSLink::getViaLane ( ) const

Returns the following inner lane.

Returns: The inner lane to use to cross the junction

Definition at line 667 of file MSLink.cpp.

References myInternalLane.

Referenced by MSVehicle::checkRewindLinkLanes(), MSDevice_SSM::classifyEncounter(), MSVehicle::executeMove(), MSDevice_SSM::findFoeConflictLane(), MSDevice_SSM::findSurroundingVehicles(), getCorrespondingExitLink(), MSLinkContHelper::getInternalFollowingEdge(), MSEdge::getInternalFollowingEdge(), MSLinkContHelper::getInternalFollowingLane(), getLengthsBeforeCrossing(), TraCI_Lane::getLinks(), MSE2Collector::initAuxiliaries(), keepClear(), MSInternalJunction::postloadInit(), MSRightOfWayJunction::postloadInit(), TraCIServerAPI_TLS::processGet(), and writeApproaching().

MSLane * MSLink::getViaLaneOrLane ( ) const

return the via lane if it exists and the lane otherwise

Definition at line 892 of file MSLink.cpp.

References myInternalLane, and myLane.

Referenced by blockedByFoe(), MSLaneChanger::changeOpposite(), computeParallelLink(), GUIVehicle::drawAction_drawLinkItems(), MEVehicle::estimateLeaveSpeed(), MSVehicle::estimateLeaveSpeed(), MSVehicle::executeMove(), MSLinkContHelper::getConnectingLink(), getLeaderInfo(), MSPModel_Striping::getNextLane(), MSVehicle::getPositionAlongBestLanes(), MSVehicle::ignoreRed(), keepClear(), MSPModel_Striping::moveInDirectionOnLane(), opened(), GUIVehicle::selectBlockingFoes(), and setRequestInformation().

const MSLane* MSLink::getWalkingAreaFoe ( )

inline

get walkingarea as foe

Definition at line 181 of file MSLink.h.

References addBlockedLink(), getApproaching(), myWalkingAreaFoe, removeApproaching(), and setApproaching().

double MSLink::getZipperSpeed	(	const MSVehicle *	ego,
		const double	dist,
		double	vSafe,
		SUMOTime	arrivalTime,
		std::vector< const SUMOVehicle * > *	collectFoes
	)		const

return the speed at which ego vehicle must approach the zipper link

Definition at line 960 of file MSLink.cpp.

References MSLink::ApproachingVehicleInformation::arrivalTime, couldBrakeForLeader(), MSLink::ApproachingVehicleInformation::dist, MSCFModel::followSpeed(), getApproaching(), MSVehicle::getCarFollowModel(), MSNet::getCurrentTimeStep(), Named::getID(), MSLane::getIndex(), MSNet::getInstance(), MSVehicle::getLane(), MSVehicleType::getLength(), MSCFModel::getMaxDecel(), MSVehicleType::getMinGap(), MSVehicle::getSpeed(), MSBaseVehicle::getVehicleType(), MAX2(), MIN2(), myFoeLinks, myJunction, STEPS2TIME, TS, ZIPPER_ADAPT_DIST, and ZIPPER_ADAPT_TIME.

Referenced by MSVehicle::executeMove(), and keepClear().

bool MSLink::hasApproachingFoe	(	SUMOTime	arrivalTime,
		SUMOTime	leaveTime,
		double	speed,
		double	decel
	)		const

Returns the information whether a vehicle is approaching on one of the link's foe streams.

Valid after the vehicles have set their requests

Parameters

[in]	arrivalTime	The arrivalTime of the vehicle who checks for an approaching foe
[in]	leaveTime	The leaveTime of the vehicle who checks for an approaching foe
[in]	speed	The speed with which the checking vehicle plans to leave the link
[in]	decel	The maximum deceleration of the checking vehicle

Returns: Whether a foe of this link is approaching

Definition at line 494 of file MSLink.cpp.

References myFoeLanes, myFoeLinks, and myLane.

Referenced by TraCI_Lane::getLinks(), and isBlockingAnyone().

bool MSLink::hasFoes ( ) const

inline

Returns whether this link belongs to a junction where more than one edge is incoming.

Returns: Whether any foe links exist

Definition at line 367 of file MSLink.h.

References myHasFoes.

Referenced by MSVehicle::keepClear(), and setRequestInformation().

bool MSLink::havePriority ( ) const

inline

Returns whether this link is a major link.

Returns: Whether the link has a large priority

Definition at line 324 of file MSLink.h.

References myState.

Referenced by MSLaneChanger::changeOpposite(), MSVehicle::checkRewindLinkLanes(), GUILane::drawGL(), MSVehicle::executeMove(), MESegment::getLinkPenalty(), TraCI_Lane::getLinks(), MESegment::getMaxPenaltySeconds(), MESegment::isOpen(), lastWasContMajor(), MSVehicle::nextLinkPriority(), opened(), and MSEdge::recalcCache().

bool MSLink::haveRed ( ) const

inline

Returns whether this link is blocked by a red (or redyellow) traffic light.

Returns: Whether the link has a red light

Definition at line 331 of file MSLink.h.

References LINKSTATE_TL_RED, LINKSTATE_TL_REDYELLOW, and myState.

Referenced by MSLaneChanger::changeOpposite(), MSVehicle::executeMove(), MSPModel_Striping::PState::ignoreRed(), MSVehicle::ignoreRed(), and opened().

bool MSLink::haveYellow ( ) const

inline

Definition at line 335 of file MSLink.h.

References LINKSTATE_TL_YELLOW_MAJOR, LINKSTATE_TL_YELLOW_MINOR, and myState.

Referenced by MSLaneChanger::changeOpposite(), MSVehicle::executeMove(), and MSVehicle::ignoreRed().

void MSLink::initParallelLinks ( )

initialize parallel links (to be called after all links are loaded)

Definition at line 1042 of file MSLink.cpp.

References computeParallelLink(), myParallelLeft, and myParallelRight.

Referenced by getFoeLinks().

bool MSLink::isBlockingAnyone ( ) const

inline

Definition at line 242 of file MSLink.h.

References hasApproachingFoe(), myApproachingVehicles, and willHaveBlockedFoe().

bool MSLink::isCont ( ) const

inline

Definition at line 372 of file MSLink.h.

References myAmCont.

Referenced by MSVehicle::checkRewindLinkLanes(), MSVehicle::executeMove(), and setRequestInformation().

bool MSLink::isExitLink ( ) const

return whether the fromLane of this link is an internal lane and toLane is a normal lane

Definition at line 673 of file MSLink.cpp.

References EDGEFUNC_NORMAL, MSLane::getEdge(), MSEdge::getFunction(), getInternalLaneBefore(), MSGlobals::gUsingInternalLanes, and myLane.

Referenced by fromInternalLane(), and keepClear().

bool MSLink::isInternalJunctionLink ( ) const

return whether the fromLane and the toLane of this link are internal lanes

Definition at line 695 of file MSLink.cpp.

References getInternalLaneBefore(), and myInternalLane.

Referenced by fromInternalLane(), and keepClear().

bool MSLink::isLeader	(	const MSVehicle *	ego,
		const MSVehicle *	foe
	)		const

Definition at line 944 of file MSLink.cpp.

References MSJunction::isLeader(), and myJunction.

Referenced by MSVehicle::checkLinkLeader(), keepClear(), and GUIVehicle::selectBlockingFoes().

bool MSLink::isTLSControlled ( ) const

inline

Definition at line 339 of file MSLink.h.

References myLogic.

Referenced by MESegment::getLinkPenalty(), and MESegment::getTLSCapacity().

bool MSLink::keepClear ( ) const

inline

whether the junction after this link must be kept clear

Definition at line 378 of file MSLink.h.

References fromInternalLane(), getCorrespondingExitLink(), getInternalLaneBefore(), getInternalLengthsAfter(), getInternalLengthsBefore(), getLaneBefore(), getLeaderInfo(), getLeaveTime(), getLengthBeforeCrossing(), getLengthsBeforeCrossing(), getParallelLink(), getViaLane(), getViaLaneOrLane(), getZipperSpeed(), isExitLink(), isInternalJunctionLink(), isLeader(), lastWasContMajor(), myKeepClear, passedJunction(), and writeApproaching().

Referenced by MSVehicle::keepClear().

bool MSLink::lastWasContMajor ( ) const

whether this is a link past an internal junction which currently has priority

Definition at line 530 of file MSLink.cpp.

References MSLinkContHelper::getConnectingLink(), MSLane::getEdge(), MSLane::getLogicalPredecessorLane(), havePriority(), MSEdge::isInternal(), myAmCont, and myInternalLane.

Referenced by MSVehicle::executeMove(), and keepClear().

bool MSLink::maybeOccupied ( MSLane * lane )

staticprivate

returns whether the given lane may still be occupied by a vehicle currently on it

Definition at line 478 of file MSLink.cpp.

References MSVehicle::getBackPositionOnLane(), MSVehicle::getCarFollowModel(), MSLane::getLastAnyVehicle(), MSLane::getLength(), MSCFModel::getMaxDecel(), and MSVehicle::getSpeed().

Referenced by unsafeMergeSpeeds().

bool MSLink::opened	(	SUMOTime	arrivalTime,
		double	arrivalSpeed,
		double	leaveSpeed,
		double	vehicleLength,
		double	impatience,
		double	decel,
		SUMOTime	waitingTime,
		double	posLat = `0`,
		std::vector< const SUMOVehicle * > *	collectFoes = `0`,
		bool	ignoreRed = `false`,
		const SUMOVehicle *	ego = `0`
	)		const

Returns the information whether the link may be passed.

Valid after the junctions have set their reponds

Parameters

[in] collectFoes If a vector is passed, all blocking foes are collected and inserted into this vector

Returns: Whether this link may be passed.

Definition at line 313 of file MSLink.cpp.

References blockedByFoe(), gDebugFlag1, Named::getID(), SUMOVehicle::getID(), MSLane::getIndex(), getLane(), SUMOVehicle::getLateralPositionOnLane(), getLeaveTime(), getViaLaneOrLane(), MSGlobals::gLateralResolution, MSGlobals::gUseMesoSim, MSGlobals::gUsingInternalLanes, havePriority(), haveRed(), LINKSTATE_ALLWAY_STOP, LINKSTATE_STOP, LINKSTATE_ZIPPER, myAmCont, myApproachingVehicles, myFoeLinks, myLane, myState, mySublaneFoeLinks, and SIMTIME.

Referenced by MSVehicle::checkRewindLinkLanes(), MSVehicle::executeMove(), getApproaching(), TraCI_Lane::getLinks(), MESegment::isOpen(), MSPModel_Striping::moveInDirectionOnLane(), and GUIVehicle::selectBlockingFoes().

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

private

invalidated assignment operator

void MSLink::passedJunction ( const MSVehicle * vehicle )

erase vehicle from myLinkLeaders of this links junction

Definition at line 936 of file MSLink.cpp.

References myJunction, and MSJunction::passedJunction().

Referenced by MSVehicle::executeMove(), and keepClear().

void MSLink::removeApproaching ( const SUMOVehicle * veh )

removes the vehicle from myApproachingVehicles

Definition at line 289 of file MSLink.cpp.

References myApproachingVehicles.

Referenced by MSVehicle::executeMove(), getWalkingAreaFoe(), and MEVehicle::replaceRoute().

void MSLink::setApproaching	(	const SUMOVehicle *	approaching,
		const SUMOTime	arrivalTime,
		const double	arrivalSpeed,
		const double	leaveSpeed,
		const bool	setRequest,
		const SUMOTime	arrivalTimeBraking,
		const double	arrivalSpeedBraking,
		const SUMOTime	waitingTime,
		double	dist
	)

Sets the information about an approaching vehicle.

The information is stored in myApproachingVehicles.

Definition at line 261 of file MSLink.cpp.

References getLeaveTime(), MSVehicleType::getLength(), SUMOVehicle::getVehicleType(), and myApproachingVehicles.

Referenced by MSVehicle::checkRewindLinkLanes(), getWalkingAreaFoe(), and MELoop::setApproaching().

void MSLink::setGreenFraction ( const double fraction )

inline

Sets the green fraction for passing a tls-controlled link (meso)

Definition at line 484 of file MSLink.h.

References myGreenFraction.

void MSLink::setMesoTLSPenalty ( const SUMOTime penalty )

inline

Sets the time penalty for passing a tls-controlled link (meso)

Definition at line 479 of file MSLink.h.

References myMesoTLSPenalty.

void MSLink::setRequestInformation	(	int	index,
		bool	hasFoes,
		bool	isCont,
		const std::vector< MSLink * > &	foeLinks,
		const std::vector< MSLane * > &	foeLanes,
		MSLane *	internalLaneBefore = `0`
	)

Sets the request information.

Because traffic lights and junction logics are loaded after links, we have to assign the information about the right-of-way requests and responses after the initialisation.

Todo:: Unsecure!

Definition at line 97 of file MSLink.cpp.

References fromInternalLane(), MSLane::getEdge(), MSEdge::getFromJunction(), Named::getID(), MSLane::getIncomingLanes(), getLastIntersections(), MSLane::getLength(), MSLane::getLinkCont(), MSLane::getLogicalPredecessorLane(), MSLane::getShape(), getViaLaneOrLane(), MSLane::getWidth(), MSGlobals::gLateralResolution, hasFoes(), MSLane::interpolateGeometryPosToLanePos(), PositionVector::intersectsAtLengths2D(), isCont(), MSEdge::isInternal(), myAmCont, myFoeLanes, myFoeLinks, myHasFoes, myIndex, myInternalLaneBefore, myJunction, myLane, myLaneBefore, myLengthsBehindCrossing, mySublaneFoeLanes, mySublaneFoeLinks, NUMERICAL_EPS, and toString().

Referenced by MSRightOfWayJunction::postloadInit().

void MSLink::setTLState	(	LinkState	state,
		SUMOTime	t
	)

Sets the current tl-state.

Parameters

[in]	state	The current state of the link
[in]	t	The time of the state change

Definition at line 516 of file MSLink.cpp.

References myLastStateChange, and myState.

Referenced by MSTrafficLightLogic::addLink(), and getLastStateChange().

static bool MSLink::unsafeMergeSpeeds	(	double	leaderSpeed,
		double	followerSpeed,
		double	leaderDecel,
		double	followerDecel
	)

inlinestaticprivate

return whether the given vehicles may NOT merge safely

Definition at line 505 of file MSLink.h.

References blockedByFoe(), computeParallelLink(), couldBrakeForLeader(), and maybeOccupied().

Referenced by blockedByFoe().

bool MSLink::willHaveBlockedFoe ( ) const

Definition at line 278 of file MSLink.cpp.

References myBlockedFoeLinks.

Referenced by isBlockingAnyone().

void MSLink::writeApproaching	(	OutputDevice &	od,
		const std::string	fromLaneID
	)		const

write information about all approaching vehicles to the given output device

Definition at line 549 of file MSLink.cpp.

References MSLink::ApproachingVehicleInformation::arrivalSpeed, MSLink::ApproachingVehicleInformation::arrivalSpeedBraking, MSLink::ApproachingVehicleInformation::arrivalTime, MSLink::ApproachingVehicleInformation::arrivalTimeBraking, OutputDevice::closeTag(), Named::getID(), getLane(), getViaLane(), MSLink::ApproachingVehicleInformation::leaveSpeed, MSLink::ApproachingVehicleInformation::leavingTime, myApproachingVehicles, OutputDevice::openTag(), SUMO_ATTR_FROM, SUMO_ATTR_ID, SUMO_ATTR_IMPATIENCE, SUMO_ATTR_TO, SUMO_ATTR_VIA, time2string(), toString(), MSLink::ApproachingVehicleInformation::willPass, and OutputDevice::writeAttr().

Referenced by keepClear().

Field Documentation

bool MSLink::myAmCont

private

Definition at line 562 of file MSLink.h.

Referenced by isCont(), lastWasContMajor(), opened(), and setRequestInformation().

std::map<const SUMOVehicle*, ApproachingVehicleInformation> MSLink::myApproachingVehicles

private

Definition at line 528 of file MSLink.h.

Referenced by blockedAtTime(), getApproaching(), isBlockingAnyone(), opened(), removeApproaching(), setApproaching(), and writeApproaching().

std::set<MSLink*> MSLink::myBlockedFoeLinks

private

Definition at line 529 of file MSLink.h.

Referenced by addBlockedLink(), and willHaveBlockedFoe().

LinkDirection MSLink::myDirection

private

An abstract (hopefully human readable) definition of the link's direction.

Definition at line 547 of file MSLink.h.

Referenced by getDirection().

std::vector<const MSLane*> MSLink::myFoeLanes

private

Definition at line 589 of file MSLink.h.

Referenced by getFoeLanes(), getLeaderInfo(), getLengthBeforeCrossing(), hasApproachingFoe(), and setRequestInformation().

std::vector<MSLink*> MSLink::myFoeLinks

private

Definition at line 588 of file MSLink.h.

Referenced by getFoeLinks(), getZipperSpeed(), hasApproachingFoe(), opened(), and setRequestInformation().

double MSLink::myFoeVisibilityDistance

private

distance from which an approaching vehicle is able to see all relevant foes and may accelerate if the link is minor and no foe is approaching. Defaults to 4.5m.

Definition at line 556 of file MSLink.h.

Referenced by getFoeVisibilityDistance().

double MSLink::myGreenFraction

private

green fraction at tls for mesoscopic simulation

Definition at line 578 of file MSLink.h.

Referenced by getGreenFraction(), and setGreenFraction().

bool MSLink::myHasFoes

private

Whether any foe links exist.

Definition at line 559 of file MSLink.h.

Referenced by hasFoes(), and setRequestInformation().