org.opentrafficsim.road.gtu.lane.perception

Class MultiLanePerceptionIterable<H extends Headway,U>

java.lang.Object

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

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

Type Parameters:

H - headway type

U - underlying headway type

All Implemented Interfaces:

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

public class MultiLanePerceptionIterable<H extends Headway,U>
extends AbstractPerceptionReiterable<H,U>

Iterable class to search over multiple lanes.

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 20 feb. 2018

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, 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

Modifier and Type	Field and Description
(package private) Map<RelativeLane,AbstractPerceptionReiterable<H,U>>	iterables Map of iterable per lane.
(package private) Map<RelativeLane,Iterator<AbstractPerceptionReiterable.PrimaryIteratorEntry>>	iterators Set of iterators per lane.
(package private) Map<U,RelativeLane>	laneMap Map of lane per object.

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

first, gtu, last

Constructor Summary

Constructors

Constructor and Description
MultiLanePerceptionIterable(LaneBasedGTU perceivingGtu) Constructor.

Method Summary

Modifier and Type	Method and Description
void	addIterable(RelativeLane lane, AbstractPerceptionReiterable<H,U> iterable) Adds an iterable for a lane.
H	perceive(LaneBasedGTU perceivingGtu, U object, org.djunits.value.vdouble.scalar.Length distance) Returns a perceived version of the underlying object.
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

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

Field Detail

iterators

final Map<RelativeLane,Iterator<AbstractPerceptionReiterable.PrimaryIteratorEntry>> iterators

Set of iterators per lane.

laneMap

final Map<U,RelativeLane> laneMap

Map of lane per object.

iterables

final Map<RelativeLane,AbstractPerceptionReiterable<H extends Headway,U>> iterables

Map of iterable per lane.

Constructor Detail

MultiLanePerceptionIterable

public MultiLanePerceptionIterable(LaneBasedGTU perceivingGtu)

Constructor.

Parameters:

perceivingGtu - LaneBasedGTU; perceiving GTU

Method Detail

addIterable

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

Adds an iterable for a lane.

Parameters:

lane - Lane; lane

iterable - AbstractPerceptionReiterable; iterable

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

perceive

public H perceive(LaneBasedGTU perceivingGtu,
                  U object,
                  org.djunits.value.vdouble.scalar.Length distance)
           throws org.opentrafficsim.core.gtu.GTUException,
                  org.opentrafficsim.base.parameters.ParameterException

Returns a perceived version of the underlying object.

Specified by:

perceive in class AbstractPerceptionReiterable<H extends Headway,U>

Parameters:

perceivingGtu - LaneBasedGTU; perceiving GTU

object - U; underlying object

distance - Length; distance to the object

Returns:

H; perceived version of the underlying object

Throws:

org.opentrafficsim.core.gtu.GTUException - on exception

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