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

Class HeadwayGtuType.PerceivedHeadwayGtuType

java.lang.Object

org.opentrafficsim.road.gtu.lane.perception.categories.neighbors.HeadwayGtuType.PerceivedHeadwayGtuType

All Implemented Interfaces:

HeadwayGtuType

Enclosing interface:

HeadwayGtuType

public static class HeadwayGtuType.PerceivedHeadwayGtuType
extends Object
implements HeadwayGtuType

Class for perceived neighbors. Adjacent neighbors are perceived exactly.

Copyright (c) 2013-2022 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 6 apr. 2018

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

Nested Class Summary

Nested classes/interfaces inherited from interface org.opentrafficsim.road.gtu.lane.perception.categories.neighbors.HeadwayGtuType

HeadwayGtuType.PerceivedHeadwayGtuType

Field Summary

Fields inherited from interface org.opentrafficsim.road.gtu.lane.perception.categories.neighbors.HeadwayGtuType

COPY, WRAP

Constructor Summary

Constructors

Constructor	Description
PerceivedHeadwayGtuType(Estimation estimation, Anticipation anticipation)	Constructor.

Method Summary

Modifier and Type	Method	Description
HeadwayGTU	createDownstreamGtu(LaneBasedGTU perceivingGtu, LaneBasedGTU perceivedGtu, Length distance)	Creates a headway object from a GTU, downstream.
HeadwayGTU	createHeadwayGtu(LaneBasedGTU perceivingGtu, LaneBasedGTU perceivedGtu, Length distance, boolean downstream)	Creates a headway object from a GTU, downstream or upstream.
HeadwayGTU	createParallelGtu(LaneBasedGTU perceivingGtu, LaneBasedGTU perceivedGtu, Length overlapFront, Length overlap, Length overlapRear)	Creates a headway object from a GTU, parallel.
HeadwayGTU	createUpstreamGtu(LaneBasedGTU perceivingGtu, LaneBasedGTU perceivedGtu, Length distance)	Creates a headway object from a GTU, downstream.

Methods inherited from class java.lang.Object

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

Constructor Detail

PerceivedHeadwayGtuType

public PerceivedHeadwayGtuType(Estimation estimation,
                               Anticipation anticipation)

Constructor.

Parameters:

estimation - Estimation; estimation

anticipation - Anticipation; anticipation

Method Detail

createHeadwayGtu

public HeadwayGTU createHeadwayGtu(LaneBasedGTU perceivingGtu,
                                   LaneBasedGTU perceivedGtu,
                                   Length distance,
                                   boolean downstream)
                            throws GTUException,
                                   org.opentrafficsim.base.parameters.ParameterException

Creates a headway object from a GTU, downstream or upstream. The default implementation figures out from possible negative distance whether a parallel GTU should be created.

Specified by:

createHeadwayGtu in interface HeadwayGtuType

Parameters:

perceivingGtu - LaneBasedGTU; perceiving GTU

perceivedGtu - LaneBasedGTU; perceived GTU

distance - Length; distance

downstream - boolean; downstream (or upstream) neighbor

Returns:

headway object from a gtu

Throws:

GTUException - when headway object cannot be created

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

createDownstreamGtu

public HeadwayGTU createDownstreamGtu(LaneBasedGTU perceivingGtu,
                                      LaneBasedGTU perceivedGtu,
                                      Length distance)
                               throws GTUException,
                                      org.opentrafficsim.base.parameters.ParameterException

Creates a headway object from a GTU, downstream.

Specified by:

createDownstreamGtu in interface HeadwayGtuType

Parameters:

perceivingGtu - LaneBasedGTU; perceiving GTU

perceivedGtu - LaneBasedGTU; perceived GTU

distance - Length; distance

Returns:

headway object from a gtu

Throws:

GTUException - when headway object cannot be created

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

createUpstreamGtu

public HeadwayGTU createUpstreamGtu(LaneBasedGTU perceivingGtu,
                                    LaneBasedGTU perceivedGtu,
                                    Length distance)
                             throws GTUException,
                                    org.opentrafficsim.base.parameters.ParameterException

Creates a headway object from a GTU, downstream.

Specified by:

createUpstreamGtu in interface HeadwayGtuType

Parameters:

perceivingGtu - LaneBasedGTU; perceiving GTU

perceivedGtu - LaneBasedGTU; perceived GTU

distance - Length; distance

Returns:

headway object from a gtu

Throws:

GTUException - when headway object cannot be created

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

createParallelGtu

public HeadwayGTU createParallelGtu(LaneBasedGTU perceivingGtu,
                                    LaneBasedGTU perceivedGtu,
                                    Length overlapFront,
                                    Length overlap,
                                    Length overlapRear)
                             throws GTUException

Creates a headway object from a GTU, parallel.

Specified by:

createParallelGtu in interface HeadwayGtuType

Parameters:

perceivingGtu - LaneBasedGTU; perceiving GTU

perceivedGtu - LaneBasedGTU; perceived GTU

overlapFront - Length; front overlap

overlap - Length; overlap

overlapRear - Length; rear overlap

Returns:

headway object from a gtu

Throws:

GTUException - when headway object cannot be created