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

Class AbstractCarFollowingModel

java.lang.Object

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

All Implemented Interfaces:

CarFollowingModel, GTUFollowingModelOld

Direct Known Subclasses:

IDM

public abstract class AbstractCarFollowingModel
extends Object
implements CarFollowingModel, GTUFollowingModelOld

Implements free, single-leader and multi-anticipative methods as forwards to a new multi-anticipative method with desired headway and speed pre-calculated. The information forwarded to the new method implies a leader at infinite headway for free acceleration, and a single vehicle in the set for single-leader acceleration. As a result, implementations of this class only need to implement a single, and simpler, method covering different calls to the car-following model. The headway towards the first vehicle being followed is guaranteed to be positive. TODO: do not implement GTUFollowingModelOld

Author:

Wouter Schakel

Constructor Summary

Constructors

Constructor and Description
AbstractCarFollowingModel()

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.
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, org.djunits.value.vdouble.scalar.Time.Rel stepSize) Compute the acceleration that would be used to follow a leader.
AccelerationStep	computeAccelerationStep(LaneBasedGTU gtu, org.djunits.value.vdouble.scalar.Speed leaderSpeed, org.djunits.value.vdouble.scalar.Length.Rel headway, org.djunits.value.vdouble.scalar.Length.Rel maxDistance, org.djunits.value.vdouble.scalar.Speed speedLimit) Compute the acceleration that would be used to follow a leader.
AccelerationStep	computeAccelerationStep(LaneBasedGTU gtu, org.djunits.value.vdouble.scalar.Speed leaderSpeed, org.djunits.value.vdouble.scalar.Length.Rel headway, org.djunits.value.vdouble.scalar.Length.Rel maxDistance, org.djunits.value.vdouble.scalar.Speed speedLimit, org.djunits.value.vdouble.scalar.Time.Rel stepSize) Compute the acceleration that would be used to follow a leader.
AccelerationStep	computeAccelerationStep(org.djunits.value.vdouble.scalar.Speed followerSpeed, org.djunits.value.vdouble.scalar.Speed leaderSpeed, org.djunits.value.vdouble.scalar.Length.Rel headway, org.djunits.value.vdouble.scalar.Speed speedLimit, org.djunits.value.vdouble.scalar.Time.Abs currentTime) Compute the acceleration that would be used to follow a leader.
AccelerationStep	computeAccelerationStep(org.djunits.value.vdouble.scalar.Speed followerSpeed, org.djunits.value.vdouble.scalar.Speed leaderSpeed, org.djunits.value.vdouble.scalar.Length.Rel headway, org.djunits.value.vdouble.scalar.Speed speedLimit, org.djunits.value.vdouble.scalar.Time.Abs currentTime, org.djunits.value.vdouble.scalar.Time.Rel stepSize) Compute the acceleration that would be used to follow a leader.
AccelerationStep	computeAccelerationStepWithNoLeader(LaneBasedGTU gtu, org.djunits.value.vdouble.scalar.Length.Rel maxDistance, org.djunits.value.vdouble.scalar.Speed speedLimit) Compute the acceleration that would be used if the is not leader in sight.
AccelerationStep	computeAccelerationStepWithNoLeader(LaneBasedGTU gtu, org.djunits.value.vdouble.scalar.Length.Rel maxDistance, org.djunits.value.vdouble.scalar.Speed speedLimit, org.djunits.value.vdouble.scalar.Time.Rel stepSize) Compute the acceleration that would be used if the is not leader in sight.
DualAccelerationStep	computeDualAccelerationStep(LaneBasedGTU gtu, Collection<HeadwayGTU> otherGtuHeadways, org.djunits.value.vdouble.scalar.Length.Rel maxDistance, org.djunits.value.vdouble.scalar.Speed speedLimit) Compute the lowest accelerations (or most severe decelerations) that would be used if a referenceGTU is present (inserted, or not removed) in a set of other GTUs. If any GTU in the set of otherGTUs has a null headway (indicating that the other GTU is in fact parallel to the referenceGTU), prohibitive decelerations shall be returned. Two AccelerationStep values are returned in a DualAccelerationStep. or should slow down for a crossing from accelerating to unsafe speeds.
DualAccelerationStep	computeDualAccelerationStep(LaneBasedGTU gtu, Collection<HeadwayGTU> otherGtuHeadways, org.djunits.value.vdouble.scalar.Length.Rel maxDistance, org.djunits.value.vdouble.scalar.Speed speedLimit, org.djunits.value.vdouble.scalar.Time.Rel stepSize) Compute the lowest accelerations (or most severe decelerations) that would be used if a referenceGTU is present (inserted, or not removed) in a set of other GTUs. If any GTU in the set of otherGTUs has a null headway (indicating that the other GTU is in fact parallel to the referenceGTU), prohibitive decelerations shall be returned. Two AccelerationStep values are returned in a DualAccelerationStep. or should slow down for a crossing from accelerating to unsafe speeds.
org.djunits.value.vdouble.scalar.Acceleration	followingAcceleration(LaneBasedGTU gtu, org.djunits.value.vdouble.scalar.Speed speed, org.djunits.value.vdouble.scalar.Speed speedLimit, boolean enforcement, org.djunits.value.vdouble.scalar.Speed maximumVehicleSpeed, org.djunits.value.vdouble.scalar.Length.Rel headway, org.djunits.value.vdouble.scalar.Speed leaderSpeed) Determines car-following acceleration.
org.djunits.value.vdouble.scalar.Acceleration	followingAcceleration(LaneBasedGTU gtu, org.djunits.value.vdouble.scalar.Speed speed, org.djunits.value.vdouble.scalar.Speed speedLimit, boolean enforcement, org.djunits.value.vdouble.scalar.Speed maximumVehicleSpeed, SortedMap<org.djunits.value.vdouble.scalar.Length.Rel,org.djunits.value.vdouble.scalar.Speed> leaders) Multi-anticipative determination of car-following acceleration.
protected abstract org.djunits.value.vdouble.scalar.Acceleration	followingAcceleration(LaneBasedGTU gtu, org.djunits.value.vdouble.scalar.Speed speed, org.djunits.value.vdouble.scalar.Speed desiredSpeed, org.djunits.value.vdouble.scalar.Length.Rel desiredHeadway, SortedMap<org.djunits.value.vdouble.scalar.Length.Rel,org.djunits.value.vdouble.scalar.Speed> leaders) Multi-anticipative determination of car-following acceleration.
org.djunits.value.vdouble.scalar.Acceleration	freeAcceleration(LaneBasedGTU gtu, org.djunits.value.vdouble.scalar.Speed speed, org.djunits.value.vdouble.scalar.Speed speedLimit, boolean enforcement, org.djunits.value.vdouble.scalar.Speed maximumVehicleSpeed) Determines the acceleration if there is no reason to decelerate.
org.djunits.value.vdouble.scalar.Acceleration	getMaximumSafeDeceleration() Return the maximum safe deceleration for use in gap acceptance models.
org.djunits.value.vdouble.scalar.Time.Rel	getStepSize() Return the standard step size of this GTU following model.
org.djunits.value.vdouble.scalar.Length.Rel	minimumHeadway(org.djunits.value.vdouble.scalar.Speed followerSpeed, org.djunits.value.vdouble.scalar.Speed leaderSpeed, org.djunits.value.vdouble.scalar.Length.Rel precision, org.djunits.value.vdouble.scalar.Length.Rel maxDistance, org.djunits.value.vdouble.scalar.Speed speedLimit, org.djunits.value.vdouble.scalar.Speed followerMaximumSpeed) Compute the minimum net headway given the speed of the follower and the leader. At the returned headway, the follower would decelerate with it's maximum comfortable deceleration.

Methods inherited from class java.lang.Object

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

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

desiredHeadway, desiredSpeed, getLongName, getName

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

getLongName, getName

Constructor Detail

AbstractCarFollowingModel

public AbstractCarFollowingModel()

Method Detail

freeAcceleration

public org.djunits.value.vdouble.scalar.Acceleration freeAcceleration(LaneBasedGTU gtu,
                                                                      org.djunits.value.vdouble.scalar.Speed speed,
                                                                      org.djunits.value.vdouble.scalar.Speed speedLimit,
                                                                      boolean enforcement,
                                                                      org.djunits.value.vdouble.scalar.Speed maximumVehicleSpeed)
                                                               throws org.opentrafficsim.core.gtu.drivercharacteristics.ParameterException

Determines the acceleration if there is no reason to decelerate.

Specified by:

freeAcceleration in interface CarFollowingModel

Parameters:

gtu - GTU for which the acceleration is calculated.

speed - Current speed.

speedLimit - Speed limit, static or dynamic.

enforcement - Whether the speed limit is enforced by camera, section control, etc.

maximumVehicleSpeed - Maximum speed of the vehicle.

Returns:

Acceleration if there is no reason to decelerate.

Throws:

org.opentrafficsim.core.gtu.drivercharacteristics.ParameterException - If parameter exception occurs.

followingAcceleration

public org.djunits.value.vdouble.scalar.Acceleration followingAcceleration(LaneBasedGTU gtu,
                                                                           org.djunits.value.vdouble.scalar.Speed speed,
                                                                           org.djunits.value.vdouble.scalar.Speed speedLimit,
                                                                           boolean enforcement,
                                                                           org.djunits.value.vdouble.scalar.Speed maximumVehicleSpeed,
                                                                           org.djunits.value.vdouble.scalar.Length.Rel headway,
                                                                           org.djunits.value.vdouble.scalar.Speed leaderSpeed)
                                                                    throws org.opentrafficsim.core.gtu.drivercharacteristics.ParameterException

Determines car-following acceleration. 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:

gtu - GTU for which the acceleration is calculated.

speed - Current speed.

speedLimit - Speed limit, static or dynamic.

enforcement - Whether the speed limit is enforced by camera, section control, etc.

maximumVehicleSpeed - Maximum speed of the vehicle.

headway - Net headway towards the leading vehicle.

leaderSpeed - Speed of the leading vehicle.

Returns:

Car-following acceleration.

Throws:

org.opentrafficsim.core.gtu.drivercharacteristics.ParameterException - If parameter exception occurs.

followingAcceleration

public org.djunits.value.vdouble.scalar.Acceleration followingAcceleration(LaneBasedGTU gtu,
                                                                           org.djunits.value.vdouble.scalar.Speed speed,
                                                                           org.djunits.value.vdouble.scalar.Speed speedLimit,
                                                                           boolean enforcement,
                                                                           org.djunits.value.vdouble.scalar.Speed maximumVehicleSpeed,
                                                                           SortedMap<org.djunits.value.vdouble.scalar.Length.Rel,org.djunits.value.vdouble.scalar.Speed> leaders)
                                                                    throws org.opentrafficsim.core.gtu.drivercharacteristics.ParameterException

Multi-anticipative determination of car-following acceleration. The implementation should be able to deal with:
The current speed being higher than the desired speed. The headway being negative. The tactical planner determines whether multi-anticipative car-following is applied, including to how many leaders and within what distance, by including these vehicles in the set. The car-following model itself may however only respond to the first vehicle.

Specified by:

followingAcceleration in interface CarFollowingModel

Parameters:

gtu - GTU for which the acceleration is calculated.

speed - Current speed.

speedLimit - Speed limit, static or dynamic.

enforcement - Whether the speed limit is enforced by camera, section control, etc.

maximumVehicleSpeed - Maximum speed of the vehicle.

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

Returns:

Car-following acceleration.

Throws:

org.opentrafficsim.core.gtu.drivercharacteristics.ParameterException - If parameter exception occurs.

followingAcceleration

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

Multi-anticipative determination of car-following acceleration. The implementation should be able to deal with the current speed being higher than the desired speed. The tactical planner determines whether multi-anticipative car-following is applied, including to how many leaders and within what distance, by including these vehicles in the set. The car-following model itself may however only respond to the first vehicle.

Parameters:

gtu - GTU for which the acceleration is calculated.

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.drivercharacteristics.ParameterException - If parameter exception occurs.

computeAccelerationStep

public AccelerationStep computeAccelerationStep(LaneBasedGTU gtu,
                                                org.djunits.value.vdouble.scalar.Speed leaderSpeed,
                                                org.djunits.value.vdouble.scalar.Length.Rel headway,
                                                org.djunits.value.vdouble.scalar.Length.Rel maxDistance,
                                                org.djunits.value.vdouble.scalar.Speed speedLimit)
                                         throws org.opentrafficsim.core.gtu.GTUException

Description copied from interface: GTUFollowingModelOld

Compute the acceleration that would be used to follow a leader.

Specified by:

computeAccelerationStep in interface GTUFollowingModelOld

Parameters:

gtu - LaneBasedGTU; the GTU for which acceleration is computed

leaderSpeed - Speed; the speed of the leader

headway - Length.Rel; the headway of the leader

maxDistance - Length.Rel; the maximum distance we can cover at the current time, e.g. as the result of a lane drop

speedLimit - Speed; the local speed limit

Returns:

AccelerationStep; the result of application of the GTU following model

Throws:

org.opentrafficsim.core.gtu.GTUException - when the velocity of the gtu cannot be determined

computeAccelerationStep

public AccelerationStep computeAccelerationStep(LaneBasedGTU gtu,
                                                org.djunits.value.vdouble.scalar.Speed leaderSpeed,
                                                org.djunits.value.vdouble.scalar.Length.Rel headway,
                                                org.djunits.value.vdouble.scalar.Length.Rel maxDistance,
                                                org.djunits.value.vdouble.scalar.Speed speedLimit,
                                                org.djunits.value.vdouble.scalar.Time.Rel stepSize)
                                         throws org.opentrafficsim.core.gtu.GTUException

Description copied from interface: GTUFollowingModelOld

Compute the acceleration that would be used to follow a leader.

Specified by:

computeAccelerationStep in interface GTUFollowingModelOld

Parameters:

gtu - LaneBasedGTU; the GTU for which acceleration is computed

leaderSpeed - Speed; the speed of the leader

headway - Length.Rel; the headway of the leader

maxDistance - Length.Rel; the maximum distance we can cover at the current time, e.g. as the result of a lane drop

speedLimit - Speed; the local speed limit

stepSize - given step size, which can be longer or shorter than the provided step size in the algorithms.

Returns:

AccelerationStep; the result of application of the GTU following model

Throws:

org.opentrafficsim.core.gtu.GTUException - when the velocity of the gtu cannot be determined

computeAcceleration

public 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)

Description copied from interface: GTUFollowingModelOld

Compute the acceleration that would be used to follow a leader.

Specified by:

computeAcceleration in interface GTUFollowingModelOld

Parameters:

followerSpeed - Speed; the speed of the follower at the current time

followerMaximumSpeed - Speed; the maximum speed that the follower is capable of driving at

leaderSpeed - Speed; the speed of the follower at the current time

headway - Length.Rel; the net headway (distance between the front of the follower to the rear of the leader) at the current time, or the maximum distance we can cover at the current time, e.g. as the result of a lane drop

speedLimit - Speed; the local speed limit

Returns:

Acceleration; the acceleration (or, if negative, deceleration) resulting from application of the GTU following model

computeAcceleration

public 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,
                                                                         org.djunits.value.vdouble.scalar.Time.Rel stepSize)

Description copied from interface: GTUFollowingModelOld

Compute the acceleration that would be used to follow a leader.

Specified by:

computeAcceleration in interface GTUFollowingModelOld

Parameters:

followerSpeed - Speed; the speed of the follower at the current time

followerMaximumSpeed - Speed; the maximum speed that the follower is capable of driving at

leaderSpeed - Speed; the speed of the follower at the current time

headway - Length.Rel; the net headway (distance between the front of the follower to the rear of the leader) at the current time, or the maximum distance we can cover at the current time, e.g. as the result of a lane drop

speedLimit - Speed; the local speed limit

stepSize - given step size, which can be longer or shorter than the provided step size in the algorithms.

Returns:

Acceleration; the acceleration (or, if negative, deceleration) resulting from application of the GTU following model

computeAccelerationStep

public AccelerationStep computeAccelerationStep(org.djunits.value.vdouble.scalar.Speed followerSpeed,
                                                org.djunits.value.vdouble.scalar.Speed leaderSpeed,
                                                org.djunits.value.vdouble.scalar.Length.Rel headway,
                                                org.djunits.value.vdouble.scalar.Speed speedLimit,
                                                org.djunits.value.vdouble.scalar.Time.Abs currentTime)

Description copied from interface: GTUFollowingModelOld

Compute the acceleration that would be used to follow a leader.

Specified by:

computeAccelerationStep in interface GTUFollowingModelOld

Parameters:

followerSpeed - Speed; the speed of the follower at the current time

leaderSpeed - Speed; the speed of the follower at the current time

headway - Length.Rel; the net headway (distance between the front of the follower to the rear of the leader) at the current time, or the maximum distance we can cover at the current time, e.g. as the result of a lane drop

speedLimit - Speed; the local speed limit

currentTime - to be used to determine the validity of the AccelerationStep

Returns:

Acceleration; the acceleration (or, if negative, deceleration) resulting from application of the GTU following model

computeAccelerationStep

public AccelerationStep computeAccelerationStep(org.djunits.value.vdouble.scalar.Speed followerSpeed,
                                                org.djunits.value.vdouble.scalar.Speed leaderSpeed,
                                                org.djunits.value.vdouble.scalar.Length.Rel headway,
                                                org.djunits.value.vdouble.scalar.Speed speedLimit,
                                                org.djunits.value.vdouble.scalar.Time.Abs currentTime,
                                                org.djunits.value.vdouble.scalar.Time.Rel stepSize)

Description copied from interface: GTUFollowingModelOld

Compute the acceleration that would be used to follow a leader.

Specified by:

computeAccelerationStep in interface GTUFollowingModelOld

Parameters:

followerSpeed - Speed; the speed of the follower at the current time

leaderSpeed - Speed; the speed of the follower at the current time

headway - Length.Rel; the net headway (distance between the front of the follower to the rear of the leader) at the current time, or the maximum distance we can cover at the current time, e.g. as the result of a lane drop

speedLimit - Speed; the local speed limit

currentTime - to be used to determine the validity of the AccelerationStep

stepSize - given step size, which can be longer or shorter than the provided step size in the algorithms.

Returns:

Acceleration; the acceleration (or, if negative, deceleration) resulting from application of the GTU following model

computeDualAccelerationStep

public DualAccelerationStep computeDualAccelerationStep(LaneBasedGTU gtu,
                                                        Collection<HeadwayGTU> otherGtuHeadways,
                                                        org.djunits.value.vdouble.scalar.Length.Rel maxDistance,
                                                        org.djunits.value.vdouble.scalar.Speed speedLimit)
                                                 throws org.opentrafficsim.core.gtu.GTUException

Description copied from interface: GTUFollowingModelOld

Compute the lowest accelerations (or most severe decelerations) that would be used if a referenceGTU is present (inserted, or not removed) in a set of other GTUs.
If any GTU in the set of otherGTUs has a null headway (indicating that the other GTU is in fact parallel to the referenceGTU), prohibitive decelerations shall be returned.
Two AccelerationStep values are returned in a DualAccelerationStep.
or should slow down for a crossing from accelerating to unsafe speeds.

Specified by:

computeDualAccelerationStep in interface GTUFollowingModelOld

Parameters:

gtu - LaneBasedGTU; the GTU for which the accelerations are computed

otherGtuHeadways - Collection<HeadwayGTU>; the other GTUs. A negative headway value indicates that the other GTU is a follower. NB. If the referenceGTU is contained in this Collection, it is ignored.

maxDistance - Length.Rel; the maximum distance we can cover at the current time, e.g. as the result of a lane drop

speedLimit - Speed; the local speed limit

Returns:

DualAccelerationStep; the result with the lowest accelerations (or most severe decelerations) of application of the GTU following model of the referenceGTU for each leader and follower

Throws:

org.opentrafficsim.core.gtu.GTUException - when the velocity of the gtu cannot be determined

computeDualAccelerationStep

public DualAccelerationStep computeDualAccelerationStep(LaneBasedGTU gtu,
                                                        Collection<HeadwayGTU> otherGtuHeadways,
                                                        org.djunits.value.vdouble.scalar.Length.Rel maxDistance,
                                                        org.djunits.value.vdouble.scalar.Speed speedLimit,
                                                        org.djunits.value.vdouble.scalar.Time.Rel stepSize)
                                                 throws org.opentrafficsim.core.gtu.GTUException

Description copied from interface: GTUFollowingModelOld

Compute the lowest accelerations (or most severe decelerations) that would be used if a referenceGTU is present (inserted, or not removed) in a set of other GTUs.
If any GTU in the set of otherGTUs has a null headway (indicating that the other GTU is in fact parallel to the referenceGTU), prohibitive decelerations shall be returned.
Two AccelerationStep values are returned in a DualAccelerationStep.
or should slow down for a crossing from accelerating to unsafe speeds.

Specified by:

computeDualAccelerationStep in interface GTUFollowingModelOld

Parameters:

gtu - LaneBasedGTU; the GTU for which the accelerations are computed

otherGtuHeadways - Collection<HeadwayGTU>; the other GTUs. A negative headway value indicates that the other GTU is a follower. NB. If the referenceGTU is contained in this Collection, it is ignored.

maxDistance - Length.Rel; the maximum distance we can cover at the current time, e.g. as the result of a lane drop

speedLimit - Speed; the local speed limit

stepSize - given step size, which can be longer or shorter than the provided step size in the algorithms.

Returns:

DualAccelerationStep; the result with the lowest accelerations (or most severe decelerations) of application of the GTU following model of the referenceGTU for each leader and follower

Throws:

org.opentrafficsim.core.gtu.GTUException - when the velocity of the gtu cannot be determined

computeAccelerationStepWithNoLeader

public AccelerationStep computeAccelerationStepWithNoLeader(LaneBasedGTU gtu,
                                                            org.djunits.value.vdouble.scalar.Length.Rel maxDistance,
                                                            org.djunits.value.vdouble.scalar.Speed speedLimit)
                                                     throws org.opentrafficsim.core.gtu.GTUException

Description copied from interface: GTUFollowingModelOld

Compute the acceleration that would be used if the is not leader in sight.

Specified by:

computeAccelerationStepWithNoLeader in interface GTUFollowingModelOld

Parameters:

gtu - LaneBasedGTU; the GTU for which acceleration is computed

maxDistance - Length.Rel; the maximum distance we can cover at the current time, e.g. as the result of a lane drop

speedLimit - Speed; the local speed limit

Returns:

AccelerationStep; the result of application of the GTU following model

Throws:

org.opentrafficsim.core.gtu.GTUException - when the velocity of the gtu cannot be determined

computeAccelerationStepWithNoLeader

public AccelerationStep computeAccelerationStepWithNoLeader(LaneBasedGTU gtu,
                                                            org.djunits.value.vdouble.scalar.Length.Rel maxDistance,
                                                            org.djunits.value.vdouble.scalar.Speed speedLimit,
                                                            org.djunits.value.vdouble.scalar.Time.Rel stepSize)
                                                     throws org.opentrafficsim.core.gtu.GTUException

Description copied from interface: GTUFollowingModelOld

Compute the acceleration that would be used if the is not leader in sight.

Specified by:

computeAccelerationStepWithNoLeader in interface GTUFollowingModelOld

Parameters:

gtu - LaneBasedGTU; the GTU for which acceleration is computed

maxDistance - Length.Rel; the maximum distance we can cover at the current time, e.g. as the result of a lane drop

speedLimit - Speed; the local speed limit

stepSize - given step size, which can be longer or shorter than the provided step size in the algorithms.

Returns:

AccelerationStep; the result of application of the GTU following model

Throws:

org.opentrafficsim.core.gtu.GTUException - when the velocity of the gtu cannot be determined

minimumHeadway

public org.djunits.value.vdouble.scalar.Length.Rel minimumHeadway(org.djunits.value.vdouble.scalar.Speed followerSpeed,
                                                                  org.djunits.value.vdouble.scalar.Speed leaderSpeed,
                                                                  org.djunits.value.vdouble.scalar.Length.Rel precision,
                                                                  org.djunits.value.vdouble.scalar.Length.Rel maxDistance,
                                                                  org.djunits.value.vdouble.scalar.Speed speedLimit,
                                                                  org.djunits.value.vdouble.scalar.Speed followerMaximumSpeed)

Description copied from interface: GTUFollowingModelOld

Compute the minimum net headway given the speed of the follower and the leader.
At the returned headway, the follower would decelerate with it's maximum comfortable deceleration.

Specified by:

minimumHeadway in interface GTUFollowingModelOld

Parameters:

followerSpeed - Speed; speed of the follower

leaderSpeed - Speed; speed of the leader

precision - Length.Rel; the required precision of the result (must be > 0)

maxDistance - Length.Rel; the maximum distance we can cover at the current time, e.g. as the result of a lane drop

speedLimit - Speed; the local speed limit

followerMaximumSpeed - Speed; the maximum speed that the follower can drive at

Returns:

Length.Rel

getMaximumSafeDeceleration

public org.djunits.value.vdouble.scalar.Acceleration getMaximumSafeDeceleration()

Description copied from interface: GTUFollowingModelOld

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.

Specified by:

getMaximumSafeDeceleration in interface GTUFollowingModelOld

Returns:

Acceleration; must be a positive value!

getStepSize

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

Description copied from interface: GTUFollowingModelOld

Return the standard step size of this GTU following model.

Specified by:

getStepSize in interface GTUFollowingModelOld

Returns:

Time.Rel; the standard step size of the GTU following model