org.opentrafficsim.road.gtu.lane.perception.categories

Class DelayedNeighborsPerception

java.lang.Object

org.opentrafficsim.base.Type<org.opentrafficsim.core.gtu.perception.AbstractPerceptionCategory>

org.opentrafficsim.core.gtu.perception.AbstractPerceptionCategory

org.opentrafficsim.road.gtu.lane.perception.categories.LaneBasedAbstractPerceptionCategory

org.opentrafficsim.road.gtu.lane.perception.categories.AbstractDelayedPerceptionCategory

org.opentrafficsim.road.gtu.lane.perception.categories.AbstractDelayedNeighborsPerception

org.opentrafficsim.road.gtu.lane.perception.categories.DelayedNeighborsPerception

All Implemented Interfaces:

Serializable, org.opentrafficsim.core.gtu.perception.PerceptionCategory, NeighborsPerception

public class DelayedNeighborsPerception
extends AbstractDelayedNeighborsPerception

Implementation of delayed neighbors perception which anticipates using constant speed.

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 17 feb. 2017

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DelayedNeighborsPerception.Anticipation Form of anticipation.

Nested classes/interfaces inherited from class org.opentrafficsim.road.gtu.lane.perception.categories.AbstractDelayedNeighborsPerception

AbstractDelayedNeighborsPerception.NeighborsInfoType<T>

Nested classes/interfaces inherited from class org.opentrafficsim.road.gtu.lane.perception.categories.AbstractDelayedPerceptionCategory

AbstractDelayedPerceptionCategory.DelayedInfoType<T>

Field Summary

Fields

Modifier and Type	Field and Description
static org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterTypeDouble	AERROR Parameter for acceleration error factor.
static org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterTypeDouble	SERROR Parameter for distance error factor.
static org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterTypeDuration	TA Parameter for anticipating beyond current time.
static org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterTypeDuration	TAUE Parameter for correlation in errors.
static org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterTypeDouble	VERROR Parameter for speed error factor.

Fields inherited from class org.opentrafficsim.road.gtu.lane.perception.categories.AbstractDelayedNeighborsPerception

CROSSSECTION, FIRSTFOLLOWERS, FIRSTLEADERS, FOLLOWERS, GTUALONGSIDE, LEADERS, ODOMETER

Fields inherited from class org.opentrafficsim.road.gtu.lane.perception.categories.LaneBasedAbstractPerceptionCategory

MAX_RED_DECELERATION, MAX_YELLOW_DECELERATION

Constructor Summary

Constructors

Constructor and Description
DelayedNeighborsPerception(LanePerception perception, DelayedNeighborsPerception.Anticipation anticipation)

Method Summary

Modifier and Type	Method and Description
SortedSet<HeadwayGTU>	getFirstFollowers(org.opentrafficsim.core.network.LateralDirectionality lat) Set of followers on a lane, which is usually 0 or 1, but possibly more in case of an upstream merge with no intermediate GTU.
SortedSet<HeadwayGTU>	getFirstLeaders(org.opentrafficsim.core.network.LateralDirectionality lat) Set of leaders on a lane, which is usually 0 or 1, but possibly more in case of a downstream split with no intermediate GTU.
SortedSet<HeadwayGTU>	getFollowers(RelativeLane lane) Set of followers on a lane, including adjacent GTU's who's FRONT is back of the own vehicle FRONT.
SortedSet<HeadwayGTU>	getLeaders(RelativeLane lane) Set of leaders on a lane, including adjacent GTU's who's FRONT is ahead of the own vehicle FRONT.
boolean	isGtuAlongside(org.opentrafficsim.core.network.LateralDirectionality lat) Whether there is a GTU alongside, i.e.

Methods inherited from class org.opentrafficsim.road.gtu.lane.perception.categories.AbstractDelayedNeighborsPerception

getDelayedCrossSection, isGtuAlongsideOverride, updateAll, updateAllDelayed, updateFirstFollowers, updateFirstLeaders, updateFollowers, updateGtuAlongside, updateLeaders

Methods inherited from class org.opentrafficsim.road.gtu.lane.perception.categories.AbstractDelayedPerceptionCategory

changeLane, getInfo, getInfo, setInfo, setInfo

Methods inherited from class org.opentrafficsim.road.gtu.lane.perception.categories.LaneBasedAbstractPerceptionCategory

getGtu, getPerception

Methods inherited from class org.opentrafficsim.core.gtu.perception.AbstractPerceptionCategory

getObjectOrNull, getTimestamp

Methods inherited from class org.opentrafficsim.base.Type

isType

Methods inherited from class java.lang.Object

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

Field Detail

TA

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

Parameter for anticipating beyond current time.

TAUE

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

Parameter for correlation in errors.

SERROR

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

Parameter for distance error factor.

VERROR

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

Parameter for speed error factor.

AERROR

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

Parameter for acceleration error factor.

Constructor Detail

DelayedNeighborsPerception

public DelayedNeighborsPerception(LanePerception perception,
                                  DelayedNeighborsPerception.Anticipation anticipation)

Parameters:

perception - perception

anticipation - anticipation

Method Detail

getFirstLeaders

public SortedSet<HeadwayGTU> getFirstLeaders(org.opentrafficsim.core.network.LateralDirectionality lat)
                                      throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException,
                                             NullPointerException,
                                             IllegalArgumentException

Set of leaders on a lane, which is usually 0 or 1, but possibly more in case of a downstream split with no intermediate GTU. This is shown below. Suppose A needs to go straight. If A considers a lane change to the left, both GTUs B (who's tail ~ is still on the straight lane) and C need to be considered for whether it's safe to do so. In case of multiple splits close to one another, the returned set may contain even more than 2 leaders. Leaders are sorted by headway value.

          | |
 _________/B/_____
 _ _?_ _ _~_ _C_ _
 _ _A_ _ _ _ _ _ _
 _________________
 

Only vehicles who's rear is beyond the own front are considered, no alongside vehicles.

Parameters:

lat - LEFT or RIGHT

Returns:

list of followers on a lane

Throws:

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

NullPointerException - if lat is null

IllegalArgumentException - if lat is NONE

getFirstFollowers

public SortedSet<HeadwayGTU> getFirstFollowers(org.opentrafficsim.core.network.LateralDirectionality lat)
                                        throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException,
                                               NullPointerException,
                                               IllegalArgumentException

Set of followers on a lane, which is usually 0 or 1, but possibly more in case of an upstream merge with no intermediate GTU. This is shown below. If A considers a lane change to the left, both GTUs B and C need to be considered for whether it's safe to do so. In case of multiple merges close to one another, the returned set may contain even more than 2 followers. Followers are sorted by tailway value.

        | |
        |C| 
 ________\ \______
 _ _B_|_ _ _ _ _?_
 _ _ _|_ _ _ _ _A_ 
 _____|___________
 

Only vehicles who's front is before the own rear are considered, no alongside vehicles.

Parameters:

lat - LEFT or RIGHT

Returns:

list of followers on a lane

Throws:

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

NullPointerException - if lat is null

IllegalArgumentException - if lat is NONE

isGtuAlongside

public boolean isGtuAlongside(org.opentrafficsim.core.network.LateralDirectionality lat)
                       throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException,
                              NullPointerException,
                              IllegalArgumentException

Whether there is a GTU alongside, i.e. with overlap, in an adjacent lane.

Parameters:

lat - LEFT or RIGHT

Returns:

whether there is a GTU alongside, i.e. with overlap, in an adjacent lane

Throws:

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

NullPointerException - if lat is null

IllegalArgumentException - if lat is NONE

getLeaders

public SortedSet<HeadwayGTU> getLeaders(RelativeLane lane)

Set of leaders on a lane, including adjacent GTU's who's FRONT is ahead of the own vehicle FRONT. Leaders are sorted by headway value.

Parameters:

lane - relative lateral lane

Returns:

set of leaders on a lane, including adjacent GTU's who's FRONT is ahead of the own vehicle FRONT

getFollowers

public SortedSet<HeadwayGTU> getFollowers(RelativeLane lane)

Set of followers on a lane, including adjacent GTU's who's FRONT is back of the own vehicle FRONT. Follower are are sorted by distance.

Parameters:

lane - relative lateral lane

Returns:

set of followers on a lane, including adjacent GTU's who's FRONT is back of the own vehicle FRONT