#include <MSCFModel_Rail.h>

Inheritance diagram for MSCFModel_Rail:

Collaboration diagram for MSCFModel_Rail:

Data Structures
struct	TrainParams

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.

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

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

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

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

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)

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
	Computes the vehicle's follow speed (no dawdling)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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.

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.

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.

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

virtual double	minNextSpeed (double speed, const MSVehicle *const veh) 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.

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.

	MSCFModel_Rail (const MSVehicleType *vtype)
	Constructor.

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

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

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

virtual	~MSCFModel_Rail ()

Methods to override by model implementation
virtual double	patchSpeedBeforeLC (const MSVehicle *veh, double vMin, double vMax) const
	apply custom speed adaptations within the given speed bounds

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

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.

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)

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.

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.

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

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.

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

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

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

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

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

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

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

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

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

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.

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.

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.

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

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.

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.

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

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

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

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

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

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

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

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

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

SUMOTime	myStartupDelay
	The startup delay after halting [s].

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

Private Member Functions
std::vector< double >	getValueTable (const MSVehicleType *vtype, SumoXMLAttr attr)

TrainParams	initCustomParams () const

TrainParams	initFreightParams () const

LinearApproxHelpers::LinearApproxMap	initFreightResistance () const

LinearApproxHelpers::LinearApproxMap	initFreightTraction () const

TrainParams	initICE1Params () const

LinearApproxHelpers::LinearApproxMap	initICE1Resistance () const

LinearApproxHelpers::LinearApproxMap	initICE1Traction () const

TrainParams	initICE3Params () const

LinearApproxHelpers::LinearApproxMap	initICE3Resistance () const

LinearApproxHelpers::LinearApproxMap	initICE3Traction () const

TrainParams	initMireoPlusB2TParams () const

LinearApproxHelpers::LinearApproxMap	initMireoPlusB2TResistance () const

LinearApproxHelpers::LinearApproxMap	initMireoPlusB2TTraction () const

TrainParams	initMireoPlusH2TParams () const

LinearApproxHelpers::LinearApproxMap	initMireoPlusH2TResistance () const

LinearApproxHelpers::LinearApproxMap	initMireoPlusH2TTraction () const

TrainParams	initNGT400_16Params () const

LinearApproxHelpers::LinearApproxMap	initNGT400_16Resistance () const

LinearApproxHelpers::LinearApproxMap	initNGT400_16Traction () const

TrainParams	initNGT400Params () const

LinearApproxHelpers::LinearApproxMap	initNGT400Resistance () const

LinearApproxHelpers::LinearApproxMap	initNGT400Traction () const

TrainParams	initRB425Params () const

LinearApproxHelpers::LinearApproxMap	initRB425Resistance () const

LinearApproxHelpers::LinearApproxMap	initRB425Traction () const

TrainParams	initRB628Params () const

LinearApproxHelpers::LinearApproxMap	initRB628Resistance () const

LinearApproxHelpers::LinearApproxMap	initRB628Traction () const

TrainParams	initREDosto7Params () const

LinearApproxHelpers::LinearApproxMap	initREDosto7Resistance () const

LinearApproxHelpers::LinearApproxMap	initREDosto7Traction () const

Private Attributes
TrainParams	myTrainParams

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

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.

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)

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

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

Detailed Description

Definition at line 28 of file MSCFModel_Rail.h.

Member Enumeration Documentation

◆ CalcReason

enum MSCFModel::CalcReason

inherited

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

MSCFModel_Rail::MSCFModel_Rail ( 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 60 of file MSCFModel_Rail.cpp.

◆ ~MSCFModel_Rail()

MSCFModel_Rail::~MSCFModel_Rail ( )

virtual

Definition at line 165 of file MSCFModel_Rail.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

protectedinherited

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 (net) 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, MSCFModel::followSpeed(), MSCFModel::FUTURE, 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

protectedinherited

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 (net) distance to the obstacle

Definition at line 1099 of file MSCFModel.cpp.

References DEBUG_COND, MSCFModel::FUTURE, MSVehicle::getDriverState(), Named::getID(), MSVehicle::hasDriverState(), SIMTIME, SPEED2ACCEL, MSCFModel::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

protectedinherited

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 MSCFModel::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

virtualinherited

apply speed adaptation on startup

Definition at line 257 of file MSCFModel.cpp.

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

Referenced by MSCFModel::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
	)

staticinherited

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

inlineinherited

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 MSCFModel::brakeGap(), MSCFModel::myDecel, and MSCFModel::myHeadwayTime.

Referenced by MSCFModel_Wiedemann::_v(), MSLCM_LC2013::_wantsChange(), MSLCM_SL2015::_wantsChangeSublane(), MSVehicle::adaptToOncomingLeader(), MSPModel_Striping::addCrossingVehs(), MSLane::addLeaders(), MSCFModel::brakeGap(), MSCFModel_EIDM::brakeGap(), MSLCHelper::canSaveBlockerLength(), MSLaneChanger::checkChange(), MSLane::checkFailure(), MSVehicle::checkReversal(), MSVehicle::checkRewindLinkLanes(), MSLaneChanger::computeSafeOppositeLength(), MSCFModel::distAfterTime(), MSCFModel::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(), MSCFModel::getSecureGap(), MSLink::getZipperSpeed(), MSLane::handleCollisionBetween(), MSLane::handleIntermodalCollisionBetween(), MSIdling_Stop::idle(), MSLCM_SL2015::informLeader(), MSLCM_LC2013::informLeader(), MSLane::isInsertionSuccess(), MSVehicle::isLeader(), MSLane::lastInsertion(), MSCFModel::maximumSafeFollowSpeed(), MSDevice_StationFinder::notifyMove(), 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

virtualinherited

Reimplemented in MSCFModel_EIDM.

Definition at line 75 of file MSCFModel.cpp.

References MSCFModel::brakeGapEuler(), and MSGlobals::gSemiImplicitEulerUpdate.

◆ brakeGapEuler()

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

staticinherited

Definition at line 90 of file MSCFModel.cpp.

References ACCEL2SPEED, and SPEED2DIST.

Referenced by MSCFModel::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

inherited

Returns the minimal deceleration for following the given leader safely.

Parameters

[in]	gap	The (net) 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, MSCFModel::myEmergencyDecel, and SIMTIME.

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

Here is the caller graph for this function:

◆ createVehicleVariables()

MSCFModel::VehicleVariables * MSCFModel_Rail::createVehicleVariables ( ) const

virtual

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

Reimplemented from MSCFModel.

Definition at line 299 of file MSCFModel_Rail.cpp.

◆ distAfterTime()

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

virtualinherited

calculates the distance traveled after accelerating for time t

Definition at line 403 of file MSCFModel.cpp.

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

Referenced by MSCFModel::followSpeedTransient().

Here is the caller graph for this function:

◆ duplicate()

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

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

Implements MSCFModel.

Definition at line 215 of file MSCFModel_Rail.cpp.

◆ estimateArrivalTime() [1/2]

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

staticinherited

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
	)

staticinherited

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

inherited

Definition at line 765 of file MSCFModel.cpp.

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

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

Here is the caller graph for this function:

◆ finalizeSpeed()

double MSCFModel_Rail::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 from MSCFModel.

Definition at line 305 of file MSCFModel_Rail.cpp.

References MSCFModel::finalizeSpeed().

◆ followSpeed()

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

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 (net) distance to the LEADER
[in]	predSpeed	The speed of LEADER
[in]	usage	What the return value is used for

Returns: EGO's safe speed

Implements MSCFModel.

Definition at line 181 of file MSCFModel_Rail.cpp.

References MSVehicleType::getMinGap(), MSBaseVehicle::getVehicleType(), MSGlobals::gSemiImplicitEulerUpdate, MAX2(), MSCFModel::maximumSafeStopSpeed(), maxNextSpeed(), MIN2(), minNextSpeed(), MSCFModel::myDecel, and TS.

◆ followSpeedTransient()

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

virtualinherited

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 (net) distance to the LEADER
[in]	predSpeed	The speed of LEADER
[in]	predMaxDecel	The maximum leader deceleration

Returns: EGO's safe speed

Definition at line 353 of file MSCFModel.cpp.

References ACCEL2SPEED, MSCFModel::brakeGap(), DIST2SPEED, MSCFModel::distAfterTime(), gDebugFlag2, MSCFModel::getMaxDecel(), MSGlobals::gSemiImplicitEulerUpdate, MSCFModel::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
	)

staticinherited

Definition at line 100 of file MSCFModel.cpp.

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

◆ freeSpeed() [2/2]

double MSCFModel_Rail::freeSpeed	(	const MSVehicle *const	veh,
		double	speed,
		double	seen,
		double	maxSpeed,
		const bool	onInsertion,
		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 from MSCFModel.

Definition at line 310 of file MSCFModel_Rail.cpp.

References ACCEL2DIST, ACCEL2SPEED, MSCFModel_Rail::TrainParams::decl, DIST2SPEED, MSGlobals::gSemiImplicitEulerUpdate, MAX2(), MSCFModel::myDecel, myTrainParams, SPEED2DIST, TL, and WRITE_ERROR.

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

staticinherited

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

inlineinherited

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 MSCFModel::myApparentDecel.

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

Here is the caller graph for this function:

◆ getCollisionMinGapFactor()

double MSCFModel::getCollisionMinGapFactor ( ) const

inlineinherited

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

Definition at line 293 of file MSCFModel.h.

References MSCFModel::myCollisionMinGapFactor.

Referenced by MSLane::detectCollisionBetween().

Here is the caller graph for this function:

◆ getEmergencyDecel()

double MSCFModel::getEmergencyDecel ( ) const

inlineinherited

Get the vehicle type's maximal physically 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 MSCFModel::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

inlinevirtualinherited

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 MSCFModel::myHeadwayTime.

Referenced by MSVehicleType::check(), MSLaneChanger::checkChange(), MSVehicle::checkRewindLinkLanes(), MSLaneChanger::computeSurplusGap(), MSVehicle::Influencer::gapControlSpeed(), MSCFModel::getMinimalArrivalSpeed(), MSCFModel::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

inlinevirtualinherited

Get the driver's imperfection.

Returns: The imperfection of drivers of this class

Reimplemented in MSCFModel_Daniel1, MSCFModel_KraussOrig1, MSCFModel_PWag2009, and MSCFModel_SmartSK.

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

inlineinherited

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 MSCFModel::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(), MSCFModel::getMinimalArrivalTime(), MSLink::getZipperSpeed(), MSVehicle::isLeader(), MSCFModel::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

inlineinherited

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 MSCFModel::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(), MSCFModel::followSpeedTransient(), MSLane::freeInsertion(), MSLaneChanger::getColumnleader(), MSLane::getCriticalLeader(), MSLane::getLeaderOnConsecutive(), MSLaneChanger::getMaxOvertakingSpeed(), MSCFModel::getMinimalArrivalSpeed(), MSCFModel::getMinimalArrivalSpeedEuler(), MSCFModel::getMinimalArrivalTime(), MSLane::getMissingRearGap(), LIBSUMO_NAMESPACE::Vehicle::getNeighbors(), LIBSUMO_NAMESPACE::Vehicle::getNextLinks(), MSLCHelper::getSpeedPreservingSecureGap(), MSLink::getZipperSpeed(), MSIdling_Stop::idle(), 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

inherited

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 MSCFModel::estimateSpeedAfterDistance(), MSCFModel::getHeadwayTime(), and MSCFModel::getMaxDecel().

Referenced by MSVehicle::planMoveInternal().

Here is the caller graph for this function:

◆ getMinimalArrivalSpeedEuler()

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

inherited

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 MSCFModel::estimateSpeedAfterDistance(), MSCFModel::getHeadwayTime(), MSCFModel::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

inherited

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 MSCFModel::getMaxAccel(), MSCFModel::getMaxDecel(), MAX3(), SUMO_const_haltingSpeed, and TIME2STEPS.

Referenced by MSVehicle::getArrivalTime().

Here is the caller graph for this function:

◆ getModelID()

int MSCFModel_Rail::getModelID ( ) const

virtual

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

Returns: The model's ID

Implements MSCFModel.

Definition at line 209 of file MSCFModel_Rail.cpp.

References SUMO_TAG_CF_RAIL.

◆ getParameter()

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

inlinevirtualinherited

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_CACC, and MSCFModel_CC.

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

virtualinherited

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_ACC, MSCFModel_CACC, MSCFModel_IDM, MSCFModel_Wiedemann, MSCFModel_CC, and MSCFModel_EIDM.

Definition at line 166 of file MSCFModel.cpp.

References MSCFModel::brakeGap(), MSGlobals::gComputeLC, MSVehicle::getAcceleration(), MSVehicle::getLaneChangeModel(), MSAbstractLaneChangeModel::getSafetyFactor(), MAX2(), MIN2(), MSCFModel::myDecel, and MSCFModel::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(), MSCFModel_CC::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()

double MSCFModel_Rail::getSpeedAfterMaxDecel ( double v ) const

virtual

Returns the velocity after maximum deceleration.

Parameters

[in] v The velocity

Returns: The velocity after maximum deceleration

Reimplemented from MSCFModel.

Definition at line 286 of file MSCFModel_Rail.cpp.

References WRITE_ERROR.

◆ getStartupDelay()

SUMOTime MSCFModel::getStartupDelay ( ) const

inlineinherited

Get the vehicle type's startupDelay.

Returns: The startupDelay

Definition at line 287 of file MSCFModel.h.

References MSCFModel::myStartupDelay.

Referenced by MSRailSignal::constraintsAllow(), MSVehicle::executeMove(), and MSDriveWay::foeDriveWayOccupied().

Here is the caller graph for this function:

◆ getValueTable()

std::vector< double > MSCFModel_Rail::getValueTable	(	const MSVehicleType *	vtype,
		SumoXMLAttr	attr
	)

private

Definition at line 169 of file MSCFModel_Rail.cpp.

References SUMOVTypeParameter::getCFParamString(), MSVehicleType::getParameter(), StringTokenizer::getVector(), and StringUtils::toDouble().

Referenced by MSCFModel_Rail().

Here is the caller graph for this function:

◆ initCustomParams()

TrainParams MSCFModel_Rail::initCustomParams ( ) const

inlineprivate

Definition at line 875 of file MSCFModel_Rail.h.

References MSCFModel_Rail::TrainParams::decl, MSCFModel_Rail::TrainParams::length, MSCFModel_Rail::TrainParams::mf, MSCFModel_Rail::TrainParams::recovery, MSCFModel_Rail::TrainParams::vmax, and MSCFModel_Rail::TrainParams::weight.

Referenced by MSCFModel_Rail().

Here is the caller graph for this function:

◆ initFreightParams()

TrainParams MSCFModel_Rail::initFreightParams ( ) const

inlineprivate

Definition at line 645 of file MSCFModel_Rail.h.

References MSCFModel_Rail::TrainParams::decl, initFreightResistance(), initFreightTraction(), MSCFModel_Rail::TrainParams::length, MSCFModel_Rail::TrainParams::mf, MSCFModel_Rail::TrainParams::recovery, MSCFModel_Rail::TrainParams::resistance, MSCFModel_Rail::TrainParams::traction, MSCFModel_Rail::TrainParams::vmax, and MSCFModel_Rail::TrainParams::weight.

Referenced by MSCFModel_Rail().

Here is the caller graph for this function:

◆ initFreightResistance()

LinearApproxHelpers::LinearApproxMap MSCFModel_Rail::initFreightResistance ( ) const

inlineprivate

Definition at line 677 of file MSCFModel_Rail.h.

References LinearApproxHelpers::scalePoints().

Referenced by initFreightParams().

Here is the caller graph for this function:

◆ initFreightTraction()

LinearApproxHelpers::LinearApproxMap MSCFModel_Rail::initFreightTraction ( ) const

inlineprivate

Definition at line 658 of file MSCFModel_Rail.h.

References LinearApproxHelpers::scalePoints().

Referenced by initFreightParams().

Here is the caller graph for this function:

◆ initICE1Params()

TrainParams MSCFModel_Rail::initICE1Params ( ) const

inlineprivate

Definition at line 435 of file MSCFModel_Rail.h.

References MSCFModel_Rail::TrainParams::decl, initICE1Resistance(), initICE1Traction(), MSCFModel_Rail::TrainParams::length, MSCFModel_Rail::TrainParams::mf, MSCFModel_Rail::TrainParams::recovery, MSCFModel_Rail::TrainParams::resistance, MSCFModel_Rail::TrainParams::traction, MSCFModel_Rail::TrainParams::vmax, and MSCFModel_Rail::TrainParams::weight.

Referenced by MSCFModel_Rail().

Here is the caller graph for this function:

◆ initICE1Resistance()

LinearApproxHelpers::LinearApproxMap MSCFModel_Rail::initICE1Resistance ( ) const

inlineprivate

Definition at line 403 of file MSCFModel_Rail.h.

References LinearApproxHelpers::scalePoints().

Referenced by initICE1Params().

Here is the caller graph for this function:

◆ initICE1Traction()

LinearApproxHelpers::LinearApproxMap MSCFModel_Rail::initICE1Traction ( ) const

inlineprivate

Definition at line 371 of file MSCFModel_Rail.h.

References LinearApproxHelpers::scalePoints().

Referenced by initICE1Params().

Here is the caller graph for this function:

◆ initICE3Params()

TrainParams MSCFModel_Rail::initICE3Params ( ) const

inlineprivate

Definition at line 448 of file MSCFModel_Rail.h.

References MSCFModel_Rail::TrainParams::decl, initICE3Resistance(), initICE3Traction(), MSCFModel_Rail::TrainParams::length, MSCFModel_Rail::TrainParams::mf, MSCFModel_Rail::TrainParams::recovery, MSCFModel_Rail::TrainParams::resistance, MSCFModel_Rail::TrainParams::traction, MSCFModel_Rail::TrainParams::vmax, and MSCFModel_Rail::TrainParams::weight.

Referenced by MSCFModel_Rail().

Here is the caller graph for this function:

◆ initICE3Resistance()

LinearApproxHelpers::LinearApproxMap MSCFModel_Rail::initICE3Resistance ( ) const

inlineprivate

Definition at line 498 of file MSCFModel_Rail.h.

References LinearApproxHelpers::scalePoints().

Referenced by initICE3Params().

Here is the caller graph for this function:

◆ initICE3Traction()

LinearApproxHelpers::LinearApproxMap MSCFModel_Rail::initICE3Traction ( ) const

inlineprivate

Definition at line 461 of file MSCFModel_Rail.h.

References LinearApproxHelpers::scalePoints().

Referenced by initICE3Params().

Here is the caller graph for this function:

◆ initMireoPlusB2TParams()

TrainParams MSCFModel_Rail::initMireoPlusB2TParams ( ) const

inlineprivate

Definition at line 802 of file MSCFModel_Rail.h.

References MSCFModel_Rail::TrainParams::decl, initMireoPlusB2TResistance(), initMireoPlusB2TTraction(), MSCFModel_Rail::TrainParams::length, MSCFModel_Rail::TrainParams::mf, MSCFModel_Rail::TrainParams::recovery, MSCFModel_Rail::TrainParams::resistance, MSCFModel_Rail::TrainParams::traction, MSCFModel_Rail::TrainParams::vmax, and MSCFModel_Rail::TrainParams::weight.

Referenced by MSCFModel_Rail().

Here is the caller graph for this function:

◆ initMireoPlusB2TResistance()

LinearApproxHelpers::LinearApproxMap MSCFModel_Rail::initMireoPlusB2TResistance ( ) const

inlineprivate

Definition at line 779 of file MSCFModel_Rail.h.

References LinearApproxHelpers::scalePoints().

Referenced by initMireoPlusB2TParams().

Here is the caller graph for this function:

◆ initMireoPlusB2TTraction()

LinearApproxHelpers::LinearApproxMap MSCFModel_Rail::initMireoPlusB2TTraction ( ) const

inlineprivate

Definition at line 755 of file MSCFModel_Rail.h.

References LinearApproxHelpers::scalePoints().

Referenced by initMireoPlusB2TParams().

Here is the caller graph for this function:

◆ initMireoPlusH2TParams()

TrainParams MSCFModel_Rail::initMireoPlusH2TParams ( ) const

inlineprivate

Definition at line 862 of file MSCFModel_Rail.h.

References MSCFModel_Rail::TrainParams::decl, initMireoPlusH2TResistance(), initMireoPlusH2TTraction(), MSCFModel_Rail::TrainParams::length, MSCFModel_Rail::TrainParams::mf, MSCFModel_Rail::TrainParams::recovery, MSCFModel_Rail::TrainParams::resistance, MSCFModel_Rail::TrainParams::traction, MSCFModel_Rail::TrainParams::vmax, and MSCFModel_Rail::TrainParams::weight.

Referenced by MSCFModel_Rail().

Here is the caller graph for this function:

◆ initMireoPlusH2TResistance()

LinearApproxHelpers::LinearApproxMap MSCFModel_Rail::initMireoPlusH2TResistance ( ) const

inlineprivate

Definition at line 839 of file MSCFModel_Rail.h.

References LinearApproxHelpers::scalePoints().

Referenced by initMireoPlusH2TParams().

Here is the caller graph for this function:

◆ initMireoPlusH2TTraction()

LinearApproxHelpers::LinearApproxMap MSCFModel_Rail::initMireoPlusH2TTraction ( ) const

inlineprivate

Definition at line 815 of file MSCFModel_Rail.h.

References LinearApproxHelpers::scalePoints().

Referenced by initMireoPlusH2TParams().

Here is the caller graph for this function:

◆ initNGT400_16Params()

TrainParams MSCFModel_Rail::initNGT400_16Params ( ) const

inlineprivate

Definition at line 358 of file MSCFModel_Rail.h.

References MSCFModel_Rail::TrainParams::decl, initNGT400_16Resistance(), initNGT400_16Traction(), MSCFModel_Rail::TrainParams::length, MSCFModel_Rail::TrainParams::mf, MSCFModel_Rail::TrainParams::recovery, MSCFModel_Rail::TrainParams::resistance, MSCFModel_Rail::TrainParams::traction, MSCFModel_Rail::TrainParams::vmax, and MSCFModel_Rail::TrainParams::weight.

Referenced by MSCFModel_Rail().

Here is the caller graph for this function:

◆ initNGT400_16Resistance()

LinearApproxHelpers::LinearApproxMap MSCFModel_Rail::initNGT400_16Resistance ( ) const

inlineprivate

Definition at line 304 of file MSCFModel_Rail.h.

References LinearApproxHelpers::scalePoints().

Referenced by initNGT400_16Params().

Here is the caller graph for this function:

◆ initNGT400_16Traction()

LinearApproxHelpers::LinearApproxMap MSCFModel_Rail::initNGT400_16Traction ( ) const

inlineprivate

Definition at line 250 of file MSCFModel_Rail.h.

References LinearApproxHelpers::scalePoints().

Referenced by initNGT400_16Params().

Here is the caller graph for this function:

◆ initNGT400Params()

TrainParams MSCFModel_Rail::initNGT400Params ( ) const

inlineprivate

Definition at line 237 of file MSCFModel_Rail.h.

References MSCFModel_Rail::TrainParams::decl, initNGT400Resistance(), initNGT400Traction(), MSCFModel_Rail::TrainParams::length, MSCFModel_Rail::TrainParams::mf, MSCFModel_Rail::TrainParams::recovery, MSCFModel_Rail::TrainParams::resistance, MSCFModel_Rail::TrainParams::traction, MSCFModel_Rail::TrainParams::vmax, and MSCFModel_Rail::TrainParams::weight.

Referenced by MSCFModel_Rail().

Here is the caller graph for this function:

◆ initNGT400Resistance()

LinearApproxHelpers::LinearApproxMap MSCFModel_Rail::initNGT400Resistance ( ) const

inlineprivate

Definition at line 182 of file MSCFModel_Rail.h.

References LinearApproxHelpers::scalePoints().

Referenced by initNGT400Params().

Here is the caller graph for this function:

◆ initNGT400Traction()

LinearApproxHelpers::LinearApproxMap MSCFModel_Rail::initNGT400Traction ( ) const

inlineprivate

Definition at line 127 of file MSCFModel_Rail.h.

References LinearApproxHelpers::scalePoints().

Referenced by initNGT400Params().

Here is the caller graph for this function:

◆ initRB425Params()

TrainParams MSCFModel_Rail::initRB425Params ( ) const

inlineprivate

Definition at line 742 of file MSCFModel_Rail.h.

References MSCFModel_Rail::TrainParams::decl, initRB425Resistance(), initRB425Traction(), MSCFModel_Rail::TrainParams::length, MSCFModel_Rail::TrainParams::mf, MSCFModel_Rail::TrainParams::recovery, MSCFModel_Rail::TrainParams::resistance, MSCFModel_Rail::TrainParams::traction, MSCFModel_Rail::TrainParams::vmax, and MSCFModel_Rail::TrainParams::weight.

Referenced by MSCFModel_Rail().

Here is the caller graph for this function:

◆ initRB425Resistance()

LinearApproxHelpers::LinearApproxMap MSCFModel_Rail::initRB425Resistance ( ) const

inlineprivate

Definition at line 719 of file MSCFModel_Rail.h.

References LinearApproxHelpers::scalePoints().

Referenced by initRB425Params().

Here is the caller graph for this function:

◆ initRB425Traction()

LinearApproxHelpers::LinearApproxMap MSCFModel_Rail::initRB425Traction ( ) const

inlineprivate

Definition at line 696 of file MSCFModel_Rail.h.

References LinearApproxHelpers::scalePoints().

Referenced by initRB425Params().

Here is the caller graph for this function:

◆ initRB628Params()

TrainParams MSCFModel_Rail::initRB628Params ( ) const

inlineprivate

Definition at line 594 of file MSCFModel_Rail.h.

References MSCFModel_Rail::TrainParams::decl, initRB628Resistance(), initRB628Traction(), MSCFModel_Rail::TrainParams::length, MSCFModel_Rail::TrainParams::mf, MSCFModel_Rail::TrainParams::recovery, MSCFModel_Rail::TrainParams::resistance, MSCFModel_Rail::TrainParams::traction, MSCFModel_Rail::TrainParams::vmax, and MSCFModel_Rail::TrainParams::weight.

Referenced by MSCFModel_Rail().

Here is the caller graph for this function:

◆ initRB628Resistance()

LinearApproxHelpers::LinearApproxMap MSCFModel_Rail::initRB628Resistance ( ) const

inlineprivate

Definition at line 626 of file MSCFModel_Rail.h.

References LinearApproxHelpers::scalePoints().

Referenced by initRB628Params().

Here is the caller graph for this function:

◆ initRB628Traction()

LinearApproxHelpers::LinearApproxMap MSCFModel_Rail::initRB628Traction ( ) const

inlineprivate

Definition at line 607 of file MSCFModel_Rail.h.

References LinearApproxHelpers::scalePoints().

Referenced by initRB628Params().

Here is the caller graph for this function:

◆ initREDosto7Params()

TrainParams MSCFModel_Rail::initREDosto7Params ( ) const

inlineprivate

Definition at line 535 of file MSCFModel_Rail.h.

References MSCFModel_Rail::TrainParams::decl, initREDosto7Resistance(), initREDosto7Traction(), MSCFModel_Rail::TrainParams::length, MSCFModel_Rail::TrainParams::mf, MSCFModel_Rail::TrainParams::recovery, MSCFModel_Rail::TrainParams::resistance, MSCFModel_Rail::TrainParams::traction, MSCFModel_Rail::TrainParams::vmax, and MSCFModel_Rail::TrainParams::weight.

Referenced by MSCFModel_Rail().

Here is the caller graph for this function:

◆ initREDosto7Resistance()

LinearApproxHelpers::LinearApproxMap MSCFModel_Rail::initREDosto7Resistance ( ) const

inlineprivate

Definition at line 571 of file MSCFModel_Rail.h.

References LinearApproxHelpers::scalePoints().

Referenced by initREDosto7Params().

Here is the caller graph for this function:

◆ initREDosto7Traction()

LinearApproxHelpers::LinearApproxMap MSCFModel_Rail::initREDosto7Traction ( ) const

inlineprivate

Definition at line 548 of file MSCFModel_Rail.h.

References LinearApproxHelpers::scalePoints().

Referenced by initREDosto7Params().

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

virtualinherited

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 (net) distance to the LEADER
[in]	predSpeed	The speed of LEADER

Returns: EGO's safe speed

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

Definition at line 332 of file MSCFModel.cpp.

References MSGlobals::gSemiImplicitEulerUpdate, and MSCFModel::maximumSafeFollowSpeed().

Referenced by MSVehicle::adaptToJunctionLeader(), 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

virtualinherited

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 (net) distance to the obstacle

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

See also: stopSpeed() and insertionFollowSpeed()

Reimplemented in MSCFModel_EIDM, and MSCFModel_IDM.

Definition at line 343 of file MSCFModel.cpp.

References MSCFModel::FUTURE, MSVehicleType::getMaxSpeed(), MSGlobals::gSemiImplicitEulerUpdate, MSCFModel::maximumSafeStopSpeed(), MIN2(), MSCFModel::myDecel, MSCFModel::myType, and MSCFModel::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

virtualinherited

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_ACC, MSCFModel_CACC, MSCFModel_CC, MSCFModel_EIDM, MSCFModel_IDM, MSCFModel_W99, and MSCFModel_Wiedemann.

Definition at line 277 of file MSCFModel.cpp.

References MSVehicle::getLane(), MSVehicle::getSpeed(), MSLane::getVehicleMaxSpeed(), MAX2(), MSCFModel::maxNextSpeed(), MIN2(), MSCFModel::myDecel, MSCFModel::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

inlinevirtualinherited

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_CACC, and MSCFModel_EIDM.

Definition at line 224 of file MSCFModel.h.

References MSCFModel::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

inherited

Returns the maximum safe velocity for following the given leader.

Parameters

[in]	gap2pred	The (net) 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, MSCFModel::brakeGap(), MSCFModel::calculateEmergencyDeceleration(), DEBUG_COND2, EMERGENCY_DECEL_AMPLIFIER, MSGlobals::gComputeLC, MSGlobals::gSemiImplicitEulerUpdate, MAX2(), MSCFModel::maximumSafeStopSpeed(), MIN2(), MSCFModel::myDecel, MSCFModel::myEmergencyDecel, MSCFModel::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 MSCFModel::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

inherited

Returns the maximum next velocity for stopping within gap.

Parameters

[in]	gap	The (net) 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, MSCFModel::calculateEmergencyDeceleration(), EMERGENCY_DECEL_AMPLIFIER, MSGlobals::gSemiImplicitEulerUpdate, MAX2(), MSCFModel::maximumSafeStopSpeedBallistic(), MSCFModel::maximumSafeStopSpeedEuler(), MIN2(), MSCFModel::myDecel, MSCFModel::myEmergencyDecel, SIMTIME, and SPEED2ACCEL.

Referenced by MSLCM_LC2013::anticipateFollowSpeed(), followSpeed(), MSVehicle::handleCollisionStop(), MSCFModel::insertionStopSpeed(), MSCFModel::maximumSafeFollowSpeed(), MSVehicle::planMoveInternal(), MSCFModel_IDM::stopSpeed(), 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

inherited

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 (net) 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(), MSCFModel::myEmergencyDecel, MSCFModel::myHeadwayTime, and TS.

Referenced by MSCFModel_EIDM::maximumSafeStopSpeed(), MSCFModel::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

inherited

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

Parameters

[in]	gap	The (net) 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, MSCFModel::myHeadwayTime, and TS.

Referenced by MSCFModel::maximumSafeStopSpeed().

Here is the caller graph for this function:

◆ maxNextSafeMin()

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

inlinevirtualinherited

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 MSCFModel::maxNextSpeed().

◆ maxNextSpeed()

double MSCFModel_Rail::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 from MSCFModel.

Definition at line 220 of file MSCFModel_Rail.cpp.

References ACCEL2SPEED, DEG2RAD, MSCFModel_Rail::TrainParams::getResistance(), MSCFModel_Rail::TrainParams::getRotWeight(), MSVehicle::getSlope(), MSCFModel_Rail::TrainParams::getTraction(), GRAVITY, maxNextSpeed(), myTrainParams, MSCFModel_Rail::TrainParams::vmax, and MSCFModel_Rail::TrainParams::weight.

Referenced by followSpeed(), maxNextSpeed(), and stopSpeed().

Here is the caller graph for this function:

◆ minNextSpeed()

double MSCFModel_Rail::minNextSpeed	(	double	speed,
		const MSVehicle *const	veh
	)		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 from MSCFModel.

Definition at line 254 of file MSCFModel_Rail.cpp.

References ACCEL2SPEED, MSCFModel_Rail::TrainParams::decl, DEG2RAD, MSCFModel_Rail::TrainParams::getResistance(), MSCFModel_Rail::TrainParams::getRotWeight(), MSVehicle::getSlope(), GRAVITY, MSGlobals::gSemiImplicitEulerUpdate, MAX2(), myTrainParams, and MSCFModel_Rail::TrainParams::weight.

Referenced by followSpeed(), and minNextSpeedEmergency().

Here is the caller graph for this function:

◆ minNextSpeedEmergency()

double MSCFModel_Rail::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 from MSCFModel.

Definition at line 273 of file MSCFModel_Rail.cpp.

References minNextSpeed().

◆ passingTime()

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

staticinherited

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

inlinevirtualinherited

apply custom speed adaptations within the given speed bounds

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

Definition at line 102 of file MSCFModel.h.

References UNUSED_PARAMETER.

Referenced by MSCFModel::finalizeSpeed().

Here is the caller graph for this function:

◆ setApparentDecel()

virtual void MSCFModel::setApparentDecel ( double decel )

inlinevirtualinherited

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 MSCFModel::myApparentDecel.

Referenced by MSVehicleType::setApparentDecel().

Here is the caller graph for this function:

◆ setCollisionMinGapFactor()

void MSCFModel::setCollisionMinGapFactor ( const double factor )

inlineinherited

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 MSCFModel::myCollisionMinGapFactor.

Referenced by MSDevice_Bluelight::notifyMove().

Here is the caller graph for this function:

◆ setEmergencyDecel()

virtual void MSCFModel::setEmergencyDecel ( double decel )

inlinevirtualinherited

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 MSCFModel::myEmergencyDecel.

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

Here is the caller graph for this function:

◆ setHeadwayTime()

virtual void MSCFModel::setHeadwayTime ( double headwayTime )

inlinevirtualinherited

Sets a new value for desired headway [s].

Parameters

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

Reimplemented in MSCFModel_CACC, MSCFModel_Daniel1, MSCFModel_KraussOrig1, and MSCFModel_SmartSK.

Definition at line 574 of file MSCFModel.h.

References MSCFModel::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 )

inlinevirtualinherited

Sets a new value for driver imperfection.

Parameters

[in] accel The new driver imperfection

Reimplemented in MSCFModel_Daniel1, MSCFModel_KraussOrig1, and MSCFModel_SmartSK.

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 )

inlinevirtualinherited

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 MSCFModel::myAccel.

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

Here is the caller graph for this function:

◆ setMaxDecel()

virtual void MSCFModel::setMaxDecel ( double decel )

inlinevirtualinherited

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

Parameters

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

Reimplemented in MSCFModel_Daniel1, MSCFModel_KraussOrig1, and MSCFModel_SmartSK.

Definition at line 536 of file MSCFModel.h.

References MSCFModel::myDecel.

Referenced by MSLCM_SL2015::commitFollowSpeed(), 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

inlinevirtualinherited

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_CACC, and MSCFModel_CC.

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
	)

staticinherited

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

bool MSCFModel_Rail::startupDelayStopped ( ) const

inlinevirtual

whether startupDelay should be applied after stopping

Reimplemented from MSCFModel.

Definition at line 62 of file MSCFModel_Rail.h.

◆ stopSpeed() [1/2]

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

inlineinherited

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 (net) distance to 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 MSCFModel::myDecel, and MSCFModel::stopSpeed().

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

Here is the caller graph for this function:

◆ stopSpeed() [2/2]

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

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 (net) distance to 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

Implements MSCFModel.

Definition at line 343 of file MSCFModel_Rail.cpp.

References MSCFModel::maximumSafeStopSpeed(), maxNextSpeed(), MIN2(), and TS.

Field Documentation

◆ myAccel

double MSCFModel::myAccel

protectedinherited

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(), MSCFModel::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(), MSCFModel::setMaxAccel(), MSCFModel_CC::setParameter(), MSCFModel_EIDM::slowToStartTerm(), and MSCFModel_PWag2009::stopSpeed().

◆ myApparentDecel

double MSCFModel::myApparentDecel

protectedinherited

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

Definition at line 705 of file MSCFModel.h.

Referenced by MSCFModel::getApparentDecel(), and MSCFModel::setApparentDecel().

◆ myCollisionMinGapFactor

double MSCFModel::myCollisionMinGapFactor

protectedinherited

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(), MSCFModel::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 MSCFModel::setCollisionMinGapFactor().

◆ myDecel

double MSCFModel::myDecel

protectedinherited

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(), MSCFModel::brakeGap(), MSCFModel_EIDM::brakeGap(), MSCFModel_CC::createVehicleVariables(), MSCFModel_PWag2009::followSpeed(), followSpeed(), MSCFModel::followSpeedTransient(), freeSpeed(), MSCFModel::freeSpeed(), MSCFModel_EIDM::freeSpeed(), MSCFModel_IDM::freeSpeed(), MSCFModel::getMaxDecel(), MSCFModel::getSecureGap(), MSCFModel_EIDM::getSecureGap(), MSCFModel::getSpeedAfterMaxDecel(), MSCFModel::insertionStopSpeed(), MSCFModel_EIDM::insertionStopSpeed(), MSCFModel_IDM::insertionStopSpeed(), MSCFModel::interactionGap(), MSCFModel_EIDM::interactionGap(), MSCFModel_IDM::interactionGap(), MSCFModel_EIDM::internalsecuregap(), MSCFModel::maximumSafeFollowSpeed(), MSCFModel_EIDM::maximumSafeFollowSpeed(), MSCFModel::maximumSafeStopSpeed(), MSCFModel::minNextSpeed(), MSCFModel_IDM::minNextSpeed(), MSCFModel_SmartSK::MSCFModel_SmartSK(), MSCFModel_Daniel1::setHeadwayTime(), MSCFModel_KraussOrig1::setHeadwayTime(), MSCFModel_SmartSK::setHeadwayTime(), MSCFModel::setMaxDecel(), MSCFModel_Daniel1::setMaxDecel(), MSCFModel_KraussOrig1::setMaxDecel(), MSCFModel_SmartSK::setMaxDecel(), MSCFModel_CC::setParameter(), MSCFModel::stopSpeed(), MSCFModel_PWag2009::stopSpeed(), and MSCFModel_KraussOrig1::vsafe().

◆ myEmergencyDecel

double MSCFModel::myEmergencyDecel

protectedinherited

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

Definition at line 703 of file MSCFModel.h.

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

◆ myHeadwayTime

double MSCFModel::myHeadwayTime

protectedinherited

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(), MSCFModel::brakeGap(), MSCFModel_SmartSK::createVehicleVariables(), MSCFModel_PWag2009::followSpeed(), MSCFModel::getHeadwayTime(), MSCFModel_ACC::getSecureGap(), MSCFModel_CACC::getSecureGap(), MSCFModel_IDM::getSecureGap(), MSCFModel::getSecureGap(), MSCFModel_EIDM::getSecureGap(), MSCFModel_IDM::insertionFollowSpeed(), MSCFModel_EIDM::insertionStopSpeed(), MSCFModel::interactionGap(), MSCFModel_EIDM::internalsecuregap(), MSCFModel::maximumSafeFollowSpeed(), MSCFModel_EIDM::maximumSafeFollowSpeed(), MSCFModel::maximumSafeStopSpeedBallistic(), MSCFModel::maximumSafeStopSpeedEuler(), MSCFModel_W99::MSCFModel_W99(), MSCFModel_EIDM::patchSpeedBeforeLCEIDM(), MSCFModel::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

protectedinherited

The startup delay after halting [s].

Definition at line 713 of file MSCFModel.h.

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

◆ myTrainParams

TrainParams MSCFModel_Rail::myTrainParams

private

Definition at line 125 of file MSCFModel_Rail.h.

Referenced by freeSpeed(), maxNextSpeed(), minNextSpeed(), and MSCFModel_Rail().

◆ myType

const MSVehicleType* MSCFModel::myType

protectedinherited

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(), MSCFModel::estimateSpeedAfterDistance(), MSCFModel_W99::followSpeed(), MSCFModel_Wiedemann::getSecureGap(), MSCFModel::insertionStopSpeed(), MSCFModel_EIDM::insertionStopSpeed(), MSCFModel::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

Private Member Functions

Private Attributes

Currently fixed methods

Detailed Description

Member Enumeration Documentation

◆ CalcReason

Constructor & Destructor Documentation

◆ MSCFModel_Rail()

◆ ~MSCFModel_Rail()

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

◆ getValueTable()

◆ initCustomParams()

◆ initFreightParams()

◆ initFreightResistance()

◆ initFreightTraction()

◆ initICE1Params()

◆ initICE1Resistance()

◆ initICE1Traction()

◆ initICE3Params()

◆ initICE3Resistance()

◆ initICE3Traction()

◆ initMireoPlusB2TParams()

◆ initMireoPlusB2TResistance()

◆ initMireoPlusB2TTraction()

◆ initMireoPlusH2TParams()

◆ initMireoPlusH2TResistance()

◆ initMireoPlusH2TTraction()

◆ initNGT400_16Params()

◆ initNGT400_16Resistance()

◆ initNGT400_16Traction()

◆ initNGT400Params()

◆ initNGT400Resistance()

◆ initNGT400Traction()

◆ initRB425Params()

◆ initRB425Resistance()

◆ initRB425Traction()

◆ initRB628Params()

◆ initRB628Resistance()