Package org.opentrafficsim.road.gtu.tactical.util

Class ConflictUtil

java.lang.Object

org.opentrafficsim.road.gtu.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-2026 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 ParameterTypeBoolean	DEV_SPLIT	Parameter to deviate laterally at splits.
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 org.djunits.value.vdouble.scalar.Acceleration	approachConflicts(TacticalContextEgo context, ConflictUtil.ConflictPlans conflictPlans, RelativeLane lane, org.djunits.value.vdouble.scalar.Length mergeDistance, boolean onRoute)	Approach conflicts by applying appropriate acceleration (or deceleration).
static boolean	stopForAllStopConflict(PerceivedConflict conflict, ConflictUtil.ConflictPlans conflictPlans)	Approach an all-stop conflict.
static boolean	stopForGiveWayConflict(TacticalContext context, PerceivedConflict conflict, PerceptionCollectable<PerceivedGtu,LaneBasedGtu> leaders, ParameterTypeAcceleration bType, org.djunits.value.vdouble.scalar.Length prevEnd)	Approach a give-way conflict.
static boolean	stopForStopConflict(TacticalContext context, PerceivedConflict conflict, PerceptionCollectable<PerceivedGtu,LaneBasedGtu> leaders, ParameterTypeAcceleration bType, org.djunits.value.vdouble.scalar.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.

DEV_SPLIT

public static final ParameterTypeBoolean DEV_SPLIT

Parameter to deviate laterally at splits.

Method Details

approachConflicts

public static org.djunits.value.vdouble.scalar.Acceleration approachConflicts(TacticalContextEgo context,
 ConflictUtil.ConflictPlans conflictPlans,
 RelativeLane lane,
 org.djunits.value.vdouble.scalar.Length mergeDistance,
 boolean onRoute)
                                                                       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:

context - tactical information such as parameters and car-following model

conflictPlans - set of plans for conflict

lane - lane

mergeDistance - distance along which no lane changes can be performed towards the lane

onRoute - filter conflicts to only include conflict on the route

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(TacticalContext context,
 PerceivedConflict conflict,
 PerceptionCollectable<PerceivedGtu,LaneBasedGtu> leaders,
 ParameterTypeAcceleration bType,
 org.djunits.value.vdouble.scalar.Length prevEnd)
                                      throws ParameterException

Approach a give-way conflict.

Parameters:

context - tactical information such as parameters and car-following model

conflict - conflict

leaders - leaders

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(TacticalContext context,
 PerceivedConflict conflict,
 PerceptionCollectable<PerceivedGtu,LaneBasedGtu> leaders,
 ParameterTypeAcceleration bType,
 org.djunits.value.vdouble.scalar.Length prevEnd)
                                   throws ParameterException

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

Parameters:

context - tactical information such as parameters and car-following model

conflict - conflict

leaders - leaders

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