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

Class ConflictUtil

java.lang.Object

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

public final class ConflictUtil
extends Object

This class implements default behavior for intersection conflicts for use in tactical planners.

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 Jun 3, 2016

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ConflictUtil.ConflictPlans Holds the tactical plans of a driver considering conflicts.

Field Summary

Fields

Modifier and Type	Field and Description
static org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterTypeDuration	MIN_GAP Minimum time gap between events.
static org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterTypeLength	S0_CONF Stopping distance at conflicts.
static org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterTypeLength	STOP_AREA Area before stop line where one is considered arrived at the intersection.
static org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterTypeDuration	TI Parameter of how much time before departure a bus indicates its departure to get priority.
static org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterTypeDouble	TIME_FACTOR Multiplication factor on time for conservative assessment.

Method Summary

Modifier and Type	Method and Description
static org.djunits.value.vdouble.scalar.Acceleration	approachConflicts(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics, SortedSet<HeadwayConflict> conflicts, SortedSet<HeadwayGTU> leaders, CarFollowingModel carFollowingModel, org.djunits.value.vdouble.scalar.Length vehicleLength, org.djunits.value.vdouble.scalar.Speed speed, org.djunits.value.vdouble.scalar.Acceleration acceleration, SpeedLimitInfo speedLimitInfo, ConflictUtil.ConflictPlans conflictPlans, LaneBasedGTU gtu) Approach conflicts by applying appropriate acceleration (or deceleration).
static boolean	stopForAllStopConflict(HeadwayConflict conflict, ConflictUtil.ConflictPlans conflictPlans) Approach an all-stop conflict.
static boolean	stopForGiveWayConflict(HeadwayConflict conflict, SortedSet<HeadwayGTU> leaders, org.djunits.value.vdouble.scalar.Speed speed, org.djunits.value.vdouble.scalar.Acceleration acceleration, org.djunits.value.vdouble.scalar.Length vehicleLength, org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics, SpeedLimitInfo speedLimitInfo, CarFollowingModel carFollowingModel) Approach a give-way conflict.
static boolean	stopForPriorityConflict(HeadwayConflict conflict, SortedSet<HeadwayGTU> leaders, org.djunits.value.vdouble.scalar.Speed speed, org.djunits.value.vdouble.scalar.Length vehicleLength, org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics, ConflictUtil.ConflictPlans yieldPlans) Approach a priority conflict.
static boolean	stopForStopConflict(HeadwayConflict conflict, SortedSet<HeadwayGTU> leaders, org.djunits.value.vdouble.scalar.Speed speed, org.djunits.value.vdouble.scalar.Acceleration acceleration, org.djunits.value.vdouble.scalar.Length vehicleLength, org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics, SpeedLimitInfo speedLimitInfo, CarFollowingModel carFollowingModel) Approach a stop conflict.

Methods inherited from class java.lang.Object

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

Field Detail

MIN_GAP

public static final org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterTypeDuration MIN_GAP

Minimum time gap between events.

S0_CONF

public static final org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterTypeLength S0_CONF

Stopping distance at conflicts.

TIME_FACTOR

public static final org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterTypeDouble TIME_FACTOR

Multiplication factor on time for conservative assessment.

STOP_AREA

public static final org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterTypeLength STOP_AREA

Area before stop line where one is considered arrived at the intersection.

TI

public static final org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterTypeDuration TI

Parameter of how much time before departure a bus indicates its departure to get priority.

Method Detail

approachConflicts

public static org.djunits.value.vdouble.scalar.Acceleration approachConflicts(org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics,
                                                                              SortedSet<HeadwayConflict> conflicts,
                                                                              SortedSet<HeadwayGTU> leaders,
                                                                              CarFollowingModel carFollowingModel,
                                                                              org.djunits.value.vdouble.scalar.Length vehicleLength,
                                                                              org.djunits.value.vdouble.scalar.Speed speed,
                                                                              org.djunits.value.vdouble.scalar.Acceleration acceleration,
                                                                              SpeedLimitInfo speedLimitInfo,
                                                                              ConflictUtil.ConflictPlans conflictPlans,
                                                                              LaneBasedGTU gtu)
                                                                       throws org.opentrafficsim.core.gtu.GTUException,
                                                                              org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Approach conflicts by applying appropriate acceleration (or deceleration). The model may yield for a vehicle even while having priority. Such a 'yield plan' is remembered in YieldPlans. By forwarding the same YieldPlans for a GTU consistency of such plans is provided. If any conflict is not accepted to pass, stopping before a more upstream conflict is applied if there not sufficient stopping length in between conflicts.

Parameters:

behavioralCharacteristics - behavioral characteristics

conflicts - set of conflicts to approach

leaders - leading vehicles

carFollowingModel - car-following model

vehicleLength - length of vehicle

speed - current speed

acceleration - current acceleration

speedLimitInfo - speed limit info

conflictPlans - set of plans for conflict

gtu - gtu

Returns:

acceleration appropriate for approaching the conflicts

Throws:

org.opentrafficsim.core.gtu.GTUException - in case of an unsupported conflict rule

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if a parameter is not defined or out of bounds

stopForPriorityConflict

public static boolean stopForPriorityConflict(HeadwayConflict conflict,
                                              SortedSet<HeadwayGTU> leaders,
                                              org.djunits.value.vdouble.scalar.Speed speed,
                                              org.djunits.value.vdouble.scalar.Length vehicleLength,
                                              org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics,
                                              ConflictUtil.ConflictPlans yieldPlans)
                                       throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Approach a priority conflict. Stopping is applied to give way to conflicting traffic in case congestion is present on the own lane. This is courtesy yielding.

Parameters:

conflict - conflict to approach

leaders - leading vehicles in own lane

speed - current speed

vehicleLength - vehicle length

behavioralCharacteristics - behavioral characteristics

yieldPlans - set of plans for yielding with priority

Returns:

whether to stop for this conflict

Throws:

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

stopForGiveWayConflict

public static boolean stopForGiveWayConflict(HeadwayConflict conflict,
                                             SortedSet<HeadwayGTU> leaders,
                                             org.djunits.value.vdouble.scalar.Speed speed,
                                             org.djunits.value.vdouble.scalar.Acceleration acceleration,
                                             org.djunits.value.vdouble.scalar.Length vehicleLength,
                                             org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics,
                                             SpeedLimitInfo speedLimitInfo,
                                             CarFollowingModel carFollowingModel)
                                      throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Approach a give-way conflict.

Parameters:

conflict - conflict

leaders - leaders

speed - current speed

acceleration - current acceleration

vehicleLength - vehicle length

behavioralCharacteristics - behavioral characteristics

speedLimitInfo - speed limit info

carFollowingModel - car-following model

Returns:

whether to stop for this conflict

Throws:

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

stopForStopConflict

public static boolean stopForStopConflict(HeadwayConflict conflict,
                                          SortedSet<HeadwayGTU> leaders,
                                          org.djunits.value.vdouble.scalar.Speed speed,
                                          org.djunits.value.vdouble.scalar.Acceleration acceleration,
                                          org.djunits.value.vdouble.scalar.Length vehicleLength,
                                          org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics behavioralCharacteristics,
                                          SpeedLimitInfo speedLimitInfo,
                                          CarFollowingModel carFollowingModel)
                                   throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Approach a stop conflict. Currently this is equal to approaching a give-way conflict.

Parameters:

conflict - conflict

leaders - leaders

speed - current speed

acceleration - current acceleration

vehicleLength - vehicle length

behavioralCharacteristics - behavioral characteristics

speedLimitInfo - speed limit info

carFollowingModel - car-following model

Returns:

whether to stop for this conflict

Throws:

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

stopForAllStopConflict

public static boolean stopForAllStopConflict(HeadwayConflict conflict,
                                             ConflictUtil.ConflictPlans conflictPlans)

Approach an all-stop conflict.

Parameters:

conflict - conflict to approach

conflictPlans - set of plans for conflict

Returns:

whether to stop for this conflict