org.opentrafficsim.core.gtu.perception

Class AbstractPerception<G extends GTU>

java.lang.Object

org.opentrafficsim.core.gtu.perception.AbstractPerception<G>

Type Parameters:

G - GTU type

All Implemented Interfaces:

Serializable, Perception<G>

public abstract class AbstractPerception<G extends GTU>
extends Object
implements Perception<G>

Copyright (c) 2013-2017 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 Jul 29, 2016

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
AbstractPerception(G gtu) Construct perception.

Method Summary

Modifier and Type	Method and Description
<T extends PerceptionCategory<?,?>> void	addPerceptionCategory(T perceptionCategory) Adds given perception category to the perception.
<T extends PerceptionCategory<?,?>> boolean	contains(Class<T> category) Returns whether the given perception category is present.
G	getGtu() Return the GTU of this perception.
<T extends PerceptionCategory<?,?>> T	getPerceptionCategory(Class<T> category) Returns the given perception category.
<T extends PerceptionCategory<?,?>> T	getPerceptionCategoryOrNull(Class<T> category) Returns the given perception category, or null if not present.
void	perceive() Update the perceived information and store it in a stateful manner.
void	removePerceptionCategory(PerceptionCategory<?,?> perceptionCategory) Remove give perception category.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractPerception

public AbstractPerception(G gtu)

Construct perception.

Parameters:

gtu - GTU

Method Detail

getGtu

public G getGtu()

Return the GTU of this perception.

Specified by:

getGtu in interface Perception<G extends GTU>

Returns:

GTU of this perception

addPerceptionCategory

public final <T extends PerceptionCategory<?,?>> void addPerceptionCategory(T perceptionCategory)

Adds given perception category to the perception.

Specified by:

addPerceptionCategory in interface Perception<G extends GTU>

Type Parameters:

T - perception category type

Parameters:

perceptionCategory - perception category

contains

public final <T extends PerceptionCategory<?,?>> boolean contains(Class<T> category)

Returns whether the given perception category is present.

Specified by:

contains in interface Perception<G extends GTU>

Type Parameters:

T - perception category

Parameters:

category - perception category class

Returns:

whether the given perception category is present

getPerceptionCategory

public final <T extends PerceptionCategory<?,?>> T getPerceptionCategory(Class<T> category)
                                                                  throws OperationalPlanException

Returns the given perception category.

Specified by:

getPerceptionCategory in interface Perception<G extends GTU>

Type Parameters:

T - perception category

Parameters:

category - perception category class

Returns:

given perception category

Throws:

OperationalPlanException - if the perception category is not present

getPerceptionCategoryOrNull

public final <T extends PerceptionCategory<?,?>> T getPerceptionCategoryOrNull(Class<T> category)

Returns the given perception category, or null if not present.

Specified by:

getPerceptionCategoryOrNull in interface Perception<G extends GTU>

Type Parameters:

T - perception category

Parameters:

category - perception category class

Returns:

given perception category

removePerceptionCategory

public final void removePerceptionCategory(PerceptionCategory<?,?> perceptionCategory)

Remove give perception category.

Specified by:

removePerceptionCategory in interface Perception<G extends GTU>

Parameters:

perceptionCategory - perception category to remove

perceive

public void perceive()
              throws GTUException,
                     NetworkException,
                     org.opentrafficsim.base.parameters.ParameterException

Update the perceived information and store it in a stateful manner.

Specified by:

perceive in interface Perception<G extends GTU>

Throws:

GTUException - when GTU has not been properly initialized.

NetworkException - in case of inconsistencies in the network during perception calculations.

org.opentrafficsim.base.parameters.ParameterException - in case of a parameter error.

toString

public String toString()

Overrides:

toString in class Object