Package 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-2024 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See OpenTrafficSim License.

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

See Also:

• Schakel, W.J., B. van Arem (2012) “An Urban Traffic Extension of a Freeway Driver Model for use in the OpenTraffic® Open Source Traffic Simulation”, presented at TRAIL Congress 2012.

Nested Class Summary

Nested Classes

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

Field Summary

Fields

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

Method Summary

Modifier and Type	Method	Description
static Acceleration	approachConflicts(Parameters parameters, Iterable<PerceivedConflict> conflicts, PerceptionCollectable<PerceivedGtu,LaneBasedGtu> leaders, CarFollowingModel carFollowingModel, Length vehicleLength, Length vehicleWidth, Speed speed, Acceleration acceleration, SpeedLimitInfo speedLimitInfo, ConflictUtil.ConflictPlans conflictPlans, LaneBasedGtu gtu, RelativeLane lane)	Approach conflicts by applying appropriate acceleration (or deceleration).
static boolean	stopForAllStopConflict(PerceivedConflict conflict, ConflictUtil.ConflictPlans conflictPlans)	Approach an all-stop conflict.
static boolean	stopForGiveWayConflict(PerceivedConflict conflict, PerceptionCollectable<PerceivedGtu,LaneBasedGtu> leaders, Speed speed, Acceleration acceleration, Length vehicleLength, Parameters parameters, SpeedLimitInfo speedLimitInfo, CarFollowingModel carFollowingModel, ParameterTypeAcceleration bType, Length prevEnd)	Approach a give-way conflict.
static boolean	stopForStopConflict(PerceivedConflict conflict, PerceptionCollectable<PerceivedGtu,LaneBasedGtu> leaders, Speed speed, Acceleration acceleration, Length vehicleLength, Parameters parameters, SpeedLimitInfo speedLimitInfo, CarFollowingModel carFollowingModel, ParameterTypeAcceleration bType, Length prevEnd)	Approach a stop conflict.

Methods inherited from class java.lang.Object

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

Field Details

MIN_GAP

public static final ParameterTypeDuration MIN_GAP

Minimum time gap between events.

B

public static final ParameterTypeAcceleration B

Comfortable deceleration.

BCRIT

public static final ParameterTypeAcceleration BCRIT

Critical deceleration.

S0

public static final ParameterTypeLength S0

Stopping distance.

S0_CONF

public static final ParameterTypeLength S0_CONF

Stopping distance at conflicts.

TIME_FACTOR

public static final ParameterTypeDouble TIME_FACTOR

Multiplication factor on time for conservative assessment.

STOP_AREA

public static final ParameterTypeLength STOP_AREA

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

TI

public static final ParameterTypeDuration TI

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

Method Details

approachConflicts

public static Acceleration approachConflicts(Parameters parameters,
 Iterable<PerceivedConflict> conflicts,
 PerceptionCollectable<PerceivedGtu,LaneBasedGtu> leaders,
 CarFollowingModel carFollowingModel,
 Length vehicleLength,
 Length vehicleWidth,
 Speed speed,
 Acceleration acceleration,
 SpeedLimitInfo speedLimitInfo,
 ConflictUtil.ConflictPlans conflictPlans,
 LaneBasedGtu gtu,
 RelativeLane lane)
                                      throws GtuException,
ParameterException

Approach conflicts by applying appropriate acceleration (or deceleration). The model may yield for a vehicle even while having priority. Such a plan is remembered in ConflictUtil.ConflictPlans. By forwarding the same ConflictPlans 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 is not sufficient stopping length in between conflicts.

Parameters:

parameters - parameters

conflicts - set of conflicts to approach

leaders - leading vehicles

carFollowingModel - car-following model

vehicleLength - length of vehicle

vehicleWidth - width of vehicle

speed - current speed

acceleration - current acceleration

speedLimitInfo - speed limit info

conflictPlans - set of plans for conflict

gtu - gtu

lane - lane

Returns:

acceleration appropriate for approaching the conflicts

Throws:

GtuException - in case of an unsupported conflict rule

ParameterException - if a parameter is not defined or out of bounds

stopForGiveWayConflict

public static boolean stopForGiveWayConflict(PerceivedConflict conflict,
 PerceptionCollectable<PerceivedGtu,LaneBasedGtu> leaders,
 Speed speed,
 Acceleration acceleration,
 Length vehicleLength,
 Parameters parameters,
 SpeedLimitInfo speedLimitInfo,
 CarFollowingModel carFollowingModel,
 ParameterTypeAcceleration bType,
 Length prevEnd)
                                      throws ParameterException

Approach a give-way conflict.

Parameters:

conflict - conflict

leaders - leaders

speed - current speed

acceleration - current acceleration

vehicleLength - vehicle length

parameters - parameters

speedLimitInfo - speed limit info

carFollowingModel - car-following model

bType - parameter type for considered deceleration

prevEnd - distance to end of previous conflict that should not be blocked, null if none

Returns:

whether to stop for this conflict

Throws:

ParameterException - if a parameter is not defined

stopForStopConflict

public static boolean stopForStopConflict(PerceivedConflict conflict,
 PerceptionCollectable<PerceivedGtu,LaneBasedGtu> leaders,
 Speed speed,
 Acceleration acceleration,
 Length vehicleLength,
 Parameters parameters,
 SpeedLimitInfo speedLimitInfo,
 CarFollowingModel carFollowingModel,
 ParameterTypeAcceleration bType,
 Length prevEnd)
                                   throws 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

parameters - parameters

speedLimitInfo - speed limit info

carFollowingModel - car-following model

bType - parameter type for considered deceleration

prevEnd - distance to end of previous conflict that should not be blocked, null if none

Returns:

whether to stop for this conflict

Throws:

ParameterException - if a parameter is not defined

stopForAllStopConflict

public static boolean stopForAllStopConflict(PerceivedConflict 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