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

Class FixedAccelerationModel

java.lang.Object

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

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

All Implemented Interfaces:

Serializable, CarFollowingModel, GTUFollowingModelOld

public class FixedAccelerationModel
extends AbstractGTUFollowingModelMobil
implements Serializable

Fixed GTU following model. This GTU following model does not react in any way to other GTUs. Instead it has a predetermined acceleration for a predetermined duration.
Primary use is testing of lane based GTU movement.

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: 1378 $, $LastChangedDate: 2015-09-03 13:38:01 +0200 (Thu, 03 Sep 2015) $, by $Author: averbraeck $, initial version 6 feb. 2015

Author:

Alexander Verbraeck, Peter Knoppers

See Also:

Serialized Form

Field Summary

Fields inherited from class org.opentrafficsim.road.gtu.lane.tactical.following.AbstractGTUFollowingModelMobil

TOODANGEROUS

Constructor Summary

Constructors

Constructor and Description
FixedAccelerationModel(org.djunits.value.vdouble.scalar.Acceleration acceleration, org.djunits.value.vdouble.scalar.Duration duration) Create a new FixedAccelerationModel.

Method Summary

Modifier and Type	Method and Description
org.djunits.value.vdouble.scalar.Acceleration	computeAcceleration(org.djunits.value.vdouble.scalar.Speed followerSpeed, org.djunits.value.vdouble.scalar.Speed followerMaximumSpeed, org.djunits.value.vdouble.scalar.Speed leaderSpeed, org.djunits.value.vdouble.scalar.Length headway, org.djunits.value.vdouble.scalar.Speed speedLimit) Compute the acceleration that would be used to follow a leader.
org.djunits.value.vdouble.scalar.Acceleration	computeAcceleration(org.djunits.value.vdouble.scalar.Speed followerSpeed, org.djunits.value.vdouble.scalar.Speed followerMaximumSpeed, 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.Duration stepSize) Compute the acceleration that would be used to follow a leader.
org.djunits.value.vdouble.scalar.Length	desiredHeadway(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics, org.djunits.value.vdouble.scalar.Speed speed) Determines the desired headway in equilibrium conditions, i.e.
org.djunits.value.vdouble.scalar.Speed	desiredSpeed(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics, SpeedLimitInfo speedInfo) Determines the desired speed.
org.djunits.value.vdouble.scalar.Acceleration	followingAcceleration(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics, org.djunits.value.vdouble.scalar.Speed speed, SpeedLimitInfo speedInfo, SortedMap<org.djunits.value.vdouble.scalar.Length,org.djunits.value.vdouble.scalar.Speed> leaders) Determination of car-following acceleration, possibly based on multiple leaders.
org.djunits.value.vdouble.scalar.Acceleration	getAcceleration() Retrieve the acceleration of this FixedAccelerationModel.
org.djunits.value.vdouble.scalar.Duration	getDuration() Retrieve the duration of this FixedAccelerationModel.
String	getLongName() Return complete textual information about this instantiation of this GTU following model.
org.djunits.value.vdouble.scalar.Acceleration	getMaximumSafeDeceleration() Return the maximum safe deceleration for use in gap acceptance models.
String	getName() Return the name of this GTU following model.
org.djunits.value.vdouble.scalar.Duration	getStepSize() Return the standard step size of this GTU following model.
String	toString()

Methods inherited from class org.opentrafficsim.road.gtu.lane.tactical.following.AbstractGTUFollowingModelMobil

computeAccelerationStep, computeAccelerationStep, computeAccelerationStep, computeAccelerationStep, computeAccelerationStepWithNoLeader, computeAccelerationStepWithNoLeader, computeDualAccelerationStep, computeDualAccelerationStep, minimumHeadway

Methods inherited from class java.lang.Object

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

Constructor Detail

FixedAccelerationModel

public FixedAccelerationModel(org.djunits.value.vdouble.scalar.Acceleration acceleration,
                              org.djunits.value.vdouble.scalar.Duration duration)

Create a new FixedAccelerationModel.

Parameters:

acceleration - Acceleration; the acceleration that will be returned by the computeAcceleration methods

duration - Duration; the duration that the acceleration will be maintained

Method Detail

getDuration

public final org.djunits.value.vdouble.scalar.Duration getDuration()

Retrieve the duration of this FixedAccelerationModel.

Returns:

Duration; the duration of this FixedAccelerationModel

getAcceleration

public final org.djunits.value.vdouble.scalar.Acceleration getAcceleration()

Retrieve the acceleration of this FixedAccelerationModel.

Returns:

Acceleration; the acceleration of this FixedAccelerationModel

computeAcceleration

public final org.djunits.value.vdouble.scalar.Acceleration computeAcceleration(org.djunits.value.vdouble.scalar.Speed followerSpeed,
                                                                               org.djunits.value.vdouble.scalar.Speed followerMaximumSpeed,
                                                                               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.Duration stepSize)

Compute the acceleration that would be used to follow a leader.

Specified by:

computeAcceleration in interface GTUFollowingModelOld

Parameters:

followerSpeed - Speed; the speed of the follower at the current time

followerMaximumSpeed - Speed; the maximum speed that the follower is capable of driving at

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

stepSize - 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

computeAcceleration

public final org.djunits.value.vdouble.scalar.Acceleration computeAcceleration(org.djunits.value.vdouble.scalar.Speed followerSpeed,
                                                                               org.djunits.value.vdouble.scalar.Speed followerMaximumSpeed,
                                                                               org.djunits.value.vdouble.scalar.Speed leaderSpeed,
                                                                               org.djunits.value.vdouble.scalar.Length headway,
                                                                               org.djunits.value.vdouble.scalar.Speed speedLimit)

Compute the acceleration that would be used to follow a leader.

Specified by:

computeAcceleration in interface GTUFollowingModelOld

Parameters:

followerSpeed - Speed; the speed of the follower at the current time

followerMaximumSpeed - Speed; the maximum speed that the follower is capable of driving at

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

Returns:

Acceleration; the acceleration (or, if negative, deceleration) resulting from application of the GTU following model

getMaximumSafeDeceleration

public final org.djunits.value.vdouble.scalar.Acceleration getMaximumSafeDeceleration()

Return the maximum safe deceleration for use in gap acceptance models. This is the deceleration that may be enforced upon a new follower due to entering a road or changing into an adjacent lane. The result shall be a positive value. In most car following models this value is named b.

Specified by:

getMaximumSafeDeceleration in interface GTUFollowingModelOld

Returns:

Acceleration; must be a positive value!

getStepSize

public final org.djunits.value.vdouble.scalar.Duration getStepSize()

Return the standard step size of this GTU following model.

Specified by:

getStepSize in interface GTUFollowingModelOld

Returns:

Duration; the standard step size of the GTU following model

getName

public final String getName()

Return the name of this GTU following model.

Specified by:

getName in interface CarFollowingModel

Specified by:

getName in interface GTUFollowingModelOld

Returns:

String; just the name of the GTU following model

getLongName

public final String getLongName()

Return complete textual information about this instantiation of this GTU following model.

Specified by:

getLongName in interface CarFollowingModel

Specified by:

getLongName in interface GTUFollowingModelOld

Returns:

String; the name and parameter values of the GTU following model

toString

public final String toString()

Overrides:

toString in class Object

desiredSpeed

public final org.djunits.value.vdouble.scalar.Speed desiredSpeed(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics,
                                                                 SpeedLimitInfo speedInfo)
                                                          throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Determines the desired speed.

Specified by:

desiredSpeed in interface CarFollowingModel

Parameters:

behavioralCharacteristics - behavioral characteristics

speedInfo - info regarding the desired speed for car-following

Returns:

desired speed

Throws:

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if parameter exception occurs

desiredHeadway

public final org.djunits.value.vdouble.scalar.Length desiredHeadway(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics,
                                                                    org.djunits.value.vdouble.scalar.Speed speed)
                                                             throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Determines the desired headway in equilibrium conditions, i.e. no speed difference with the leader.

Specified by:

desiredHeadway in interface CarFollowingModel

Parameters:

behavioralCharacteristics - behavioral characteristics

speed - speed to determine the desired headway at

Returns:

desired headway

Throws:

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if parameter exception occurs

followingAcceleration

public final org.djunits.value.vdouble.scalar.Acceleration followingAcceleration(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics,
                                                                                 org.djunits.value.vdouble.scalar.Speed speed,
                                                                                 SpeedLimitInfo speedInfo,
                                                                                 SortedMap<org.djunits.value.vdouble.scalar.Length,org.djunits.value.vdouble.scalar.Speed> leaders)
                                                                          throws org.opentrafficsim.core.gtu.behavioralcharacteristics.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:

behavioralCharacteristics - behavioral characteristics

speed - current speed

speedInfo - info regarding the desired speed for car-following

leaders - set of leader headways and speeds, ordered by headway (closest first)

Returns:

car-following acceleration

Throws:

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if parameter exception occurs