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

Interface CarFollowingModel

All Superinterfaces:
DesiredHeadwayModel, DesiredSpeedModel, Initialisable
All Known Subinterfaces:
GtuFollowingModelOld
All Known Implementing Classes:
AbstractCarFollowingModel, AbstractGtuFollowingModelMobil, AbstractIdm, FixedAccelerationModel, Idm, IdmOld, IdmPlus, IdmPlusMulti, IdmPlusOld, SequentialFixedAccelerationModel, ToledoCarFollowing
public interface CarFollowingModel extends DesiredHeadwayModel, DesiredSpeedModel, Initialisable
Methods that a car-following model has to implement. The parameters are supplied to obtain parameters. The phrase 'car-following model' is the commonly used and therefore intuitive name, but in actuality it is much more.
  • Following other vehicle types: van, bus, truck.
  • Following other GTU's: bicycle, pedestrian.
  • Free driving.
  • Approaching (theoretically different from following, usually the same formula).
  • Stopping for a traffic light, intersection conflict, etc,

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, Wouter Schakel

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final org.opentrafficsim.base.parameters.ParameterTypeClass<CarFollowingModel>
    CAR_FOLLOWING_MODEL
    Parameter type for car-following model.

  • Method Summary

    Modifier and Type
    Method
    Description
    org.djunits.value.vdouble.scalar.Acceleration
    followingAcceleration(org.opentrafficsim.base.parameters.Parameters parameters, org.djunits.value.vdouble.scalar.Speed speed, SpeedLimitInfo speedLimitInfo, PerceptionIterable<? extends Headway> leaders)
    Determination of car-following acceleration, possibly based on multiple leaders.
    String
    getLongName()
    Return the complete name of the car-following model.
    String
    getName()
    Return the name of the car-following model.
    default void
    init(LaneBasedGtu gtu)
    Initialize car-following model.

    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

  • Field Details

    • CAR_FOLLOWING_MODEL

      static final org.opentrafficsim.base.parameters.ParameterTypeClass<CarFollowingModel> CAR_FOLLOWING_MODEL
      Parameter type for car-following model.

  • Method Details

    • followingAcceleration

      org.djunits.value.vdouble.scalar.Acceleration followingAcceleration(org.opentrafficsim.base.parameters.Parameters parameters, org.djunits.value.vdouble.scalar.Speed speed, SpeedLimitInfo speedLimitInfo, PerceptionIterable<? extends Headway> leaders) throws org.opentrafficsim.base.parameters.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.
      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:
      org.opentrafficsim.base.parameters.ParameterException - if parameter exception occurs

    • getName

      String getName()
      Return the name of the car-following model.
      Returns:
      name of the car-following model

    • getLongName

      String getLongName()
      Return the complete name of the car-following model.
      Returns:
      complete name of the car-following model

    • init

      default void init(LaneBasedGtu gtu)
      Initialize car-following model.
      Specified by:
      init in interface Initialisable
      Parameters:
      gtu - LaneBasedGtu; gtu