Eclipse SUMO - Simulation of Urban MObility
|
The car-following model abstraction. More...
#include <MSCFModel.h>
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. | |
virtual double | distAfterTime (double t, double speed, double accel) const |
calculates the distance traveled after accelerating for time t | |
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. | |
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 std::string | getParameter (const MSVehicle *veh, const std::string &key) const |
try to get the given parameter for this carFollowingModel | |
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. | |
MSCFModel (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 | |
virtual | ~MSCFModel () |
Destructor. | |
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) | |
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 | 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. | |
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) | |
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 | 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) | |
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 int | getModelID () const =0 |
Returns the model's ID; the XML-Tag number is used. | |
virtual MSCFModel * | duplicate (const MSVehicleType *vtype) const =0 |
Duplicates the car-following model. | |
virtual VehicleVariables * | createVehicleVariables () const |
Returns model specific values which are stored inside a vehicle and must be used with casting. | |
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]. | |
virtual bool | startupDelayStopped () const |
whether startupDelay should be applied after stopping | |
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. | |
Currently fixed methods | |
virtual double | maxNextSpeed (double speed, const MSVehicle *const veh) const |
Returns the maximum speed given the current speed. | |
virtual double | maxNextSafeMin (double speed, const MSVehicle *const veh=0) const |
Returns the maximum speed given the current speed and regarding driving dynamics. | |
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. | |
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. | |
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) | |
virtual double | getSpeedAfterMaxDecel (double v) const |
Returns the velocity after maximum deceleration. | |
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) |
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.
What the return value of stop/follow/free-Speed is used for.
Definition at line 77 of file MSCFModel.h.
MSCFModel::MSCFModel | ( | const MSVehicleType * | vtype | ) |
Constructor.
[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.
|
virtual |
Destructor.
Definition at line 68 of file MSCFModel.cpp.
|
protected |
Overwrites gap2pred and predSpeed by the perceived values obtained from the vehicle's driver state,.
[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, followSpeed(), FUTURE, MSVehicle::getDriverState(), Named::getID(), MSVehicle::hasDriverState(), SIMTIME, SPEED2ACCEL, and UNUSED_PARAMETER.
Referenced by MSCFModel_CACC::followSpeed(), MSCFModel_IDM::followSpeed(), and MSCFModel_Krauss::followSpeed().
|
protected |
Overwrites gap by the perceived value obtained from the vehicle's driver state.
[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, FUTURE, MSVehicle::getDriverState(), Named::getID(), MSVehicle::hasDriverState(), SIMTIME, SPEED2ACCEL, stopSpeed(), and UNUSED_PARAMETER.
Referenced by MSCFModel_IDM::stopSpeed(), MSCFModel_CACC::stopSpeed(), and MSCFModel_Krauss::stopSpeed().
|
protected |
Overwrites sped by the perceived values obtained from the vehicle's driver state,.
[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().
|
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().
|
static |
Computes the acceleration needed to arrive not before the given time.
[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 |
Definition at line 521 of file MSCFModel.cpp.
Referenced by MSLCM_SL2015::commitManoeuvre().
|
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.
[in] | speed | The vehicle's current speed |
Definition at line 380 of file MSCFModel.h.
References brakeGap(), myDecel, and myHeadwayTime.
Referenced by MSCFModel_Wiedemann::_v(), MSLCM_LC2013::_wantsChange(), MSLCM_SL2015::_wantsChangeSublane(), MSVehicle::adaptToOncomingLeader(), MSPModel_Striping::addCrossingVehs(), MSLane::addLeaders(), brakeGap(), 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(), MSDevice_StationFinder::notifyMove(), GUIBaseVehicle::GUIBaseVehiclePopupMenu::onCmdToggleStop(), MSVehicle::planMoveInternal(), MSLCM_SL2015::preventSliding(), MSVehicle::processLinkApproaches(), MSVehicle::unsafeLinkAhead(), MSVehicle::updateBestLanes(), and MSLCHelper::updateBlockerLength().
|
virtual |
Reimplemented in MSCFModel_EIDM.
Definition at line 75 of file MSCFModel.cpp.
References brakeGapEuler(), and MSGlobals::gSemiImplicitEulerUpdate.
|
static |
Definition at line 90 of file MSCFModel.cpp.
References ACCEL2SPEED, and SPEED2DIST.
Referenced by brakeGap(), and MSLCM_SL2015::computeSpeedLat().
double MSCFModel::calculateEmergencyDeceleration | ( | double | gap, |
double | egoSpeed, | ||
double | predSpeed, | ||
double | predMaxDecel | ||
) | const |
Returns the minimal deceleration for following the given leader safely.
[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 |
Definition at line 1002 of file MSCFModel.cpp.
References DEBUG_COND2, myEmergencyDecel, and SIMTIME.
Referenced by maximumSafeFollowSpeed(), MSCFModel_EIDM::maximumSafeFollowSpeed(), and maximumSafeStopSpeed().
|
inlinevirtual |
Returns model specific values which are stored inside a vehicle and must be used with casting.
Reimplemented in MSCFModel_ACC, MSCFModel_CACC, MSCFModel_CC, MSCFModel_EIDM, MSCFModel_IDM, MSCFModel_Kerner, MSCFModel_Krauss, MSCFModel_PWag2009, MSCFModel_Rail, MSCFModel_SmartSK, and MSCFModel_Wiedemann.
Definition at line 247 of file MSCFModel.h.
Referenced by MSVehicle::MSVehicle(), and MSVehicle::replaceVehicleType().
|
virtual |
calculates the distance traveled 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().
|
pure virtual |
Duplicates the car-following model.
[in] | vtype | The vehicle type this model belongs to (1:1) |
Implemented in MSCFModel_ACC, MSCFModel_CACC, MSCFModel_CC, MSCFModel_Daniel1, MSCFModel_EIDM, MSCFModel_IDM, MSCFModel_Kerner, MSCFModel_Krauss, MSCFModel_KraussOrig1, MSCFModel_KraussPS, MSCFModel_KraussX, MSCFModel_PWag2009, MSCFModel_Rail, MSCFModel_SmartSK, MSCFModel_W99, and MSCFModel_Wiedemann.
Referenced by MSVehicleType::duplicateType().
|
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.
[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. |
Definition at line 489 of file MSCFModel.cpp.
References UNUSED_PARAMETER.
|
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.
[in] | dist | Distance to be covered (assumed >= 0.) |
[in] | speed | Initial speed of vehicle |
[in] | accel | Assumed acceleration until reaching maxspeed or speed=0. |
Definition at line 450 of file MSCFModel.cpp.
References INVALID_DOUBLE.
Referenced by MSLCM_SL2015::commitManoeuvre(), and MSDevice_SSM::estimateConflictTimes().
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().
|
virtual |
Applies interaction with stops and lane changing model influences. Called at most once per simulation step (exactcly once per action step)
[in] | veh | The ego vehicle |
[in] | vPos | The possible velocity |
Reimplemented in MSCFModel_CC, MSCFModel_Daniel1, MSCFModel_EIDM, MSCFModel_IDM, MSCFModel_Kerner, MSCFModel_PWag2009, MSCFModel_Rail, MSCFModel_SmartSK, and MSCFModel_Wiedemann.
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().
|
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.
[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 |
Implemented in MSCFModel_ACC, MSCFModel_CACC, MSCFModel_CC, MSCFModel_Daniel1, MSCFModel_EIDM, MSCFModel_IDM, MSCFModel_Kerner, MSCFModel_Krauss, MSCFModel_KraussOrig1, MSCFModel_PWag2009, MSCFModel_Rail, MSCFModel_SmartSK, MSCFModel_W99, and MSCFModel_Wiedemann.
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().
|
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.
[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 |
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().
|
static |
Definition at line 100 of file MSCFModel.cpp.
References ACCEL2DIST, ACCEL2SPEED, DIST2SPEED, MSGlobals::gSemiImplicitEulerUpdate, MAX2(), SPEED2DIST, and TS.
|
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.
[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 |
Reimplemented in MSCFModel_Rail, MSCFModel_CACC, MSCFModel_CC, MSCFModel_EIDM, and MSCFModel_IDM.
Definition at line 321 of file MSCFModel.cpp.
References freeSpeed(), MSVehicle::getActionStepLengthSecs(), and myDecel.
Referenced by freeSpeed(), MSCFModel_CACC::freeSpeed(), MSCFModel_CC::freeSpeed(), MSLane::isInsertionSuccess(), and MSVehicle::planMoveInternal().
|
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'.
[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 |
Definition at line 564 of file MSCFModel.cpp.
References MSGlobals::gSemiImplicitEulerUpdate, MAX2(), MIN2(), and TS.
Referenced by MSLCM_SL2015::checkBlockingVehicles(), and MSLCM_LC2013::informFollower().
|
inline |
Get the vehicle type's apparent deceleration [m/s^2] (the one regarded by its followers.
Definition at line 280 of file MSCFModel.h.
References myApparentDecel.
Referenced by MSVehicle::getCurrentApparentDecel(), and MSVehicleType::setApparentDecel().
|
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().
|
inline |
Get the vehicle type's maximal physically possible deceleration [m/s^2].
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().
|
inlinevirtual |
Get the driver's desired headway [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().
|
inlinevirtual |
Get the driver's imperfection.
Reimplemented in MSCFModel_Daniel1, MSCFModel_KraussOrig1, MSCFModel_PWag2009, and MSCFModel_SmartSK.
Definition at line 303 of file MSCFModel.h.
Referenced by MSVehicleType::setImperfection().
|
inline |
Get the vehicle type's maximum acceleration [m/s^2].
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().
|
inline |
Get the vehicle type's maximal comfortable deceleration [m/s^2].
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(), 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().
double MSCFModel::getMinimalArrivalSpeed | ( | double | dist, |
double | currentSpeed | ||
) | const |
Computes the minimal possible arrival speed after covering a given distance.
[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().
double MSCFModel::getMinimalArrivalSpeedEuler | ( | double | dist, |
double | currentSpeed | ||
) | const |
Computes the minimal possible arrival speed after covering a given distance for Euler update.
[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().
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.
[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().
|
pure virtual |
Returns the model's ID; the XML-Tag number is used.
Implemented in MSCFModel_ACC, MSCFModel_CACC, MSCFModel_CC, MSCFModel_Daniel1, MSCFModel_EIDM, MSCFModel_IDM, MSCFModel_Kerner, MSCFModel_Krauss, MSCFModel_KraussOrig1, MSCFModel_KraussPS, MSCFModel_KraussX, MSCFModel_PWag2009, MSCFModel_Rail, MSCFModel_SmartSK, MSCFModel_W99, and MSCFModel_Wiedemann.
Referenced by MSCFModel_CACC::getSecureGap(), and MSCFModel_CACC::speedGapControl().
|
inlinevirtual |
try to get the given parameter for this carFollowingModel
[in] | veh | the vehicle from which the parameter must be retrieved |
[in] | key | the key of the parameter |
Reimplemented in MSCFModel_CACC, and MSCFModel_CC.
Definition at line 646 of file MSCFModel.h.
References UNUSED_PARAMETER.
Referenced by MSBaseVehicle::getPrefixedParameter().
|
virtual |
Returns the minimum gap to reserve if the leader is braking at maximum (>=0)
[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 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(), 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().
|
inlinevirtual |
Returns the velocity after maximum deceleration.
[in] | v | The velocity |
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().
|
inline |
Get the vehicle type's startupDelay.
Definition at line 287 of file MSCFModel.h.
References myStartupDelay.
Referenced by MSRailSignal::constraintsAllow(), MSVehicle::executeMove(), and MSDriveWay::foeDriveWayOccupied().
|
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.
[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 |
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 maximumSafeFollowSpeed().
Referenced by MSVehicle::adaptToJunctionLeader(), MSLane::freeInsertion(), MSLane::getCriticalLeader(), and MSLane::safeInsertionSpeed().
|
virtual |
Computes the vehicle's safe speed for approaching an obstacle at insertion without constraints due to acceleration capabilities and previous speeds.
[in] | veh | The vehicle (EGO) |
[in] | speed | The vehicle's speed |
[in] | gap | The (net) distance to the obstacle |
Reimplemented in MSCFModel_EIDM, and MSCFModel_IDM.
Definition at line 343 of file MSCFModel.cpp.
References FUTURE, MSVehicleType::getMaxSpeed(), MSGlobals::gSemiImplicitEulerUpdate, maximumSafeStopSpeed(), MIN2(), myDecel, myType, and stopSpeed().
Referenced by MSCFModel_IDM::insertionStopSpeed(), and MSLane::isInsertionSuccess().
|
virtual |
Returns the maximum gap at which an interaction between both vehicles occurs.
"interaction" means that the LEADER influences EGO's speed.
[in] | veh | The EGO vehicle |
[in] | vL | LEADER's speed |
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(), maxNextSpeed(), MIN2(), myDecel, myHeadwayTime, and SPEED2DIST.
Referenced by MSCFModel_CC::interactionGap(), and MSAbstractLaneChangeModel::predInteraction().
|
inlinevirtual |
Returns the maximum velocity the CF-model wants to achieve in the next step.
[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 applyOwnSpeedPerceptionError(), and MIN2().
Referenced by MSVehicle::planMoveInternal().
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.
[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 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().
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.
[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, 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().
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.
[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) |
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().
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.
[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, myHeadwayTime, and TS.
Referenced by maximumSafeStopSpeed().
|
inlinevirtual |
Returns the maximum speed given the current speed and regarding driving dynamics.
[in] | speed | The vehicle's current speed |
[in] | speed | The vehicle itself, for obtaining other values |
Reimplemented in MSCFModel_EIDM.
Definition at line 347 of file MSCFModel.h.
References maxNextSpeed().
|
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).
[in] | speed | The vehicle's current speed |
[in] | veh | The vehicle itself, for obtaining other values |
Reimplemented in MSCFModel_CC, MSCFModel_KraussPS, and MSCFModel_Rail.
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().
|
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.
[in] | speed | The vehicle's current speed |
[in] | speed | The vehicle itself, for obtaining other values, if needed as e.g. road conditions. |
Reimplemented in MSCFModel_Rail, MSCFModel_CC, and MSCFModel_IDM.
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().
|
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.
[in] | speed | The vehicle's current speed |
[in] | speed | The vehicle itself, for obtaining other values, if needed as e.g. road conditions. |
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().
|
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.
[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 |
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().
|
inlinevirtual |
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 finalizeSpeed().
|
inlinevirtual |
Sets a new value for the apparent deceleration [m/s^2].
[in] | decel | The new deceleration in m/s^2 |
Definition at line 552 of file MSCFModel.h.
References myApparentDecel.
Referenced by MSVehicleType::setApparentDecel().
|
inline |
Sets a new value for the factor of minGap that must be maintained to avoid a collision event.
[in] | factor | The new minGap factor |
Definition at line 559 of file MSCFModel.h.
References myCollisionMinGapFactor.
Referenced by MSDevice_Bluelight::notifyMove().
|
inlinevirtual |
Sets a new value for maximal physically possible deceleration [m/s^2].
[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().
|
inlinevirtual |
Sets a new value for desired headway [s].
[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 myHeadwayTime.
Referenced by MSVehicle::Influencer::gapControlSpeed(), MSCFModel_CACC::MSCFModel_CACC(), MSCFModel_CACC::setHeadwayTime(), and MSVehicleType::setTau().
|
inlinevirtual |
Sets a new value for driver imperfection.
[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().
|
inlinevirtual |
Sets a new value for maximum acceleration [m/s^2].
[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().
|
inlinevirtual |
Sets a new value for maximal comfortable deceleration [m/s^2].
[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 myDecel.
Referenced by MSLCM_SL2015::commitFollowSpeed(), MSCFModel_Rail::MSCFModel_Rail(), and MSVehicleType::setDecel().
|
inlinevirtual |
try to set the given parameter for this carFollowingModel
[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().
|
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.
[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 |
Definition at line 736 of file MSCFModel.cpp.
References DIST2SPEED, MSGlobals::gSemiImplicitEulerUpdate, and TS.
Referenced by MSE2Collector::calculateTimeLossAndTimeOnDetector(), MSInstantInductLoop::notifyMove(), and MSMeanData::MeanDataValues::notifyMove().
|
inlinevirtual |
whether startupDelay should be applied after stopping
Reimplemented in MSCFModel_Rail.
Definition at line 316 of file MSCFModel.h.
|
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.
[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 |
Definition at line 168 of file MSCFModel.h.
References myDecel, and stopSpeed().
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(), stopSpeed(), and MSCFModel_CC::stopSpeed().
|
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.
[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 |
Implemented in MSCFModel_EIDM, MSCFModel_IDM, MSCFModel_Rail, MSCFModel_W99, MSCFModel_Wiedemann, MSCFModel_ACC, MSCFModel_CACC, MSCFModel_CC, MSCFModel_Daniel1, MSCFModel_Kerner, MSCFModel_Krauss, MSCFModel_KraussOrig1, MSCFModel_PWag2009, and MSCFModel_SmartSK.
|
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().
|
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().
|
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().
|
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().
|
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().
|
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().
|
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().
|
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().