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

Class AbstractCarFollowingModel

java.lang.Object
org.opentrafficsim.road.gtu.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-2026 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See OpenTrafficSim License.

Author:
Wouter Schakel

  • Constructor Details

    • AbstractCarFollowingModel

      public AbstractCarFollowingModel(DesiredHeadwayModel desiredHeadwayModel, DesiredSpeedModel desiredSpeedModel)
      Constructor.
      Parameters:
      desiredHeadwayModel - desired headway model
      desiredSpeedModel - desired speed model

  • Method Details

    • desiredHeadway

      public final org.djunits.value.vdouble.scalar.Length desiredHeadway(Parameters parameters, org.djunits.value.vdouble.scalar.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 org.djunits.value.vdouble.scalar.Speed desiredSpeed(Parameters parameters, SpeedLimits speedLimits, org.djunits.value.vdouble.scalar.Speed maxVehicleSpeed) throws ParameterException
      Description copied from interface: DesiredSpeedModel
      Determines the desired speed.
      Specified by:
      desiredSpeed in interface DesiredSpeedModel
      Parameters:
      parameters - parameters
      speedLimits - speed limits
      maxVehicleSpeed - maximum speed of the vehicle
      Returns:
      desired speed
      Throws:
      ParameterException - if parameter exception occurs

    • followingAcceleration

      public final org.djunits.value.vdouble.scalar.Acceleration followingAcceleration(Parameters parameters, org.djunits.value.vdouble.scalar.Speed speed, SpeedLimits speedLimits, org.djunits.value.vdouble.scalar.Speed maxVehicleSpeed, 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
      speedLimits - speed limits
      maxVehicleSpeed - maximum vehicle speed
      leaders - set of leader headways and speeds, ordered by headway (closest first)
      Returns:
      car-following acceleration
      Throws:
      ParameterException - if parameter exception occurs

    • setDesiredSpeedModel

      public DesiredSpeedModel setDesiredSpeedModel(DesiredSpeedModel model)
      Sets the desired speed model.
      Parameters:
      model - new model
      Returns:
      the model that was set before this method was called

    • followingAcceleration

      protected abstract org.djunits.value.vdouble.scalar.Acceleration followingAcceleration(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 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