org.opentrafficsim.road.gtu.following

Class IDMPlus

java.lang.Object

org.opentrafficsim.road.gtu.following.AbstractGTUFollowingModel

org.opentrafficsim.road.gtu.following.IDMPlus

All Implemented Interfaces:

GTUFollowingModel

public class IDMPlus
extends AbstractGTUFollowingModel

IDMPlus implements the Integrated Lane Change Model with Relaxation and Synchronization as published by Wouter J. Schakel, Bart van Arem, Member, IEEE, and Bart D. Netten. 2012.
There are two nasty type setting errors in equation 7 in this published version of the paper. Both times an equals sign (=) after a_gain should not be there.

Copyright (c) 2013-2015 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See OpenTrafficSim License.

Version:

$Revision: 1408 $, $LastChangedDate: 2015-09-24 15:17:25 +0200 (Thu, 24 Sep 2015) $, by $Author: pknoppers $, initial version Jul 4, 2014

Author:

Peter Knoppers

Field Summary

Fields inherited from class org.opentrafficsim.road.gtu.following.AbstractGTUFollowingModel

TOODANGEROUS

Constructor Summary

Constructors

Constructor and Description
IDMPlus() Construct a new IDM+ car following model with reasonable values (reasonable for passenger cars).
IDMPlus(org.djunits.value.vdouble.scalar.Acceleration a, org.djunits.value.vdouble.scalar.Acceleration b, org.djunits.value.vdouble.scalar.Length.Rel s0, org.djunits.value.vdouble.scalar.Time.Rel tSafe, double delta) Construct a new IDMPlus car following model.

Method Summary

Modifier and Type	Method and Description
org.djunits.value.vdouble.scalar.Acceleration	computeAcceleration(org.djunits.value.vdouble.scalar.Speed followerSpeed, org.djunits.value.vdouble.scalar.Speed followerMaximumSpeed, org.djunits.value.vdouble.scalar.Speed leaderSpeed, org.djunits.value.vdouble.scalar.Length.Rel headway, org.djunits.value.vdouble.scalar.Speed speedLimit) Compute the acceleration that would be used to follow a leader. TODO We should probably add a be ready to stop before argument to prevent vehicles that cannot see their leader, or should slow down for a crossing from accelerating to unsafe speeds.
String	getLongName() Return complete textual information about this instantiation of this GTU following model.
String	getName() Return the name of this GTU following model.
org.djunits.value.vdouble.scalar.Time.Rel	getStepSize() Return the step size of this GTU following model.
org.djunits.value.vdouble.scalar.Acceleration	maximumSafeDeceleration() Return the maximum safe deceleration for use in gap acceptance models.

Methods inherited from class org.opentrafficsim.road.gtu.following.AbstractGTUFollowingModel

computeAcceleration, computeAcceleration, computeAccelerationWithNoLeader, minimumHeadway

Methods inherited from class java.lang.Object

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

Constructor Detail

IDMPlus

public IDMPlus()

Construct a new IDM+ car following model with reasonable values (reasonable for passenger cars).
These values are from Integrated Lane Change Model with Relaxation and Synchronization by Wouter J. Schakel, Victor L. Knoop, and Bart van Arem, published in Transportation Research Record: Journal of the Transportation Research Board, No. 2316, Transportation Research Board of the National Academies, Washington, D.C., 2012, pp. 47–57.

IDMPlus

public IDMPlus(org.djunits.value.vdouble.scalar.Acceleration a,
               org.djunits.value.vdouble.scalar.Acceleration b,
               org.djunits.value.vdouble.scalar.Length.Rel s0,
               org.djunits.value.vdouble.scalar.Time.Rel tSafe,
               double delta)

Construct a new IDMPlus car following model.

Parameters:

a - DoubleScalar.Abs<AccelerationUnit>; the maximum acceleration of a stationary vehicle (normal value is 1 m/s/s)

b - DoubleScalar.Abs<AccelerationUnit>; the maximum deemed-safe deceleration (this is a positive value)

s0 - DoubleScalar.Rel<LengthUnit>; the minimum stationary headway

tSafe - DoubleScalar.Rel<TimeUnit>; the minimum time-headway

delta - double; the speed limit adherence (1.0; mean free speed equals the speed limit; 1.1: mean free speed equals 110% of the speed limit; etc.)

Method Detail

computeAcceleration

public final org.djunits.value.vdouble.scalar.Acceleration computeAcceleration(org.djunits.value.vdouble.scalar.Speed followerSpeed,
                                                                               org.djunits.value.vdouble.scalar.Speed followerMaximumSpeed,
                                                                               org.djunits.value.vdouble.scalar.Speed leaderSpeed,
                                                                               org.djunits.value.vdouble.scalar.Length.Rel headway,
                                                                               org.djunits.value.vdouble.scalar.Speed speedLimit)

Compute the acceleration that would be used to follow a leader.
TODO We should probably add a be ready to stop before argument to prevent vehicles that cannot see their leader, or should slow down for a crossing from accelerating to unsafe speeds.

Parameters:

followerSpeed - DoubleScalar.Abs<SpeedUnit>; the speed of the follower at the current time

followerMaximumSpeed - DoubleScalar.Abs<SpeedUnit>; the maximum speed that the follower is capable of driving at

leaderSpeed - DoubleScalar.Abs<SpeedUnit>; the speed of the follower at the current time

headway - DoubleScalar.Rel<LengthUnit>; the net headway (distance between the front of the follower to the rear of the leader) at the current time

speedLimit - DoubleScalar.Abs<SpeedUnit>; the local speed limit

Returns:

DoubleScalar.Abs<AccelerationUnit>; the acceleration (or, if negative, deceleration) resulting from application of the GTU following model

getStepSize

public final org.djunits.value.vdouble.scalar.Time.Rel getStepSize()

Return the step size of this GTU following model.

Returns:

DoubleScalar.Rel<TimeUnit>; the step size of the GTU following model

maximumSafeDeceleration

public final org.djunits.value.vdouble.scalar.Acceleration maximumSafeDeceleration()

Return the maximum safe deceleration for use in gap acceptance models. This is the deceleration that may be enforced upon a new follower due to entering a road or changing into an adjacent lane. The result shall be a positive value. In most car following models this value is named b.

Returns:

DoubleScalar.Abs<AccelerationUnit>; must be a positive value!

getName

public final String getName()

Return the name of this GTU following model.

Returns:

String; just the name of the GTU following model

getLongName

public final String getLongName()

Return complete textual information about this instantiation of this GTU following model.

Returns:

String; the name and parameter values of the GTU following model