org.opentrafficsim.road.gtu.lane.tactical.following

Class IDM

java.lang.Object

org.opentrafficsim.road.gtu.lane.tactical.following.AbstractCarFollowingModel

org.opentrafficsim.road.gtu.lane.tactical.following.IDM

All Implemented Interfaces:

CarFollowingModel, GTUFollowingModelOld

Direct Known Subclasses:

IDMPlus

public class IDM
extends AbstractCarFollowingModel

Implementation of the IDM. See https://en.wikipedia.org/wiki/Intelligent_driver_model

Author:

Wouter Schakel

Field Summary

Fields

Modifier and Type	Field and Description
static org.opentrafficsim.core.gtu.drivercharacteristics.ParameterTypeDouble	DELTA Speed limit adherence factor.

Constructor Summary

Constructors

Constructor and Description
IDM()

Method Summary

Modifier and Type	Method and Description
org.djunits.value.vdouble.scalar.Length.Rel	desiredHeadway(LaneBasedGTU gtu, org.djunits.value.vdouble.scalar.Speed speed) Determines the desired headway.
org.djunits.value.vdouble.scalar.Speed	desiredSpeed(LaneBasedGTU gtu, org.djunits.value.vdouble.scalar.Speed speedLimit, boolean enforcement, org.djunits.value.vdouble.scalar.Speed maximumVehicleSpeed) Determines the desired speed.
protected org.djunits.value.vdouble.scalar.Length.Rel	dynamicDesiredHeadway(LaneBasedGTU gtu, org.djunits.value.vdouble.scalar.Speed speed, org.djunits.value.vdouble.scalar.Length.Rel desiredHeadway, org.djunits.value.vdouble.scalar.Speed leaderSpeed) Determines the dynamic desired headway, which is non-negative.
protected org.djunits.value.vdouble.scalar.Length.Rel	dynamicHeadwayTerm(LaneBasedGTU gtu, org.djunits.value.vdouble.scalar.Speed speed, org.djunits.value.vdouble.scalar.Speed leaderSpeed) Determines the dynamic headway term.
protected org.djunits.value.vdouble.scalar.Acceleration	followingAcceleration(LaneBasedGTU gtu, org.djunits.value.vdouble.scalar.Speed speed, org.djunits.value.vdouble.scalar.Speed desiredSpeed, org.djunits.value.vdouble.scalar.Length.Rel desiredHeadway, SortedMap<org.djunits.value.vdouble.scalar.Length.Rel,org.djunits.value.vdouble.scalar.Speed> leaders) Multi-anticipative determination of car-following acceleration.
String	getLongName() Return the name complete of the car-following model.
String	getName() Return the name of the car-following model.

Methods inherited from class org.opentrafficsim.road.gtu.lane.tactical.following.AbstractCarFollowingModel

computeAcceleration, computeAcceleration, computeAccelerationStep, computeAccelerationStep, computeAccelerationStep, computeAccelerationStep, computeAccelerationStepWithNoLeader, computeAccelerationStepWithNoLeader, computeDualAccelerationStep, computeDualAccelerationStep, followingAcceleration, followingAcceleration, freeAcceleration, getMaximumSafeDeceleration, getStepSize, minimumHeadway

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DELTA

public static final org.opentrafficsim.core.gtu.drivercharacteristics.ParameterTypeDouble DELTA

Speed limit adherence factor.

Constructor Detail

IDM

public IDM()

Method Detail

desiredSpeed

public org.djunits.value.vdouble.scalar.Speed desiredSpeed(LaneBasedGTU gtu,
                                                           org.djunits.value.vdouble.scalar.Speed speedLimit,
                                                           boolean enforcement,
                                                           org.djunits.value.vdouble.scalar.Speed maximumVehicleSpeed)
                                                    throws org.opentrafficsim.core.gtu.drivercharacteristics.ParameterException

Determines the desired speed.

Parameters:

gtu - GTU for which the acceleration is calculated.

speedLimit - Speed limit, static or dynamic.

enforcement - Whether the speed limit is enforced by camera, section control, etc.

maximumVehicleSpeed - Maximum speed of the vehicle.

Returns:

Desired speed.

Throws:

org.opentrafficsim.core.gtu.drivercharacteristics.ParameterException - If parameter exception occurs.

desiredHeadway

public org.djunits.value.vdouble.scalar.Length.Rel desiredHeadway(LaneBasedGTU gtu,
                                                                  org.djunits.value.vdouble.scalar.Speed speed)
                                                           throws org.opentrafficsim.core.gtu.drivercharacteristics.ParameterException

Determines the desired headway.

Parameters:

gtu - GTU for which the acceleration is calculated.

speed - Speed to determine the desired headway at.

Returns:

Desired headway.

Throws:

org.opentrafficsim.core.gtu.drivercharacteristics.ParameterException - If parameter exception occurs.

getName

public String getName()

Return the name of the car-following model.

Returns:

Name of the car-following model.

getLongName

public String getLongName()

Return the name complete of the car-following model.

Returns:

Complete name of the car-following model.

followingAcceleration

protected org.djunits.value.vdouble.scalar.Acceleration followingAcceleration(LaneBasedGTU gtu,
                                                                              org.djunits.value.vdouble.scalar.Speed speed,
                                                                              org.djunits.value.vdouble.scalar.Speed desiredSpeed,
                                                                              org.djunits.value.vdouble.scalar.Length.Rel desiredHeadway,
                                                                              SortedMap<org.djunits.value.vdouble.scalar.Length.Rel,org.djunits.value.vdouble.scalar.Speed> leaders)
                                                                       throws org.opentrafficsim.core.gtu.drivercharacteristics.ParameterException

Multi-anticipative determination of car-following acceleration. The implementation should be able to deal with the current speed being higher than the desired speed. The tactical planner determines whether multi-anticipative car-following is applied, including to how many leaders and within what distance, by including these vehicles in the set. The car-following model itself may however only respond to the first vehicle.

Specified by:

followingAcceleration in class AbstractCarFollowingModel

Parameters:

gtu - GTU for which the acceleration is calculated.

speed - Current speed.

desiredSpeed - Desired speed.

desiredHeadway - Desired headway.

leaders - Set of leader headways (guaranteed positive) and speeds, ordered by headway (closest first).

Returns:

Car-following acceleration.

Throws:

org.opentrafficsim.core.gtu.drivercharacteristics.ParameterException - If parameter exception occurs.

dynamicDesiredHeadway

protected org.djunits.value.vdouble.scalar.Length.Rel dynamicDesiredHeadway(LaneBasedGTU gtu,
                                                                            org.djunits.value.vdouble.scalar.Speed speed,
                                                                            org.djunits.value.vdouble.scalar.Length.Rel desiredHeadway,
                                                                            org.djunits.value.vdouble.scalar.Speed leaderSpeed)
                                                                     throws org.opentrafficsim.core.gtu.drivercharacteristics.ParameterException

Determines the dynamic desired headway, which is non-negative.

Parameters:

gtu - GTU for which the dynamic desired headway is calculated.

speed - Current speed.

desiredHeadway - Desired speed.

leaderSpeed - Speed of the leading vehicle.

Returns:

Dynamic desired headway.

Throws:

org.opentrafficsim.core.gtu.drivercharacteristics.ParameterException - x

dynamicHeadwayTerm

protected org.djunits.value.vdouble.scalar.Length.Rel dynamicHeadwayTerm(LaneBasedGTU gtu,
                                                                         org.djunits.value.vdouble.scalar.Speed speed,
                                                                         org.djunits.value.vdouble.scalar.Speed leaderSpeed)
                                                                  throws org.opentrafficsim.core.gtu.drivercharacteristics.ParameterException

Determines the dynamic headway term. May be used on individual leaders for multi-anticipative following.

Parameters:

gtu - GTU for which the dynamic desired headway term is calculated.

speed - Current speed.

leaderSpeed - Speed of the leading vehicle.

Returns:

Dynamic headway term.

Throws:

org.opentrafficsim.core.gtu.drivercharacteristics.ParameterException - x