Package org.opentrafficsim.road.gtu.lane.perception

Class PerceptionReiterable<O extends LaneBasedObject,P extends PerceivedObject,U>

java.lang.Object

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

org.opentrafficsim.road.gtu.lane.perception.PerceptionReiterable<O,P,U>

Type Parameters:

O - perceiving object type (an O is perceiving a U as a P)

P - perceived object type (an O is perceiving a U as a P)

U - underlying object type (an O is perceiving a U as a P)

All Implemented Interfaces:

Iterable<P>, PerceptionCollectable<P,U>, PerceptionIterable<P>

public class PerceptionReiterable<O extends LaneBasedObject,P extends PerceivedObject,U>
extends AbstractPerceptionReiterable<O,P,U>

Standard implementation of AbstractPerceptionReiterable useful for most cases using an iterator over NavigatingIterable.Entry from the LaneStructure.

Copyright (c) 2026-2026 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See OpenTrafficSim License.

Author:

Wouter Schakel

Nested Class Summary

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

AbstractPerceptionReiterable.PerceptionIterator

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.UnderlyingDistance<U>

Constructor Summary

Constructors

Constructor	Description
PerceptionReiterable(O perceivingObject, Iterable<NavigatingIterable.Entry<U>> iterable, BiFunction<U,Length,P> perception)	Constructor.

Method Summary

Modifier and Type	Method	Description
protected P	perceive(U object, Length distance)	Returns a perceived version of the underlying object.
protected Iterator<PerceptionCollectable.UnderlyingDistance<U>>	primaryIterator()	Returns the primary iterator.

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

collect, first, getObject, isEmpty, iterator, underlying, underlyingWithDistance

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Methods inherited from interface org.opentrafficsim.road.gtu.lane.perception.PerceptionCollectable

collect

Constructor Details

PerceptionReiterable

public PerceptionReiterable(O perceivingObject,
 Iterable<NavigatingIterable.Entry<U>> iterable,
 BiFunction<U,Length,P> perception)

Constructor.

Parameters:

perceivingObject - perceiving object

iterable - iterable over entries of underlying objects

perception - function to translate an object, and the distance to it, in to a perceived object

Method Details

primaryIterator

protected Iterator<PerceptionCollectable.UnderlyingDistance<U>> primaryIterator()

Description copied from class: AbstractPerceptionReiterable

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

Specified by:

primaryIterator in class AbstractPerceptionReiterable<O extends LaneBasedObject,P extends PerceivedObject,U>

Returns:

primary iterator

perceive

protected P perceive(U object,
 Length distance)
              throws GtuException,
ParameterException

Description copied from class: AbstractPerceptionReiterable

Returns a perceived version of the underlying object.

Specified by:

perceive in class AbstractPerceptionReiterable<O extends LaneBasedObject,P extends PerceivedObject,U>

Parameters:

object - underlying object

distance - distance to the object

Returns:

perceived version of the underlying object

Throws:

GtuException - on exception

ParameterException - on invalid parameter value or missing parameter