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

Class AbstractPerceptionReiterable<P extends LaneBasedObject,H extends Headway,U>

java.lang.Object

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

Type Parameters:

P - perceiving object type

H - headway type

U - underlying object type

All Implemented Interfaces:

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

Direct Known Subclasses:

MultiLanePerceptionIterable

public abstract class AbstractPerceptionReiterable<P extends LaneBasedObject,H extends Headway,U>
extends Object
implements PerceptionCollectable<H,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.
protected class	AbstractPerceptionReiterable.PrimaryIteratorEntry	Class for primaryIterator() to return, implemented in subclasses.

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(P perceivingObject)	Constructor.

Method Summary

Modifier and Type	Method	Description
(package private) final void	addNext(AbstractPerceptionReiterable<P,H,U>.PrimaryIteratorEntry next)	Adds an iterator entry to the internal linked list.
(package private) AbstractPerceptionReiterable<P,H,U>.org.opentrafficsim.road.gtu.lane.perception.AbstractPerceptionReiterable.SecondaryIteratorEntry	assureNext(AbstractPerceptionReiterable<P,H,U>.org.opentrafficsim.road.gtu.lane.perception.AbstractPerceptionReiterable.SecondaryIteratorEntry next, AbstractPerceptionReiterable<P,H,U>.org.opentrafficsim.road.gtu.lane.perception.AbstractPerceptionReiterable.SecondaryIteratorEntry lastReturned)	Helper method that assures that a next entry is available, if the primary iterator has a next value.
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 H	first()	Returns the first element.
protected P	getObject()	Returns the perceiving object.
(package private) final Iterator<AbstractPerceptionReiterable<P,H,U>.PrimaryIteratorEntry>	getPrimaryIterator()	Returns the primary iterator.
final boolean	isEmpty()	Returns whether this iterable is empty.
final Iterator<H>	iterator()
protected abstract H	perceive(U object, org.djunits.value.vdouble.scalar.Length distance)	Returns a perceived version of the underlying object.
protected abstract Iterator<AbstractPerceptionReiterable<P,H,U>.PrimaryIteratorEntry>	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(P perceivingObject)

Constructor.

Parameters:

perceivingObject - perceiving object.

Method Details

getObject

protected P getObject()

Returns the perceiving object.

Returns:

perceiving object.

getPrimaryIterator

final Iterator<AbstractPerceptionReiterable<P,H,U>.PrimaryIteratorEntry> getPrimaryIterator()

Returns the primary iterator.

Returns:

primary iterator

primaryIterator

protected abstract Iterator<AbstractPerceptionReiterable<P,H,U>.PrimaryIteratorEntry> primaryIterator()

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

Returns:

primary iterator

perceive

protected abstract H perceive(U object,
 org.djunits.value.vdouble.scalar.Length distance)
                       throws GtuException,
org.opentrafficsim.base.parameters.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

org.opentrafficsim.base.parameters.ParameterException - on invalid parameter value or missing parameter

first

public final H first()

Description copied from interface: PerceptionIterable

Returns the first element.

Specified by:

first in interface PerceptionIterable<P extends LaneBasedObject>

Returns:

first element

addNext

final void addNext(AbstractPerceptionReiterable<P,H,U>.PrimaryIteratorEntry next)

Adds an iterator entry to the internal linked list.

Parameters:

next - next object

isEmpty

public final boolean isEmpty()

Description copied from interface: PerceptionIterable

Returns whether this iterable is empty.

Specified by:

isEmpty in interface PerceptionIterable<P extends LaneBasedObject>

Returns:

whether this iterable is empty

iterator

public final Iterator<H> iterator()

Specified by:

iterator in interface Iterable<P 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<P extends LaneBasedObject,H extends Headway>

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<P extends LaneBasedObject,H extends Headway>

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<P extends LaneBasedObject,H extends Headway>

Returns:

iterator

assureNext

AbstractPerceptionReiterable<P,H,U>.org.opentrafficsim.road.gtu.lane.perception.AbstractPerceptionReiterable.SecondaryIteratorEntry assureNext(AbstractPerceptionReiterable<P,H,U>.org.opentrafficsim.road.gtu.lane.perception.AbstractPerceptionReiterable.SecondaryIteratorEntry next,
 AbstractPerceptionReiterable<P,H,U>.org.opentrafficsim.road.gtu.lane.perception.AbstractPerceptionReiterable.SecondaryIteratorEntry lastReturned)

Helper method that assures that a next entry is available, if the primary iterator has a next value. This method may be used by any process that derives from the primary iterator.

Parameters:

next - currently known next entry

lastReturned - entry of last returned object or value

Returns:

next entry