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 java.lang.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

  • Constructor Details

  • Method Details

    • 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 java.lang.String toString()
      Overrides:
      toString in class java.lang.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