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

public abstract class AbstractCarFollowingModel
extends Object
implements CarFollowingModel

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

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

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)	Constructor.

Method Summary

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

AbstractCarFollowingModel

public AbstractCarFollowingModel(DesiredHeadwayModel desiredHeadwayModel,
 DesiredSpeedModel desiredSpeedModel)

Constructor.

Parameters:

desiredHeadwayModel - desired headway model

desiredSpeedModel - desired speed model

Method Details

desiredHeadway

public final Length desiredHeadway(Parameters parameters,
 Speed speed)
                            throws ParameterException

Description copied from interface: DesiredHeadwayModel

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:

ParameterException - if parameter exception occurs

desiredSpeed

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

Description copied from interface: DesiredSpeedModel

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:

ParameterException - if parameter exception occurs

followingAcceleration

public final Acceleration followingAcceleration(Parameters parameters,
 Speed speed,
 SpeedLimitInfo speedLimitInfo,
 PerceptionIterable<? extends PerceivedObject> leaders)
                                         throws ParameterException

Description copied from interface: CarFollowingModel

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:

ParameterException - if parameter exception occurs

followingAcceleration

protected abstract Acceleration followingAcceleration(Parameters parameters,
 Speed speed,
 Speed desiredSpeed,
 Length desiredHeadway,
 PerceptionIterable<? extends PerceivedObject> leaders)
                                               throws 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:

ParameterException - if parameter exception occurs

toString

public String toString()

Overrides:

toString in class Object

init

public final void init(LaneBasedGtu gtu)

Description copied from interface: Initialisable

Initialize car-following model.

Specified by:

init in interface CarFollowingModel

Specified by:

init in interface Initialisable

Parameters:

gtu - gtu