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

Class AbstractCarFollowingModel

java.lang.Object

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

All Implemented Interfaces:

CarFollowingModel, DesiredHeadwayModel, DesiredSpeedModel, Initialisable

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-2018 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

Field Summary

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

CAR_FOLLOWING_MODEL

Constructor Summary

Constructors

Constructor and Description
AbstractCarFollowingModel(DesiredHeadwayModel desiredHeadwayModel, DesiredSpeedModel desiredSpeedModel)

Method Summary

Modifier and Type	Method and Description
org.djunits.value.vdouble.scalar.Length	desiredHeadway(org.opentrafficsim.base.parameters.Parameters parameters, org.djunits.value.vdouble.scalar.Speed speed) Determines the desired headway in equilibrium conditions, i.e.
org.djunits.value.vdouble.scalar.Speed	desiredSpeed(org.opentrafficsim.base.parameters.Parameters parameters, SpeedLimitInfo speedInfo) Determines the desired speed.
protected abstract org.djunits.value.vdouble.scalar.Acceleration	followingAcceleration(org.opentrafficsim.base.parameters.Parameters parameters, org.djunits.value.vdouble.scalar.Speed speed, org.djunits.value.vdouble.scalar.Speed desiredSpeed, org.djunits.value.vdouble.scalar.Length desiredHeadway, PerceptionIterable<? extends Headway> leaders) Determination of car-following acceleration, possibly based on multiple leaders.
org.djunits.value.vdouble.scalar.Acceleration	followingAcceleration(org.opentrafficsim.base.parameters.Parameters parameters, org.djunits.value.vdouble.scalar.Speed speed, SpeedLimitInfo speedLimitInfo, PerceptionIterable<? extends Headway> leaders) Determination of car-following acceleration, possibly based on multiple leaders.
void	init(LaneBasedGTU gtu) Initialize car-following model.
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

getLongName, getName

Constructor Detail

AbstractCarFollowingModel

public AbstractCarFollowingModel(DesiredHeadwayModel desiredHeadwayModel,
                                 DesiredSpeedModel desiredSpeedModel)

Parameters:

desiredHeadwayModel - desired headway model

desiredSpeedModel - desired speed model

Method Detail

desiredHeadway

public final org.djunits.value.vdouble.scalar.Length desiredHeadway(org.opentrafficsim.base.parameters.Parameters parameters,
                                                                    org.djunits.value.vdouble.scalar.Speed speed)
                                                             throws org.opentrafficsim.base.parameters.ParameterException

Determines the desired headway in equilibrium conditions, i.e. no speed difference with the leader.

Specified by:

desiredHeadway in interface DesiredHeadwayModel

Parameters:

parameters - parameters

speed - speed to determine the desired headway at

Returns:

desired headway

Throws:

org.opentrafficsim.base.parameters.ParameterException - if parameter exception occurs

desiredSpeed

public final org.djunits.value.vdouble.scalar.Speed desiredSpeed(org.opentrafficsim.base.parameters.Parameters parameters,
                                                                 SpeedLimitInfo speedInfo)
                                                          throws org.opentrafficsim.base.parameters.ParameterException

Determines the desired speed.

Specified by:

desiredSpeed in interface DesiredSpeedModel

Parameters:

parameters - parameters

speedInfo - info regarding the desired speed for car-following

Returns:

desired speed

Throws:

org.opentrafficsim.base.parameters.ParameterException - if parameter exception occurs

followingAcceleration

public final org.djunits.value.vdouble.scalar.Acceleration followingAcceleration(org.opentrafficsim.base.parameters.Parameters parameters,
                                                                                 org.djunits.value.vdouble.scalar.Speed speed,
                                                                                 SpeedLimitInfo speedLimitInfo,
                                                                                 PerceptionIterable<? extends Headway> leaders)
                                                                          throws org.opentrafficsim.base.parameters.ParameterException

Determination of car-following acceleration, possibly based on multiple leaders. The implementation should be able to deal with:

• The current speed being higher than the desired speed.
• The headway being negative.

Specified by:

followingAcceleration in interface CarFollowingModel

Parameters:

parameters - parameters

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

followingAcceleration

protected abstract org.djunits.value.vdouble.scalar.Acceleration followingAcceleration(org.opentrafficsim.base.parameters.Parameters parameters,
                                                                                       org.djunits.value.vdouble.scalar.Speed speed,
                                                                                       org.djunits.value.vdouble.scalar.Speed desiredSpeed,
                                                                                       org.djunits.value.vdouble.scalar.Length desiredHeadway,
                                                                                       PerceptionIterable<? extends Headway> leaders)
                                                                                throws org.opentrafficsim.base.parameters.ParameterException

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

Parameters:

parameters - parameters

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

toString

public String toString()

Overrides:

toString in class Object

init

public final void init(LaneBasedGTU gtu)

Initialize car-following model.

Specified by:

init in interface CarFollowingModel

Specified by:

init in interface Initialisable

Parameters:

gtu - LaneBasedGTU; gtu