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

Enum Synchronization

java.lang.Object

java.lang.Enum<Synchronization>

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

All Implemented Interfaces:

Serializable, Comparable<Synchronization>, LmrsParameters

public enum Synchronization
extends Enum<Synchronization>
implements LmrsParameters

Different forms of synchronization, which includes cooperation.

Copyright (c) 2013-2017 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 3 apr. 2017

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

Enum Constant Summary

Enum Constants

Enum Constant and Description
ACTIVE Synchronization where a suitable leader is actively targeted, in relation to infrastructure.
COOPERATION Synchronization that only includes stopping for a dead-end and simple cooperation.
NONE Synchronization that only includes stopping for a dead-end.
PASSIVE Synchronization where current leaders are taken.

Field Summary

Fields inherited from interface org.opentrafficsim.road.gtu.lane.tactical.util.lmrs.LmrsParameters

COURTESY, DCOOP, DFREE, DLC, DLEFT, DRIGHT, DSYNC, HIERARCHY, VGAIN

Method Summary

Modifier and Type	Method and Description
(package private) static boolean	canBeAhead(HeadwayGTU adjacentVehicle, org.djunits.value.vdouble.scalar.Length xCur, int nCur, org.djunits.value.vdouble.scalar.Speed ownSpeed, org.djunits.value.vdouble.scalar.Length ownLength, org.djunits.value.vdouble.scalar.Speed tagSpeed, double dCoop, org.djunits.value.vdouble.scalar.Acceleration b, org.djunits.value.vdouble.scalar.Duration tMin, org.djunits.value.vdouble.scalar.Duration tMax, org.djunits.value.vdouble.scalar.Length x0, org.djunits.value.vdouble.scalar.Duration t0, org.djunits.value.vdouble.scalar.Duration lc, double desire) Returns whether a driver estimates it can be ahead of an adjacent vehicle for merging.
(package private) abstract org.djunits.value.vdouble.scalar.Acceleration	cooperate(LanePerception perception, org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics bc, SpeedLimitInfo sli, CarFollowingModel cfm, org.opentrafficsim.core.network.LateralDirectionality lat, Desire ownDesire) Determine acceleration for cooperation.
(package private) static org.djunits.value.vdouble.scalar.Acceleration	gentleUrgency(org.djunits.value.vdouble.scalar.Acceleration a, double desire, org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics bc) Return limited deceleration.
(package private) static HeadwayGTU	getFollower(HeadwayGTU gtu, SortedSet<HeadwayGTU> leaders, HeadwayGTU follower, org.djunits.value.vdouble.scalar.Length ownLength) Returns the upstream gtu of the given gtu.
(package private) static HeadwayGTU	getTargetLeader(HeadwayGTU gtu, SortedSet<HeadwayGTU> leaders) Returns the leader of one gtu from a set.
(package private) static SortedSet<HeadwayGTU>	removeAllUpstreamOfConflicts(SortedSet<HeadwayGTU> set, LanePerception perception, RelativeLane relativeLane) Removes all GTUs from the set, that are found upstream on the conflicting lane of a conflict in the current lane.
(package private) static org.djunits.value.vdouble.scalar.Length	requiredBufferSpace(org.djunits.value.vdouble.scalar.Speed speed, int nCur, org.djunits.value.vdouble.scalar.Length x0, org.djunits.value.vdouble.scalar.Duration t0, org.djunits.value.vdouble.scalar.Duration lc, double dCoop) Returns the required buffer space to perform a lane change and further lane changes.
(package private) static org.djunits.value.vdouble.scalar.Acceleration	stopForEnd(org.djunits.value.vdouble.scalar.Length xCur, org.djunits.value.vdouble.scalar.Length xMerge, org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics bc, org.djunits.value.vdouble.scalar.Speed ownSpeed, CarFollowingModel cfm, SpeedLimitInfo sli) Calculates acceleration to stop for a split or dead-end, accounting for infrastructure.
(package private) abstract org.djunits.value.vdouble.scalar.Acceleration	synchronize(LanePerception perception, org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics bc, SpeedLimitInfo sli, CarFollowingModel cfm, double desire, org.opentrafficsim.core.network.LateralDirectionality lat, LmrsData lmrsData) Determine acceleration for synchronization.
(package private) static org.djunits.value.vdouble.scalar.Acceleration	tagAlongAcceleration(HeadwayGTU leader, org.djunits.value.vdouble.scalar.Speed followerSpeed, org.djunits.value.vdouble.scalar.Length followerLength, org.djunits.value.vdouble.scalar.Speed tagSpeed, double desire, org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics bc, SpeedLimitInfo sli, CarFollowingModel cfm) Calculates acceleration by following an adjacent vehicle, with tagging along if desire is not very high and speed is low.
static Synchronization	valueOf(String name) Returns the enum constant of this type with the specified name.
static Synchronization[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

NONE

public static final Synchronization NONE

Synchronization that only includes stopping for a dead-end.

COOPERATION

public static final Synchronization COOPERATION

Synchronization that only includes stopping for a dead-end and simple cooperation.

PASSIVE

public static final Synchronization PASSIVE

Synchronization where current leaders are taken.

ACTIVE

public static final Synchronization ACTIVE

Synchronization where a suitable leader is actively targeted, in relation to infrastructure.

Method Detail

values

public static Synchronization[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (Synchronization c : Synchronization.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static Synchronization valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

synchronize

abstract org.djunits.value.vdouble.scalar.Acceleration synchronize(LanePerception perception,
                                                                   org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics bc,
                                                                   SpeedLimitInfo sli,
                                                                   CarFollowingModel cfm,
                                                                   double desire,
                                                                   org.opentrafficsim.core.network.LateralDirectionality lat,
                                                                   LmrsData lmrsData)
                                                            throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException,
                                                                   org.opentrafficsim.core.gtu.plan.operational.OperationalPlanException

Determine acceleration for synchronization.

Parameters:

perception - perception

bc - behavioral characteristics

sli - speed limit info

cfm - car-following model

desire - level of lane change desire

lat - lateral direction for synchronization

lmrsData - LMRS data

Returns:

acceleration for synchronization

Throws:

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if a parameter is not defined

org.opentrafficsim.core.gtu.plan.operational.OperationalPlanException - perception exception

cooperate

abstract org.djunits.value.vdouble.scalar.Acceleration cooperate(LanePerception perception,
                                                                 org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics bc,
                                                                 SpeedLimitInfo sli,
                                                                 CarFollowingModel cfm,
                                                                 org.opentrafficsim.core.network.LateralDirectionality lat,
                                                                 Desire ownDesire)
                                                          throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException,
                                                                 org.opentrafficsim.core.gtu.plan.operational.OperationalPlanException

Determine acceleration for cooperation.

Parameters:

perception - perception

bc - behavioral characteristics

sli - speed limit info

cfm - car-following model

lat - lateral direction for cooperation

ownDesire - own lane change desire

Returns:

acceleration for synchronization

Throws:

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if a parameter is not defined

org.opentrafficsim.core.gtu.plan.operational.OperationalPlanException - perception exception

removeAllUpstreamOfConflicts

static SortedSet<HeadwayGTU> removeAllUpstreamOfConflicts(SortedSet<HeadwayGTU> set,
                                                          LanePerception perception,
                                                          RelativeLane relativeLane)
                                                   throws org.opentrafficsim.core.gtu.plan.operational.OperationalPlanException

Removes all GTUs from the set, that are found upstream on the conflicting lane of a conflict in the current lane.

Parameters:

set - set of GTUs

perception - perception

relativeLane - relative lane

Returns:

the input set, for chained use

Throws:

org.opentrafficsim.core.gtu.plan.operational.OperationalPlanException - if the IntersectionPerception category is not present

gentleUrgency

static org.djunits.value.vdouble.scalar.Acceleration gentleUrgency(org.djunits.value.vdouble.scalar.Acceleration a,
                                                                   double desire,
                                                                   org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics bc)
                                                            throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Return limited deceleration. Deceleration is limited to b for d < dCoop. Beyond dCoop the limit is a linear interpolation between b and bCrit.

Parameters:

a - acceleration to limit

desire - lane change desire

bc - behavioral characteristics

Returns:

limited deceleration

Throws:

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - when parameter is no available or value out of range

getFollower

static HeadwayGTU getFollower(HeadwayGTU gtu,
                              SortedSet<HeadwayGTU> leaders,
                              HeadwayGTU follower,
                              org.djunits.value.vdouble.scalar.Length ownLength)

Returns the upstream gtu of the given gtu.

Parameters:

gtu - gtu

leaders - leaders of own vehicle

follower - following vehicle of own vehicle

ownLength - own vehicle length

Returns:

upstream gtu of the given gtu

tagAlongAcceleration

static org.djunits.value.vdouble.scalar.Acceleration tagAlongAcceleration(HeadwayGTU leader,
                                                                          org.djunits.value.vdouble.scalar.Speed followerSpeed,
                                                                          org.djunits.value.vdouble.scalar.Length followerLength,
                                                                          org.djunits.value.vdouble.scalar.Speed tagSpeed,
                                                                          double desire,
                                                                          org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics bc,
                                                                          SpeedLimitInfo sli,
                                                                          CarFollowingModel cfm)
                                                                   throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Calculates acceleration by following an adjacent vehicle, with tagging along if desire is not very high and speed is low.

Parameters:

leader - leader

followerSpeed - follower speed

followerLength - follower length

tagSpeed - maximum tag along speed

desire - lane change desire

bc - behavioral characteristics

sli - speed limit info

cfm - car-following model

Returns:

acceleration by following an adjacent vehicle including tagging along

Throws:

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if a parameter is not present

canBeAhead

static boolean canBeAhead(HeadwayGTU adjacentVehicle,
                          org.djunits.value.vdouble.scalar.Length xCur,
                          int nCur,
                          org.djunits.value.vdouble.scalar.Speed ownSpeed,
                          org.djunits.value.vdouble.scalar.Length ownLength,
                          org.djunits.value.vdouble.scalar.Speed tagSpeed,
                          double dCoop,
                          org.djunits.value.vdouble.scalar.Acceleration b,
                          org.djunits.value.vdouble.scalar.Duration tMin,
                          org.djunits.value.vdouble.scalar.Duration tMax,
                          org.djunits.value.vdouble.scalar.Length x0,
                          org.djunits.value.vdouble.scalar.Duration t0,
                          org.djunits.value.vdouble.scalar.Duration lc,
                          double desire)
                   throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Returns whether a driver estimates it can be ahead of an adjacent vehicle for merging.

Parameters:

adjacentVehicle - adjacent vehicle

xCur - remaining distance

nCur - number of lane changes to perform

ownSpeed - own speed

ownLength - own length

tagSpeed - maximum tag along speed

dCoop - cooperation threshold

b - critical deceleration

tMin - minimum headway

tMax - normal headway

x0 - anticipation distance

t0 - anticipation time

lc - lane change duration

desire - lane change desire

Returns:

whether a driver estimates it can be ahead of an adjacent vehicle for merging

Throws:

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if parameter is not defined

requiredBufferSpace

static org.djunits.value.vdouble.scalar.Length requiredBufferSpace(org.djunits.value.vdouble.scalar.Speed speed,
                                                                   int nCur,
                                                                   org.djunits.value.vdouble.scalar.Length x0,
                                                                   org.djunits.value.vdouble.scalar.Duration t0,
                                                                   org.djunits.value.vdouble.scalar.Duration lc,
                                                                   double dCoop)

Returns the required buffer space to perform a lane change and further lane changes.

Parameters:

speed - representative speed

nCur - number of required lane changes

x0 - anticipation distance

t0 - anticipation time

lc - lane change duration

dCoop - cooperation threshold

Returns:

required buffer space to perform a lane change and further lane changes

stopForEnd

static org.djunits.value.vdouble.scalar.Acceleration stopForEnd(org.djunits.value.vdouble.scalar.Length xCur,
                                                                org.djunits.value.vdouble.scalar.Length xMerge,
                                                                org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics bc,
                                                                org.djunits.value.vdouble.scalar.Speed ownSpeed,
                                                                CarFollowingModel cfm,
                                                                SpeedLimitInfo sli)
                                                         throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Calculates acceleration to stop for a split or dead-end, accounting for infrastructure.

Parameters:

xCur - remaining distance to end

xMerge - distance until merge point

bc - behavioral characteristics

ownSpeed - own speed

cfm - car-following model

sli - speed limit info

Returns:

acceleration to stop for a split or dead-end, accounting for infrastructure

Throws:

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if parameter is not defined

getTargetLeader

static HeadwayGTU getTargetLeader(HeadwayGTU gtu,
                                  SortedSet<HeadwayGTU> leaders)

Returns the leader of one gtu from a set.

Parameters:

gtu - gtu

leaders - leaders

Returns:

leader of one gtu from a set