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

Class AbstractGtuFollowingModelMobil

java.lang.Object
org.opentrafficsim.road.gtu.lane.tactical.following.AbstractGtuFollowingModelMobil
All Implemented Interfaces:
CarFollowingModel, DesiredHeadwayModel, DesiredSpeedModel, GtuFollowingModelOld, Initialisable
Direct Known Subclasses:
FixedAccelerationModel, IdmOld, IdmPlusOld, SequentialFixedAccelerationModel
public abstract class AbstractGtuFollowingModelMobil extends Object implements GtuFollowingModelOld
Code shared between various car following models.
Note: many of the methods have a maxDistance, which may be "behind" the location of the next GTU, or stand-alone. Note that the maxDistance is equivalent to a GTU with zero speed, and not equivalent to a moving GTU.

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:
Alexander Verbraeck, Peter Knoppers

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final DualAccelerationStep
    TOODANGEROUS
    Return value if lane change causes immediate collision.

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

    CAR_FOLLOWING_MODEL

  • Constructor Summary

    Constructors
    Constructor
    Description
    AbstractGtuFollowingModelMobil()
     

  • Method Summary

    Modifier and Type
    Method
    Description
    final AccelerationStep
    computeAccelerationStep(org.djunits.value.vdouble.scalar.Speed followerSpeed, org.djunits.value.vdouble.scalar.Speed leaderSpeed, org.djunits.value.vdouble.scalar.Length headway, org.djunits.value.vdouble.scalar.Speed speedLimit, org.djunits.value.vdouble.scalar.Time currentTime)
    Compute the acceleration that would be used to follow a leader.
    final AccelerationStep
    computeAccelerationStep(org.djunits.value.vdouble.scalar.Speed followerSpeed, org.djunits.value.vdouble.scalar.Speed leaderSpeed, org.djunits.value.vdouble.scalar.Length headway, org.djunits.value.vdouble.scalar.Speed speedLimit, org.djunits.value.vdouble.scalar.Time currentTime, org.djunits.value.vdouble.scalar.Duration stepSize)
    Compute the acceleration that would be used to follow a leader.
    final AccelerationStep
    computeAccelerationStep(LaneBasedGtu gtu, org.djunits.value.vdouble.scalar.Speed leaderSpeed, org.djunits.value.vdouble.scalar.Length headway, org.djunits.value.vdouble.scalar.Length maxDistance, org.djunits.value.vdouble.scalar.Speed speedLimit)
    Compute the acceleration that would be used to follow a leader.
    final AccelerationStep
    computeAccelerationStep(LaneBasedGtu gtu, org.djunits.value.vdouble.scalar.Speed leaderSpeed, org.djunits.value.vdouble.scalar.Length headway, org.djunits.value.vdouble.scalar.Length maxDistance, org.djunits.value.vdouble.scalar.Speed speedLimit, org.djunits.value.vdouble.scalar.Duration stepSize)
    Compute the acceleration that would be used to follow a leader.
    final AccelerationStep
    computeAccelerationStepWithNoLeader(LaneBasedGtu gtu, org.djunits.value.vdouble.scalar.Length maxDistance, org.djunits.value.vdouble.scalar.Speed speedLimit)
    Compute the acceleration that would be used if the is not leader in sight.
    final AccelerationStep
    computeAccelerationStepWithNoLeader(LaneBasedGtu gtu, org.djunits.value.vdouble.scalar.Length maxDistance, org.djunits.value.vdouble.scalar.Speed speedLimit, org.djunits.value.vdouble.scalar.Duration stepSize)
    Compute the acceleration that would be used if the is not leader in sight.
    final DualAccelerationStep
    computeDualAccelerationStep(LaneBasedGtu referenceGTU, Collection<Headway> otherGTUs, org.djunits.value.vdouble.scalar.Length 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.
    final DualAccelerationStep
    computeDualAccelerationStep(LaneBasedGtu referenceGTU, Collection<Headway> otherHeadways, org.djunits.value.vdouble.scalar.Length maxDistance, org.djunits.value.vdouble.scalar.Speed speedLimit, org.djunits.value.vdouble.scalar.Duration 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.
    final org.djunits.value.vdouble.scalar.Length
    minimumHeadway(org.djunits.value.vdouble.scalar.Speed followerSpeed, org.djunits.value.vdouble.scalar.Speed leaderSpeed, org.djunits.value.vdouble.scalar.Length precision, org.djunits.value.vdouble.scalar.Length 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

    followingAcceleration, getLongName, getName, init

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

    desiredHeadway

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

    desiredSpeed

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

    computeAcceleration, computeAcceleration, getMaximumSafeDeceleration, getStepSize, setA, setFspeed, setT

  • Field Details

    • TOODANGEROUS

      public static final DualAccelerationStep TOODANGEROUS
      Return value if lane change causes immediate collision.

  • Constructor Details

    • AbstractGtuFollowingModelMobil

      public AbstractGtuFollowingModelMobil()

  • Method Details

    • computeDualAccelerationStep

      public final DualAccelerationStep computeDualAccelerationStep(LaneBasedGtu referenceGTU, Collection<Headway> otherGTUs, org.djunits.value.vdouble.scalar.Length maxDistance, org.djunits.value.vdouble.scalar.Speed speedLimit) throws GtuException
      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:
      referenceGTU - LaneBasedGtu; the GTU for which the accelerations are computed
      otherGTUs - Collection<Headway>; 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; 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:
      GtuException - when the speed of the gtu cannot be determined

    • computeDualAccelerationStep

      public final DualAccelerationStep computeDualAccelerationStep(LaneBasedGtu referenceGTU, Collection<Headway> otherHeadways, org.djunits.value.vdouble.scalar.Length maxDistance, org.djunits.value.vdouble.scalar.Speed speedLimit, org.djunits.value.vdouble.scalar.Duration stepSize) throws GtuException
      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:
      referenceGTU - LaneBasedGtu; the GTU for which the accelerations are computed
      otherHeadways - Collection<Headway>; 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; 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 - Duration; 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:
      GtuException - when the speed of the gtu cannot be determined

    • computeAccelerationStep

      public final AccelerationStep computeAccelerationStep(LaneBasedGtu gtu, org.djunits.value.vdouble.scalar.Speed leaderSpeed, org.djunits.value.vdouble.scalar.Length headway, org.djunits.value.vdouble.scalar.Length maxDistance, org.djunits.value.vdouble.scalar.Speed speedLimit) throws GtuException
      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; the headway of the leader
      maxDistance - Length; 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:
      GtuException - when the speed of the gtu cannot be determined

    • computeAccelerationStep

      public final AccelerationStep computeAccelerationStep(LaneBasedGtu gtu, org.djunits.value.vdouble.scalar.Speed leaderSpeed, org.djunits.value.vdouble.scalar.Length headway, org.djunits.value.vdouble.scalar.Length maxDistance, org.djunits.value.vdouble.scalar.Speed speedLimit, org.djunits.value.vdouble.scalar.Duration stepSize) throws GtuException
      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; the headway of the leader
      maxDistance - Length; 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 - Duration; 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:
      GtuException - when the speed of the gtu cannot be determined

    • computeAccelerationStep

      public final AccelerationStep computeAccelerationStep(org.djunits.value.vdouble.scalar.Speed followerSpeed, org.djunits.value.vdouble.scalar.Speed leaderSpeed, org.djunits.value.vdouble.scalar.Length headway, org.djunits.value.vdouble.scalar.Speed speedLimit, org.djunits.value.vdouble.scalar.Time currentTime)
      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; 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 - Time; 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 final AccelerationStep computeAccelerationStep(org.djunits.value.vdouble.scalar.Speed followerSpeed, org.djunits.value.vdouble.scalar.Speed leaderSpeed, org.djunits.value.vdouble.scalar.Length headway, org.djunits.value.vdouble.scalar.Speed speedLimit, org.djunits.value.vdouble.scalar.Time currentTime, org.djunits.value.vdouble.scalar.Duration stepSize)
      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; 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 - Time; to be used to determine the validity of the AccelerationStep
      stepSize - Duration; 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

    • computeAccelerationStepWithNoLeader

      public final AccelerationStep computeAccelerationStepWithNoLeader(LaneBasedGtu gtu, org.djunits.value.vdouble.scalar.Length maxDistance, org.djunits.value.vdouble.scalar.Speed speedLimit) throws GtuException
      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; 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:
      GtuException - when the speed of the gtu cannot be determined

    • computeAccelerationStepWithNoLeader

      public final AccelerationStep computeAccelerationStepWithNoLeader(LaneBasedGtu gtu, org.djunits.value.vdouble.scalar.Length maxDistance, org.djunits.value.vdouble.scalar.Speed speedLimit, org.djunits.value.vdouble.scalar.Duration stepSize) throws GtuException
      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; 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 - Duration; 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:
      GtuException - when the speed of the gtu cannot be determined

    • minimumHeadway

      public final org.djunits.value.vdouble.scalar.Length minimumHeadway(org.djunits.value.vdouble.scalar.Speed followerSpeed, org.djunits.value.vdouble.scalar.Speed leaderSpeed, org.djunits.value.vdouble.scalar.Length precision, org.djunits.value.vdouble.scalar.Length 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.
      Specified by:
      minimumHeadway in interface GtuFollowingModelOld
      Parameters:
      followerSpeed - Speed; speed of the follower
      leaderSpeed - Speed; speed of the leader
      precision - Length; the required precision of the result (must be > 0)
      maxDistance - Length; 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