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

Class AbstractDelayedNeighborsPerception

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

All Implemented Interfaces:

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

Direct Known Subclasses:

DelayedNeighborsPerception

public abstract class AbstractDelayedNeighborsPerception
extends AbstractDelayedPerceptionCategory
implements NeighborsPerception

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	AbstractDelayedNeighborsPerception.NeighborsInfoType<T> Copyright (c) 2013-2017 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands.

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.
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<org.djunits.value.vdouble.scalar.Length>	ODOMETER Id for odometer info 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(org.opentrafficsim.core.network.LateralDirectionality lat) Returns whether to override the gtu alongside boolean as true.
void	updateAll()
protected void	updateAllDelayed() Performs actual update.
void	updateFirstFollowers(org.opentrafficsim.core.network.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(org.opentrafficsim.core.network.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(org.opentrafficsim.core.network.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.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

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

getFirstFollowers, getFirstLeaders, getFollowers, getLeaders, isGtuAlongside

Field Detail

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<org.djunits.value.vdouble.scalar.Length> ODOMETER

Id for odometer info type.

Constructor Detail

AbstractDelayedNeighborsPerception

public AbstractDelayedNeighborsPerception(LanePerception perception)

Constructor.

Parameters:

perception - perception

Method Detail

updateAll

public void updateAll()
               throws org.opentrafficsim.core.gtu.GTUException,
                      org.opentrafficsim.core.network.NetworkException,
                      org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Specified by:

updateAll in interface org.opentrafficsim.core.gtu.perception.PerceptionCategory

Throws:

org.opentrafficsim.core.gtu.GTUException

org.opentrafficsim.core.network.NetworkException

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

isGtuAlongsideOverride

public boolean isGtuAlongsideOverride(org.opentrafficsim.core.network.LateralDirectionality lat)

Returns whether to override the gtu alongside boolean as true.

Parameters:

lat - lateral direction

Returns:

whether to override the gtu alongside boolean as true

updateAllDelayed

protected void updateAllDelayed()
                         throws org.opentrafficsim.core.gtu.GTUException,
                                org.opentrafficsim.core.network.NetworkException,
                                org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Performs actual update.

Throws:

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if parameter is not present or is given a wrong value

org.opentrafficsim.core.network.NetworkException - on error in the network

org.opentrafficsim.core.gtu.GTUException - if not initialized

updateFirstLeaders

public void updateFirstLeaders(org.opentrafficsim.core.network.LateralDirectionality lat)
                        throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException,
                               org.opentrafficsim.core.gtu.GTUException,
                               org.opentrafficsim.core.network.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 - LEFT or RIGHT

Throws:

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if a parameter was not present or out of bounds

org.opentrafficsim.core.gtu.GTUException - if the GTU was not initialized

org.opentrafficsim.core.network.NetworkException - in case of a network exception

updateFirstFollowers

public void updateFirstFollowers(org.opentrafficsim.core.network.LateralDirectionality lat)
                          throws org.opentrafficsim.core.gtu.GTUException,
                                 org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException,
                                 org.opentrafficsim.core.network.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 - LEFT or RIGHT

Throws:

org.opentrafficsim.core.gtu.GTUException - if the GTU was not initialized

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if a parameter was not present or out of bounds

org.opentrafficsim.core.network.NetworkException - in case of a network exception

updateGtuAlongside

public void updateGtuAlongside(org.opentrafficsim.core.network.LateralDirectionality lat)
                        throws org.opentrafficsim.core.gtu.GTUException,
                               org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

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

Specified by:

updateGtuAlongside in interface NeighborsPerception

Parameters:

lat - LEFT or RIGHT

Throws:

org.opentrafficsim.core.gtu.GTUException - if the GTU was not initialized

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

updateLeaders

public void updateLeaders(RelativeLane lane)
                   throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException,
                          org.opentrafficsim.core.gtu.GTUException,
                          org.opentrafficsim.core.network.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 - relative lateral lane

Throws:

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if a parameter was not present or out of bounds

org.opentrafficsim.core.gtu.GTUException - if the GRU was not initialized

org.opentrafficsim.core.network.NetworkException - in case of a network exception

updateFollowers

public void updateFollowers(RelativeLane lane)
                     throws org.opentrafficsim.core.gtu.GTUException,
                            org.opentrafficsim.core.network.NetworkException,
                            org.opentrafficsim.core.gtu.behavioralcharacteristics.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 - relative lateral lane

Throws:

org.opentrafficsim.core.gtu.GTUException - if the GRU was not initialized

org.opentrafficsim.core.network.NetworkException - in case of a network exception

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if a parameter was not present or out of bounds

getDelayedCrossSection

public 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