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

Class AnticipationInfo

java.lang.Object

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

All Implemented Interfaces:

Serializable

public final class AnticipationInfo
extends Object
implements Serializable

Utility class that stores duration and end-speed for a given anticipated movement.

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$, $LastChangedDate$, by $Author$, initial version Jun 7, 2016

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
AnticipationInfo(Duration duration, Speed endSpeed)

Method Summary

Modifier and Type	Method and Description
static AnticipationInfo	anticipateMovement(Length distance, Speed initialSpeed, Acceleration acceleration) Returns info of the anticipation assuming constant acceleration.
static AnticipationInfo	anticipateMovementFreeAcceleration(Length distance, Speed initialSpeed, Parameters parameters, CarFollowingModel carFollowingModel, SpeedLimitInfo speedLimitInfo, Duration timeStep) Returns info of the anticipation using free acceleration from car-following model.
static AnticipationInfo	anticipateMovementSpeedLimited(Length distance, Speed initialSpeed, Acceleration acceleration, Speed maxSpeed) Returns info of the anticipation assuming constant acceleration, without exceeding maximum speed.
Duration	getDuration()
Speed	getEndSpeed()
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

AnticipationInfo

public AnticipationInfo(Duration duration,
                        Speed endSpeed)

Parameters:

duration - Duration; duration of movement

endSpeed - Speed; end speed of movement

Method Detail

getDuration

public Duration getDuration()

Returns:

duration.

getEndSpeed

public Speed getEndSpeed()

Returns:

endSpeed.

anticipateMovement

public static AnticipationInfo anticipateMovement(Length distance,
                                                  Speed initialSpeed,
                                                  Acceleration acceleration)

Returns info of the anticipation assuming constant acceleration.

Parameters:

distance - Length; distance to cover

initialSpeed - Speed; initial speed

acceleration - Acceleration; (assumed) acceleration

Returns:

duration to cover given distance with given initial speed and acceleration

anticipateMovementSpeedLimited

public static AnticipationInfo anticipateMovementSpeedLimited(Length distance,
                                                              Speed initialSpeed,
                                                              Acceleration acceleration,
                                                              Speed maxSpeed)

Returns info of the anticipation assuming constant acceleration, without exceeding maximum speed.

Parameters:

distance - Length; distance to cover

initialSpeed - Speed; initial speed

acceleration - Acceleration; (assumed) acceleration

maxSpeed - Speed; maximum speed

Returns:

duration to cover given distance with given initial speed and acceleration, without exceeding maximum speed

anticipateMovementFreeAcceleration

public static AnticipationInfo anticipateMovementFreeAcceleration(Length distance,
                                                                  Speed initialSpeed,
                                                                  Parameters parameters,
                                                                  CarFollowingModel carFollowingModel,
                                                                  SpeedLimitInfo speedLimitInfo,
                                                                  Duration timeStep)
                                                           throws ParameterException

Returns info of the anticipation using free acceleration from car-following model.

Parameters:

distance - Length; distance to cover

initialSpeed - Speed; initial speed

parameters - Parameters; parameters of the anticipated GTU

carFollowingModel - CarFollowingModel; car-following model of the anticipated GTU

speedLimitInfo - SpeedLimitInfo; speed limit info of the anticipated GTU

timeStep - Duration; time step to use

Returns:

info regarding anticipation of movement

Throws:

ParameterException - if parameter is not defined

toString

public String toString()

Overrides:

toString in class Object