org.opentrafficsim.road.gtu.lane.perception.headway

Class HeadwayConflict

java.lang.Object

org.opentrafficsim.road.gtu.lane.perception.headway.AbstractHeadway

org.opentrafficsim.road.gtu.lane.perception.headway.AbstractHeadwayCopy

org.opentrafficsim.road.gtu.lane.perception.headway.HeadwayConflict

All Implemented Interfaces:

Serializable, Comparable<Headway>, Identifiable, PerceivedObject, Headway

public class HeadwayConflict
extends AbstractHeadwayCopy

Copyright (c) 2013-2019 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 2, 2016

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	HeadwayConflict.Width Width progression of conflict.

Nested classes/interfaces inherited from interface org.opentrafficsim.road.gtu.lane.perception.headway.Headway

Headway.ObjectType

Constructor Summary

Constructors

Constructor and Description
HeadwayConflict(ConflictType conflictType, ConflictPriority conflictPriority, Class<? extends ConflictRule> conflictRuleType, String id, Length distance, Length length, Length conflictingLength, PerceptionCollectable<HeadwayGTU,LaneBasedGTU> upstreamConflictingGTUs, PerceptionCollectable<HeadwayGTU,LaneBasedGTU> downstreamConflictingGTUs, Length conflictingVisibility, Speed conflictingSpeedLimit, CrossSectionLink conflictingLink, HeadwayConflict.Width width) Constructor without stop lines.
HeadwayConflict(ConflictType conflictType, ConflictPriority conflictPriority, Class<? extends ConflictRule> conflictRuleType, String id, Length distance, Length length, Length conflictingLength, PerceptionCollectable<HeadwayGTU,LaneBasedGTU> upstreamConflictingGTUs, PerceptionCollectable<HeadwayGTU,LaneBasedGTU> downstreamConflictingGTUs, Length conflictingVisibility, Speed conflictingSpeedLimit, CrossSectionLink conflictingLink, HeadwayConflict.Width width, HeadwayStopLine stopLine, HeadwayStopLine conflictingStopLine) Constructor.

Method Summary

Modifier and Type	Method and Description
Length	getConflictingLength() Returns the length of the conflict on the conflicting lane.
CrossSectionLink	getConflictingLink() Returns the conflicting link.
Speed	getConflictingSpeedLimit() Returns the speed limit on the conflicting lane.
HeadwayStopLine	getConflictingStopLine() Returns the stop line on the conflicting lane.
Length	getConflictingTrafficLightDistance() Returns the distance of a traffic light upstream on the conflicting lane.
Length	getConflictingVisibility() Returns the visibility on the conflicting lane within which conflicting vehicles are visible.
ConflictPriority	getConflictPriority() Returns the conflict priority.
Class<? extends ConflictRule>	getConflictRuleType() Returns the conflict rule type.
ConflictType	getConflictType() Returns the conflict type.
PerceptionCollectable<HeadwayGTU,LaneBasedGTU>	getDownstreamConflictingGTUs() Returns a set of conflicting GTU's downstream of the start of the conflict ordered close to far from the conflict.
HeadwayStopLine	getStopLine() Returns the stop line.
PerceptionCollectable<HeadwayGTU,LaneBasedGTU>	getUpstreamConflictingGTUs() Returns a set of conflicting GTU's upstream of the start of the conflict ordered close to far from the conflict.
Length	getWidthAtFraction(double fraction) Returns the width at the given fraction.
boolean	isCrossing() Returns whether this is a crossing conflict.
boolean	isMerge() Returns whether this is a merge conflict.
boolean	isPermitted() Whether the conflict is permitted by the traffic light.
boolean	isSplit() Returns whether this is a split conflict.
void	setConflictingTrafficLight(Length trafficLightDistance, boolean permittedConflict) Set the distance of a traffic light upstream on the conflicting lane.
String	toString()

Methods inherited from class org.opentrafficsim.road.gtu.lane.perception.headway.AbstractHeadwayCopy

equals, getAcceleration, getId, getLength, getObjectType, getSpeed, hashCode

Methods inherited from class org.opentrafficsim.road.gtu.lane.perception.headway.AbstractHeadway

getDistance, getOverlap, getOverlapFront, getOverlapRear, isAhead, isBehind, isParallel

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.opentrafficsim.road.gtu.lane.perception.headway.Headway

compareTo

Constructor Detail

HeadwayConflict

public HeadwayConflict(ConflictType conflictType,
                       ConflictPriority conflictPriority,
                       Class<? extends ConflictRule> conflictRuleType,
                       String id,
                       Length distance,
                       Length length,
                       Length conflictingLength,
                       PerceptionCollectable<HeadwayGTU,LaneBasedGTU> upstreamConflictingGTUs,
                       PerceptionCollectable<HeadwayGTU,LaneBasedGTU> downstreamConflictingGTUs,
                       Length conflictingVisibility,
                       Speed conflictingSpeedLimit,
                       CrossSectionLink conflictingLink,
                       HeadwayConflict.Width width,
                       HeadwayStopLine stopLine,
                       HeadwayStopLine conflictingStopLine)
                throws GTUException

Constructor.

Parameters:

conflictType - ConflictType; conflict type

conflictPriority - ConflictPriority; conflict priority

conflictRuleType - Class<? extends ConflictRule>; conflict rule type

id - String; id

distance - Length; distance

length - Length; length of the conflict

conflictingLength - Length; length of the conflict on the conflicting lane

upstreamConflictingGTUs - PerceptionCollectable<HeadwayGTU,LaneBasedGTU>; conflicting GTU's upstream of the <i>start</i> of the conflict

downstreamConflictingGTUs - PerceptionCollectable<HeadwayGTU,LaneBasedGTU>; conflicting GTU's downstream of the <i>start</i> of the conflict

conflictingVisibility - Length; visibility on the conflicting lane within which conflicting vehicles are visible

conflictingSpeedLimit - Speed; speed limit on the conflicting lane

conflictingLink - CrossSectionLink; conflicting link

width - Width; width progression of conflict

stopLine - HeadwayStopLine; stop line on the own lane

conflictingStopLine - HeadwayStopLine; stop line on the conflicting lane

Throws:

GTUException - when id is null, or parameters are inconsistent

HeadwayConflict

public HeadwayConflict(ConflictType conflictType,
                       ConflictPriority conflictPriority,
                       Class<? extends ConflictRule> conflictRuleType,
                       String id,
                       Length distance,
                       Length length,
                       Length conflictingLength,
                       PerceptionCollectable<HeadwayGTU,LaneBasedGTU> upstreamConflictingGTUs,
                       PerceptionCollectable<HeadwayGTU,LaneBasedGTU> downstreamConflictingGTUs,
                       Length conflictingVisibility,
                       Speed conflictingSpeedLimit,
                       CrossSectionLink conflictingLink,
                       HeadwayConflict.Width width)
                throws GTUException

Constructor without stop lines.

Parameters:

conflictType - ConflictType; conflict type

conflictPriority - ConflictPriority; conflict priority

conflictRuleType - Class<? extends ConflictRule>; conflict rule type

id - String; id

distance - Length; distance

length - Length; length of the conflict

conflictingLength - Length; length of the conflict on the conflicting lane

upstreamConflictingGTUs - PerceptionCollectable<HeadwayGTU,LaneBasedGTU>; conflicting GTU's upstream of the <i>start</i> of the conflict

downstreamConflictingGTUs - PerceptionCollectable<HeadwayGTU,LaneBasedGTU>; conflicting GTU's downstream of the <i>start</i> of the conflict

conflictingVisibility - Length; visibility on the conflicting lane within which conflicting vehicles are visible

conflictingSpeedLimit - Speed; speed limit on the conflicting lane

conflictingLink - CrossSectionLink; conflicting link

width - Width; width progression of conflict

Throws:

GTUException - when id is null, or parameters are inconsistent

Method Detail

getConflictType

public final ConflictType getConflictType()

Returns the conflict type.

Returns:

conflict type

isCrossing

public final boolean isCrossing()

Returns whether this is a crossing conflict.

Returns:

whether this is a crossing conflict

isMerge

public final boolean isMerge()

Returns whether this is a merge conflict.

Returns:

whether this is a merge conflict

isSplit

public final boolean isSplit()

Returns whether this is a split conflict.

Returns:

whether this is a split conflict

getConflictPriority

public final ConflictPriority getConflictPriority()

Returns the conflict priority.

Returns:

conflict priority

getConflictingLength

public final Length getConflictingLength()

Returns the length of the conflict on the conflicting lane.

Returns:

length of the conflict on the conflicting lane

getUpstreamConflictingGTUs

public final PerceptionCollectable<HeadwayGTU,LaneBasedGTU> getUpstreamConflictingGTUs()

Returns a set of conflicting GTU's upstream of the start of the conflict ordered close to far from the conflict.

Returns:

set of conflicting GTU's upstream of the start of the conflict ordered close to far from the conflict

getDownstreamConflictingGTUs

public final PerceptionCollectable<HeadwayGTU,LaneBasedGTU> getDownstreamConflictingGTUs()

Returns a set of conflicting GTU's downstream of the start of the conflict ordered close to far from the conflict. Distance is given relative to the end of the conflict, or null for conflicting vehicles on the conflict. In the latter case the overlap is used.

Returns:

set of conflicting GTU's downstream of the start of the conflict ordered close to far from the conflict

getConflictingVisibility

public final Length getConflictingVisibility()

Returns the visibility on the conflicting lane within which conflicting vehicles are visible. All upstream conflicting GTUs have a distance smaller than the visibility. Depending on a limited visibility, a certain (lower) speed may be required while approaching the conflict.

Returns:

visibility on the conflicting lane within which conflicting vehicles are visible

getConflictingSpeedLimit

public final Speed getConflictingSpeedLimit()

Returns the speed limit on the conflicting lane.

Returns:

speed limit on the conflicting lane

getConflictingLink

public final CrossSectionLink getConflictingLink()

Returns the conflicting link.

Returns:

the conflicting link

getStopLine

public final HeadwayStopLine getStopLine()

Returns the stop line.

Returns:

stop line

getConflictingStopLine

public final HeadwayStopLine getConflictingStopLine()

Returns the stop line on the conflicting lane.

Returns:

stop line

getConflictRuleType

public final Class<? extends ConflictRule> getConflictRuleType()

Returns the conflict rule type.

Returns:

conflict rule type

getConflictingTrafficLightDistance

public final Length getConflictingTrafficLightDistance()

Returns the distance of a traffic light upstream on the conflicting lane.

Returns:

distance of a traffic light upstream on the conflicting lane.

isPermitted

public final boolean isPermitted()

Whether the conflict is permitted by the traffic light.

Returns:

whether the conflict is permitted by the traffic light

setConflictingTrafficLight

public final void setConflictingTrafficLight(Length trafficLightDistance,
                                             boolean permittedConflict)

Set the distance of a traffic light upstream on the conflicting lane.

Parameters:

trafficLightDistance - Length; distance of a traffic light upstream on the conflicting lane.

permittedConflict - boolean; whether the conflict is permitted by the traffic light

getWidthAtFraction

public final Length getWidthAtFraction(double fraction)

Returns the width at the given fraction.

Parameters:

fraction - double; fraction from 0 to 1

Returns:

Length; width at the given fraction

toString

public final String toString()

Overrides:

toString in class AbstractHeadway