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

Class MultiLanePerceptionIterable<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.MultiLanePerceptionIterable<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 MultiLanePerceptionIterable<O extends LaneBasedObject,P extends PerceivedObject,U>
extends AbstractPerceptionReiterable<O,P,U>

Iterable class to search over multiple lanes.

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/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
MultiLanePerceptionIterable(O perceivingObject)	Constructor.

Method Summary

Modifier and Type	Method	Description
void	addIterable(RelativeLane lane, AbstractPerceptionReiterable<O,P,U> iterable)	Adds an iterable for a lane.
P	perceive(U object, Length distance)	Returns a perceived version of the underlying object.
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

MultiLanePerceptionIterable

public MultiLanePerceptionIterable(O perceivingObject)

Constructor.

Parameters:

perceivingObject - perceiving object

Method Details

addIterable

public void addIterable(RelativeLane lane,
 AbstractPerceptionReiterable<O,P,U> iterable)

Adds an iterable for a lane.

Parameters:

lane - lane

iterable - iterable

primaryIterator

public 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

public 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