org.opentrafficsim.road.gtu.lane.perception

Class AbstractLanePerception

java.lang.Object

org.opentrafficsim.core.gtu.perception.AbstractPerception

org.opentrafficsim.road.gtu.lane.perception.AbstractLanePerception

All Implemented Interfaces:

Serializable, org.opentrafficsim.core.gtu.perception.Perception, LanePerception

Direct Known Subclasses:

CategorialLanePerception

public abstract class AbstractLanePerception
extends org.opentrafficsim.core.gtu.perception.AbstractPerception
implements LanePerception

The perception module of a GTU based on lanes. It is responsible for perceiving (sensing) the environment of the GTU, which includes the locations of other GTUs. Perception is done at a certain time, and the perceived information might have a limited validity. In that sense, Perception is stateful. Information can be requested as often as needed, but will only be recalculated when asked explicitly. This abstract class provides the building blocks for lane-based perception.
Perception for lane-based GTUs involves information about GTUs in front of the owner GTU on the same lane (the 'leader' GTU), parallel vehicles (important if we want to change lanes), distance to other vehicles on parallel lanes, as well in front as to the back (important if we want to change lanes), and information about obstacles, traffic lights, speed signs, and ending lanes.

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

$LastChangedDate: 2015-07-24 02:58:59 +0200 (Fri, 24 Jul 2015) $, @version $Revision: 1147 $, by $Author: averbraeck $, initial version Nov 15, 2015

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
AbstractLanePerception(LaneBasedGTU gtu) Create a new LanePerception module.

Method Summary

Modifier and Type	Method and Description
LaneBasedGTU	getGtu()
LaneStructure	getLaneStructure()

Methods inherited from class org.opentrafficsim.core.gtu.perception.AbstractPerception

addPerceptionCategory, contains, getPerceptionCategory, perceive, removePerceptionCategory, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.opentrafficsim.core.gtu.perception.Perception

addPerceptionCategory, contains, getPerceptionCategory, perceive, removePerceptionCategory

Constructor Detail

AbstractLanePerception

public AbstractLanePerception(LaneBasedGTU gtu)

Create a new LanePerception module. Because the constructor is often called inside the constructor of a GTU, this constructor does not ask for the pointer to the GTU, as it is often impossible to provide at the time of construction. Use the setter of the GTU instead.

Parameters:

gtu - GTU

Method Detail

getGtu

public final LaneBasedGTU getGtu()

Specified by:

getGtu in interface org.opentrafficsim.core.gtu.perception.Perception

Specified by:

getGtu in interface LanePerception

Overrides:

getGtu in class org.opentrafficsim.core.gtu.perception.AbstractPerception

getLaneStructure

public final LaneStructure getLaneStructure()
                                     throws org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException

Specified by:

getLaneStructure in interface LanePerception

Returns:

lane structure to perform perception

Throws:

org.opentrafficsim.core.gtu.behavioralcharacteristics.ParameterException - if parameter is not defined