SUMO - Simulation of Urban MObility
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
MSCFModel_Wiedemann Class Reference

The Intellignet Driver Model (IDM) car-following model. More...

#include <MSCFModel_Wiedemann.h>

Inheritance diagram for MSCFModel_Wiedemann:
MSCFModel

Data Structures

class  VehicleVariables

Public Member Functions

 MSCFModel_Wiedemann (const MSVehicleType *vtype, SUMOReal accel, SUMOReal decel, SUMOReal security, SUMOReal estimation)
 Constructor.
 ~MSCFModel_Wiedemann ()
 Destructor.
Implementations of the MSCFModel interface
SUMOReal moveHelper (MSVehicle *const veh, SUMOReal vPos) const
 Applies interaction with stops and lane changing model influences.
SUMOReal followSpeed (const MSVehicle *const veh, SUMOReal speed, SUMOReal gap2pred, SUMOReal predSpeed, SUMOReal predMaxDecel) const
 Computes the vehicle's safe speed (no dawdling)
SUMOReal stopSpeed (const MSVehicle *const veh, SUMOReal gap) const
 Computes the vehicle's safe speed for approaching a non-moving obstacle (no dawdling)
SUMOReal interactionGap (const MSVehicle *const , SUMOReal vL) const
 Returns the maximum gap at which an interaction between both vehicles occurs.
int getModelID () const
 Returns the model's name.
MSCFModelduplicate (const MSVehicleType *vtype) const
 Duplicates the car-following model.
VehicleVariablescreateVehicleVariables () const
 Returns model specific values which are stored inside a vehicle and must be used with casting.
Methods to override by model implementation
virtual SUMOReal freeSpeed (const MSVehicle *const veh, SUMOReal speed, SUMOReal seen, SUMOReal maxSpeed) const
 Computes the vehicle's safe speed without a leader.
virtual void saveState (std::ostream &os)
 Saves the model's definition into the state.
Virtual methods with default implementation
virtual SUMOReal getMaxAccel () const
 Get the vehicle type's maximum acceleration [m/s^2].
virtual SUMOReal getMaxDecel () const
 Get the vehicle type's maximum deceleration [m/s^2].
virtual SUMOReal getImperfection () const
 Get the driver's imperfection.
virtual SUMOReal getHeadwayTime () const
 Get the driver's reaction time [s].
Currently fixed methods
void leftVehicleVsafe (const MSVehicle *const ego, const MSVehicle *const neigh, SUMOReal &vSafe) const
 Incorporates the influence of the vehicle on the left lane.
SUMOReal maxNextSpeed (SUMOReal speed) const
 Returns the maximum speed given the current speed.
SUMOReal brakeGap (SUMOReal speed) const
 Returns the distance the vehicle needs to halt including driver's reaction time.
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.
SUMOReal getSpeedAfterMaxDecel (SUMOReal v) const
 Returns the velocity after maximum deceleration.
Setter methods
virtual void setMaxAccel (SUMOReal accel)
 Sets a new value for maximum acceleration [m/s^2].
virtual void setMaxDecel (SUMOReal decel)
 Sets a new value for maximum deceleration [m/s^2].
virtual void setImperfection (SUMOReal imperfection)
 Sets a new value for driver imperfection.
virtual void setHeadwayTime (SUMOReal headwayTime)
 Sets a new value for driver reaction time [s].

Protected Attributes

SUMOReal myAccel
 The vehicle's maximum acceleration [m/s^2].
SUMOReal myDecel
 The vehicle's maximum deceleration [m/s^2].
SUMOReal myHeadwayTime
 The driver's desired time headway (aka reaction time tau) [s].
const MSVehicleTypemyType
 The type to which this model definition belongs to.

Private Member Functions

SUMOReal _v (const MSVehicle *veh, SUMOReal predSpeed, SUMOReal gap) const
SUMOReal krauss_vsafe (SUMOReal gap, SUMOReal predSpeed) const
 vsafe from krauss since Wiedemann is deficient at approaching
acceleration based on the 'driving regime'
SUMOReal fullspeed (SUMOReal v, SUMOReal vpref, SUMOReal dx, SUMOReal bx) const
SUMOReal following (SUMOReal sign) const
SUMOReal approaching (SUMOReal dv, SUMOReal dx, SUMOReal bx) const
SUMOReal emergency (SUMOReal dv, SUMOReal dx) const

model parameter

const SUMOReal mySecurity
 The driver's security parameter // also 'ZF1'.
const SUMOReal myEstimation
 The driver's estimation parameter // also 'ZF2'.
const SUMOReal myAX
 front-bumper to front-bumper distance
const SUMOReal myCX
 perception threshold modifier
const SUMOReal myMinAccel
 The vehicle's minimum acceleration [m/s^2].
static const SUMOReal D_MAX = 150
 free-flow distance in m

Detailed Description

The Intellignet Driver Model (IDM) car-following model.

See also:
MSCFModel

Definition at line 47 of file MSCFModel_Wiedemann.h.


Constructor & Destructor Documentation

MSCFModel_Wiedemann::MSCFModel_Wiedemann ( const MSVehicleType vtype,
SUMOReal  accel,
SUMOReal  decel,
SUMOReal  security,
SUMOReal  estimation 
)

Constructor.

Parameters:
[in]securityThe security parameter in [0,1] (dimensionless)
[in]estimationThe estimation capability parameter in [0,1] (dimensionless)
[in]accelThe maximum acceleration
[in]decelThe maximum deceleration
Note:
other parameters of the wiedemann model:

Definition at line 54 of file MSCFModel_Wiedemann.cpp.

Referenced by duplicate().

MSCFModel_Wiedemann::~MSCFModel_Wiedemann ( )

Destructor.

Definition at line 66 of file MSCFModel_Wiedemann.cpp.


Member Function Documentation

SUMOReal MSCFModel_Wiedemann::approaching ( SUMOReal  dv,
SUMOReal  dx,
SUMOReal  bx 
) const
private

Definition at line 168 of file MSCFModel_Wiedemann.cpp.

Referenced by _v().

SUMOReal MSCFModel::brakeGap ( SUMOReal  speed) const
inherited
VehicleVariables* MSCFModel_Wiedemann::createVehicleVariables ( ) const
inlinevirtual

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

Reimplemented from MSCFModel.

Definition at line 129 of file MSCFModel_Wiedemann.h.

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

Implements MSCFModel.

Definition at line 104 of file MSCFModel_Wiedemann.cpp.

References MSCFModel_Wiedemann(), MSCFModel::myAccel, MSCFModel::myDecel, myEstimation, and mySecurity.

SUMOReal MSCFModel_Wiedemann::emergency ( SUMOReal  dv,
SUMOReal  dx 
) const
private

Definition at line 175 of file MSCFModel_Wiedemann.cpp.

References MSCFModel::myDecel.

Referenced by _v().

SUMOReal MSCFModel_Wiedemann::following ( SUMOReal  sign) const
private

Definition at line 162 of file MSCFModel_Wiedemann.cpp.

References myMinAccel, and sign.

Referenced by _v().

SUMOReal MSCFModel_Wiedemann::followSpeed ( const MSVehicle *const  veh,
SUMOReal  speed,
SUMOReal  gap2pred,
SUMOReal  predSpeed,
SUMOReal  predMaxDecel 
) const
virtual

Computes the vehicle's safe speed (no dawdling)

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
See also:
MSCFModel::ffeV

Implements MSCFModel.

Definition at line 79 of file MSCFModel_Wiedemann.cpp.

References _v().

virtual SUMOReal MSCFModel::freeSpeed ( const MSVehicle *const  veh,
SUMOReal  speed,
SUMOReal  seen,
SUMOReal  maxSpeed 
) const
inlinevirtualinherited

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.

Parameters:
[in]vehThe vehicle (EGO)
[in]speedThe vehicle's speed
[in]seenThe look ahead distance
[in]maxSpeedThe maximum allowed speed
Returns:
EGO's safe speed

Definition at line 96 of file MSCFModel.h.

References MSCFModel::followSpeed().

Referenced by getMaxSpeedRegardingNextLanes(), MSLane::isInsertionSuccess(), MSVehicle::moveRegardingCritical(), and MSVehicle::vsafeCriticalCont().

SUMOReal MSCFModel_Wiedemann::fullspeed ( SUMOReal  v,
SUMOReal  vpref,
SUMOReal  dx,
SUMOReal  bx 
) const
private

Definition at line 150 of file MSCFModel_Wiedemann.cpp.

References MIN2(), MSCFModel::myAccel, myMinAccel, and SUMOReal.

Referenced by _v().

virtual SUMOReal MSCFModel::getHeadwayTime ( ) const
inlinevirtualinherited

Get the driver's reaction time [s].

Returns:
The reaction time of this class' drivers in s

Definition at line 193 of file MSCFModel.h.

References MSCFModel::myHeadwayTime.

Referenced by MSVehicle::checkRewindLinkLanes(), TraCIServerAPI_VehicleType::getVariable(), MSLane::maxSpeedGapInsertion(), MSVehicle::moveChecked(), MSLane::pWagSimpleInsertion(), and MSVehicle::vsafeCriticalCont().

virtual SUMOReal MSCFModel::getImperfection ( ) const
inlinevirtualinherited

Get the driver's imperfection.

Returns:
The imperfection of drivers of this class

Reimplemented in MSCFModel_KraussOrig1, and MSCFModel_PWag2009.

Definition at line 185 of file MSCFModel.h.

Referenced by TraCIServerAPI_VehicleType::getVariable().

virtual SUMOReal MSCFModel::getMaxAccel ( ) const
inlinevirtualinherited

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 169 of file MSCFModel.h.

References MSCFModel::myAccel.

Referenced by TraCIServerAPI_VehicleType::getVariable(), MSCFModel::maxNextSpeed(), MSVehicle::vsafeCriticalCont(), and MSMeanData_HBEFA::MSLaneMeanDataValues::write().

int MSCFModel_Wiedemann::getModelID ( ) const
inlinevirtual

Returns the model's name.

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

Implements MSCFModel.

Definition at line 117 of file MSCFModel_Wiedemann.h.

References SUMO_TAG_CF_WIEDEMANN.

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

Returns the minimum gap to reserve if the leader is braking at maximum.

Parameters:
[in]speedEGO's speed
[in]leaderSpeedLEADER's speed
[in]leaderMaxDecelLEADER's max. deceleration rate

Definition at line 239 of file MSCFModel.h.

References ACCEL2SPEED, MSCFModel::brakeGap(), MAX2(), SPEED2DIST, and SUMOReal.

Referenced by MSLaneChanger::change2left(), MSLaneChanger::change2right(), MSLane::freeInsertion(), MSLCM_DK2004::informBlocker(), and MSLane::isInsertionSuccess().

SUMOReal MSCFModel::getSpeedAfterMaxDecel ( SUMOReal  v) const
inlineinherited

Returns the velocity after maximum deceleration.

Parameters:
[in]vThe velocity
Returns:
The velocity after maximum deceleration

Definition at line 250 of file MSCFModel.h.

References ACCEL2SPEED, MAX2(), MSCFModel::myDecel, and SUMOReal.

Referenced by MSCFModel_Krauss::followSpeed(), MSVehicle::moveRegardingCritical(), MSCFModel_Krauss::stopSpeed(), stopSpeed(), and MSVehicle::vsafeCriticalCont().

SUMOReal MSCFModel_Wiedemann::interactionGap ( const MSVehicle * const  ,
SUMOReal  vL 
) const
virtual

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

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

Parameters:
[in]vehThe EGO vehicle
[in]vLLEADER's speed
Returns:
The interaction gap
Todo:
evaluate signature
See also:
MSCFModel::interactionGap

Reimplemented from MSCFModel.

Definition at line 97 of file MSCFModel_Wiedemann.cpp.

References D_MAX, and UNUSED_PARAMETER.

SUMOReal MSCFModel_Wiedemann::krauss_vsafe ( SUMOReal  gap,
SUMOReal  predSpeed 
) const
private

vsafe from krauss since Wiedemann is deficient at approaching

Definition at line 196 of file MSCFModel_Wiedemann.cpp.

References ACCEL2SPEED, MSCFModel::myDecel, MSCFModel::myHeadwayTime, SPEED2DIST, and SUMOReal.

Referenced by stopSpeed().

void MSCFModel::leftVehicleVsafe ( const MSVehicle *const  ego,
const MSVehicle *const  neigh,
SUMOReal vSafe 
) const
inherited

Incorporates the influence of the vehicle on the left lane.

In Germany, vehicles on the right lane must not pass a vehicle on the lane left to the if the allowed velocity>60km/h

Parameters:
[in]egoThe ego vehicle
[in]neighThe neighbor vehicle on the left lane
[in,out]vSafeCurrent vSafe; may be adapted due to the left neighbor

Definition at line 86 of file MSCFModel.cpp.

References MSCFModel::followSpeed(), MSVehicle::getCarFollowModel(), MSVehicleType::getLength(), MSCFModel::getMaxDecel(), MSVehicleType::getMinGap(), MSVehicle::getPositionOnLane(), MSVehicle::getSpeed(), MSBaseVehicle::getVehicleType(), MAX2(), MIN2(), and SUMOReal.

Referenced by MSVehicle::moveRegardingCritical().

SUMOReal MSCFModel::maxNextSpeed ( SUMOReal  speed) const
inherited

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
Returns:
The maximum possible speed for the next step

Definition at line 98 of file MSCFModel.cpp.

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

Referenced by MSCFModel_Kerner::followSpeed(), MSCFModel_Krauss::followSpeed(), MSCFModel_KraussOrig1::followSpeed(), MSLane::getFollowerOnConsecutive(), MSCFModel::interactionGap(), MSVehicle::moveChecked(), MSCFModel_KraussOrig1::moveHelper(), MSCFModel::moveHelper(), MSVehicle::moveRegardingCritical(), MSLCM_DK2004::patchSpeed(), MSCFModel_Kerner::stopSpeed(), MSCFModel_Krauss::stopSpeed(), MSCFModel_KraussOrig1::stopSpeed(), stopSpeed(), and MSVehicle::vsafeCriticalCont().

SUMOReal MSCFModel_Wiedemann::moveHelper ( MSVehicle *const  veh,
SUMOReal  vPos 
) const
virtual

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 70 of file MSCFModel_Wiedemann.cpp.

References MSCFModel_Wiedemann::VehicleVariables::accelSign, MSVehicle::getCarFollowVariables(), MSVehicle::getSpeed(), and SUMOReal.

void MSCFModel::saveState ( std::ostream &  os)
virtualinherited

Saves the model's definition into the state.

Parameters:
[in]osThe output to write the definition into

Definition at line 113 of file MSCFModel.cpp.

virtual void MSCFModel::setHeadwayTime ( SUMOReal  headwayTime)
inlinevirtualinherited

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

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

Reimplemented in MSCFModel_KraussOrig1.

Definition at line 286 of file MSCFModel.h.

References MSCFModel::myHeadwayTime.

Referenced by TraCIServerAPI_VehicleType::setVariable().

virtual void MSCFModel::setImperfection ( SUMOReal  imperfection)
inlinevirtualinherited

Sets a new value for driver imperfection.

Parameters:
[in]accelThe new driver imperfection

Reimplemented in MSCFModel_KraussOrig1.

Definition at line 278 of file MSCFModel.h.

References UNUSED_PARAMETER.

Referenced by TraCIServerAPI_VehicleType::setVariable().

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 262 of file MSCFModel.h.

References MSCFModel::myAccel.

Referenced by TraCIServerAPI_VehicleType::setVariable().

virtual void MSCFModel::setMaxDecel ( SUMOReal  decel)
inlinevirtualinherited

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

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

Reimplemented in MSCFModel_KraussOrig1.

Definition at line 270 of file MSCFModel.h.

References MSCFModel::myDecel.

Referenced by TraCIServerAPI_VehicleType::setVariable().

SUMOReal MSCFModel_Wiedemann::stopSpeed ( const MSVehicle *const  veh,
SUMOReal  gap 
) const
virtual

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

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

Implements MSCFModel.

Definition at line 85 of file MSCFModel_Wiedemann.cpp.

References MSVehicle::getSpeed(), MSCFModel::getSpeedAfterMaxDecel(), krauss_vsafe(), MAX2(), MSCFModel::maxNextSpeed(), and MIN2().


Field Documentation

const SUMOReal MSCFModel_Wiedemann::D_MAX = 150
staticprivate

free-flow distance in m

Definition at line 178 of file MSCFModel_Wiedemann.h.

Referenced by _v(), and interactionGap().

const SUMOReal MSCFModel_Wiedemann::myAX
private

front-bumper to front-bumper distance

Definition at line 169 of file MSCFModel_Wiedemann.h.

Referenced by _v().

const SUMOReal MSCFModel_Wiedemann::myCX
private

perception threshold modifier

Definition at line 172 of file MSCFModel_Wiedemann.h.

Referenced by _v().

const SUMOReal MSCFModel_Wiedemann::myEstimation
private

The driver's estimation parameter // also 'ZF2'.

Definition at line 166 of file MSCFModel_Wiedemann.h.

Referenced by _v(), and duplicate().

const SUMOReal MSCFModel_Wiedemann::myMinAccel
private

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

Definition at line 175 of file MSCFModel_Wiedemann.h.

Referenced by following(), and fullspeed().

const SUMOReal MSCFModel_Wiedemann::mySecurity
private

The driver's security parameter // also 'ZF1'.

Definition at line 163 of file MSCFModel_Wiedemann.h.

Referenced by _v(), and duplicate().

const MSVehicleType* MSCFModel::myType
protectedinherited

The type to which this model definition belongs to.

Definition at line 294 of file MSCFModel.h.

Referenced by _v(), MSCFModel_IDM::_v(), MSCFModel_IDM::desiredSpeed(), and MSCFModel::maxNextSpeed().


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