org.opentrafficsim.road.gtu.lane.tactical.util

Class CarFollowingUtil

java.lang.Object

org.opentrafficsim.road.gtu.lane.tactical.util.CarFollowingUtil

public final class CarFollowingUtil
extends Object

Static methods regarding car-following for composition in tactical planners.

Copyright (c) 2013-2016 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 May 23, 2016

Author:

Alexander Verbraeck, Wouter Schakel

Method Summary

Modifier and Type	Method and Description
static org.djunits.value.vdouble.scalar.Acceleration	constantAccelerationStop(CarFollowingModel carFollowingModel, org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics, org.djunits.value.vdouble.scalar.Speed speed, org.djunits.value.vdouble.scalar.Length distance) Return constant acceleration in order to stop in specified distance.
static org.djunits.value.vdouble.scalar.Acceleration	followLeaders(CarFollowingModel carFollowingModel, org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics, org.djunits.value.vdouble.scalar.Speed speed, SpeedLimitInfo speedLimitInfo, SortedSet<AbstractHeadwayGTU> leaders) Follow a set of headway GTUs.
static org.djunits.value.vdouble.scalar.Acceleration	freeAcceleration(CarFollowingModel carFollowingModel, org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics, org.djunits.value.vdouble.scalar.Speed speed, SpeedLimitInfo speedLimitInfo) Calculate free acceleration.
static org.djunits.value.vdouble.scalar.Acceleration	stop(CarFollowingModel carFollowingModel, org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics, org.djunits.value.vdouble.scalar.Speed speed, SpeedLimitInfo speedLimitInfo, org.djunits.value.vdouble.scalar.Length distance) Stop within given distance.

Methods inherited from class java.lang.Object

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

Method Detail

followLeaders

public static org.djunits.value.vdouble.scalar.Acceleration followLeaders(CarFollowingModel carFollowingModel,
                                                                          org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics,
                                                                          org.djunits.value.vdouble.scalar.Speed speed,
                                                                          SpeedLimitInfo speedLimitInfo,
                                                                          SortedSet<AbstractHeadwayGTU> leaders)
                                                                   throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Follow a set of headway GTUs.

Parameters:

carFollowingModel - car-following model

behavioralCharacteristics - behavioral characteristics

speed - current speed

speedLimitInfo - speed limit info

leaders - leaders

Returns:

acceleration for following the leader

Throws:

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if a parameter is not given or out of bounds

stop

public static org.djunits.value.vdouble.scalar.Acceleration stop(CarFollowingModel carFollowingModel,
                                                                 org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics,
                                                                 org.djunits.value.vdouble.scalar.Speed speed,
                                                                 SpeedLimitInfo speedLimitInfo,
                                                                 org.djunits.value.vdouble.scalar.Length distance)
                                                          throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Stop within given distance.

Parameters:

carFollowingModel - car-following model

behavioralCharacteristics - behavioral characteristics

speed - current speed

speedLimitInfo - speed limit info

distance - distance to stop over

Returns:

acceleration to stop over distance

Throws:

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if a parameter is not given or out of bounds

constantAccelerationStop

public static org.djunits.value.vdouble.scalar.Acceleration constantAccelerationStop(CarFollowingModel carFollowingModel,
                                                                                     org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics,
                                                                                     org.djunits.value.vdouble.scalar.Speed speed,
                                                                                     org.djunits.value.vdouble.scalar.Length distance)
                                                                              throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Return constant acceleration in order to stop in specified distance. The car-following model is used to determine the stopping distance (i.e. distance remaining at stand still, e.g. 1-3m).

Parameters:

carFollowingModel - car-following model

behavioralCharacteristics - behavioral characteristics

speed - current speed

distance - distance to stop over

Returns:

constant acceleration in order to stop in specified distance

Throws:

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - on missing parameter

freeAcceleration

public static org.djunits.value.vdouble.scalar.Acceleration freeAcceleration(CarFollowingModel carFollowingModel,
                                                                             org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics,
                                                                             org.djunits.value.vdouble.scalar.Speed speed,
                                                                             SpeedLimitInfo speedLimitInfo)
                                                                      throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Calculate free acceleration.

Parameters:

carFollowingModel - car-following model

behavioralCharacteristics - behavioral characteristics

speed - current speed

speedLimitInfo - speed limit info

Returns:

acceleration free acceleration

Throws:

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if a parameter is not given or out of bounds