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

Class AbstractDelayedNeighborsPerception

java.lang.Object

org.opentrafficsim.base.Type<AbstractPerceptionCategory<G,P>>

org.opentrafficsim.core.gtu.perception.AbstractPerceptionCategory<LaneBasedGTU,LanePerception>

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

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

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

All Implemented Interfaces:

Serializable, PerceptionCategory<LaneBasedGTU,LanePerception>, LaneBasedPerceptionCategory, NeighborsPerception

Direct Known Subclasses:

DelayedNeighborsPerception

public abstract class AbstractDelayedNeighborsPerception
extends AbstractDelayedPerceptionCategory
implements NeighborsPerception

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 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	AbstractDelayedNeighborsPerception.NeighborsInfoType<T> Delayed information about the type of the neighbors.

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 AbstractDelayedNeighborsPerception.NeighborsInfoType<SortedSet<RelativeLane>>	CROSSSECTION Info type id for cross-section.
protected static ParameterTypeDuration	DT Time step parameter type.
static String	FIRSTFOLLOWERS Info type id base for first followers.
static String	FIRSTLEADERS Info type id base for first leaders.
static String	FOLLOWERS Info type id base for followers.
static String	GTUALONGSIDE Info type id base for gtu alongside.
static String	LEADERS Info type id base for leaders.
static AbstractDelayedNeighborsPerception.NeighborsInfoType<Length>	ODOMETER Id for odometer info type.
protected static ParameterTypeDuration	TR Reaction time parameter type.

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

MAX_RED_DECELERATION, MAX_YELLOW_DECELERATION

Constructor Summary

Constructors

Constructor and Description
AbstractDelayedNeighborsPerception(LanePerception perception) Constructor.

Method Summary

Modifier and Type	Method and Description
SortedSet<RelativeLane>	getDelayedCrossSection() Returns the cross-section on which the most recent observed neighbors were determined.
boolean	isGtuAlongsideOverride(LateralDirectionality lat) Returns whether to override the gtu alongside boolean as true.
void	updateAll()
protected void	updateAllDelayed() Performs actual update.
void	updateFirstFollowers(LateralDirectionality lat) Update 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.
void	updateFirstLeaders(LateralDirectionality lat) Update 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.
void	updateFollowers(RelativeLane lane) Update set of followers on a lane, including adjacent GTU's who's FRONT is back of the own vehicle FRONT.
void	updateGtuAlongside(LateralDirectionality lat) Update whether there is a GTU alongside, i.e.
void	updateLeaders(RelativeLane lane) Update set of leaders on a lane, including adjacent GTU's who's FRONT is ahead of the own vehicle FRONT.

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

changeLane, getInfo, getInfo, setInfo, setInfo

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

getGtu, getObjectOrNull, getPerception, 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

Methods inherited from interface org.opentrafficsim.road.gtu.lane.perception.categories.neighbors.NeighborsPerception

getFirstFollowers, getFirstLeaders, getFollowers, getLeaders, isGtuAlongside

Field Detail

TR

protected static final ParameterTypeDuration TR

Reaction time parameter type.

DT

protected static final ParameterTypeDuration DT

Time step parameter type.

FIRSTLEADERS

public static final String FIRSTLEADERS

Info type id base for first leaders.

See Also:

Constant Field Values

FIRSTFOLLOWERS

public static final String FIRSTFOLLOWERS

Info type id base for first followers.

See Also:

Constant Field Values

GTUALONGSIDE

public static final String GTUALONGSIDE

Info type id base for gtu alongside.

See Also:

Constant Field Values

LEADERS

public static final String LEADERS

Info type id base for leaders.

See Also:

Constant Field Values

FOLLOWERS

public static final String FOLLOWERS

Info type id base for followers.

See Also:

Constant Field Values

CROSSSECTION

public static final AbstractDelayedNeighborsPerception.NeighborsInfoType<SortedSet<RelativeLane>> CROSSSECTION

Info type id for cross-section.

ODOMETER

public static final AbstractDelayedNeighborsPerception.NeighborsInfoType<Length> ODOMETER

Id for odometer info type.

Constructor Detail

AbstractDelayedNeighborsPerception

public AbstractDelayedNeighborsPerception(LanePerception perception)

Constructor.

Parameters:

perception - LanePerception; perception

Method Detail

updateAll

public final void updateAll()
                     throws GTUException,
                            NetworkException,
                            ParameterException

Specified by:

updateAll in interface PerceptionCategory<LaneBasedGTU,LanePerception>

Throws:

GTUException

NetworkException

ParameterException

isGtuAlongsideOverride

public final boolean isGtuAlongsideOverride(LateralDirectionality lat)

Returns whether to override the gtu alongside boolean as true.

Parameters:

lat - LateralDirectionality; lateral direction

Returns:

whether to override the gtu alongside boolean as true

updateAllDelayed

protected void updateAllDelayed()
                         throws GTUException,
                                NetworkException,
                                ParameterException

Performs actual update.

Throws:

ParameterException - if parameter is not present or is given a wrong value

NetworkException - on error in the network

GTUException - if not initialized

updateFirstLeaders

public final void updateFirstLeaders(LateralDirectionality lat)
                              throws ParameterException,
                                     GTUException,
                                     NetworkException

Update 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.

Specified by:

updateFirstLeaders in interface NeighborsPerception

Parameters:

lat - LateralDirectionality; LEFT or RIGHT

Throws:

ParameterException - if a parameter was not present or out of bounds

GTUException - if the GTU was not initialized

NetworkException - in case of a network exception

updateFirstFollowers

public final void updateFirstFollowers(LateralDirectionality lat)
                                throws GTUException,
                                       ParameterException,
                                       NetworkException

Update 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.

Specified by:

updateFirstFollowers in interface NeighborsPerception

Parameters:

lat - LateralDirectionality; LEFT or RIGHT

Throws:

GTUException - if the GTU was not initialized

ParameterException - if a parameter was not present or out of bounds

NetworkException - in case of a network exception

updateGtuAlongside

public final void updateGtuAlongside(LateralDirectionality lat)
                              throws GTUException,
                                     ParameterException

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

Specified by:

updateGtuAlongside in interface NeighborsPerception

Parameters:

lat - LateralDirectionality; LEFT or RIGHT

Throws:

GTUException - if the GTU was not initialized

ParameterException - if parameter is not defined

updateLeaders

public final void updateLeaders(RelativeLane lane)
                         throws ParameterException,
                                GTUException,
                                NetworkException

Update set of leaders on a lane, including adjacent GTU's who's FRONT is ahead of the own vehicle FRONT. Distance will be from the own vehicle FRONT to their REAR. This is negative for (partially) adjacent vehicles.

Specified by:

updateLeaders in interface NeighborsPerception

Parameters:

lane - RelativeLane; relative lateral lane

Throws:

ParameterException - if a parameter was not present or out of bounds

GTUException - if the GRU was not initialized

NetworkException - in case of a network exception

updateFollowers

public final void updateFollowers(RelativeLane lane)
                           throws GTUException,
                                  NetworkException,
                                  ParameterException

Update set of followers on a lane, including adjacent GTU's who's FRONT is back of the own vehicle FRONT. Distance will be from their FRONT to the own vehicle REAR. This is negative for (partially) adjacent vehicles.

Specified by:

updateFollowers in interface NeighborsPerception

Parameters:

lane - RelativeLane; relative lateral lane

Throws:

GTUException - if the GRU was not initialized

NetworkException - in case of a network exception

ParameterException - if a parameter was not present or out of bounds

getDelayedCrossSection

public final SortedSet<RelativeLane> getDelayedCrossSection()

Returns the cross-section on which the most recent observed neighbors were determined.

Returns:

cross-section on which the most recent observed neighbors were determined