SUMO - Simulation of Urban MObility
MSCFModel_KraussPS Class Reference

Krauss car-following model, changing accel and speed by slope. More...

#include <MSCFModel_KraussPS.h>

Inheritance diagram for MSCFModel_KraussPS:
Inheritance graph
Collaboration diagram for MSCFModel_KraussPS:
Collaboration graph

Public Member Functions

MSCFModelduplicate (const MSVehicleType *vtype) const
 Duplicates the car-following model. More...
 
SUMOReal estimateSpeedAfterDistance (const SUMOReal dist, const SUMOReal v, const SUMOReal accel) const
 
SUMOReal getMaxAccel () const
 Get the vehicle type's maximum acceleration [m/s^2]. More...
 
SUMOReal getMaxDecel () const
 Get the vehicle type's maximum deceleration [m/s^2]. More...
 
SUMOReal getMinimalArrivalSpeed (SUMOReal dist, SUMOReal currentSpeed) const
 Computes the minimal possible arrival speed after covering a given distance. More...
 
SUMOReal getMinimalArrivalSpeedEuler (SUMOReal dist, SUMOReal currentSpeed) const
 Computes the minimal possible arrival speed after covering a given distance for Euler update. More...
 
SUMOTime getMinimalArrivalTime (SUMOReal dist, SUMOReal currentSpeed, SUMOReal arrivalSpeed) const
 Computes the minimal time needed to cover a distance given the desired speed at arrival. More...
 
SUMOReal maximumSafeFollowSpeed (SUMOReal gap, SUMOReal egoSpeed, SUMOReal predSpeed, SUMOReal predMaxDecel, bool onInsertion=false) const
 Returns the maximum safe velocity for following the given leader. More...
 
SUMOReal maximumSafeStopSpeed (SUMOReal gap, SUMOReal currentSpeed, bool onInsertion=false, SUMOReal headway=-1) const
 Returns the maximum next velocity for stopping within gap. More...
 
SUMOReal maximumSafeStopSpeedBallistic (SUMOReal gap, SUMOReal currentSpeed, bool onInsertion=false, SUMOReal headway=-1) const
 Returns the maximum next velocity for stopping within gap when using the ballistic positional update. More...
 
SUMOReal maximumSafeStopSpeedEuler (SUMOReal gap) const
 Returns the maximum next velocity for stopping within gap when using the semi-implicit Euler update. More...
 
 MSCFModel_KraussPS (const MSVehicleType *vtype, SUMOReal accel, SUMOReal decel, SUMOReal dawdle, SUMOReal headwayTime)
 Constructor. More...
 
 ~MSCFModel_KraussPS ()
 Destructor. More...
 
Implementations of the MSCFModel interface
SUMOReal maxNextSpeed (SUMOReal speed, const MSVehicle *const veh) const
 Returns the maximum speed given the current speed. More...
 
int getModelID () const
 Returns the model's name. More...
 
Implementations of the MSCFModel interface
SUMOReal stopSpeed (const MSVehicle *const veh, const SUMOReal speed, SUMOReal gap2pred) const
 Computes the vehicle's safe speed for approaching a non-moving obstacle (no dawdling) this uses the maximumSafeStopSpeed. More...
 
SUMOReal followSpeed (const MSVehicle *const veh, SUMOReal speed, SUMOReal gap2pred, SUMOReal predSpeed, SUMOReal predMaxDecel) const
 Computes the vehicle's safe speed (no dawdling) this uses the maximumSafeFollowSpeed. More...
 
Implementations of the MSCFModel interface
SUMOReal moveHelper (MSVehicle *const veh, SUMOReal vPos) const
 Applies interaction with stops and lane changing model influences. More...
 
SUMOReal insertionFollowSpeed (const MSVehicle *const veh, SUMOReal speed, SUMOReal gap2pred, SUMOReal predSpeed, SUMOReal predMaxDecel) const
 Computes the vehicle's safe speed (no dawdling) This method is used during the insertion stage. Whereas the method followSpeed returns the desired speed which may be lower than the safe speed, this method only considers safety constraints. More...
 
SUMOReal getImperfection () const
 Get the driver's imperfection. More...
 
Setter methods
void setMaxDecel (SUMOReal decel)
 Sets a new value for maximum deceleration [m/s^2]. More...
 
void setImperfection (SUMOReal imperfection)
 Sets a new value for driver imperfection. More...
 
void setHeadwayTime (SUMOReal headwayTime)
 Sets a new value for driver reaction time [s]. More...
 
Methods to override by model implementation
virtual SUMOReal freeSpeed (const MSVehicle *const veh, SUMOReal speed, SUMOReal seen, SUMOReal maxSpeed, const bool onInsertion=false) const
 Computes the vehicle's safe speed without a leader. More...
 
virtual SUMOReal insertionStopSpeed (const MSVehicle *const veh, SUMOReal speed, SUMOReal gap) const
 Computes the vehicle's safe speed for approaching an obstacle at insertion without constraints due to acceleration capabilities and previous speeds. More...
 
virtual SUMOReal interactionGap (const MSVehicle *const veh, SUMOReal vL) const
 Returns the maximum gap at which an interaction between both vehicles occurs. More...
 
virtual VehicleVariablescreateVehicleVariables () const
 Returns model specific values which are stored inside a vehicle and must be used with casting. More...
 
Virtual methods with default implementation
virtual SUMOReal getHeadwayTime () const
 Get the driver's reaction time [s]. More...
 
Setter methods
virtual void setMaxAccel (SUMOReal accel)
 Sets a new value for maximum acceleration [m/s^2]. More...
 

Static Public Member Functions

static SUMOReal gapExtrapolation (const SUMOReal duration, const SUMOReal currentGap, SUMOReal v1, SUMOReal v2, SUMOReal a1=0, SUMOReal a2=0, const SUMOReal maxV1=std::numeric_limits< SUMOReal >::max(), const SUMOReal maxV2=std::numeric_limits< SUMOReal >::max())
 return the resulting gap if, starting with gap currentGap, two vehicles continue with constant accelerations (velocities bounded by 0 and maxSpeed) for a given timespan of length 'duration'. More...
 
static SUMOReal passingTime (const SUMOReal lastPos, const SUMOReal passedPos, const SUMOReal currentPos, const SUMOReal lastSpeed, const SUMOReal currentSpeed)
 Calculates the time at which the position passedPosition has been passed In case of a ballistic update, the possibility of a stop within a time step requires more information about the last time-step than in case of the euler update to determine the last position if the currentSpeed is zero. More...
 
static SUMOReal speedAfterTime (const SUMOReal t, const SUMOReal oldSpeed, const SUMOReal dist)
 Calculates the speed after a time t [0,TS] given the initial speed and the distance traveled in an interval of step length TS. More...
 

Protected Attributes

SUMOReal myAccel
 The vehicle's maximum acceleration [m/s^2]. More...
 
SUMOReal myDawdle
 The vehicle's dawdle-parameter. 0 for no dawdling, 1 for max. More...
 
SUMOReal myDecel
 The vehicle's maximum deceleration [m/s^2]. More...
 
SUMOReal myHeadwayTime
 The driver's desired time headway (aka reaction time tau) [s]. More...
 
SUMOReal myTauDecel
 The precomputed value for myDecel*myTau. More...
 
const MSVehicleTypemyType
 The type to which this model definition belongs to. More...
 

Currently fixed methods

SUMOReal minNextSpeed (SUMOReal speed, const MSVehicle *const veh=0) const
 Returns the minimum speed given the current speed (depends on the numerical update scheme and its step width) Note that it wouldn't have to depend on the numerical update scheme if the semantics would rely on acceleration instead of velocity. More...
 
SUMOReal brakeGap (const SUMOReal speed) const
 Returns the distance the vehicle needs to halt including driver's reaction time, assuming that during the reaction time, the speed remains constant. More...
 
SUMOReal getSecureGap (const SUMOReal speed, const SUMOReal leaderSpeed, const SUMOReal leaderMaxDecel) const
 Returns the minimum gap to reserve if the leader is braking at maximum (>=0) More...
 
SUMOReal getSpeedAfterMaxDecel (SUMOReal v) const
 Returns the velocity after maximum deceleration. More...
 
static SUMOReal freeSpeed (const SUMOReal currentSpeed, const SUMOReal decel, const SUMOReal dist, const SUMOReal maxSpeed, const bool onInsertion)
 
static SUMOReal brakeGap (const SUMOReal speed, const SUMOReal decel, const SUMOReal headwayTime)
 

Detailed Description

Krauss car-following model, changing accel and speed by slope.

See also
MSCFModel
MSCFModel_Krauss

Definition at line 47 of file MSCFModel_KraussPS.h.

Constructor & Destructor Documentation

§ MSCFModel_KraussPS()

MSCFModel_KraussPS::MSCFModel_KraussPS ( const MSVehicleType vtype,
SUMOReal  accel,
SUMOReal  decel,
SUMOReal  dawdle,
SUMOReal  headwayTime 
)

Constructor.

Parameters
[in]accelThe maximum acceleration
[in]decelThe maximum deceleration
[in]dawdleThe driver imperfection
[in]headwayTimeThe driver's reaction time

Definition at line 44 of file MSCFModel_KraussPS.cpp.

Referenced by duplicate().

§ ~MSCFModel_KraussPS()

MSCFModel_KraussPS::~MSCFModel_KraussPS ( )

Destructor.

Definition at line 50 of file MSCFModel_KraussPS.cpp.

References SUMOReal.

Member Function Documentation

§ brakeGap() [1/2]

§ brakeGap() [2/2]

SUMOReal MSCFModel::brakeGap ( const SUMOReal  speed,
const SUMOReal  decel,
const SUMOReal  headwayTime 
)
staticinherited

Definition at line 61 of file MSCFModel.cpp.

References ACCEL2SPEED, MSGlobals::gSemiImplicitEulerUpdate, SPEED2DIST, and SUMOReal.

§ createVehicleVariables()

virtual VehicleVariables* MSCFModel::createVehicleVariables ( ) const
inlinevirtualinherited

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

Reimplemented in MSCFModel_SmartSK, MSCFModel_IDM, MSCFModel_Wiedemann, MSCFModel_PWag2009, and MSCFModel_Kerner.

Definition at line 184 of file MSCFModel.h.

Referenced by MSVehicle::MSVehicle().

§ duplicate()

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

Duplicates the car-following model.

Parameters
[in]vtypeThe vehicle type this model belongs to (1:1)
Returns
A duplicate of this car-following model

Reimplemented from MSCFModel_Krauss.

Definition at line 64 of file MSCFModel_KraussPS.cpp.

References MSCFModel_KraussPS(), MSCFModel::myAccel, MSCFModel_KraussOrig1::myDawdle, MSCFModel::myDecel, and MSCFModel::myHeadwayTime.

Referenced by getModelID().

§ estimateSpeedAfterDistance()

§ followSpeed()

SUMOReal MSCFModel_Krauss::followSpeed ( const MSVehicle *const  veh,
SUMOReal  speed,
SUMOReal  gap2pred,
SUMOReal  predSpeed,
SUMOReal  predMaxDecel 
) const
virtualinherited

Computes the vehicle's safe speed (no dawdling) this uses the maximumSafeFollowSpeed.

Parameters
[in]vehThe vehicle (EGO)
[in]speedThe vehicle's speed
[in]gap2predThe (netto) distance to the LEADER
[in]predSpeedThe speed of LEADER
Returns
EGO's safe speed

Implements MSCFModel.

Definition at line 65 of file MSCFModel_Krauss.cpp.

References MSGlobals::gSemiImplicitEulerUpdate, MAX2(), MSCFModel::maximumSafeFollowSpeed(), MSCFModel::maxNextSpeed(), MIN2(), MSCFModel::minNextSpeed(), SUMOReal, and MSCFModel_KraussOrig1::vsafe().

§ freeSpeed() [1/2]

SUMOReal MSCFModel::freeSpeed ( const MSVehicle *const  veh,
SUMOReal  speed,
SUMOReal  seen,
SUMOReal  maxSpeed,
const bool  onInsertion = false 
) const
virtualinherited

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]vehThe vehicle (EGO)
[in]speedThe vehicle's speed
[in]seenThe look ahead distance
[in]maxSpeedThe maximum allowed speed
[in]onInsertionwhether speed at insertion is asked for
Returns
EGO's safe speed

Definition at line 206 of file MSCFModel.cpp.

References MSCFModel::myDecel, and SUMOReal.

Referenced by MSCFModel::brakeGap(), MSLane::isInsertionSuccess(), and MSVehicle::planMoveInternal().

§ freeSpeed() [2/2]

SUMOReal MSCFModel::freeSpeed ( const SUMOReal  currentSpeed,
const SUMOReal  decel,
const SUMOReal  dist,
const SUMOReal  maxSpeed,
const bool  onInsertion 
)
staticinherited

§ gapExtrapolation()

SUMOReal MSCFModel::gapExtrapolation ( const SUMOReal  duration,
const SUMOReal  currentGap,
SUMOReal  v1,
SUMOReal  v2,
SUMOReal  a1 = 0,
SUMOReal  a2 = 0,
const SUMOReal  maxV1 = std::numeric_limits<SUMOReal>::max(),
const SUMOReal  maxV2 = std::numeric_limits<SUMOReal>::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]v1initial speed of vehicle 1
[in]v2initial speed of vehicle 2
[in]a1acceleration of vehicle 1
[in]a2acceleration of vehicle 2
[in]maxV1maximal speed of vehicle 1
[in]maxV2maximal speed of vehicle 2
[in]durationtime span for the process
Returns
estimated gap after 'duration' seconds

Definition at line 273 of file MSCFModel.cpp.

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

Referenced by MSCFModel::getSpeedAfterMaxDecel(), and MSLCM_LC2013::informFollower().

§ getHeadwayTime()

virtual SUMOReal MSCFModel::getHeadwayTime ( ) const
inlinevirtualinherited

§ getImperfection()

SUMOReal MSCFModel_KraussOrig1::getImperfection ( ) const
inlinevirtualinherited

Get the driver's imperfection.

Returns
The imperfection of drivers of this class

Reimplemented from MSCFModel.

Definition at line 120 of file MSCFModel_KraussOrig1.h.

References MSCFModel_KraussOrig1::myDawdle.

§ getMaxAccel()

§ getMaxDecel()

SUMOReal MSCFModel::getMaxDecel ( ) const
inlineinherited

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

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

Definition at line 201 of file MSCFModel.h.

References MSCFModel::myDecel.

Referenced by MSLCM_LC2013::_wantsChange(), MSCriticalFollowerDistanceInfo::addFollower(), MSLink::blockedByFoe(), MSLaneChanger::changeOpposite(), MSLCM_SL2015::checkBlockingVehicles(), MSLaneChanger::checkChange(), MSVehicle::checkRewindLinkLanes(), MSLCM_SL2015::checkStrategicChange(), MSLink::couldBrakeForLeader(), MSVehicle::executeMove(), MSLane::freeInsertion(), MSLane::getCriticalLeader(), MSLane::getFollower(), MSLane::getLeaderOnConsecutive(), MSLane::getLeadersOnConsecutive(), MSCFModel::getMinimalArrivalSpeed(), MSCFModel::getMinimalArrivalSpeedEuler(), MSCFModel::getMinimalArrivalTime(), MSLaneChanger::getRealFollower(), TraCIServerAPI_VehicleType::getVariable(), MSLink::getZipperSpeed(), MSLCM_DK2008::informBlocker(), MSLCM_LC2013::informFollower(), MSLCM_SL2015::informFollower(), MSLCM_LC2013::informLeader(), MSLCM_SL2015::informLeader(), MSLane::isInsertionSuccess(), MESegment::isOpen(), MSLane::lastInsertion(), MSLink::maybeOccupied(), MSCFModel::minNextSpeed(), MSCFModel_KraussOrig1::moveHelper(), MSLCM_LC2013::overtakeDistance(), MSVehicle::planMoveInternal(), MSLane::safeInsertionSpeed(), MSLCM_SL2015::saveBlockerLength(), MSLCM_LC2013::saveBlockerLength(), GUIVehicle::selectBlockingFoes(), MSLCM_LC2013::slowDownForBlocked(), MSLCM_SL2015::slowDownForBlocked(), MSLCM_SL2015::updateExpectedSublaneSpeeds(), MSVehicleControl::vehicleDeparted(), MSLCM_DK2008::wantsChangeToLeft(), and MSLCM_DK2008::wantsChangeToRight().

§ getMinimalArrivalSpeed()

SUMOReal MSCFModel::getMinimalArrivalSpeed ( SUMOReal  dist,
SUMOReal  currentSpeed 
) const
inherited

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

Parameters
[in]distDistance to be covered
[in]currentSpeedActual speed of vehicle

Definition at line 247 of file MSCFModel.cpp.

References MSCFModel::estimateSpeedAfterDistance(), MSCFModel::getHeadwayTime(), MSCFModel::getMaxDecel(), and SUMOReal.

Referenced by MSCFModel::getSpeedAfterMaxDecel(), and MSVehicle::planMoveInternal().

§ getMinimalArrivalSpeedEuler()

SUMOReal MSCFModel::getMinimalArrivalSpeedEuler ( SUMOReal  dist,
SUMOReal  currentSpeed 
) const
inherited

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

Parameters
[in]distDistance to be covered
[in]currentSpeedActual speed of vehicle

Definition at line 254 of file MSCFModel.cpp.

References MSCFModel::estimateSpeedAfterDistance(), MSCFModel::getHeadwayTime(), MSCFModel::getMaxDecel(), INVALID_SPEED, and SUMOReal.

Referenced by MSCFModel::getSpeedAfterMaxDecel(), and MSVehicle::planMoveInternal().

§ getMinimalArrivalTime()

SUMOTime MSCFModel::getMinimalArrivalTime ( SUMOReal  dist,
SUMOReal  currentSpeed,
SUMOReal  arrivalSpeed 
) const
inherited

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

Parameters
[in]distDistance to be covered
[in]currentSpeedActual speed of vehicle
[in]arrivalSpeedDesired speed at arrival

Definition at line 234 of file MSCFModel.cpp.

References MSCFModel::getMaxAccel(), MSCFModel::getMaxDecel(), MAX2(), MAX3(), SUMO_const_haltingSpeed, SUMOReal, and TIME2STEPS.

Referenced by MSCFModel::getSpeedAfterMaxDecel(), and MSVehicle::planMoveInternal().

§ getModelID()

int MSCFModel_KraussPS::getModelID ( ) const
inlinevirtual

Returns the model's name.

Returns
The model's name
See also
MSCFModel::getModelName

Reimplemented from MSCFModel_Krauss.

Definition at line 84 of file MSCFModel_KraussPS.h.

References duplicate(), and SUMO_TAG_CF_KRAUSS_PLUS_SLOPE.

§ getSecureGap()

SUMOReal MSCFModel::getSecureGap ( const SUMOReal  speed,
const SUMOReal  leaderSpeed,
const SUMOReal  leaderMaxDecel 
) const
inlineinherited

§ getSpeedAfterMaxDecel()

§ insertionFollowSpeed()

SUMOReal MSCFModel_KraussOrig1::insertionFollowSpeed ( const MSVehicle *const  veh,
SUMOReal  speed,
SUMOReal  gap2pred,
SUMOReal  predSpeed,
SUMOReal  predMaxDecel 
) 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]vehThe vehicle (EGO)
[in]speedThe vehicle's speed
[in]gap2predThe (netto) distance to the LEADER
[in]predSpeedThe speed of LEADER
Returns
EGO's safe speed

Reimplemented from MSCFModel.

Definition at line 110 of file MSCFModel_KraussOrig1.cpp.

References MSCFModel_KraussOrig1::followSpeed(), MSGlobals::gSemiImplicitEulerUpdate, MSCFModel::maximumSafeFollowSpeed(), and SUMOReal.

§ insertionStopSpeed()

SUMOReal MSCFModel::insertionStopSpeed ( const MSVehicle *const  veh,
SUMOReal  speed,
SUMOReal  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]vehThe vehicle (EGO)
[in]speedThe vehicle's speed
[in]gapThe (netto) distance to the the obstacle
Returns
EGO's safe speed for approaching a non-moving obstacle at insertion
See also
stopSpeed() and insertionFollowSpeed()

Definition at line 224 of file MSCFModel.cpp.

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

Referenced by MSLane::isInsertionSuccess().

§ interactionGap()

SUMOReal MSCFModel::interactionGap ( const MSVehicle *const  veh,
SUMOReal  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]vehThe EGO vehicle
[in]vLLEADER's speed
Returns
The interaction gap
Todo:
evaluate signature

Reimplemented in MSCFModel_IDM, and MSCFModel_Wiedemann.

Definition at line 175 of file MSCFModel.cpp.

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

Referenced by MSAbstractLaneChangeModel::predInteraction().

§ maximumSafeFollowSpeed()

SUMOReal MSCFModel::maximumSafeFollowSpeed ( SUMOReal  gap,
SUMOReal  egoSpeed,
SUMOReal  predSpeed,
SUMOReal  predMaxDecel,
bool  onInsertion = false 
) const
inherited

Returns the maximum safe velocity for following the given leader.

Parameters
[in]gap2predThe (netto) distance to the LEADER
[in]egoSpeedThe FOLLOWERS's speed
[in]predSpeedThe LEADER's speed
[in]predMaxDecelThe LEADER's maximum deceleration
[in]onInsertionIndicator whether the call is triggered during vehicle insertion
Returns
the safe velocity

Returns the SK-vsafe.

Definition at line 585 of file MSCFModel.cpp.

References MSCFModel::brakeGap(), MSGlobals::gSemiImplicitEulerUpdate, ISNAN(), MAX2(), MSCFModel::maximumSafeStopSpeed(), MSCFModel::myDecel, MSCFModel::myHeadwayTime, and SUMOReal.

Referenced by MSCFModel_KraussOrig1::followSpeed(), MSCFModel_Krauss::followSpeed(), MSCFModel_KraussOrig1::insertionFollowSpeed(), MSCFModel::insertionFollowSpeed(), and MSCFModel::setHeadwayTime().

§ maximumSafeStopSpeed()

SUMOReal MSCFModel::maximumSafeStopSpeed ( SUMOReal  gap,
SUMOReal  currentSpeed,
bool  onInsertion = false,
SUMOReal  headway = -1 
) const
inherited

Returns the maximum next velocity for stopping within gap.

Parameters
[in]gapThe (netto) distance to the desired stopping point
[in]currentSpeedThe current speed of the ego vehicle
[in]onInsertionIndicator whether the call is triggered during vehicle insertion
[in]headwayThe desired time headway to be included in the calculations (default argument -1 induces the use of myHeadway)

Definition at line 477 of file MSCFModel.cpp.

References MSGlobals::gSemiImplicitEulerUpdate, MSCFModel::maximumSafeStopSpeedBallistic(), MSCFModel::maximumSafeStopSpeedEuler(), and SUMOReal.

Referenced by MSCFModel::insertionStopSpeed(), MSCFModel::maximumSafeFollowSpeed(), MSVehicle::planMoveInternal(), MSCFModel::setHeadwayTime(), and MSCFModel_Krauss::stopSpeed().

§ maximumSafeStopSpeedBallistic()

SUMOReal MSCFModel::maximumSafeStopSpeedBallistic ( SUMOReal  gap,
SUMOReal  currentSpeed,
bool  onInsertion = false,
SUMOReal  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 and the car's current speed. (The latter is required to calculate the distance covered in the following timestep.)
Parameters
[in]gapThe (netto) distance to the desired stopping point
[in]currentSpeedThe current speed of the ego vehicle
[in]onInsertionIndicator whether the call is triggered during vehicle insertion
[in]headwayThe 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 518 of file MSCFModel.cpp.

References INVALID_SPEED, MAX2(), MSCFModel::myDecel, MSCFModel::myHeadwayTime, NUMERICAL_EPS, SUMOReal, and TS.

Referenced by MSCFModel::maximumSafeStopSpeed(), MSCFModel::setHeadwayTime(), and MSCFModel_KraussOrig1::stopSpeed().

§ maximumSafeStopSpeedEuler()

SUMOReal MSCFModel::maximumSafeStopSpeedEuler ( SUMOReal  gap) const
inherited

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

Parameters
[in]gapThe (netto) distance to the LEADER

Definition at line 487 of file MSCFModel.cpp.

References ACCEL2SPEED, DIST2SPEED, MIN2(), MSCFModel::myDecel, MSCFModel::myHeadwayTime, NUMERICAL_EPS, SUMOReal, and TS.

Referenced by MSCFModel::maximumSafeStopSpeed(), and MSCFModel::setHeadwayTime().

§ maxNextSpeed()

SUMOReal MSCFModel_KraussPS::maxNextSpeed ( SUMOReal  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]speedThe vehicle's current speed
[in]speedThe vehicle itself, for obtaining other values
Returns
The maximum possible speed for the next step

Reimplemented from MSCFModel.

Definition at line 54 of file MSCFModel_KraussPS.cpp.

References ACCEL2SPEED, DEG2RAD, MSCFModel::getMaxAccel(), MSVehicleType::getMaxSpeed(), MSVehicle::getSlope(), MAX2(), MIN2(), MSCFModel::myType, and SUMOReal.

§ minNextSpeed()

SUMOReal MSCFModel::minNextSpeed ( SUMOReal  speed,
const MSVehicle *const  veh = 0 
) const
inherited

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]speedThe vehicle's current speed
[in]speedThe vehicle itself, for obtaining other values, if needed as e.g. road conditions.
Returns
The minimum possible speed for the next step

Definition at line 195 of file MSCFModel.cpp.

References ACCEL2SPEED, MSCFModel::getMaxDecel(), MSGlobals::gSemiImplicitEulerUpdate, MAX2(), and SUMOReal.

Referenced by MSCFModel_KraussOrig1::followSpeed(), MSCFModel_Krauss::followSpeed(), MSCFModel::getHeadwayTime(), MSCFModel_KraussOrig1::moveHelper(), and MSCFModel::moveHelper().

§ moveHelper()

SUMOReal MSCFModel_KraussOrig1::moveHelper ( MSVehicle *const  veh,
SUMOReal  vPos 
) const
virtualinherited

Applies interaction with stops and lane changing model influences.

Parameters
[in]vehThe ego vehicle
[in]vPosThe possible velocity
Returns
The velocity after applying interactions with stops and lane change model influences

Reimplemented from MSCFModel.

Definition at line 57 of file MSCFModel_KraussOrig1.cpp.

References ACCEL2SPEED, MSCFModel_KraussOrig1::dawdle(), DEBUG_COND, MSBaseVehicle::getID(), MSVehicle::getLane(), MSVehicle::getLaneChangeModel(), MSCFModel::getMaxDecel(), MSVehicle::getSpeed(), MSLane::getVehicleMaxSpeed(), MSGlobals::gSemiImplicitEulerUpdate, MAX2(), MSCFModel::maxNextSpeed(), MIN2(), MIN3(), MSCFModel::minNextSpeed(), MSAbstractLaneChangeModel::patchSpeed(), MSVehicle::processNextStop(), and SUMOReal.

§ passingTime()

SUMOReal MSCFModel::passingTime ( const SUMOReal  lastPos,
const SUMOReal  passedPos,
const SUMOReal  currentPos,
const SUMOReal  lastSpeed,
const SUMOReal  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]lastPosthe position at time t=0 (must be < currentPos)
[in]passedPosthe position for which the passing time is to be determined (has to lie within [lastPos, currentPos]!)
[in]currentPosthe position at time t=TS (one time-step after lastPos) (must be > lastPos)
[in]lastSpeedthe speed at moment t=0
[in]currentSpeedthe speed at moment t=TS
Returns
time t in [0,TS] at which passedPos in [lastPos, currentPos] was passed.

Definition at line 367 of file MSCFModel.cpp.

References MSGlobals::gSemiImplicitEulerUpdate, NUMERICAL_EPS, SPEED2ACCEL, SUMOReal, TS, and WRITE_ERROR.

Referenced by MSCFModel::getSpeedAfterMaxDecel(), MSE3Collector::MSE3EntryReminder::notifyMove(), MSInstantInductLoop::notifyMove(), MSMeanData::MeanDataValues::notifyMove(), MSInductLoop::notifyMove(), MSE3Collector::MSE3LeaveReminder::notifyMove(), and MSE2Collector::notifyMove().

§ setHeadwayTime()

void MSCFModel_KraussOrig1::setHeadwayTime ( SUMOReal  headwayTime)
inlinevirtualinherited

Sets a new value for driver reaction time [s].

Parameters
[in]headwayTimeThe new driver reaction time (in s)

Reimplemented from MSCFModel.

Definition at line 149 of file MSCFModel_KraussOrig1.h.

References MSCFModel_KraussOrig1::dawdle(), MSCFModel_KraussOrig1::duplicate(), MSCFModel::myDecel, MSCFModel::myHeadwayTime, MSCFModel_KraussOrig1::myTauDecel, SUMOReal, and MSCFModel_KraussOrig1::vsafe().

§ setImperfection()

void MSCFModel_KraussOrig1::setImperfection ( SUMOReal  imperfection)
inlinevirtualinherited

Sets a new value for driver imperfection.

Parameters
[in]accelThe new driver imperfection

Reimplemented from MSCFModel.

Definition at line 141 of file MSCFModel_KraussOrig1.h.

References MSCFModel_KraussOrig1::myDawdle.

§ setMaxAccel()

virtual void MSCFModel::setMaxAccel ( SUMOReal  accel)
inlinevirtualinherited

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

Parameters
[in]accelThe new acceleration in m/s^2

Definition at line 391 of file MSCFModel.h.

References MSCFModel::myAccel.

Referenced by TraCIServerAPI_VehicleType::setVariable().

§ setMaxDecel()

void MSCFModel_KraussOrig1::setMaxDecel ( SUMOReal  decel)
inlinevirtualinherited

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

Parameters
[in]accelThe new deceleration in m/s^2

Reimplemented from MSCFModel.

Definition at line 132 of file MSCFModel_KraussOrig1.h.

References MSCFModel::myDecel, MSCFModel::myHeadwayTime, and MSCFModel_KraussOrig1::myTauDecel.

§ speedAfterTime()

SUMOReal MSCFModel::speedAfterTime ( const SUMOReal  t,
const SUMOReal  oldSpeed,
const SUMOReal  dist 
)
staticinherited

Calculates the speed after a time t [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]ttime in [0,TS] for which the speed shall be determined
[in]oldSpeedspeed before the last time step (referred to as t == 0)
[in]distancecovered
Returns
speed at time t

Definition at line 439 of file MSCFModel.cpp.

References DIST2SPEED, MSGlobals::gSemiImplicitEulerUpdate, SUMOReal, and TS.

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

§ stopSpeed()

SUMOReal MSCFModel_Krauss::stopSpeed ( const MSVehicle *const  veh,
const SUMOReal  speed,
SUMOReal  gap2pred 
) const
virtualinherited

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

Parameters
[in]vehThe vehicle (EGO)
[in]gap2predThe (netto) distance to the the obstacle
Returns
EGO's safe speed for approaching a non-moving obstacle
Todo:
generic Interface, models can call for the values they need

Reimplemented from MSCFModel_KraussOrig1.

Definition at line 56 of file MSCFModel_Krauss.cpp.

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

Field Documentation

§ myAccel

§ myDawdle

SUMOReal MSCFModel_KraussOrig1::myDawdle
protectedinherited

§ myDecel

§ myHeadwayTime

§ myTauDecel

SUMOReal MSCFModel_KraussOrig1::myTauDecel
protectedinherited

The precomputed value for myDecel*myTau.

Definition at line 183 of file MSCFModel_KraussOrig1.h.

Referenced by MSCFModel_KraussOrig1::setHeadwayTime(), MSCFModel_KraussOrig1::setMaxDecel(), and MSCFModel_KraussOrig1::vsafe().

§ myType

const MSVehicleType* MSCFModel::myType
protectedinherited

The type to which this model definition belongs to.

Definition at line 463 of file MSCFModel.h.

Referenced by MSCFModel_Wiedemann::_v(), MSCFModel_IDM::_v(), MSCFModel::estimateSpeedAfterDistance(), MSCFModel::insertionStopSpeed(), maxNextSpeed(), and MSCFModel::maxNextSpeed().


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