org.opentrafficsim.road.gtu.lane.perception

Class AbstractPerceptionIterable<H extends Headway,U,C>

java.lang.Object

org.opentrafficsim.road.gtu.lane.perception.AbstractPerceptionReiterable<H,U>

org.opentrafficsim.road.gtu.lane.perception.AbstractPerceptionIterable<H,U,C>

Type Parameters:

H - headway type

U - underlying object type

C - counter type

All Implemented Interfaces:

Iterable<H>, PerceptionCollectable<H,U>, PerceptionIterable<H>

Direct Known Subclasses:

DownstreamNeighborsIterable, LaneBasedObjectIterable, UpstreamNeighborsIterable

public abstract class AbstractPerceptionIterable<H extends Headway,U,C>
extends AbstractPerceptionReiterable<H,U>

Abstract iterable that figures out how to find the next nearest object, including splits.

Copyright (c) 2013-2018 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 16 feb. 2018

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	AbstractPerceptionIterable.Entry Class of objects for subclasses to return.

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

AbstractPerceptionReiterable.PerceptionIterator, AbstractPerceptionReiterable.PrimaryIteratorEntry

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

PerceptionCollectable.Intermediate<I>, PerceptionCollectable.PerceptionAccumulator<U,I>, PerceptionCollectable.PerceptionCollector<C,U,I>, PerceptionCollectable.PerceptionFinalizer<C,I>

Field Summary

Fields inherited from class org.opentrafficsim.road.gtu.lane.perception.AbstractPerceptionReiterable

first, gtu, last

Constructor Summary

Constructors

Constructor and Description
AbstractPerceptionIterable(LaneBasedGTU perceivingGtu, LaneRecord<?> root, org.djunits.value.vdouble.scalar.Length initialPosition, boolean downstream, org.djunits.value.vdouble.scalar.Length maxDistance, org.opentrafficsim.core.gtu.RelativePosition relativePosition, org.opentrafficsim.core.network.route.Route route) Constructor.

Method Summary

Modifier and Type	Method and Description
protected abstract org.djunits.value.vdouble.scalar.Length	getDistance(U object, LaneRecord<?> record, org.djunits.value.vdouble.scalar.Length position) Returns the distance to the object.
protected org.djunits.value.vdouble.scalar.Length	getDx() Returns the longitudinal length of the relevant relative position such that distances to this points can be calculated.
protected abstract AbstractPerceptionIterable.Entry	getNext(LaneRecord<?> record, org.djunits.value.vdouble.scalar.Length position, C counter) Returns the next object(s) on the lane represented by the record.
(package private) boolean	isOnRoute(LaneRecord<?> record) Returns whether the record is on the route.
Iterator<AbstractPerceptionReiterable.PrimaryIteratorEntry>	primaryIterator() Returns the primary iterator.

Methods inherited from class org.opentrafficsim.road.gtu.lane.perception.AbstractPerceptionReiterable

addNext, assureNext, collect, first, getPrimaryIterator, isEmpty, iterator, perceive

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

collect

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

AbstractPerceptionIterable

public AbstractPerceptionIterable(LaneBasedGTU perceivingGtu,
                                  LaneRecord<?> root,
                                  org.djunits.value.vdouble.scalar.Length initialPosition,
                                  boolean downstream,
                                  org.djunits.value.vdouble.scalar.Length maxDistance,
                                  org.opentrafficsim.core.gtu.RelativePosition relativePosition,
                                  org.opentrafficsim.core.network.route.Route route)

Constructor.

Parameters:

perceivingGtu - LaneBasedGTU; perceiving GTU

root - R; root record

initialPosition - Length; initial position

downstream - boolean; search downstream (or upstream)

maxDistance - Length; max distance to search

relativePosition - RelativePosition; position to which distance are calculated by subclasses

route - Route; route of the GTU, may be null

Method Detail

primaryIterator

public Iterator<AbstractPerceptionReiterable.PrimaryIteratorEntry> primaryIterator()

Returns the primary iterator. This method is called once by AbstractPerceptionReiterable.

Specified by:

primaryIterator in class AbstractPerceptionReiterable<H extends Headway,U>

Returns:

Iterator; primary iterator

getNext

protected abstract AbstractPerceptionIterable.Entry getNext(LaneRecord<?> record,
                                                            org.djunits.value.vdouble.scalar.Length position,
                                                            C counter)
                                                     throws org.opentrafficsim.core.gtu.GTUException

Returns the next object(s) on the lane represented by the record. This should only consider objects on the given lane. This method should not check the distance towards objects with the maximum distance.

Parameters:

record - R; record representing the lane and direction

position - Length; position to look beyond

counter - C; counter

Returns:

next object(s) on the lane or null if none

Throws:

org.opentrafficsim.core.gtu.GTUException - on any exception in the process

getDistance

protected abstract org.djunits.value.vdouble.scalar.Length getDistance(U object,
                                                                       LaneRecord<?> record,
                                                                       org.djunits.value.vdouble.scalar.Length position)

Returns the distance to the object. The position fed in to this method is directly taken from an Entry returned by getNext. The two methods need to be consistent with each other.

Parameters:

object - U; underlying object

record - R; record representing the lane and direction

position - Length; position of the object on the lane

Returns:

Length; distance to the object

getDx

protected org.djunits.value.vdouble.scalar.Length getDx()

Returns the longitudinal length of the relevant relative position such that distances to this points can be calculated.

Returns:

Length; the longitudinal length of the relevant relative position such that distances to this points can be calculated

isOnRoute

final boolean isOnRoute(LaneRecord<?> record)

Returns whether the record is on the route.

Parameters:

record - R; record

Returns:

boolean; whether the record is on the route