Package 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-2020 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	Description
AbstractCarFollowingModel(DesiredHeadwayModel desiredHeadwayModel, DesiredSpeedModel desiredSpeedModel)

Method Summary

Modifier and Type	Method	Description
Length	desiredHeadway(Parameters parameters, Speed speed)	Determines the desired headway in equilibrium conditions, i.e.
Speed	desiredSpeed(Parameters parameters, SpeedLimitInfo speedInfo)	Determines the desired speed.
protected abstract Acceleration	followingAcceleration(Parameters parameters, Speed speed, Speed desiredSpeed, Length desiredHeadway, PerceptionIterable<? extends Headway> leaders)	Determination of car-following acceleration, possibly based on multiple leaders.
Acceleration	followingAcceleration(Parameters parameters, 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 - DesiredHeadwayModel; desired headway model

desiredSpeedModel - DesiredSpeedModel; desired speed model

Method Detail

desiredHeadway

public final Length desiredHeadway(Parameters parameters,
                                   Speed speed)
                            throws 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; parameters

speed - Speed; speed to determine the desired headway at

Returns:

desired headway

Throws:

ParameterException - if parameter exception occurs

desiredSpeed

public final Speed desiredSpeed(Parameters parameters,
                                SpeedLimitInfo speedInfo)
                         throws ParameterException

Determines the desired speed.

Specified by:

desiredSpeed in interface DesiredSpeedModel

Parameters:

parameters - Parameters; parameters

speedInfo - SpeedLimitInfo; info regarding the desired speed for car-following

Returns:

desired speed

Throws:

ParameterException - if parameter exception occurs

followingAcceleration

public final Acceleration followingAcceleration(Parameters parameters,
                                                Speed speed,
                                                SpeedLimitInfo speedLimitInfo,
                                                PerceptionIterable<? extends Headway> leaders)
                                         throws 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; parameters

speed - Speed; current speed

speedLimitInfo - SpeedLimitInfo; info regarding the desired speed for car-following

leaders - PerceptionIterable<? extends Headway>; set of leader headways and speeds, ordered by headway (closest first)

Returns:

car-following acceleration

Throws:

ParameterException - if parameter exception occurs

followingAcceleration

protected abstract Acceleration followingAcceleration(Parameters parameters,
                                                      Speed speed,
                                                      Speed desiredSpeed,
                                                      Length desiredHeadway,
                                                      PerceptionIterable<? extends Headway> leaders)
                                               throws ParameterException

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

Parameters:

parameters - Parameters; parameters

speed - Speed; current speed

desiredSpeed - Speed; desired speed

desiredHeadway - Length; desired headway

leaders - PerceptionIterable<? extends Headway>; set of leader headways (guaranteed positive) and speeds, ordered by headway (closest first)

Returns:

car-following acceleration

Throws:

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