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

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

java.lang.Object

org.opentrafficsim.road.gtu.lane.perception.AbstractPerceptionReiterable<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>

Direct Known Subclasses:

MultiLanePerceptionIterable, PerceptionReiterable

public abstract class AbstractPerceptionReiterable<O extends LaneBasedObject,P extends PerceivedObject,U>
extends Object
implements PerceptionCollectable<P,U>

This class uses a single primary iterator which a subclass defines, and makes sure that all elements are only looked up and created once. It does so by storing the elements in a linked list. All calls to iterator() return an iterator which iterates over the linked list. If an iterator runs to the end of the linked list, the primary iterator is requested to add an element if it has one.

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

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
class	AbstractPerceptionReiterable.PerceptionIterator	This iterator is returned to callers of the iterator() method.

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

Modifier	Constructor	Description
protected	AbstractPerceptionReiterable(O perceivingObject)	Constructor.

Method Summary

Modifier and Type	Method	Description
final <C, I> C	collect(Supplier<I> identity, PerceptionCollectable.PerceptionAccumulator<? super U,I> accumulator, Function<I,C> finalizer)	Collect the underlying objects in to a perceived result.
final P	first()	Returns the first element.
O	getObject()	Returns the perceiving object.
final boolean	isEmpty()	Returns whether this iterable is empty.
final Iterator<P>	iterator()
protected abstract P	perceive(U object, Length distance)	Returns a perceived version of the underlying object.
protected abstract Iterator<PerceptionCollectable.UnderlyingDistance<U>>	primaryIterator()	Returns the primary iterator.
Iterator<U>	underlying()	Returns an iterator over the underlying objects.
Iterator<PerceptionCollectable.UnderlyingDistance<U>>	underlyingWithDistance()	Returns an iterator over the underlying objects coupled with the distance.

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

AbstractPerceptionReiterable

protected AbstractPerceptionReiterable(O perceivingObject)

Constructor.

Parameters:

perceivingObject - perceiving object.

Method Details

getObject

public O getObject()

Returns the perceiving object.

Returns:

perceiving object.

primaryIterator

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

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

Returns:

primary iterator

perceive

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

Returns a perceived version of the underlying object.

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

first

public final P first()

Description copied from interface: PerceptionIterable

Returns the first element.

Specified by:

first in interface PerceptionIterable<O extends LaneBasedObject>

Returns:

first element

isEmpty

public final boolean isEmpty()

Description copied from interface: PerceptionIterable

Returns whether this iterable is empty.

Specified by:

isEmpty in interface PerceptionIterable<O extends LaneBasedObject>

Returns:

whether this iterable is empty

iterator

public final Iterator<P> iterator()

Specified by:

iterator in interface Iterable<O extends LaneBasedObject>

collect

public final <C,
I> C collect(Supplier<I> identity,
 PerceptionCollectable.PerceptionAccumulator<? super U,I> accumulator,
 Function<I,C> finalizer)

Description copied from interface: PerceptionCollectable

Collect the underlying objects in to a perceived result. This methodology is loosely based on Stream.collect().

Specified by:

collect in interface PerceptionCollectable<O extends LaneBasedObject,P extends PerceivedObject>

Type Parameters:

C - collection result type

I - intermediate type

Parameters:

identity - the initial intermediate result value

accumulator - accumulator

finalizer - finalizer

Returns:

collection result

underlying

public Iterator<U> underlying()

Description copied from interface: PerceptionCollectable

Returns an iterator over the underlying objects.

Specified by:

underlying in interface PerceptionCollectable<O extends LaneBasedObject,P extends PerceivedObject>

Returns:

iterator

underlyingWithDistance

public Iterator<PerceptionCollectable.UnderlyingDistance<U>> underlyingWithDistance()

Description copied from interface: PerceptionCollectable

Returns an iterator over the underlying objects coupled with the distance.

Specified by:

underlyingWithDistance in interface PerceptionCollectable<O extends LaneBasedObject,P extends PerceivedObject>

Returns:

iterator