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

Class SequentialFixedAccelerationModel

java.lang.Object

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

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

All Implemented Interfaces:

Serializable, CarFollowingModel, DesiredHeadwayModel, DesiredSpeedModel, GTUFollowingModelOld, Initialisable

public class SequentialFixedAccelerationModel
extends AbstractGTUFollowingModelMobil
implements Serializable

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

See Also:

Serialized Form

Field Summary

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

TOODANGEROUS

Fields inherited from interface org.opentrafficsim.road.gtu.lane.tactical.following.CarFollowingModel

CAR_FOLLOWING_MODEL

Constructor Summary

Constructors

Constructor and Description
SequentialFixedAccelerationModel(DEVSSimulatorInterface.TimeDoubleUnit simulator, Acceleration maximumSafeDeceleration) Construct a SequentialFixedAccelerationModel with empty list of FixedAccelerationModel steps.
SequentialFixedAccelerationModel(DEVSSimulatorInterface.TimeDoubleUnit simulator, Acceleration maximumSafeDeceleration, 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.
Acceleration	computeAcceleration(Speed followerSpeed, Speed followerMaximumSpeed, Speed leaderSpeed, Length headway, Speed speedLimit) Compute the acceleration that would be used to follow a leader.
Acceleration	computeAcceleration(Speed followerSpeed, Speed followerMaximumSpeed, Speed leaderSpeed, Length headway, Speed speedLimit, Duration stepSize) Compute the acceleration that would be used to follow a leader.
Length	desiredHeadway(Parameters parameters, Speed speed) Determines the desired headway in equilibrium conditions, i.e.
Speed	desiredSpeed(Parameters parameters, SpeedLimitInfo speedInfo) Determines the desired speed.
Acceleration	followingAcceleration(Parameters parameters, Speed speed, SpeedLimitInfo speedInfo, PerceptionIterable<? extends Headway> leaders) Determination of car-following acceleration, possibly based on multiple leaders.
FixedAccelerationModel	get(int index) Retrieve one FixedAccelerationModel step.
String	getLongName() Return the complete name of the car-following model.
Acceleration	getMaximumSafeDeceleration() Return the maximum safe deceleration for use in gap acceptance models.
String	getName() Return the name of the car-following model.
Duration	getStepSize() Return the standard step size of this GTU following model.
void	setA(Acceleration a) Set value of acceleration parameter.
void	setFspeed(double fSpeed) Set value of desired speed factor.
void	setT(Duration t) Set value of desired headway.
int	size() Retrieve the number of FixedAccelerationModel steps in this SequentialFixedAccelerationModel.
Time	timeAfterCompletionOfStep(int index) Retrieve the simulation time at the end of the Nth step of this SequentialFixedAccelerationModel.
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

Methods inherited from interface org.opentrafficsim.road.gtu.lane.tactical.following.CarFollowingModel

init

Constructor Detail

SequentialFixedAccelerationModel

public SequentialFixedAccelerationModel(DEVSSimulatorInterface.TimeDoubleUnit simulator,
                                        Acceleration maximumSafeDeceleration)

Construct a SequentialFixedAccelerationModel with empty list of FixedAccelerationModel steps.

Parameters:

simulator - DEVSSimulatorInterface.TimeDoubleUnit; the simulator (needed to obtain the current simulation time)

maximumSafeDeceleration - Acceleration; specified maximum safe deceleration

SequentialFixedAccelerationModel

public SequentialFixedAccelerationModel(DEVSSimulatorInterface.TimeDoubleUnit simulator,
                                        Acceleration maximumSafeDeceleration,
                                        Set<FixedAccelerationModel> steps)

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

Parameters:

simulator - DEVSSimulatorInterface.TimeDoubleUnit; the simulator (needed to obtain the current simulation time)

maximumSafeDeceleration - Acceleration; specified maximum safe deceleration

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 Time timeAfterCompletionOfStep(int index)

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

Parameters:

index - int; the step

Returns:

Time

computeAcceleration

public final Acceleration computeAcceleration(Speed followerSpeed,
                                              Speed followerMaximumSpeed,
                                              Speed leaderSpeed,
                                              Length headway,
                                              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

computeAcceleration

public final Acceleration computeAcceleration(Speed followerSpeed,
                                              Speed followerMaximumSpeed,
                                              Speed leaderSpeed,
                                              Length headway,
                                              Speed speedLimit,
                                              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 - Duration; 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

getMaximumSafeDeceleration

public final 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 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 the car-following model.

Specified by:

getName in interface CarFollowingModel

Returns:

name of the car-following model

getLongName

public final String getLongName()

Return the complete name of the car-following model.

Specified by:

getLongName in interface CarFollowingModel

Returns:

complete name of the car-following model

setA

public final void setA(Acceleration a)

Set value of acceleration parameter.

Specified by:

setA in interface GTUFollowingModelOld

Parameters:

a - Acceleration; value to set

setT

public final void setT(Duration t)

Set value of desired headway.

Specified by:

setT in interface GTUFollowingModelOld

Parameters:

t - Duration; desired headway

setFspeed

public final void setFspeed(double fSpeed)

Set value of desired speed factor.

Specified by:

setFspeed in interface GTUFollowingModelOld

Parameters:

fSpeed - double; desired speed factor

desiredSpeed

public final Speed desiredSpeed(Parameters parameters,
                                SpeedLimitInfo speedInfo)
                         throws ParameterException

Determines the desired speed.

Specified by:

desiredSpeed in interface DesiredSpeedModel

Parameters:

parameters - Parameters; parameters

speedInfo - SpeedLimitInfo; info regarding the desired speed for car-following

Returns:

desired speed

Throws:

ParameterException - if parameter exception occurs

desiredHeadway

public final Length desiredHeadway(Parameters parameters,
                                   Speed speed)
                            throws ParameterException

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

Specified by:

desiredHeadway in interface DesiredHeadwayModel

Parameters:

parameters - Parameters; parameters

speed - Speed; speed to determine the desired headway at

Returns:

desired headway

Throws:

ParameterException - if parameter exception occurs

followingAcceleration

public final Acceleration followingAcceleration(Parameters parameters,
                                                Speed speed,
                                                SpeedLimitInfo speedInfo,
                                                PerceptionIterable<? extends Headway> leaders)
                                         throws 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:

parameters - Parameters; parameters

speed - Speed; current speed

speedInfo - 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:

ParameterException - if parameter exception occurs

toString

public final String toString()

Overrides:

toString in class Object