org.opentrafficsim.road.gtu.following

Class SequentialFixedAccelerationModel

java.lang.Object

org.opentrafficsim.road.gtu.following.AbstractGTUFollowingModel

org.opentrafficsim.road.gtu.following.SequentialFixedAccelerationModel

All Implemented Interfaces:

GTUFollowingModel

public class SequentialFixedAccelerationModel
extends AbstractGTUFollowingModel

Extended version of FixedAccelerationModel. The addition is that this GTUFollowingModel stores a series of acceleration and duration values. Mostly used for testing.

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: 1401 $, $LastChangedDate: 2015-09-14 01:33:02 +0200 (Mon, 14 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
SequentialFixedAccelerationModel(org.opentrafficsim.core.dsol.OTSDEVSSimulatorInterface simulator) Construct a SequentialFixedAccelerationModel with empty list of FixedAccelerationModel steps.
SequentialFixedAccelerationModel(org.opentrafficsim.core.dsol.OTSDEVSSimulatorInterface simulator, Set<FixedAccelerationModel> steps) Construct a SequentialFixedAccelerationModel and load it with a list of FixedAccelerationModel steps.

Method Summary

Modifier and Type	Method and Description
SequentialFixedAccelerationModel	addStep(FixedAccelerationModel step) Add one FixedAccelerationModel step to this SequentialFixedAccelerationModel.
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.
FixedAccelerationModel	get(int index) Retrieve one FixedAccelerationModel step.
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.
int	size() Retrieve the number of FixedAccelerationModel steps in this SequentialFixedAccelerationModel.
org.djunits.value.vdouble.scalar.Time.Abs	timeAfterCompletionOfStep(int index) Retrieve the simulation time at the end of the Nth step of this SequentialFixedAccelerationModel.

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, toString, wait, wait, wait

Constructor Detail

SequentialFixedAccelerationModel

public SequentialFixedAccelerationModel(org.opentrafficsim.core.dsol.OTSDEVSSimulatorInterface simulator)

Construct a SequentialFixedAccelerationModel with empty list of FixedAccelerationModel steps.

Parameters:

simulator - DEVSSimulator; the simulator (needed to obtain the current simulation time)

SequentialFixedAccelerationModel

public SequentialFixedAccelerationModel(org.opentrafficsim.core.dsol.OTSDEVSSimulatorInterface simulator,
                                        Set<FixedAccelerationModel> steps)

Construct a SequentialFixedAccelerationModel and load it with a list of FixedAccelerationModel steps.

Parameters:

simulator - DEVSSimulator; the simulator (needed to obtain the current simulation time)

steps - Set<FixedAccelerationModel>; the list of FixedAccelerationModel steps.

Method Detail

addStep

public final SequentialFixedAccelerationModel addStep(FixedAccelerationModel step)

Add one FixedAccelerationModel step to this SequentialFixedAccelerationModel.

Parameters:

step - FixedAccelerationModel; the step to add

Returns:

SequentialFixedAccelerationModel; this modified SequentialFixedAccelerationModel

size

public final int size()

Retrieve the number of FixedAccelerationModel steps in this SequentialFixedAccelerationModel.

Returns:

int; the number of steps in this SequentialFixedAccelerationModel

get

public final FixedAccelerationModel get(int index)

Retrieve one FixedAccelerationModel step.

Parameters:

index - int; the index of the retrieved FixedAccelerationModel step

Returns:

FixedAccelerationModel

timeAfterCompletionOfStep

public final org.djunits.value.vdouble.scalar.Time.Abs timeAfterCompletionOfStep(int index)

Retrieve the simulation time at the end of the Nth step of this SequentialFixedAccelerationModel.

Parameters:

index - int; the step

Returns:

DoubleScalar.Abs<TimeUnit>

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