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

Class AbstractCarFollowingModel

java.lang.Object

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

All Implemented Interfaces:

CarFollowingModel

Direct Known Subclasses:

AbstractIDM, ToledoCarFollowing

public abstract class AbstractCarFollowingModel
extends Object
implements CarFollowingModel

Default implementation where desired speed and headway are pre-calculated for car-following.

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

Version:

$Revision$, $LastChangedDate$, by $Author$, initial version Apr 2016

Author:

Wouter Schakel

Constructor Summary

Constructors

Constructor and Description
AbstractCarFollowingModel()

Method Summary

Modifier and Type	Method and Description
protected abstract org.djunits.value.vdouble.scalar.Acceleration	followingAcceleration(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics, org.djunits.value.vdouble.scalar.Speed speed, org.djunits.value.vdouble.scalar.Speed desiredSpeed, org.djunits.value.vdouble.scalar.Length desiredHeadway, SortedMap<org.djunits.value.vdouble.scalar.Length,org.djunits.value.vdouble.scalar.Speed> leaders) Determination of car-following acceleration, possibly based on multiple leaders.
org.djunits.value.vdouble.scalar.Acceleration	followingAcceleration(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics, org.djunits.value.vdouble.scalar.Speed speed, SpeedLimitInfo speedLimitInfo, SortedMap<org.djunits.value.vdouble.scalar.Length,org.djunits.value.vdouble.scalar.Speed> leaders) Forwards the calculation to a similar method with desired speed and desired (equilibrium) headway pre-calculated.
String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.opentrafficsim.road.gtu.lane.tactical.following.CarFollowingModel

desiredHeadway, desiredSpeed, getLongName, getName

Constructor Detail

AbstractCarFollowingModel

public AbstractCarFollowingModel()

Method Detail

followingAcceleration

public final org.djunits.value.vdouble.scalar.Acceleration followingAcceleration(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics,
                                                                                 org.djunits.value.vdouble.scalar.Speed speed,
                                                                                 SpeedLimitInfo speedLimitInfo,
                                                                                 SortedMap<org.djunits.value.vdouble.scalar.Length,org.djunits.value.vdouble.scalar.Speed> leaders)
                                                                          throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Forwards the calculation to a similar method with desired speed and desired (equilibrium) headway pre-calculated. Additionally, if the headway to the (first) leader is negative, Double.NEGATIVE_INFINITY is returned as an 'inappropriate' acceleration, since car-following models are then undefined. This may for example occur when checking a gap in an adjacent lane for lane changing. It is then up to the client to decide what to do. E.g. limit deceleration to an extent depending on the circumstances, or divert from a certain behavior.

Specified by:

followingAcceleration in interface CarFollowingModel

Parameters:

behavioralCharacteristics - behavioral characteristics

speed - current speed

speedLimitInfo - info regarding the desired speed for car-following

leaders - set of leader headways and speeds, ordered by headway (closest first)

Returns:

car-following acceleration

Throws:

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if parameter exception occurs

NullPointerException - if any input is null

followingAcceleration

protected abstract org.djunits.value.vdouble.scalar.Acceleration followingAcceleration(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics,
                                                                                       org.djunits.value.vdouble.scalar.Speed speed,
                                                                                       org.djunits.value.vdouble.scalar.Speed desiredSpeed,
                                                                                       org.djunits.value.vdouble.scalar.Length desiredHeadway,
                                                                                       SortedMap<org.djunits.value.vdouble.scalar.Length,org.djunits.value.vdouble.scalar.Speed> leaders)
                                                                                throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Determination of car-following acceleration, possibly based on multiple leaders.

Parameters:

behavioralCharacteristics - behavioral characteristics

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.behavioralcharacteristics.ParameterException - if parameter exception occurs

toString

public String toString()

Overrides:

toString in class Object