The car-following model abstraction. More...

#include <MSCFModel.h>

Inheritance diagram for MSCFModel:

Collaboration diagram for MSCFModel:

Data Structures
class	VehicleVariables

Public Types
enum	CalcReason { CURRENT , FUTURE , CURRENT_WAIT , LANE_CHANGE }
	What the return value of stop/follow/free-Speed is used for. More...

Public Member Functions
double	calculateEmergencyDeceleration (double gap, double egoSpeed, double predSpeed, double predMaxDecel) const
	Returns the minimal deceleration for following the given leader safely. More...

virtual double	distAfterTime (double t, double speed, double accel) const
	calculates the distance travelled after accelerating for time t More...

double	estimateSpeedAfterDistance (const double dist, const double v, const double accel) const

double	getApparentDecel () const
	Get the vehicle type's apparent deceleration [m/s^2] (the one regarded by its followers. More...

double	getCollisionMinGapFactor () const
	Get the factor of minGap that must be maintained to avoid a collision event. More...

double	getEmergencyDecel () const
	Get the vehicle type's maximal phisically possible deceleration [m/s^2]. More...

double	getMaxAccel () const
	Get the vehicle type's maximum acceleration [m/s^2]. More...

double	getMaxDecel () const
	Get the vehicle type's maximal comfortable deceleration [m/s^2]. More...

double	getMinimalArrivalSpeed (double dist, double currentSpeed) const
	Computes the minimal possible arrival speed after covering a given distance. More...

double	getMinimalArrivalSpeedEuler (double dist, double currentSpeed) const
	Computes the minimal possible arrival speed after covering a given distance for Euler update. More...

SUMOTime	getMinimalArrivalTime (double dist, double currentSpeed, double arrivalSpeed) const
	Computes the minimal time needed to cover a distance given the desired speed at arrival. More...

virtual std::string	getParameter (const MSVehicle *veh, const std::string &key) const
	try to get the given parameter for this carFollowingModel More...

SUMOTime	getStartupDelay () const
	Get the vehicle type's startupDelay. More...

double	maximumSafeFollowSpeed (double gap, double egoSpeed, double predSpeed, double predMaxDecel, bool onInsertion=false) const
	Returns the maximum safe velocity for following the given leader. More...

double	maximumSafeStopSpeed (double gap, double decel, double currentSpeed, bool onInsertion=false, double headway=-1, bool relaxEmergency=true) const
	Returns the maximum next velocity for stopping within gap. More...

double	maximumSafeStopSpeedBallistic (double gap, double decel, double currentSpeed, bool onInsertion=false, double headway=-1) const
	Returns the maximum next velocity for stopping within gap when using the ballistic positional update. More...

double	maximumSafeStopSpeedEuler (double gap, double decel, bool onInsertion, double headway) const
	Returns the maximum next velocity for stopping within gap when using the semi-implicit Euler update. More...

	MSCFModel (const MSVehicleType *vtype)
	Constructor. More...

virtual void	setParameter (MSVehicle *veh, const std::string &key, const std::string &value) const
	try to set the given parameter for this carFollowingModel More...

virtual	~MSCFModel ()
	Destructor. More...

Methods to override by model implementation
virtual double	finalizeSpeed (MSVehicle *const veh, double vPos) const
	Applies interaction with stops and lane changing model influences. Called at most once per simulation step (exactcly once per action step) More...

virtual double	patchSpeedBeforeLC (const MSVehicle *veh, double vMin, double vMax) const
	apply custom speed adaptations within the given speed bounds More...

virtual double	applyStartupDelay (const MSVehicle *veh, const double vMin, const double vMax, const SUMOTime addTime=0) const
	apply speed adaptation on startup More...

virtual double	freeSpeed (const MSVehicle *const veh, double speed, double seen, double maxSpeed, const bool onInsertion=false, const CalcReason usage=CalcReason::CURRENT) const
	Computes the vehicle's safe speed without a leader. More...

virtual double	followSpeed (const MSVehicle const veh, double speed, double gap2pred, double predSpeed, double predMaxDecel, const MSVehicle const pred=0, const CalcReason usage=CalcReason::CURRENT) const =0
	Computes the vehicle's follow speed (no dawdling) More...

virtual double	insertionFollowSpeed (const MSVehicle const veh, double speed, double gap2pred, double predSpeed, double predMaxDecel, const MSVehicle const pred=0) const
	Computes the vehicle's safe speed (no dawdling) This method is used during the insertion stage. Whereas the method followSpeed returns the desired speed which may be lower than the safe speed, this method only considers safety constraints. More...

double	stopSpeed (const MSVehicle *const veh, const double speed, double gap, const CalcReason usage=CalcReason::CURRENT) const
	Computes the vehicle's safe speed for approaching a non-moving obstacle (no dawdling) More...

virtual double	stopSpeed (const MSVehicle *const veh, const double speed, double gap, double decel, const CalcReason usage=CalcReason::CURRENT) const =0
	Computes the vehicle's safe speed for approaching a non-moving obstacle (no dawdling) More...

virtual double	insertionStopSpeed (const MSVehicle *const veh, double speed, double gap) const
	Computes the vehicle's safe speed for approaching an obstacle at insertion without constraints due to acceleration capabilities and previous speeds. More...

virtual double	followSpeedTransient (double duration, const MSVehicle *const veh, double speed, double gap2pred, double predSpeed, double predMaxDecel) const
	Computes the vehicle's follow speed that avoids a collision for the given amount of time. More...

virtual double	interactionGap (const MSVehicle *const veh, double vL) const
	Returns the maximum gap at which an interaction between both vehicles occurs. More...

virtual double	maximumLaneSpeedCF (const MSVehicle *const veh, double maxSpeed, double maxSpeedLane) const
	Returns the maximum velocity the CF-model wants to achieve in the next step. More...

virtual int	getModelID () const =0
	Returns the model's ID; the XML-Tag number is used. More...

virtual MSCFModel *	duplicate (const MSVehicleType *vtype) const =0
	Duplicates the car-following model. More...

virtual VehicleVariables *	createVehicleVariables () const
	Returns model specific values which are stored inside a vehicle and must be used with casting. More...

Virtual methods with default implementation
virtual double	getImperfection () const
	Get the driver's imperfection. More...

virtual double	getHeadwayTime () const
	Get the driver's desired headway [s]. More...

virtual bool	startupDelayStopped () const
	whether startupDelay should be applied after stopping More...

Setter methods
virtual void	setMaxAccel (double accel)
	Sets a new value for maximum acceleration [m/s^2]. More...

virtual void	setMaxDecel (double decel)
	Sets a new value for maximal comfortable deceleration [m/s^2]. More...

virtual void	setEmergencyDecel (double decel)
	Sets a new value for maximal physically possible deceleration [m/s^2]. More...

virtual void	setApparentDecel (double decel)
	Sets a new value for the apparent deceleration [m/s^2]. More...

void	setCollisionMinGapFactor (const double factor)
	Sets a new value for the factor of minGap that must be maintained to avoid a collision event. More...

virtual void	setImperfection (double imperfection)
	Sets a new value for driver imperfection. More...

virtual void	setHeadwayTime (double headwayTime)
	Sets a new value for desired headway [s]. More...

Static Public Member Functions
static double	avoidArrivalAccel (double dist, double time, double speed, double maxDecel)
	Computes the acceleration needed to arrive not before the given time. More...

static double	estimateArrivalTime (double dist, double initialSpeed, double arrivalSpeed, double maxSpeed, double accel, double decel)
	Computes the time needed to travel a distance dist given an initial speed, arrival speed, constant acceleration and deceleration. The speed during traveling is assumed not to exceed the max speed. More...

static double	estimateArrivalTime (double dist, double speed, double maxSpeed, double accel)
	Computes the time needed to travel a distance dist given an initial speed and constant acceleration. The speed during traveling is assumed not to exceed the max speed. More...

static double	gapExtrapolation (const double duration, const double currentGap, double v1, double v2, double a1=0, double a2=0, const double maxV1=std::numeric_limits< double >::max(), const double maxV2=std::numeric_limits< double >::max())
	return the resulting gap if, starting with gap currentGap, two vehicles continue with constant accelerations (velocities bounded by 0 and maxSpeed) for a given timespan of length 'duration'. More...

static double	passingTime (const double lastPos, const double passedPos, const double currentPos, const double lastSpeed, const double currentSpeed)
	Calculates the time at which the position passedPosition has been passed In case of a ballistic update, the possibility of a stop within a time step requires more information about the last time-step than in case of the euler update to determine the last position if the currentSpeed is zero. More...

static double	speedAfterTime (const double t, const double oldSpeed, const double dist)
	Calculates the speed after a time t \in [0,TS] given the initial speed and the distance traveled in an interval of step length TS. More...

Protected Member Functions
void	applyHeadwayAndSpeedDifferencePerceptionErrors (const MSVehicle const veh, double speed, double &gap, double &predSpeed, double predMaxDecel, const MSVehicle const pred) const
	Overwrites gap2pred and predSpeed by the perceived values obtained from the vehicle's driver state,. More...

void	applyHeadwayPerceptionError (const MSVehicle *const veh, double speed, double &gap) const
	Overwrites gap by the perceived value obtained from the vehicle's driver state. More...

void	applyOwnSpeedPerceptionError (const MSVehicle *const veh, double &speed) const
	Overwrites sped by the perceived values obtained from the vehicle's driver state,. More...

Protected Attributes
double	myAccel
	The vehicle's maximum acceleration [m/s^2]. More...

double	myApparentDecel
	The vehicle's deceleration as expected by surrounding traffic [m/s^2]. More...

double	myCollisionMinGapFactor
	The factor of minGap that must be maintained to avoid a collision event. More...

double	myDecel
	The vehicle's maximum deceleration [m/s^2]. More...

double	myEmergencyDecel
	The vehicle's maximum emergency deceleration [m/s^2]. More...

double	myHeadwayTime
	The driver's desired time headway (aka reaction time tau) [s]. More...

SUMOTime	myStartupDelay
	The startup delay after halting [s]. More...

const MSVehicleType *	myType
	The type to which this model definition belongs to. More...

Currently fixed methods
virtual double	maxNextSpeed (double speed, const MSVehicle *const veh) const
	Returns the maximum speed given the current speed. More...

virtual double	maxNextSafeMin (double speed, const MSVehicle *const veh=0) const
	Returns the maximum speed given the current speed and regarding driving dynamics. More...

virtual double	minNextSpeed (double speed, const MSVehicle *const veh=0) const
	Returns the minimum speed given the current speed (depends on the numerical update scheme and its step width) Note that it wouldn't have to depend on the numerical update scheme if the semantics would rely on acceleration instead of velocity. More...

virtual double	minNextSpeedEmergency (double speed, const MSVehicle *const veh=0) const
	Returns the minimum speed after emergency braking, given the current speed (depends on the numerical update scheme and its step width) Note that it wouldn't have to depend on the numerical update scheme if the semantics would rely on acceleration instead of velocity. More...

double	brakeGap (const double speed) const
	Returns the distance the vehicle needs to halt including driver's reaction time tau (i.e. desired headway), assuming that during the reaction time, the speed remains constant. More...

virtual double	brakeGap (const double speed, const double decel, const double headwayTime) const

virtual double	getSecureGap (const MSVehicle const veh, const MSVehicle const, const double speed, const double leaderSpeed, const double leaderMaxDecel) const
	Returns the minimum gap to reserve if the leader is braking at maximum (>=0) More...

virtual double	getSpeedAfterMaxDecel (double v) const
	Returns the velocity after maximum deceleration. More...

static double	brakeGapEuler (const double speed, const double decel, const double headwayTime)

static double	freeSpeed (const double currentSpeed, const double decel, const double dist, const double maxSpeed, const bool onInsertion, const double actionStepLength)

Detailed Description

The car-following model abstraction.

MSCFModel is an interface for different car following Models to implement. It provides methods to compute a vehicles velocity for a simulation step.

Definition at line 55 of file MSCFModel.h.

Member Enumeration Documentation

◆ CalcReason

enum MSCFModel::CalcReason

What the return value of stop/follow/free-Speed is used for.

Enumerator
CURRENT	the return value is used for calculating the next speed
FUTURE	the return value is used for calculating future speeds
CURRENT_WAIT	the return value is used for calculating junction stop speeds
LANE_CHANGE	the return value is used for lane change calculations

Definition at line 77 of file MSCFModel.h.

Constructor & Destructor Documentation

◆ MSCFModel()

MSCFModel::MSCFModel ( const MSVehicleType * vtype )

Constructor.

Parameters

[in] vtype the type for which this model is built and also the parameter object to configure this model

Definition at line 55 of file MSCFModel.cpp.

◆ ~MSCFModel()

MSCFModel::~MSCFModel ( )

virtual

Destructor.

Definition at line 68 of file MSCFModel.cpp.

Member Function Documentation

◆ applyHeadwayAndSpeedDifferencePerceptionErrors()

void MSCFModel::applyHeadwayAndSpeedDifferencePerceptionErrors	(	const MSVehicle *const	veh,
		double	speed,
		double &	gap,
		double &	predSpeed,
		double	predMaxDecel,
		const MSVehicle *const	pred
	)		const

protected

Overwrites gap2pred and predSpeed by the perceived values obtained from the vehicle's driver state,.

See also: MSCFModel_Krauss::stopSpeed() and MSCFModel_Krauss::followSpeed() for integration into a CF model

Parameters

[in]	veh	The vehicle (EGO)
[in]	speed	The vehicle's speed
[in,out]	gap2pred	The (netto) distance to the LEADER
[in,out]	predSpeed	The speed of LEADER
[in]	pred	The leading vehicle (LEADER)

Definition at line 1063 of file MSCFModel.cpp.

References DEBUG_COND, followSpeed(), MSVehicle::getDriverState(), Named::getID(), MSVehicle::hasDriverState(), SIMTIME, SPEED2ACCEL, and UNUSED_PARAMETER.

Referenced by MSCFModel_CACC::followSpeed(), MSCFModel_IDM::followSpeed(), and MSCFModel_Krauss::followSpeed().

Here is the caller graph for this function:

◆ applyHeadwayPerceptionError()

void MSCFModel::applyHeadwayPerceptionError	(	const MSVehicle *const	veh,
		double	speed,
		double &	gap
	)		const

protected

Overwrites gap by the perceived value obtained from the vehicle's driver state.

Parameters

[in]	veh	The vehicle (EGO)
[in]	speed	The vehicle's speed
[in,out]	gap	The (netto) distance to the the obstacle

Definition at line 1099 of file MSCFModel.cpp.

References DEBUG_COND, MSVehicle::getDriverState(), Named::getID(), MSVehicle::hasDriverState(), SIMTIME, SPEED2ACCEL, stopSpeed(), and UNUSED_PARAMETER.

Referenced by MSCFModel_IDM::stopSpeed(), MSCFModel_CACC::stopSpeed(), and MSCFModel_Krauss::stopSpeed().

Here is the caller graph for this function:

◆ applyOwnSpeedPerceptionError()

void MSCFModel::applyOwnSpeedPerceptionError	(	const MSVehicle *const	veh,
		double &	speed
	)		const

protected

Overwrites sped by the perceived values obtained from the vehicle's driver state,.

See also: MSCFModel_Krauss::freeSpeed()

Parameters

[in]	veh	The vehicle (EGO)
[in,out]	speed	The vehicle's speed

Definition at line 1054 of file MSCFModel.cpp.

References MSVehicle::getDriverState(), and MSVehicle::hasDriverState().

Referenced by maximumLaneSpeedCF(), and MSCFModel_CACC::maximumLaneSpeedCF().

Here is the caller graph for this function:

◆ applyStartupDelay()

double MSCFModel::applyStartupDelay	(	const MSVehicle *	veh,
		const double	vMin,
		const double	vMax,
		const SUMOTime	addTime = `0`
	)		const

virtual

apply speed adaptation on startup

Definition at line 257 of file MSCFModel.cpp.

References DELTA_T, MSVehicle::getSpeed(), MSVehicle::getTimeSinceStartup(), myStartupDelay, SUMO_const_haltingSpeed, and UNUSED_PARAMETER.

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

Here is the caller graph for this function:

◆ avoidArrivalAccel()

double MSCFModel::avoidArrivalAccel	(	double	dist,
		double	time,
		double	speed,
		double	maxDecel
	)

static

Computes the acceleration needed to arrive not before the given time.

Parameters

[in]	dist	- the distance of the critical point
[in]	time	- the time after which an arrival at dist is allowed
[in]	speed	- the current speed

Returns: Returns the acceleration which would ensure an arrival at distance dist earliest for the given time

Definition at line 521 of file MSCFModel.cpp.

Referenced by MSLCM_SL2015::commitManoeuvre().

Here is the caller graph for this function:

◆ brakeGap() [1/2]

double MSCFModel::brakeGap ( const double speed ) const

inline

Returns the distance the vehicle needs to halt including driver's reaction time tau (i.e. desired headway), assuming that during the reaction time, the speed remains constant.

Parameters

[in] speed The vehicle's current speed

Returns: The distance needed to halt

Definition at line 380 of file MSCFModel.h.

References myDecel, and myHeadwayTime.

Referenced by MSCFModel_Wiedemann::_v(), MSLCM_LC2013::_wantsChange(), MSLCM_SL2015::_wantsChangeSublane(), MSVehicle::adaptToOncomingLeader(), MSPModel_Striping::addCrossingVehs(), MSLane::addLeaders(), MSCFModel_EIDM::brakeGap(), MSLCHelper::canSaveBlockerLength(), MSLaneChanger::checkChange(), MSLane::checkFailure(), MSVehicle::checkReversal(), MSVehicle::checkRewindLinkLanes(), MSLaneChanger::computeSafeOppositeLength(), distAfterTime(), followSpeedTransient(), MSVehicle::getBrakeGap(), MSLaneChanger::getColumnleader(), MSLane::getCriticalLeader(), MSVehicle::getFollower(), LIBSUMO_NAMESPACE::Vehicle::getJunctionFoes(), MSLane::getLeader(), MSVehicle::getLeader(), MSLink::getLeaderInfo(), MSLane::getLeaderOnConsecutive(), MSLane::getLeadersOnConsecutive(), MSLaneChanger::getRealLeader(), getSecureGap(), MSLink::getZipperSpeed(), MSLane::handleCollisionBetween(), MSLane::handleIntermodalCollisionBetween(), MSIdling_Stop::idle(), MSLCM_SL2015::informLeader(), MSLCM_LC2013::informLeader(), MSLane::isInsertionSuccess(), MSVehicle::isLeader(), MSLane::lastInsertion(), maximumSafeFollowSpeed(), GUIBaseVehicle::GUIBaseVehiclePopupMenu::onCmdToggleStop(), MSVehicle::planMoveInternal(), MSLCM_SL2015::preventSliding(), MSVehicle::processLinkApproaches(), MSVehicle::unsafeLinkAhead(), MSVehicle::updateBestLanes(), and MSLCHelper::updateBlockerLength().

Here is the caller graph for this function:

◆ brakeGap() [2/2]

double MSCFModel::brakeGap	(	const double	speed,
		const double	decel,
		const double	headwayTime
	)		const

virtual

Reimplemented in MSCFModel_EIDM.

Definition at line 75 of file MSCFModel.cpp.

References brakeGapEuler(), and MSGlobals::gSemiImplicitEulerUpdate.

◆ brakeGapEuler()

double MSCFModel::brakeGapEuler	(	const double	speed,
		const double	decel,
		const double	headwayTime
	)

static

Definition at line 90 of file MSCFModel.cpp.

References ACCEL2SPEED, and SPEED2DIST.

Referenced by brakeGap(), and MSLCM_SL2015::computeSpeedLat().

Here is the caller graph for this function:

◆ calculateEmergencyDeceleration()

double MSCFModel::calculateEmergencyDeceleration	(	double	gap,
		double	egoSpeed,
		double	predSpeed,
		double	predMaxDecel
	)		const

Returns the minimal deceleration for following the given leader safely.

Parameters

[in]	gap	The (netto) distance to the LEADER
[in]	egoSpeed	The FOLLOWERS's speed
[in]	predSpeed	The LEADER's speed
[in]	predMaxDecel	The LEADER's maximum deceleration

Returns: The minimal deceleration b>0 that, if applied constantly until a full stop, asserts that the vehicle does not crash into the leader.

Note: If b > predMaxDecel, this function actually does not calculate the tangency for the trajectories, i.e. a double root for the gap, but applies a simpler approach following the spirit of maximumSafeFollowSpeed, where the leader's decel is assumed as maximum of its actual value and the followers decel.

Definition at line 1002 of file MSCFModel.cpp.

References DEBUG_COND2, myEmergencyDecel, and SIMTIME.

Referenced by maximumSafeFollowSpeed(), MSCFModel_EIDM::maximumSafeFollowSpeed(), and maximumSafeStopSpeed().

Here is the caller graph for this function:

◆ createVehicleVariables()

virtual VehicleVariables* MSCFModel::createVehicleVariables ( ) const

inlinevirtual

Returns model specific values which are stored inside a vehicle and must be used with casting.

Reimplemented in MSCFModel_Wiedemann, MSCFModel_SmartSK, MSCFModel_Rail, MSCFModel_PWag2009, MSCFModel_Krauss, MSCFModel_Kerner, MSCFModel_IDM, MSCFModel_EIDM, MSCFModel_CC, MSCFModel_CACC, and MSCFModel_ACC.

Definition at line 247 of file MSCFModel.h.

Referenced by MSVehicle::MSVehicle(), and MSVehicle::replaceVehicleType().

Here is the caller graph for this function:

◆ distAfterTime()

double MSCFModel::distAfterTime	(	double	t,
		double	speed,
		double	accel
	)		const

virtual

calculates the distance travelled after accelerating for time t

Definition at line 403 of file MSCFModel.cpp.

References ACCEL2SPEED, brakeGap(), MSGlobals::gSemiImplicitEulerUpdate, MAX2(), SPEED2DIST, and TS.

Referenced by followSpeedTransient().

Here is the caller graph for this function:

◆ duplicate()

virtual MSCFModel* MSCFModel::duplicate ( const MSVehicleType * vtype ) const

pure virtual

Duplicates the car-following model.

Parameters

[in] vtype The vehicle type this model belongs to (1:1)

Returns: A duplicate of this car-following model

Implemented in MSCFModel_Wiedemann, MSCFModel_W99, MSCFModel_SmartSK, MSCFModel_Rail, MSCFModel_PWag2009, MSCFModel_KraussX, MSCFModel_KraussPS, MSCFModel_KraussOrig1, MSCFModel_Krauss, MSCFModel_Kerner, MSCFModel_IDM, MSCFModel_EIDM, MSCFModel_Daniel1, MSCFModel_CC, MSCFModel_CACC, and MSCFModel_ACC.

Referenced by MSVehicleType::duplicateType().

Here is the caller graph for this function:

◆ estimateArrivalTime() [1/2]

double MSCFModel::estimateArrivalTime	(	double	dist,
		double	initialSpeed,
		double	arrivalSpeed,
		double	maxSpeed,
		double	accel,
		double	decel
	)

static

Computes the time needed to travel a distance dist given an initial speed, arrival speed, constant acceleration and deceleration. The speed during traveling is assumed not to exceed the max speed.

Parameters

[in]	dist	Distance to be covered (assumed >= 0.)
[in]	initialSpeed	Initial speed of vehicle
[in]	arrivalSpeed	desired arrival speed of vehicle
[in]	accel	Assumed acceleration until reaching maxspeed.
[in]	accel	Assumed deceleration until reaching targetspeed.

Returns: Returns the estimated time needed to cover the given distance If distance will never be covered with the given parameters INVALID_DOUBLE (from MSLink.h) is returned.

Note: Currently, this is still a stub for actually very special situations in LC context: It is assumed that 0==initialSpeed==arrivalSpeed<=maxspeed, accel==decel>0 (because currently this is only used for lane change purposes, where lateral accel == lateral decel)

Definition at line 489 of file MSCFModel.cpp.

References UNUSED_PARAMETER.

◆ estimateArrivalTime() [2/2]

double MSCFModel::estimateArrivalTime	(	double	dist,
		double	speed,
		double	maxSpeed,
		double	accel
	)

static

Computes the time needed to travel a distance dist given an initial speed and constant acceleration. The speed during traveling is assumed not to exceed the max speed.

Parameters

[in]	dist	Distance to be covered (assumed >= 0.)
[in]	speed	Initial speed of vehicle
[in]	accel	Assumed acceleration until reaching maxspeed or speed=0.

Returns: Returns the estimated time needed to cover the given distance If distance will never be covered with the given parameters INVALID_DOUBLE (from MSLink.h) is returned.

Definition at line 450 of file MSCFModel.cpp.

References INVALID_DOUBLE.

Referenced by MSLCM_SL2015::commitManoeuvre(), and MSDevice_SSM::estimateConflictTimes().

Here is the caller graph for this function:

◆ estimateSpeedAfterDistance()

double MSCFModel::estimateSpeedAfterDistance	(	const double	dist,
		const double	v,
		const double	accel
	)		const

Definition at line 765 of file MSCFModel.cpp.

References MSVehicleType::getMaxSpeed(), MAX2(), MIN2(), and myType.

Referenced by getMinimalArrivalSpeed(), getMinimalArrivalSpeedEuler(), MSLink::getZipperSpeed(), and MSVehicle::planMoveInternal().

Here is the caller graph for this function:

◆ finalizeSpeed()

double MSCFModel::finalizeSpeed	(	MSVehicle *const	veh,
		double	vPos
	)		const

virtual

Applies interaction with stops and lane changing model influences. Called at most once per simulation step (exactcly once per action step)

Parameters

[in]	veh	The ego vehicle
[in]	vPos	The possible velocity

Returns: The velocity after applying interactions with stops and lane change model influences

Reimplemented in MSCFModel_Wiedemann, MSCFModel_SmartSK, MSCFModel_Rail, MSCFModel_PWag2009, MSCFModel_Kerner, MSCFModel_IDM, MSCFModel_EIDM, MSCFModel_Daniel1, and MSCFModel_CC.

Definition at line 187 of file MSCFModel.cpp.

References ACCEL2SPEED, applyStartupDelay(), DEBUG_COND, MSVehicle::getActionStepLengthSecs(), MSVehicle::getFriction(), Named::getID(), MSVehicle::getLane(), MSVehicle::getLaneChangeModel(), MSVehicle::getSpeed(), MSLane::getVehicleMaxSpeed(), gPrecision, MAX2(), maxNextSpeed(), MIN2(), MIN3(), minNextSpeed(), minNextSpeedEmergency(), MSAbstractLaneChangeModel::patchSpeed(), patchSpeedBeforeLC(), MSVehicle::processNextStop(), and SIMTIME.

Referenced by MSVehicle::executeMove(), MSCFModel_CC::finalizeSpeed(), MSCFModel_IDM::finalizeSpeed(), MSCFModel_Kerner::finalizeSpeed(), MSCFModel_PWag2009::finalizeSpeed(), MSCFModel_Rail::finalizeSpeed(), MSCFModel_SmartSK::finalizeSpeed(), and MSCFModel_Wiedemann::finalizeSpeed().

Here is the caller graph for this function:

◆ followSpeed()

virtual double MSCFModel::followSpeed	(	const MSVehicle *const	veh,
		double	speed,
		double	gap2pred,
		double	predSpeed,
		double	predMaxDecel,
		const MSVehicle *const	pred = `0`,
		const CalcReason	usage = `CalcReason::CURRENT`
	)		const

pure virtual

Computes the vehicle's follow speed (no dawdling)

Returns the velocity of the vehicle in dependence to the vehicle's and its leader's values and the distance between them.

Parameters

[in]	veh	The vehicle (EGO)
[in]	speed	The vehicle's speed
[in]	gap2pred	The (netto) distance to the LEADER
[in]	predSpeed	The speed of LEADER
[in]	usage	What the return value is used for

Returns: EGO's safe speed

Implemented in MSCFModel_Wiedemann, MSCFModel_W99, MSCFModel_SmartSK, MSCFModel_Rail, MSCFModel_PWag2009, MSCFModel_KraussOrig1, MSCFModel_Krauss, MSCFModel_Kerner, MSCFModel_IDM, MSCFModel_EIDM, MSCFModel_Daniel1, MSCFModel_CC, MSCFModel_CACC, and MSCFModel_ACC.

Referenced by MSLCM_LC2013::_wantsChange(), MSVehicle::adaptToJunctionLeader(), MSVehicle::adaptToLeader(), MSLCM_LC2013::anticipateFollowSpeed(), applyHeadwayAndSpeedDifferencePerceptionErrors(), MSLCM_SL2015::checkStrategicChange(), MSLCM_SL2015::commitFollowSpeed(), MSCFModel_CC::followSpeed(), MSVehicle::Influencer::gapControlSpeed(), LIBSUMO_NAMESPACE::Vehicle::getFollowSpeed(), MSLCHelper::getSpeedPreservingSecureGap(), MSLink::getZipperSpeed(), MSLCM_DK2008::informBlocker(), MSLCM_SL2015::informFollower(), MSLCM_LC2013::informFollower(), MSLCM_SL2015::informLeader(), MSLCM_SL2015::updateExpectedSublaneSpeeds(), MSLCM_DK2008::wantsChangeToLeft(), and MSLCM_DK2008::wantsChangeToRight().

Here is the caller graph for this function:

◆ followSpeedTransient()

double MSCFModel::followSpeedTransient	(	double	duration,
		const MSVehicle *const	veh,
		double	speed,
		double	gap2pred,
		double	predSpeed,
		double	predMaxDecel
	)		const

virtual

Computes the vehicle's follow speed that avoids a collision for the given amount of time.

Returns the velocity of the vehicle in dependence to the vehicle's and its leader's values and the distance between them.

Parameters

[in]	veh	The vehicle (EGO)
[in]	speed	The vehicle's speed
[in]	gap2pred	The (netto) distance to the LEADER
[in]	predSpeed	The speed of LEADER
[in]	predMaxDecel	The maximum leader decelration

Returns: EGO's safe speed

Definition at line 353 of file MSCFModel.cpp.

References ACCEL2SPEED, brakeGap(), DIST2SPEED, distAfterTime(), gDebugFlag2, getMaxDecel(), MSGlobals::gSemiImplicitEulerUpdate, myDecel, SPEED2DIST, and TS.

Referenced by MSLCM_SL2015::commitFollowSpeed().

Here is the caller graph for this function:

◆ freeSpeed() [1/2]

double MSCFModel::freeSpeed	(	const double	currentSpeed,
		const double	decel,
		const double	dist,
		const double	maxSpeed,
		const bool	onInsertion,
		const double	actionStepLength
	)

static

Definition at line 100 of file MSCFModel.cpp.

References ACCEL2DIST, ACCEL2SPEED, DIST2SPEED, MSGlobals::gSemiImplicitEulerUpdate, MAX2(), SPEED2DIST, and TS.

◆ freeSpeed() [2/2]

double MSCFModel::freeSpeed	(	const MSVehicle *const	veh,
		double	speed,
		double	seen,
		double	maxSpeed,
		const bool	onInsertion = `false`,
		const CalcReason	usage = `CalcReason::CURRENT`
	)		const

virtual

Computes the vehicle's safe speed without a leader.

Returns the velocity of the vehicle in dependence to the length of the free street and the target velocity at the end of the free range. If onInsertion is true, the vehicle may still brake before the next movement.

Parameters

[in]	veh	The vehicle (EGO)
[in]	speed	The vehicle's speed
[in]	seen	The look ahead distance
[in]	maxSpeed	The maximum allowed speed
[in]	onInsertion	whether speed at insertion is asked for
[in]	usage	What the return value is used for

Returns: EGO's safe speed

Reimplemented in MSCFModel_IDM, MSCFModel_EIDM, MSCFModel_CC, MSCFModel_CACC, and MSCFModel_Rail.

Definition at line 321 of file MSCFModel.cpp.

References MSVehicle::getActionStepLengthSecs(), and myDecel.

Referenced by MSCFModel_CACC::freeSpeed(), MSCFModel_CC::freeSpeed(), MSLane::isInsertionSuccess(), and MSVehicle::planMoveInternal().

Here is the caller graph for this function:

◆ gapExtrapolation()

double MSCFModel::gapExtrapolation	(	const double	duration,
		const double	currentGap,
		double	v1,
		double	v2,
		double	a1 = `0`,
		double	a2 = `0`,
		const double	maxV1 = `std::numeric_limits<double>::max()`,
		const double	maxV2 = `std::numeric_limits<double>::max()`
	)

static

return the resulting gap if, starting with gap currentGap, two vehicles continue with constant accelerations (velocities bounded by 0 and maxSpeed) for a given timespan of length 'duration'.

Parameters

[in]	currentGap	(pos(veh1) - pos(veh2) at start)
[in]	v1	initial speed of vehicle 1
[in]	v2	initial speed of vehicle 2
[in]	a1	acceleration of vehicle 1
[in]	a2	acceleration of vehicle 2
[in]	maxV1	maximal speed of vehicle 1
[in]	maxV2	maximal speed of vehicle 2
[in]	duration	time span for the process

Returns: estimated gap after 'duration' seconds

Definition at line 564 of file MSCFModel.cpp.

References MSGlobals::gSemiImplicitEulerUpdate, MAX2(), MIN2(), and TS.

Referenced by MSLCM_SL2015::checkBlockingVehicles(), and MSLCM_LC2013::informFollower().

Here is the caller graph for this function:

◆ getApparentDecel()

double MSCFModel::getApparentDecel ( ) const

inline

Get the vehicle type's apparent deceleration [m/s^2] (the one regarded by its followers.

Returns: The apparent deceleration (in m/s^2) of vehicles of this class

Definition at line 280 of file MSCFModel.h.

References myApparentDecel.

Referenced by MSVehicle::getCurrentApparentDecel(), and MSVehicleType::setApparentDecel().

Here is the caller graph for this function:

◆ getCollisionMinGapFactor()

double MSCFModel::getCollisionMinGapFactor ( ) const

inline

Get the factor of minGap that must be maintained to avoid a collision event.

Definition at line 293 of file MSCFModel.h.

References myCollisionMinGapFactor.

Referenced by MSLane::detectCollisionBetween().

Here is the caller graph for this function:

◆ getEmergencyDecel()

double MSCFModel::getEmergencyDecel ( ) const

inline

Get the vehicle type's maximal phisically possible deceleration [m/s^2].

Returns: The maximal physically possible deceleration (in m/s^2) of vehicles of this class

Definition at line 272 of file MSCFModel.h.

References myEmergencyDecel.

Referenced by MSLane::checkFailure(), MSLCM_SL2015::commitManoeuvre(), MSCFModel_EIDM::finalizeSpeed(), MSLink::getZipperSpeed(), MSLane::handleCollisionBetween(), MSLane::handleIntermodalCollisionBetween(), MSVehicle::planMoveInternal(), and MSVehicleType::setEmergencyDecel().

Here is the caller graph for this function:

◆ getHeadwayTime()

virtual double MSCFModel::getHeadwayTime ( ) const

inlinevirtual

Get the driver's desired headway [s].

Returns: The desired headway of this class' drivers in s

Definition at line 311 of file MSCFModel.h.

References myHeadwayTime.

Referenced by MSVehicleType::check(), MSLaneChanger::checkChange(), MSVehicle::checkRewindLinkLanes(), MSLaneChanger::computeSurplusGap(), MSVehicle::Influencer::gapControlSpeed(), getMinimalArrivalSpeed(), getMinimalArrivalSpeedEuler(), MSVehicle::isLeader(), LIBSUMO_NAMESPACE::Vehicle::openGap(), MESegment::receive(), MSCalibrator::remainingVehicleCapacity(), MSDevice_ToC::requestToC(), MESegment::send(), MSVehicleType::setTau(), and MSVehicle::updateBestLanes().

Here is the caller graph for this function:

◆ getImperfection()

virtual double MSCFModel::getImperfection ( ) const

inlinevirtual

Get the driver's imperfection.

Returns: The imperfection of drivers of this class

Reimplemented in MSCFModel_SmartSK, MSCFModel_PWag2009, MSCFModel_KraussOrig1, and MSCFModel_Daniel1.

Definition at line 303 of file MSCFModel.h.

Referenced by MSVehicleType::setImperfection().

Here is the caller graph for this function:

◆ getMaxAccel()

double MSCFModel::getMaxAccel ( ) const

inline

Get the vehicle type's maximum acceleration [m/s^2].

Returns: The maximum acceleration (in m/s^2) of vehicles of this class

Definition at line 256 of file MSCFModel.h.

References myAccel.

Referenced by MSVehicle::accelThresholdForWaiting(), MSDevice_GLOSA::adaptSpeed(), MSVehicle::adaptToLeaders(), MSLCM_LC2013::anticipateFollowSpeed(), MSLaneChanger::checkOppositeStop(), MSLCM_SL2015::commitManoeuvre(), MSLaneChanger::computeOvertakingTime(), MSDevice_GLOSA::distance_at_continuous_accel(), MSDevice_GLOSA::earliest_arrival(), MSVehicle::estimateTimeToNextStop(), MSLaneChanger::getMaxOvertakingSpeed(), getMinimalArrivalTime(), MSLink::getZipperSpeed(), MSVehicle::isLeader(), maxNextSpeed(), MSCFModel_CC::maxNextSpeed(), MSCFModel_KraussPS::maxNextSpeed(), MSVehicle::planMoveInternal(), MSVehicleType::setAccel(), MSDevice_ToC::setState(), MSDevice_GLOSA::time_to_junction_at_continuous_accel(), MSLCM_SL2015::updateExpectedSublaneSpeeds(), and MSMeanData_Emissions::MSLaneMeanDataValues::write().

Here is the caller graph for this function:

◆ getMaxDecel()

double MSCFModel::getMaxDecel ( ) const

inline

Get the vehicle type's maximal comfortable deceleration [m/s^2].

Returns: The maximal comfortable deceleration (in m/s^2) of vehicles of this class

Definition at line 264 of file MSCFModel.h.

References myDecel.

Referenced by MSLCM_LC2013::_wantsChange(), MSDevice_GLOSA::adaptSpeed(), MSLCM_LC2013::adaptSpeedToPedestrians(), MSVehicle::adaptToOncomingLeader(), MSPModel_Striping::addCrossingVehs(), MSCriticalFollowerDistanceInfo::addFollower(), MSLCM_LC2013::anticipateFollowSpeed(), MSLink::blockedByFoe(), MSLCHelper::canSaveBlockerLength(), MSLCM_SL2015::checkBlockingVehicles(), MSLaneChanger::checkChange(), MSLane::checkForPedestrians(), MSVehicle::checkRewindLinkLanes(), MSLCM_SL2015::checkStrategicChange(), MSLCM_SL2015::commitFollowSpeed(), MSLink::computeFoeArrivalTimeBraking(), MSLaneChanger::computeOvertakingTime(), MSLaneChanger::computeSafeOppositeLength(), MSLink::couldBrakeForLeader(), MSVehicle::estimateTimeToNextStop(), followSpeedTransient(), MSLane::freeInsertion(), MSLaneChanger::getColumnleader(), MSLane::getCriticalLeader(), MSLane::getLeaderOnConsecutive(), MSLaneChanger::getMaxOvertakingSpeed(), getMinimalArrivalSpeed(), getMinimalArrivalSpeedEuler(), getMinimalArrivalTime(), MSLane::getMissingRearGap(), LIBSUMO_NAMESPACE::Vehicle::getNeighbors(), MSLCHelper::getSpeedPreservingSecureGap(), MSLink::getZipperSpeed(), MSLCM_DK2008::informBlocker(), MSLCM_SL2015::informFollower(), MSLCM_LC2013::informFollower(), MSLCM_SL2015::informLeader(), MSLCM_LC2013::informLeader(), MSLane::insertVehicle(), MSLane::isInsertionSuccess(), MSVehicle::isLeader(), MESegment::isOpen(), MSLane::lastInsertion(), MSCFModel_KraussPS::maxNextSpeed(), MSDevice_Bluelight::notifyMove(), MSLCM_LC2013::overtakeDistance(), MSVehicle::planMoveInternal(), MSVehicle::processLinkApproaches(), MSVehicle::processNextStop(), MSAbstractLaneChangeModel::remainingTime(), MSLane::safeInsertionSpeed(), GUIVehicle::selectBlockingFoes(), MSVehicleType::setDecel(), MSAbstractLaneChangeModel::setFollowerGaps(), MSAbstractLaneChangeModel::setLeaderGaps(), MSAbstractLaneChangeModel::setOrigLeaderGaps(), MSLCM_LC2013::slowDownForBlocked(), MSLCM_SL2015::slowDownForBlocked(), MSVehicle::slowDownForSchedule(), MSLCHelper::updateBlockerLength(), MSLCM_SL2015::updateExpectedSublaneSpeeds(), MSVehicle::updateState(), MSVehicleControl::vehicleDeparted(), MSLCM_DK2008::wantsChangeToLeft(), and MSLCM_DK2008::wantsChangeToRight().

◆ getMinimalArrivalSpeed()

double MSCFModel::getMinimalArrivalSpeed	(	double	dist,
		double	currentSpeed
	)		const

Computes the minimal possible arrival speed after covering a given distance.

Parameters

[in]	dist	Distance to be covered
[in]	currentSpeed	Actual speed of vehicle

Definition at line 538 of file MSCFModel.cpp.

References estimateSpeedAfterDistance(), getHeadwayTime(), and getMaxDecel().

Referenced by MSVehicle::planMoveInternal().

Here is the caller graph for this function:

◆ getMinimalArrivalSpeedEuler()

double MSCFModel::getMinimalArrivalSpeedEuler	(	double	dist,
		double	currentSpeed
	)		const

Computes the minimal possible arrival speed after covering a given distance for Euler update.

Parameters

[in]	dist	Distance to be covered
[in]	currentSpeed	Actual speed of vehicle

Definition at line 545 of file MSCFModel.cpp.

References estimateSpeedAfterDistance(), getHeadwayTime(), getMaxDecel(), and INVALID_SPEED.

Referenced by MSVehicle::planMoveInternal(), and MSVehicle::registerInsertionApproach().

Here is the caller graph for this function:

◆ getMinimalArrivalTime()

SUMOTime MSCFModel::getMinimalArrivalTime	(	double	dist,
		double	currentSpeed,
		double	arrivalSpeed
	)		const

Computes the minimal time needed to cover a distance given the desired speed at arrival.

Parameters

[in]	dist	Distance to be covered
[in]	currentSpeed	Actual speed of vehicle
[in]	arrivalSpeed	Desired speed at arrival

Definition at line 429 of file MSCFModel.cpp.

References getMaxAccel(), getMaxDecel(), MAX3(), SUMO_const_haltingSpeed, and TIME2STEPS.

Referenced by MSVehicle::getArrivalTime().

Here is the caller graph for this function:

◆ getModelID()

virtual int MSCFModel::getModelID ( ) const

pure virtual

Returns the model's ID; the XML-Tag number is used.

Returns: The model's ID

Implemented in MSCFModel_Wiedemann, MSCFModel_W99, MSCFModel_SmartSK, MSCFModel_Rail, MSCFModel_PWag2009, MSCFModel_KraussX, MSCFModel_KraussPS, MSCFModel_KraussOrig1, MSCFModel_Krauss, MSCFModel_Kerner, MSCFModel_IDM, MSCFModel_EIDM, MSCFModel_Daniel1, MSCFModel_CC, MSCFModel_CACC, and MSCFModel_ACC.

Referenced by MSCFModel_CACC::getSecureGap(), and MSCFModel_CACC::speedGapControl().

Here is the caller graph for this function:

◆ getParameter()

virtual std::string MSCFModel::getParameter	(	const MSVehicle *	veh,
		const std::string &	key
	)		const

inlinevirtual

try to get the given parameter for this carFollowingModel

Parameters

[in]	veh	the vehicle from which the parameter must be retrieved
[in]	key	the key of the parameter

Returns: the value of the requested parameter

Reimplemented in MSCFModel_CC, and MSCFModel_CACC.

Definition at line 646 of file MSCFModel.h.

References UNUSED_PARAMETER.

Referenced by MSBaseVehicle::getPrefixedParameter().

Here is the caller graph for this function:

◆ getSecureGap()

double MSCFModel::getSecureGap	(	const MSVehicle *const	veh,
		const MSVehicle * const	,
		const double	speed,
		const double	leaderSpeed,
		const double	leaderMaxDecel
	)		const

virtual

Returns the minimum gap to reserve if the leader is braking at maximum (>=0)

Parameters

[in]	veh	The vehicle itself, for obtaining other values
[in]	pred	The leader vehicle, for obtaining other values
[in]	speed	EGO's speed
[in]	leaderSpeed	LEADER's speed
[in]	leaderMaxDecel	LEADER's max. deceleration rate

Reimplemented in MSCFModel_EIDM, MSCFModel_Wiedemann, MSCFModel_IDM, MSCFModel_CACC, and MSCFModel_ACC.

Definition at line 166 of file MSCFModel.cpp.

References brakeGap(), MSGlobals::gComputeLC, MSVehicle::getAcceleration(), MSVehicle::getLaneChangeModel(), MSAbstractLaneChangeModel::getSafetyFactor(), MAX2(), MIN2(), myDecel, and myHeadwayTime.

Referenced by MSLCM_LC2013::_wantsChange(), MSLCM_SL2015::_wantsChangeSublane(), MSCriticalFollowerDistanceInfo::addFollower(), MSLCM_LC2013::anticipateFollowSpeed(), MSLCM_SL2015::checkBlockingVehicles(), MSLaneChanger::checkChange(), MSLCM_SL2015::commitFollowSpeed(), MSLaneChanger::computeOvertakingTime(), MSLane::freeInsertion(), MSLaneChanger::getColumnleader(), MSLane::getMissingRearGap(), LIBSUMO_NAMESPACE::Vehicle::getNeighbors(), MSCFModel_CACC::getSecureGap(), MSCFModel_Wiedemann::getSecureGap(), LIBSUMO_NAMESPACE::Vehicle::getSecureGap(), MSLCHelper::getSpeedPreservingSecureGap(), MSLink::getZipperSpeed(), MSLCM_DK2008::informBlocker(), MSLCM_SL2015::informFollower(), MSLCM_LC2013::informFollower(), MSLCM_SL2015::informLeader(), MSLCM_LC2013::informLeader(), MSLane::insertVehicle(), MSLane::isInsertionSuccess(), MSLane::lastInsertion(), MSLCM_LC2013::overtakeDistance(), MSAbstractLaneChangeModel::setFollowerGaps(), MSAbstractLaneChangeModel::setLeaderGaps(), and MSAbstractLaneChangeModel::setOrigLeaderGaps().

Here is the caller graph for this function:

◆ getSpeedAfterMaxDecel()

virtual double MSCFModel::getSpeedAfterMaxDecel ( double v ) const

inlinevirtual

Returns the velocity after maximum deceleration.

Parameters

[in] v The velocity

Returns: The velocity after maximum deceleration

Reimplemented in MSCFModel_Rail.

Definition at line 403 of file MSCFModel.h.

References ACCEL2SPEED, MAX2(), and myDecel.

Referenced by MSLCM_LC2013::_wantsChange(), MSCFModel_Daniel1::finalizeSpeed(), MSCFModel_SmartSK::followSpeed(), and MSCFModel_SmartSK::stopSpeed().

Here is the caller graph for this function:

◆ getStartupDelay()

SUMOTime MSCFModel::getStartupDelay ( ) const

inline

Get the vehicle type's startupDelay.

Returns: The startupDelay

Definition at line 287 of file MSCFModel.h.

References myStartupDelay.

Referenced by MSVehicle::executeMove().

Here is the caller graph for this function:

◆ insertionFollowSpeed()

double MSCFModel::insertionFollowSpeed	(	const MSVehicle *const	veh,
		double	speed,
		double	gap2pred,
		double	predSpeed,
		double	predMaxDecel,
		const MSVehicle *const	pred = `0`
	)		const

virtual

Computes the vehicle's safe speed (no dawdling) This method is used during the insertion stage. Whereas the method followSpeed returns the desired speed which may be lower than the safe speed, this method only considers safety constraints.

Returns the velocity of the vehicle in dependence to the vehicle's and its leader's values and the distance between them.

Parameters

[in]	veh	The vehicle (EGO)
[in]	speed	The vehicle's speed
[in]	gap2pred	The (netto) distance to the LEADER
[in]	predSpeed	The speed of LEADER

Returns: EGO's safe speed

Reimplemented in MSCFModel_IDM, MSCFModel_EIDM, MSCFModel_CC, MSCFModel_CACC, and MSCFModel_ACC.

Definition at line 332 of file MSCFModel.cpp.

References MSGlobals::gSemiImplicitEulerUpdate, and maximumSafeFollowSpeed().

Referenced by MSLane::freeInsertion(), MSLane::getCriticalLeader(), and MSLane::safeInsertionSpeed().

Here is the caller graph for this function:

◆ insertionStopSpeed()

double MSCFModel::insertionStopSpeed	(	const MSVehicle *const	veh,
		double	speed,
		double	gap
	)		const

virtual

Computes the vehicle's safe speed for approaching an obstacle at insertion without constraints due to acceleration capabilities and previous speeds.

Parameters

[in]	veh	The vehicle (EGO)
[in]	speed	The vehicle's speed
[in]	gap	The (netto) distance to the the obstacle

Returns: EGO's safe speed for approaching a non-moving obstacle at insertion

See also: stopSpeed() and insertionFollowSpeed()

Reimplemented in MSCFModel_IDM, and MSCFModel_EIDM.

Definition at line 343 of file MSCFModel.cpp.

References MSVehicleType::getMaxSpeed(), MSGlobals::gSemiImplicitEulerUpdate, maximumSafeStopSpeed(), MIN2(), myDecel, myType, and stopSpeed().

Referenced by MSCFModel_IDM::insertionStopSpeed(), and MSLane::isInsertionSuccess().

Here is the caller graph for this function:

◆ interactionGap()

double MSCFModel::interactionGap	(	const MSVehicle *const	veh,
		double	vL
	)		const

virtual

Returns the maximum gap at which an interaction between both vehicles occurs.

"interaction" means that the LEADER influences EGO's speed.

Parameters

[in]	veh	The EGO vehicle
[in]	vL	LEADER's speed

Returns: The interaction gap

Todo:: evaluate signature

Reimplemented in MSCFModel_Wiedemann, MSCFModel_W99, MSCFModel_IDM, MSCFModel_EIDM, MSCFModel_CC, MSCFModel_CACC, and MSCFModel_ACC.

Definition at line 277 of file MSCFModel.cpp.

References MSVehicle::getLane(), MSVehicle::getSpeed(), MSLane::getVehicleMaxSpeed(), MAX2(), maxNextSpeed(), MIN2(), myDecel, myHeadwayTime, and SPEED2DIST.

Referenced by MSCFModel_CC::interactionGap(), and MSAbstractLaneChangeModel::predInteraction().

Here is the caller graph for this function:

◆ maximumLaneSpeedCF()

virtual double MSCFModel::maximumLaneSpeedCF	(	const MSVehicle *const	veh,
		double	maxSpeed,
		double	maxSpeedLane
	)		const

inlinevirtual

Returns the maximum velocity the CF-model wants to achieve in the next step.

Parameters

[in]	maxSpeed	The maximum achievable speed in the next step
[in]	maxSpeedLane	The maximum speed the vehicle wants to drive on this lane (Speedlimit*SpeedFactor)

Reimplemented in MSCFModel_EIDM, and MSCFModel_CACC.

Definition at line 224 of file MSCFModel.h.

References applyOwnSpeedPerceptionError(), and MIN2().

Referenced by MSVehicle::planMoveInternal().

Here is the caller graph for this function:

◆ maximumSafeFollowSpeed()

double MSCFModel::maximumSafeFollowSpeed	(	double	gap,
		double	egoSpeed,
		double	predSpeed,
		double	predMaxDecel,
		bool	onInsertion = `false`
	)		const

Returns the maximum safe velocity for following the given leader.

Parameters

[in]	gap2pred	The (netto) distance to the LEADER
[in]	egoSpeed	The FOLLOWERS's speed
[in]	predSpeed	The LEADER's speed
[in]	predMaxDecel	The LEADER's maximum deceleration
[in]	onInsertion	Indicator whether the call is triggered during vehicle insertion

Returns: the safe velocity

Returns the SK-vsafe.

Definition at line 922 of file MSCFModel.cpp.

References ACCEL2SPEED, brakeGap(), calculateEmergencyDeceleration(), DEBUG_COND2, EMERGENCY_DECEL_AMPLIFIER, MSGlobals::gComputeLC, MSGlobals::gSemiImplicitEulerUpdate, MAX2(), maximumSafeStopSpeed(), MIN2(), myDecel, myEmergencyDecel, myHeadwayTime, SIMTIME, and SPEED2ACCEL.

Referenced by MSLCM_LC2013::anticipateFollowSpeed(), MSCFModel_ACC::followSpeed(), MSCFModel_CACC::followSpeed(), MSCFModel_Krauss::followSpeed(), MSCFModel_KraussOrig1::followSpeed(), MSCFModel_CACC::insertionFollowSpeed(), and insertionFollowSpeed().

Here is the caller graph for this function:

◆ maximumSafeStopSpeed()

double MSCFModel::maximumSafeStopSpeed	(	double	gap,
		double	decel,
		double	currentSpeed,
		bool	onInsertion = `false`,
		double	headway = `-1`,
		bool	relaxEmergency = `true`
	)		const

Returns the maximum next velocity for stopping within gap.

Parameters

[in]	gap	The (netto) distance to the desired stopping point
[in]	decel	The desired deceleration rate
[in]	currentSpeed	The current speed of the ego vehicle
[in]	onInsertion	Indicator whether the call is triggered during vehicle insertion
[in]	headway	The desired time headway to be included in the calculations (default argument -1 induces the use of myHeadway)
[in]	relaxEmergency	Whether emergency deceleration should be reduced (at the cost of staying in a dangerous situation for longer)

Definition at line 774 of file MSCFModel.cpp.

References ACCEL2SPEED, calculateEmergencyDeceleration(), EMERGENCY_DECEL_AMPLIFIER, MSGlobals::gSemiImplicitEulerUpdate, MAX2(), maximumSafeStopSpeedBallistic(), maximumSafeStopSpeedEuler(), MIN2(), myDecel, myEmergencyDecel, SIMTIME, and SPEED2ACCEL.

Referenced by MSLCM_LC2013::anticipateFollowSpeed(), MSCFModel_Rail::followSpeed(), MSVehicle::handleCollisionStop(), insertionStopSpeed(), maximumSafeFollowSpeed(), MSVehicle::planMoveInternal(), MSCFModel_IDM::stopSpeed(), MSCFModel_Rail::stopSpeed(), MSCFModel_W99::stopSpeed(), MSCFModel_Wiedemann::stopSpeed(), MSCFModel_ACC::stopSpeed(), MSCFModel_CACC::stopSpeed(), and MSCFModel_Krauss::stopSpeed().

Here is the caller graph for this function:

◆ maximumSafeStopSpeedBallistic()

double MSCFModel::maximumSafeStopSpeedBallistic	(	double	gap,
		double	decel,
		double	currentSpeed,
		bool	onInsertion = `false`,
		double	headway = `-1`
	)		const

Returns the maximum next velocity for stopping within gap when using the ballistic positional update.

Note: This takes into account the driver's reaction time tau (i.e. the desired headway) and the car's current speed. (The latter is required to calculate the distance covered in the following timestep.)

Parameters

[in]	gap	The (netto) distance to the desired stopping point
[in]	decel	The desired deceleration rate
[in]	currentSpeed	The current speed of the ego vehicle
[in]	onInsertion	Indicator whether the call is triggered during vehicle insertion
[in]	headway	The desired time headway to be included in the calculations (default argument -1 induces the use of myHeadway)

Returns: the safe velocity (to be attained at the end of the following time step) that assures the possibility of stopping within gap. If a negative value is returned, the required stop has to take place before the end of the time step.

Definition at line 855 of file MSCFModel.cpp.

References ACCEL2SPEED, MAX2(), myEmergencyDecel, myHeadwayTime, and TS.

Referenced by MSCFModel_EIDM::maximumSafeStopSpeed(), maximumSafeStopSpeed(), and MSCFModel_KraussOrig1::stopSpeed().

Here is the caller graph for this function:

◆ maximumSafeStopSpeedEuler()

double MSCFModel::maximumSafeStopSpeedEuler	(	double	gap,
		double	decel,
		bool	onInsertion,
		double	headway
	)		const

Returns the maximum next velocity for stopping within gap when using the semi-implicit Euler update.

Parameters

[in]	gap	The (netto) distance to the LEADER
[in]	decel	The desired deceleration rate
[in]	onInsertion	Indicator whether the call is triggered during vehicle insertion
[in]	headway	The desired time headway to be included in the calculations (-1 induces the use of myHeadway)

Definition at line 827 of file MSCFModel.cpp.

References ACCEL2SPEED, myHeadwayTime, and TS.

Referenced by maximumSafeStopSpeed().

Here is the caller graph for this function:

◆ maxNextSafeMin()

virtual double MSCFModel::maxNextSafeMin	(	double	speed,
		const MSVehicle *const	veh = `0`
	)		const

inlinevirtual

Returns the maximum speed given the current speed and regarding driving dynamics.

Parameters

[in]	speed	The vehicle's current speed
[in]	speed	The vehicle itself, for obtaining other values

Returns: The maximum possible speed for the next step taking driving dynamics into account

Reimplemented in MSCFModel_EIDM.

Definition at line 347 of file MSCFModel.h.

References maxNextSpeed().

◆ maxNextSpeed()

double MSCFModel::maxNextSpeed	(	double	speed,
		const MSVehicle *const	veh
	)		const

virtual

Returns the maximum speed given the current speed.

The implementation of this method must take into account the time step duration.

Justification: Due to air brake or other influences, the vehicle's next maximum speed may depend on the vehicle's current speed (given).

Parameters

[in]	speed	The vehicle's current speed
[in]	veh	The vehicle itself, for obtaining other values

Returns: The maximum possible speed for the next step

Reimplemented in MSCFModel_Rail, MSCFModel_KraussPS, and MSCFModel_CC.

Definition at line 292 of file MSCFModel.cpp.

References ACCEL2SPEED, getMaxAccel(), MSVehicleType::getMaxSpeed(), MIN2(), and myType.

Referenced by MSCFModel_EIDM::_v(), MSLCM_SL2015::commitManoeuvre(), finalizeSpeed(), MSCFModel_Daniel1::finalizeSpeed(), MSCFModel_EIDM::finalizeSpeed(), MSCFModel_Daniel1::followSpeed(), MSCFModel_Kerner::followSpeed(), MSCFModel_Krauss::followSpeed(), MSCFModel_KraussOrig1::followSpeed(), MSCFModel_SmartSK::followSpeed(), MSLCHelper::getSpeedPreservingSecureGap(), interactionGap(), maxNextSafeMin(), MSLCM_DK2008::patchSpeed(), MSVehicle::planMoveInternal(), MSVehicle::processTraCISpeedControl(), MSCFModel_W99::stopSpeed(), MSCFModel_Wiedemann::stopSpeed(), MSCFModel_ACC::stopSpeed(), MSCFModel_CACC::stopSpeed(), MSCFModel_Daniel1::stopSpeed(), MSCFModel_Kerner::stopSpeed(), MSCFModel_Krauss::stopSpeed(), MSCFModel_KraussOrig1::stopSpeed(), and MSCFModel_SmartSK::stopSpeed().

Here is the caller graph for this function:

◆ minNextSpeed()

double MSCFModel::minNextSpeed	(	double	speed,
		const MSVehicle *const	veh = `0`
	)		const

virtual

Returns the minimum speed given the current speed (depends on the numerical update scheme and its step width) Note that it wouldn't have to depend on the numerical update scheme if the semantics would rely on acceleration instead of velocity.

Parameters

[in]	speed	The vehicle's current speed
[in]	speed	The vehicle itself, for obtaining other values, if needed as e.g. road conditions.

Returns: The minimum possible speed for the next step

Reimplemented in MSCFModel_IDM, MSCFModel_CC, and MSCFModel_Rail.

Definition at line 298 of file MSCFModel.cpp.

References ACCEL2SPEED, MSGlobals::gSemiImplicitEulerUpdate, MAX2(), and myDecel.

Referenced by MSVehicle::checkReversal(), MSLCM_SL2015::commitManoeuvre(), finalizeSpeed(), MSCFModel_EIDM::finalizeSpeed(), MSCFModel_KraussOrig1::followSpeed(), MSLCHelper::getSpeedPreservingSecureGap(), MSLCM_LC2013::informLeader(), MSCFModel_CC::minNextSpeed(), MSVehicle::planMoveInternal(), and MSVehicle::processTraCISpeedControl().

Here is the caller graph for this function:

◆ minNextSpeedEmergency()

double MSCFModel::minNextSpeedEmergency	(	double	speed,
		const MSVehicle *const	veh = `0`
	)		const

virtual

Returns the minimum speed after emergency braking, given the current speed (depends on the numerical update scheme and its step width) Note that it wouldn't have to depend on the numerical update scheme if the semantics would rely on acceleration instead of velocity.

Parameters

[in]	speed	The vehicle's current speed
[in]	speed	The vehicle itself, for obtaining other values, if needed as e.g. road conditions.

Returns: The minimum possible speed for the next step

Reimplemented in MSCFModel_Rail.

Definition at line 309 of file MSCFModel.cpp.

References ACCEL2SPEED, MSGlobals::gSemiImplicitEulerUpdate, MAX2(), and myEmergencyDecel.

Referenced by MSLCM_LC2013::_patchSpeed(), MSLCM_SL2015::_patchSpeed(), finalizeSpeed(), MSCFModel_EIDM::finalizeSpeed(), MSCFModel_Krauss::followSpeed(), and MSVehicle::Influencer::implicitSpeedRemote().

Here is the caller graph for this function:

◆ passingTime()

double MSCFModel::passingTime	(	const double	lastPos,
		const double	passedPos,
		const double	currentPos,
		const double	lastSpeed,
		const double	currentSpeed
	)

static

Calculates the time at which the position passedPosition has been passed In case of a ballistic update, the possibility of a stop within a time step requires more information about the last time-step than in case of the euler update to determine the last position if the currentSpeed is zero.

Parameters

[in]	lastPos	the position at time t=0 (must be < currentPos)
[in]	passedPos	the position for which the passing time is to be determined (has to lie within [lastPos, currentPos]!)
[in]	currentPos	the position at time t=TS (one time-step after lastPos) (must be > lastPos)
[in]	lastSpeed	the speed at moment t=0
[in]	currentSpeed	the speed at moment t=TS

Returns: time t in [0,TS] at which passedPos in [lastPos, currentPos] was passed.

Definition at line 658 of file MSCFModel.cpp.

References MSGlobals::gSemiImplicitEulerUpdate, MAX2(), MIN2(), SPEED2ACCEL, TS, and WRITE_ERROR.

Referenced by MSE2Collector::calculateTimeLossAndTimeOnDetector(), MSDevice_SSM::checkConflictEntryAndExit(), MSInductLoop::notifyMove(), MSInstantInductLoop::notifyMove(), MSMeanData::MeanDataValues::notifyMove(), MSE3Collector::MSE3LeaveReminder::notifyMove(), and MSE3Collector::MSE3EntryReminder::notifyMove().

Here is the caller graph for this function:

◆ patchSpeedBeforeLC()

virtual double MSCFModel::patchSpeedBeforeLC	(	const MSVehicle *	veh,
		double	vMin,
		double	vMax
	)		const

inlinevirtual

apply custom speed adaptations within the given speed bounds

Reimplemented in MSCFModel_SmartSK, MSCFModel_PWag2009, MSCFModel_KraussX, MSCFModel_KraussOrig1, and MSCFModel_Krauss.

Definition at line 102 of file MSCFModel.h.

References UNUSED_PARAMETER.

Referenced by finalizeSpeed().

Here is the caller graph for this function:

◆ setApparentDecel()

virtual void MSCFModel::setApparentDecel ( double decel )

inlinevirtual

Sets a new value for the apparent deceleration [m/s^2].

Parameters

[in] decel The new deceleration in m/s^2

Definition at line 552 of file MSCFModel.h.

References myApparentDecel.

Referenced by MSVehicleType::setApparentDecel().

Here is the caller graph for this function:

◆ setCollisionMinGapFactor()

void MSCFModel::setCollisionMinGapFactor ( const double factor )

inline

Sets a new value for the factor of minGap that must be maintained to avoid a collision event.

Parameters

[in] factor The new minGap factor

Definition at line 559 of file MSCFModel.h.

References myCollisionMinGapFactor.

Referenced by MSDevice_Bluelight::notifyMove().

Here is the caller graph for this function:

◆ setEmergencyDecel()

virtual void MSCFModel::setEmergencyDecel ( double decel )

inlinevirtual

Sets a new value for maximal physically possible deceleration [m/s^2].

Parameters

[in] decel The new deceleration in m/s^2

Definition at line 544 of file MSCFModel.h.

References myEmergencyDecel.

Referenced by MSCFModel_Rail::MSCFModel_Rail(), and MSVehicleType::setEmergencyDecel().

Here is the caller graph for this function:

◆ setHeadwayTime()

virtual void MSCFModel::setHeadwayTime ( double headwayTime )

inlinevirtual

Sets a new value for desired headway [s].

Parameters

[in] headwayTime The new desired headway (in s)

Reimplemented in MSCFModel_SmartSK, MSCFModel_KraussOrig1, MSCFModel_Daniel1, and MSCFModel_CACC.

Definition at line 574 of file MSCFModel.h.

References myHeadwayTime.

Referenced by MSVehicle::Influencer::gapControlSpeed(), MSCFModel_CACC::MSCFModel_CACC(), MSCFModel_CACC::setHeadwayTime(), and MSVehicleType::setTau().

Here is the caller graph for this function:

◆ setImperfection()

virtual void MSCFModel::setImperfection ( double imperfection )

inlinevirtual

Sets a new value for driver imperfection.

Parameters

[in] accel The new driver imperfection

Reimplemented in MSCFModel_SmartSK, MSCFModel_KraussOrig1, and MSCFModel_Daniel1.

Definition at line 566 of file MSCFModel.h.

References UNUSED_PARAMETER.

Referenced by MSVehicleType::setImperfection().

Here is the caller graph for this function:

◆ setMaxAccel()

virtual void MSCFModel::setMaxAccel ( double accel )

inlinevirtual

Sets a new value for maximum acceleration [m/s^2].

Parameters

[in] accel The new acceleration in m/s^2

Definition at line 528 of file MSCFModel.h.

References myAccel.

Referenced by MSVehicleType::setAccel(), and MSDevice_ToC::setState().

Here is the caller graph for this function:

◆ setMaxDecel()

virtual void MSCFModel::setMaxDecel ( double decel )

inlinevirtual

Sets a new value for maximal comfortable deceleration [m/s^2].

Parameters

[in] decel The new deceleration in m/s^2

Reimplemented in MSCFModel_SmartSK, MSCFModel_KraussOrig1, and MSCFModel_Daniel1.

Definition at line 536 of file MSCFModel.h.

References myDecel.

Referenced by MSLCM_SL2015::commitFollowSpeed(), MSCFModel_Rail::MSCFModel_Rail(), and MSVehicleType::setDecel().

Here is the caller graph for this function:

◆ setParameter()

virtual void MSCFModel::setParameter	(	MSVehicle *	veh,
		const std::string &	key,
		const std::string &	value
	)		const

inlinevirtual

try to set the given parameter for this carFollowingModel

Parameters

[in]	veh	the vehicle for which the parameter must be set
[in]	key	the key of the parameter
[in]	value	the value to be set for the given parameter

Reimplemented in MSCFModel_CC, and MSCFModel_CACC.

Definition at line 659 of file MSCFModel.h.

References UNUSED_PARAMETER.

Referenced by MSBaseVehicle::setCarFollowModelParameter().

Here is the caller graph for this function:

◆ speedAfterTime()

double MSCFModel::speedAfterTime	(	const double	t,
		const double	oldSpeed,
		const double	dist
	)

static

Calculates the speed after a time t \in [0,TS] given the initial speed and the distance traveled in an interval of step length TS.

Note: If the acceleration were known, this would be much nicer, but in this way we need to reconstruct it (for the ballistic update at least, where we assume that a stop may occur within the interval)

Parameters

[in]	t	time in [0,TS] for which the speed shall be determined
[in]	oldSpeed	speed before the last time step (referred to as t == 0)
[in]	distance	covered

Returns: speed at time t

Definition at line 736 of file MSCFModel.cpp.

References DIST2SPEED, MSGlobals::gSemiImplicitEulerUpdate, and TS.

Referenced by MSE2Collector::calculateTimeLossAndTimeOnDetector(), MSInstantInductLoop::notifyMove(), and MSMeanData::MeanDataValues::notifyMove().

Here is the caller graph for this function:

◆ startupDelayStopped()

virtual bool MSCFModel::startupDelayStopped ( ) const

inlinevirtual

whether startupDelay should be applied after stopping

Reimplemented in MSCFModel_Rail.

Definition at line 316 of file MSCFModel.h.

◆ stopSpeed() [1/2]

double MSCFModel::stopSpeed	(	const MSVehicle *const	veh,
		const double	speed,
		double	gap,
		const CalcReason	usage = `CalcReason::CURRENT`
	)		const

inline

Computes the vehicle's safe speed for approaching a non-moving obstacle (no dawdling)

Returns the velocity of the vehicle when approaching a static object (such as the end of a lane) assuming no reaction time is needed.

Parameters

[in]	veh	The vehicle (EGO)
[in]	speed	The vehicle's speed
[in]	gap	The (netto) distance to the the obstacle
[in]	usage	What the return value is used for

Returns: EGO's safe speed for approaching a non-moving obstacle

Todo:: generic Interface, models can call for the values they need

Definition at line 168 of file MSCFModel.h.

References myDecel.

Referenced by MSLCM_LC2013::_patchSpeed(), MSLCM_SL2015::_patchSpeed(), MSLCM_LC2013::adaptSpeedToPedestrians(), MSVehicle::adaptToJunctionLeader(), MSVehicle::adaptToLeader(), MSVehicle::adaptToOncomingLeader(), applyHeadwayPerceptionError(), MSLane::checkForPedestrians(), LIBSUMO_NAMESPACE::Vehicle::getStopSpeed(), MSLCM_SL2015::informLeader(), MSLCM_LC2013::informLeader(), MSLCM_SL2015::informLeaders(), insertionStopSpeed(), MSLane::isInsertionSuccess(), MSLCM_DK2008::patchSpeed(), MSVehicle::planMoveInternal(), MSVehicle::processNextStop(), and MSCFModel_CC::stopSpeed().

Here is the caller graph for this function:

◆ stopSpeed() [2/2]

virtual double MSCFModel::stopSpeed	(	const MSVehicle *const	veh,
		const double	speed,
		double	gap,
		double	decel,
		const CalcReason	usage = `CalcReason::CURRENT`
	)		const

pure virtual

Computes the vehicle's safe speed for approaching a non-moving obstacle (no dawdling)

Returns the velocity of the vehicle when approaching a static object (such as the end of a lane) assuming no reaction time is needed.

Parameters

[in]	veh	The vehicle (EGO)
[in]	speed	The vehicle's speed
[in]	gap	The (netto) distance to the the obstacle
[in]	decel	The desired deceleration rate
[in]	usage	What the return value is used for

Returns: EGO's safe speed for approaching a non-moving obstacle

Todo:: generic Interface, models can call for the values they need

Implemented in MSCFModel_SmartSK, MSCFModel_PWag2009, MSCFModel_KraussOrig1, MSCFModel_Krauss, MSCFModel_Kerner, MSCFModel_Daniel1, MSCFModel_CC, MSCFModel_CACC, MSCFModel_ACC, MSCFModel_Wiedemann, MSCFModel_W99, MSCFModel_Rail, MSCFModel_IDM, and MSCFModel_EIDM.

Field Documentation

◆ myAccel

double MSCFModel::myAccel

protected

The vehicle's maximum acceleration [m/s^2].

Definition at line 698 of file MSCFModel.h.

Referenced by MSCFModel_EIDM::_v(), MSCFModel_IDM::_v(), MSCFModel_Kerner::_v(), MSCFModel_Wiedemann::_v(), MSCFModel_CC::createVehicleVariables(), MSCFModel_Daniel1::dawdle(), MSCFModel_KraussOrig1::dawdle(), MSCFModel_SmartSK::dawdle(), MSCFModel_Krauss::dawdle2(), MSCFModel_KraussX::dawdleX(), MSCFModel_PWag2009::followSpeed(), MSCFModel_Wiedemann::fullspeed(), getMaxAccel(), MSCFModel_EIDM::getSecureGap(), MSCFModel_EIDM::interactionGap(), MSCFModel_IDM::interactionGap(), MSCFModel_EIDM::internalsecuregap(), MSCFModel_EIDM::maximumSafeFollowSpeed(), MSCFModel_EIDM::maximumSafeStopSpeed(), MSCFModel_SmartSK::MSCFModel_SmartSK(), MSCFModel_W99::MSCFModel_W99(), MSCFModel_EIDM::patchSpeedBeforeLCEIDM(), setMaxAccel(), MSCFModel_CC::setParameter(), MSCFModel_EIDM::slowToStartTerm(), and MSCFModel_PWag2009::stopSpeed().

◆ myApparentDecel

double MSCFModel::myApparentDecel

protected

The vehicle's deceleration as expected by surrounding traffic [m/s^2].

Definition at line 705 of file MSCFModel.h.

Referenced by getApparentDecel(), and setApparentDecel().

◆ myCollisionMinGapFactor

double MSCFModel::myCollisionMinGapFactor

protected

The factor of minGap that must be maintained to avoid a collision event.

Definition at line 707 of file MSCFModel.h.

Referenced by MSCFModel_W99::followSpeed(), getCollisionMinGapFactor(), MSCFModel_ACC::MSCFModel_ACC(), MSCFModel_CACC::MSCFModel_CACC(), MSCFModel_EIDM::MSCFModel_EIDM(), MSCFModel_IDM::MSCFModel_IDM(), MSCFModel_Kerner::MSCFModel_Kerner(), MSCFModel_PWag2009::MSCFModel_PWag2009(), MSCFModel_W99::MSCFModel_W99(), MSCFModel_Wiedemann::MSCFModel_Wiedemann(), and setCollisionMinGapFactor().

◆ myDecel

double MSCFModel::myDecel

protected

The vehicle's maximum deceleration [m/s^2].

Definition at line 701 of file MSCFModel.h.

Referenced by MSCFModel_EIDM::_v(), MSCFModel_Kerner::_v(), MSCFModel_Wiedemann::_v(), MSCFModel_SmartSK::_vsafe(), MSCFModel_Daniel1::_vsafe(), brakeGap(), MSCFModel_EIDM::brakeGap(), MSCFModel_CC::createVehicleVariables(), MSCFModel_PWag2009::followSpeed(), MSCFModel_Rail::followSpeed(), followSpeedTransient(), MSCFModel_Rail::freeSpeed(), freeSpeed(), MSCFModel_EIDM::freeSpeed(), MSCFModel_IDM::freeSpeed(), getMaxDecel(), getSecureGap(), MSCFModel_EIDM::getSecureGap(), getSpeedAfterMaxDecel(), insertionStopSpeed(), MSCFModel_EIDM::insertionStopSpeed(), MSCFModel_IDM::insertionStopSpeed(), interactionGap(), MSCFModel_EIDM::interactionGap(), MSCFModel_IDM::interactionGap(), MSCFModel_EIDM::internalsecuregap(), maximumSafeFollowSpeed(), MSCFModel_EIDM::maximumSafeFollowSpeed(), maximumSafeStopSpeed(), minNextSpeed(), MSCFModel_IDM::minNextSpeed(), MSCFModel_SmartSK::MSCFModel_SmartSK(), MSCFModel_Daniel1::setHeadwayTime(), MSCFModel_KraussOrig1::setHeadwayTime(), MSCFModel_SmartSK::setHeadwayTime(), setMaxDecel(), MSCFModel_Daniel1::setMaxDecel(), MSCFModel_KraussOrig1::setMaxDecel(), MSCFModel_SmartSK::setMaxDecel(), MSCFModel_CC::setParameter(), stopSpeed(), MSCFModel_PWag2009::stopSpeed(), and MSCFModel_KraussOrig1::vsafe().

◆ myEmergencyDecel

double MSCFModel::myEmergencyDecel

protected

The vehicle's maximum emergency deceleration [m/s^2].

Definition at line 703 of file MSCFModel.h.

Referenced by MSCFModel_Wiedemann::_v(), calculateEmergencyDeceleration(), MSCFModel_Wiedemann::emergency(), getEmergencyDecel(), maximumSafeFollowSpeed(), MSCFModel_EIDM::maximumSafeFollowSpeed(), maximumSafeStopSpeed(), maximumSafeStopSpeedBallistic(), MSCFModel_IDM::minNextSpeed(), minNextSpeedEmergency(), and setEmergencyDecel().

◆ myHeadwayTime

double MSCFModel::myHeadwayTime

protected

The driver's desired time headway (aka reaction time tau) [s].

Definition at line 710 of file MSCFModel.h.

Referenced by MSCFModel_EIDM::_v(), MSCFModel_ACC::_v(), MSCFModel_IDM::_v(), MSCFModel_CACC::_v(), MSCFModel_ACC::accelGapControl(), brakeGap(), MSCFModel_SmartSK::createVehicleVariables(), MSCFModel_PWag2009::followSpeed(), getHeadwayTime(), MSCFModel_ACC::getSecureGap(), MSCFModel_CACC::getSecureGap(), MSCFModel_IDM::getSecureGap(), getSecureGap(), MSCFModel_EIDM::getSecureGap(), MSCFModel_IDM::insertionFollowSpeed(), MSCFModel_EIDM::insertionStopSpeed(), interactionGap(), MSCFModel_EIDM::internalsecuregap(), maximumSafeFollowSpeed(), MSCFModel_EIDM::maximumSafeFollowSpeed(), maximumSafeStopSpeedBallistic(), maximumSafeStopSpeedEuler(), MSCFModel_W99::MSCFModel_W99(), MSCFModel_EIDM::patchSpeedBeforeLCEIDM(), setHeadwayTime(), MSCFModel_CACC::setHeadwayTime(), MSCFModel_Daniel1::setHeadwayTime(), MSCFModel_KraussOrig1::setHeadwayTime(), MSCFModel_SmartSK::setHeadwayTime(), MSCFModel_Daniel1::setMaxDecel(), MSCFModel_KraussOrig1::setMaxDecel(), MSCFModel_SmartSK::setMaxDecel(), MSCFModel_CACC::speedGapControl(), MSCFModel_PWag2009::stopSpeed(), and MSCFModel_SmartSK::updateMyHeadway().

◆ myStartupDelay

SUMOTime MSCFModel::myStartupDelay

protected

The startup delay after halting [s].

Definition at line 713 of file MSCFModel.h.

Referenced by applyStartupDelay(), MSCFModel_EIDM::finalizeSpeed(), getStartupDelay(), and MSCFModel_EIDM::slowToStartTerm().

◆ myType

const MSVehicleType* MSCFModel::myType

protected

The type to which this model definition belongs to.

Definition at line 695 of file MSCFModel.h.

Referenced by MSCFModel_EIDM::_v(), MSCFModel_IDM::_v(), MSCFModel_Wiedemann::_v(), MSCFModel_W99::computeThresholds(), estimateSpeedAfterDistance(), MSCFModel_W99::followSpeed(), MSCFModel_Wiedemann::getSecureGap(), insertionStopSpeed(), MSCFModel_EIDM::insertionStopSpeed(), maxNextSpeed(), MSCFModel_KraussPS::maxNextSpeed(), and MSCFModel_EIDM::patchSpeedBeforeLCEIDM().

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

Data Structures

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Currently fixed methods

Detailed Description

Member Enumeration Documentation

◆ CalcReason

Constructor & Destructor Documentation

◆ MSCFModel()

◆ ~MSCFModel()

Member Function Documentation

◆ applyHeadwayAndSpeedDifferencePerceptionErrors()

◆ applyHeadwayPerceptionError()

◆ applyOwnSpeedPerceptionError()

◆ applyStartupDelay()

◆ avoidArrivalAccel()

◆ brakeGap() [1/2]

◆ brakeGap() [2/2]

◆ brakeGapEuler()

◆ calculateEmergencyDeceleration()

◆ createVehicleVariables()

◆ distAfterTime()

◆ duplicate()

◆ estimateArrivalTime() [1/2]

◆ estimateArrivalTime() [2/2]

◆ estimateSpeedAfterDistance()

◆ finalizeSpeed()

◆ followSpeed()

◆ followSpeedTransient()

◆ freeSpeed() [1/2]

◆ freeSpeed() [2/2]

◆ gapExtrapolation()

◆ getApparentDecel()

◆ getCollisionMinGapFactor()

◆ getEmergencyDecel()

◆ getHeadwayTime()

◆ getImperfection()

◆ getMaxAccel()

◆ getMaxDecel()

◆ getMinimalArrivalSpeed()

◆ getMinimalArrivalSpeedEuler()

◆ getMinimalArrivalTime()

◆ getModelID()

◆ getParameter()

◆ getSecureGap()

◆ getSpeedAfterMaxDecel()

◆ getStartupDelay()

◆ insertionFollowSpeed()

◆ insertionStopSpeed()

◆ interactionGap()

◆ maximumLaneSpeedCF()

◆ maximumSafeFollowSpeed()

◆ maximumSafeStopSpeed()

◆ maximumSafeStopSpeedBallistic()

◆ maximumSafeStopSpeedEuler()

◆ maxNextSafeMin()

◆ maxNextSpeed()

◆ minNextSpeed()

◆ minNextSpeedEmergency()

◆ passingTime()

◆ patchSpeedBeforeLC()

◆ setApparentDecel()

◆ setCollisionMinGapFactor()

◆ setEmergencyDecel()

◆ setHeadwayTime()

◆ setImperfection()

◆ setMaxAccel()

◆ setMaxDecel()

◆ setParameter()

◆ speedAfterTime()

◆ startupDelayStopped()

◆ stopSpeed() [1/2]

◆ stopSpeed() [2/2]

Field Documentation

◆ myAccel

◆ myApparentDecel

◆ myCollisionMinGapFactor