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

Interface Synchronization

All Superinterfaces:

LmrsParameters

public interface Synchronization
extends LmrsParameters

Different forms of synchronization.

Copyright (c) 2013-2018 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

Field Summary

Fields

Modifier and Type	Field and Description
static Synchronization	ACTIVE Synchronization where a suitable leader is actively targeted, in relation to infrastructure.
static Synchronization	DEADEND Synchronization that only includes stopping for a dead-end.
static Synchronization	PASSIVE Synchronization where current leaders are taken.
static Synchronization	PASSIVE_MOVING Synchronization where current leaders are taken.

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

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

Method Summary

Modifier and Type	Method and Description
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.
static org.djunits.value.vdouble.scalar.Acceleration	gentleUrgency(org.djunits.value.vdouble.scalar.Acceleration a, double desire, org.opentrafficsim.base.parameters.Parameters params) Return limited deceleration.
static HeadwayGTU	getFollower(HeadwayGTU gtu, PerceptionCollectable<HeadwayGTU,LaneBasedGTU> leaders, HeadwayGTU follower, org.djunits.value.vdouble.scalar.Length ownLength) Returns the upstream gtu of the given gtu.
static org.djunits.value.vdouble.scalar.Length	getMergeDistance(LanePerception perception, org.opentrafficsim.core.network.LateralDirectionality lat) Returns the distance to the next merge, stopping within this distance is futile for a lane change.
static HeadwayGTU	getTargetLeader(HeadwayGTU gtu, SortedSet<HeadwayGTU> leaders) Returns the leader of one gtu from a set.
static PerceptionCollectable<HeadwayGTU,LaneBasedGTU>	removeAllUpstreamOfConflicts(PerceptionCollectable<HeadwayGTU,LaneBasedGTU> 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.
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.
static org.djunits.value.vdouble.scalar.Acceleration	stopForEnd(org.djunits.value.vdouble.scalar.Length xCur, org.djunits.value.vdouble.scalar.Length xMerge, org.opentrafficsim.base.parameters.Parameters params, org.djunits.value.vdouble.scalar.Speed ownSpeed, CarFollowingModel cfm, SpeedLimitInfo sli) Calculates acceleration to stop for a split or dead-end, accounting for infrastructure.
org.djunits.value.vdouble.scalar.Acceleration	synchronize(LanePerception perception, org.opentrafficsim.base.parameters.Parameters params, SpeedLimitInfo sli, CarFollowingModel cfm, double desire, org.opentrafficsim.core.network.LateralDirectionality lat, LmrsData lmrsData) Determine acceleration for synchronization.
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.base.parameters.Parameters params, SpeedLimitInfo sli, CarFollowingModel cfm) Calculates acceleration by following an adjacent vehicle, with tagging along if desire is not very high and speed is low.

Field Detail

DEADEND

static final Synchronization DEADEND

Synchronization that only includes stopping for a dead-end.

PASSIVE

static final Synchronization PASSIVE

Synchronization where current leaders are taken.

PASSIVE_MOVING

static final Synchronization PASSIVE_MOVING

Synchronization where current leaders are taken. Synchronization is disabled for d_sync<d<d_coop at low speeds.

ACTIVE

static final Synchronization ACTIVE

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

Method Detail

getMergeDistance

static org.djunits.value.vdouble.scalar.Length getMergeDistance(LanePerception perception,
                                                                org.opentrafficsim.core.network.LateralDirectionality lat)
                                                         throws org.opentrafficsim.core.gtu.plan.operational.OperationalPlanException

Returns the distance to the next merge, stopping within this distance is futile for a lane change.

Parameters:

perception - LanePerception; perception

lat - LateralDirectionality; lateral direction

Returns:

Length; distance to the next merge

Throws:

org.opentrafficsim.core.gtu.plan.operational.OperationalPlanException - if there is no infrastructure perception

synchronize

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

Determine acceleration for synchronization.

Parameters:

perception - perception

params - parameters

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.base.parameters.ParameterException - if a parameter is not defined

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

removeAllUpstreamOfConflicts

static PerceptionCollectable<HeadwayGTU,LaneBasedGTU> removeAllUpstreamOfConflicts(PerceptionCollectable<HeadwayGTU,LaneBasedGTU> 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.base.parameters.Parameters params)
                                                            throws org.opentrafficsim.base.parameters.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

params - parameters

Returns:

limited deceleration

Throws:

org.opentrafficsim.base.parameters.ParameterException - when parameter is no available or value out of range

getFollower

static HeadwayGTU getFollower(HeadwayGTU gtu,
                              PerceptionCollectable<HeadwayGTU,LaneBasedGTU> 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.base.parameters.Parameters params,
                                                                          SpeedLimitInfo sli,
                                                                          CarFollowingModel cfm)
                                                                   throws org.opentrafficsim.base.parameters.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

params - parameters

sli - speed limit info

cfm - car-following model

Returns:

acceleration by following an adjacent vehicle including tagging along

Throws:

org.opentrafficsim.base.parameters.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.base.parameters.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.base.parameters.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.base.parameters.Parameters params,
                                                                org.djunits.value.vdouble.scalar.Speed ownSpeed,
                                                                CarFollowingModel cfm,
                                                                SpeedLimitInfo sli)
                                                         throws org.opentrafficsim.base.parameters.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

params - parameters

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.base.parameters.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