org.opentrafficsim.road.gtu.following

Class FixedAccelerationModel

java.lang.Object

org.opentrafficsim.road.gtu.following.AbstractGTUFollowingModel

org.opentrafficsim.road.gtu.following.FixedAccelerationModel

All Implemented Interfaces:

GTUFollowingModel

public class FixedAccelerationModel
extends AbstractGTUFollowingModel

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

Field Summary

Fields inherited from class org.opentrafficsim.road.gtu.following.AbstractGTUFollowingModel

TOODANGEROUS

Constructor Summary

Constructors

Constructor and Description
FixedAccelerationModel(org.djunits.value.vdouble.scalar.Acceleration acceleration, org.djunits.value.vdouble.scalar.Time.Rel 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.Rel headway, org.djunits.value.vdouble.scalar.Speed speedLimit) Compute the acceleration that would be used to follow a leader. TODO We should probably add a be ready to stop before argument to prevent vehicles that cannot see their leader, or should slow down for a crossing from accelerating to unsafe speeds.
org.djunits.value.vdouble.scalar.Acceleration	getAcceleration() Retrieve the acceleration of this FixedAccelerationModel.
org.djunits.value.vdouble.scalar.Time.Rel	getDuration() Retrieve the duration of this FixedAccelerationModel.
String	getLongName() Return complete textual information about this instantiation of this GTU following model.
String	getName() Return the name of this GTU following model.
org.djunits.value.vdouble.scalar.Time.Rel	getStepSize() Return the step size of this GTU following model.
org.djunits.value.vdouble.scalar.Acceleration	maximumSafeDeceleration() Return the maximum safe deceleration for use in gap acceptance models.
String	toString()

Methods inherited from class org.opentrafficsim.road.gtu.following.AbstractGTUFollowingModel

computeAcceleration, computeAcceleration, computeAccelerationWithNoLeader, 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.Time.Rel duration)

Create a new FixedAccelerationModel.

Parameters:

acceleration - DoubleScalar.Abs<AccelerationUnit>; the acceleration that will be returned by the computeAcceleration methods

duration - DoubleScalar.Abs<TimeUnit>; the duration that the acceleration will be maintained

Method Detail

getDuration

public final org.djunits.value.vdouble.scalar.Time.Rel getDuration()

Retrieve the duration of this FixedAccelerationModel.

Returns:

DoubleScalar.Rel<TimeUnit>; the duration of this FixedAccelerationModel

getAcceleration

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

Retrieve the acceleration of this FixedAccelerationModel.

Returns:

DoubleScalar.Abs<AccelerationUnit>; 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.Rel headway,
                                                                               org.djunits.value.vdouble.scalar.Speed speedLimit)

Compute the acceleration that would be used to follow a leader.
TODO We should probably add a be ready to stop before argument to prevent vehicles that cannot see their leader, or should slow down for a crossing from accelerating to unsafe speeds.

Parameters:

followerSpeed - DoubleScalar.Abs<SpeedUnit>; the speed of the follower at the current time

followerMaximumSpeed - DoubleScalar.Abs<SpeedUnit>; the maximum speed that the follower is capable of driving at

leaderSpeed - DoubleScalar.Abs<SpeedUnit>; the speed of the follower at the current time

headway - DoubleScalar.Rel<LengthUnit>; the net headway (distance between the front of the follower to the rear of the leader) at the current time

speedLimit - DoubleScalar.Abs<SpeedUnit>; the local speed limit

Returns:

DoubleScalar.Abs<AccelerationUnit>; the acceleration (or, if negative, deceleration) resulting from application of the GTU following model

maximumSafeDeceleration

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

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.

Returns:

DoubleScalar.Abs<AccelerationUnit>; must be a positive value!

getStepSize

public final org.djunits.value.vdouble.scalar.Time.Rel getStepSize()

Return the step size of this GTU following model.

Returns:

DoubleScalar.Rel<TimeUnit>; the step size of the GTU following model

getName

public final String getName()

Return the name of this GTU following model.

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.

Returns:

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

toString

public final String toString()

Overrides:

toString in class Object