org.opentrafficsim.road.gtu.lane.perception.headway

Class HeadwayGTUSimple

java.lang.Object

org.opentrafficsim.road.gtu.lane.perception.headway.AbstractHeadway

org.opentrafficsim.road.gtu.lane.perception.headway.AbstractHeadwayCopy

org.opentrafficsim.road.gtu.lane.perception.headway.AbstractHeadwayGTU

org.opentrafficsim.road.gtu.lane.perception.headway.HeadwayGTUSimple

All Implemented Interfaces:

Serializable, Comparable<Headway>, org.opentrafficsim.core.perception.PerceivedObject, Headway, HeadwayGTU

public class HeadwayGTUSimple
extends AbstractHeadwayGTU

Container for a reference to information about a (lane based) GTU and a headway. The Headway can store information about GTUs or objects ahead of the reference GTU, behind the reference GTU, or (partially) parallel to the reference GTU. In addition to the (perceived) headway, several other pieces of information can be stored, such as (perceived) speed, (perceived) acceleration, (perceived) turn indicators, and (perceived) braking lights.
This particular version has only limited behavioral information about the observed GTU.
Special care must be taken in curves when perceiving headway of a GTU or object on an adjacent lane.The question is whether we perceive the parallel or ahead/behind based on a line perpendicular to the front/back of the GTU (rectangular), or perpendicular to the center line of the lane (wedge-shaped in case of a curve). The difficulty of a wedge-shaped situation is that reciprocity might be violated: in case of a clothoid, for instance, it is not sure that the point on the center line when projected from lane 1 to lane 2 is the same as the projection from lane 2 to lane 1. The same holds for shapes with sharp bends. Therefore, algorithms implementing headway should only project the reference point of the reference GTU on the center line of the adjacent lane, and then calculate the forward position and backward position on the adjacent lane based on the reference point. Still, our human perception of what is parallel and what not, is not reflected by fractional positions. See examples in http://simulation.tudelft.nl:8085/browse/OTS-113.

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.

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

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface org.opentrafficsim.road.gtu.lane.perception.headway.Headway

Headway.ObjectType

Constructor Summary

Constructors

Constructor and Description
HeadwayGTUSimple(String id, org.opentrafficsim.core.gtu.GTUType gtuType, org.djunits.value.vdouble.scalar.Length distance, org.djunits.value.vdouble.scalar.Length length, GTUStatus... gtuStatus) Construct a new Headway information object, for a non-moving GTU ahead of us or behind us.
HeadwayGTUSimple(String id, org.opentrafficsim.core.gtu.GTUType gtuType, org.djunits.value.vdouble.scalar.Length overlapFront, org.djunits.value.vdouble.scalar.Length overlap, org.djunits.value.vdouble.scalar.Length overlapRear, org.djunits.value.vdouble.scalar.Length length, GTUStatus... gtuStatus) Construct a new Headway information object, for a non-moving GTU parallel with us.
HeadwayGTUSimple(String id, org.opentrafficsim.core.gtu.GTUType gtuType, org.djunits.value.vdouble.scalar.Length overlapFront, org.djunits.value.vdouble.scalar.Length overlap, org.djunits.value.vdouble.scalar.Length overlapRear, org.djunits.value.vdouble.scalar.Length length, org.djunits.value.vdouble.scalar.Speed speed, org.djunits.value.vdouble.scalar.Acceleration acceleration, GTUStatus... gtuStatus) Construct a new Headway information object, for a moving GTU parallel with us.
HeadwayGTUSimple(String id, org.opentrafficsim.core.gtu.GTUType gtuType, org.djunits.value.vdouble.scalar.Length distance, org.djunits.value.vdouble.scalar.Length length, org.djunits.value.vdouble.scalar.Speed speed, org.djunits.value.vdouble.scalar.Acceleration acceleration, GTUStatus... gtuStatus) Construct a new Headway information object, for a moving GTU ahead of us or behind us.

Method Summary

Modifier and Type	Method and Description
org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics	getBehavioralCharacteristics() Many models that observe a GTU need to predict the imminent behavior of that GTU.
CarFollowingModel	getCarFollowingModel() Many models that observe a GTU need to predict the imminent behavior of that GTU.
org.opentrafficsim.core.network.route.Route	getRoute() Models responding to other GTU may assume a route of the vehicle, for instance at intersections.
SpeedLimitInfo	getSpeedLimitInfo() Many models that observe a GTU need to predict the imminent behavior of that GTU.
AbstractHeadwayGTU	moved(org.djunits.value.vdouble.scalar.Length headway, org.djunits.value.vdouble.scalar.Speed speed, org.djunits.value.vdouble.scalar.Acceleration acceleration) Creates a copy with different headway, speed and possibly acceleration.

Methods inherited from class org.opentrafficsim.road.gtu.lane.perception.headway.AbstractHeadwayGTU

getGtuStatus, getGtuType, isBrakingLightsOn, isEmergencyLightsOn, isFacingSameDirection, isHonking, isLeftTurnIndicatorOn, isRightTurnIndicatorOn, toString

Methods inherited from class org.opentrafficsim.road.gtu.lane.perception.headway.AbstractHeadwayCopy

equals, getAcceleration, getId, getLength, getObjectType, getSpeed, hashCode

Methods inherited from class org.opentrafficsim.road.gtu.lane.perception.headway.AbstractHeadway

getDistance, getOverlap, getOverlapFront, getOverlapRear, isAhead, isBehind, isParallel

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.opentrafficsim.road.gtu.lane.perception.headway.Headway

compareTo, getAcceleration, getDistance, getId, getLength, getObjectType, getOverlap, getOverlapFront, getOverlapRear, getSpeed, isAhead, isBehind, isParallel

Constructor Detail

HeadwayGTUSimple

public HeadwayGTUSimple(String id,
                        org.opentrafficsim.core.gtu.GTUType gtuType,
                        org.djunits.value.vdouble.scalar.Length distance,
                        org.djunits.value.vdouble.scalar.Length length,
                        org.djunits.value.vdouble.scalar.Speed speed,
                        org.djunits.value.vdouble.scalar.Acceleration acceleration,
                        GTUStatus... gtuStatus)
                 throws org.opentrafficsim.core.gtu.GTUException

Construct a new Headway information object, for a moving GTU ahead of us or behind us.

Parameters:

id - the id of the GTU for comparison purposes, can not be null.

gtuType - the perceived GTU Type, or null if unknown.

distance - the distance to the other object; if this constructor is used, distance cannot be null.

length - the length of the other object; if this constructor is used, length cannot be null.

speed - the (perceived) speed of the other object; can be null if unknown.

acceleration - the (perceived) acceleration of the other object; can be null if unknown.

gtuStatus - the observable characteristics of the GTU.

Throws:

org.opentrafficsim.core.gtu.GTUException - when id is null, objectType is null, or parameters are inconsistent

HeadwayGTUSimple

public HeadwayGTUSimple(String id,
                        org.opentrafficsim.core.gtu.GTUType gtuType,
                        org.djunits.value.vdouble.scalar.Length distance,
                        org.djunits.value.vdouble.scalar.Length length,
                        GTUStatus... gtuStatus)
                 throws org.opentrafficsim.core.gtu.GTUException

Construct a new Headway information object, for a non-moving GTU ahead of us or behind us.

Parameters:

id - the id of the GTU for comparison purposes, can not be null.

gtuType - the perceived GTU Type, or null if unknown.

distance - Length; the distance to the other GTU; if this constructor is used, distance cannot be null.

length - the length of the other object; if this constructor is used, length cannot be null.

gtuStatus - the observable characteristics of the GTU.

Throws:

org.opentrafficsim.core.gtu.GTUException - when id is null, or parameters are inconsistent

HeadwayGTUSimple

public HeadwayGTUSimple(String id,
                        org.opentrafficsim.core.gtu.GTUType gtuType,
                        org.djunits.value.vdouble.scalar.Length overlapFront,
                        org.djunits.value.vdouble.scalar.Length overlap,
                        org.djunits.value.vdouble.scalar.Length overlapRear,
                        org.djunits.value.vdouble.scalar.Length length,
                        org.djunits.value.vdouble.scalar.Speed speed,
                        org.djunits.value.vdouble.scalar.Acceleration acceleration,
                        GTUStatus... gtuStatus)
                 throws org.opentrafficsim.core.gtu.GTUException

Construct a new Headway information object, for a moving GTU parallel with us.

Parameters:

id - the id of the GTU for comparison purposes, can not be null.

gtuType - the perceived GTU Type, or null if unknown.

overlapFront - the front-front distance to the other GTU; if this constructor is used, this value cannot be null.

overlap - the 'center' overlap with the other GTU; if this constructor is used, this value cannot be null.

overlapRear - the rear-rear distance to the other GTU; if this constructor is used, this value cannot be null.

length - the length of the other object; if this constructor is used, length cannot be null.

speed - the (perceived) speed of the other GTU; can be null if unknown.

acceleration - the (perceived) acceleration of the other GTU; can be null if unknown.

gtuStatus - the observable characteristics of the GTU.

Throws:

org.opentrafficsim.core.gtu.GTUException - when id is null, or parameters are inconsistent

HeadwayGTUSimple

public HeadwayGTUSimple(String id,
                        org.opentrafficsim.core.gtu.GTUType gtuType,
                        org.djunits.value.vdouble.scalar.Length overlapFront,
                        org.djunits.value.vdouble.scalar.Length overlap,
                        org.djunits.value.vdouble.scalar.Length overlapRear,
                        org.djunits.value.vdouble.scalar.Length length,
                        GTUStatus... gtuStatus)
                 throws org.opentrafficsim.core.gtu.GTUException

Construct a new Headway information object, for a non-moving GTU parallel with us.

Parameters:

id - the id of the GTU for comparison purposes, can not be null.

gtuType - the perceived GTU Type, or null if unknown.

overlapFront - the front-front distance to the other GTU; if this constructor is used, this value cannot be null.

overlap - the 'center' overlap with the other GTU; if this constructor is used, this value cannot be null.

overlapRear - the rear-rear distance to the other GTU; if this constructor is used, this value cannot be null.

length - the length of the other object; if this constructor is used, length cannot be null.

gtuStatus - the observable characteristics of the GTU.

Throws:

org.opentrafficsim.core.gtu.GTUException - when id is null, or parameters are inconsistent

Method Detail

getCarFollowingModel

public final CarFollowingModel getCarFollowingModel()

Many models that observe a GTU need to predict the imminent behavior of that GTU. Having a car following model of the observed GTU can help with that. The car following model that is returned can be on a continuum between the actual car following model of the observed GTU and the own car following model of the observing GTU, not making any assumptions about the observed GTU. When successive observations of the GTU take place, parameters about its behavior can be estimated more accurately. Another interesting easy-to-implement solution is to return a car following model per GTU type, where the following model of a truck can differ from that of a car.

Returns:

a car following model that represents the expected behavior of the observed GTU

getBehavioralCharacteristics

public final org.opentrafficsim.core.gtu.behavioralcharacteristics.BehavioralCharacteristics getBehavioralCharacteristics()

Many models that observe a GTU need to predict the imminent behavior of that GTU. Having an estimate of the behavioral characteristics of the observed GTU can help with that. The behavioral characteristics that are returned can be on a continuum between the actual behavioral characteristics of the observed GTU and the own behavioral characteristics of the observing GTU, not making any assumptions about the observed GTU. When successive observations of the GTU take place, parameters about its behavior can be estimated more accurately. Another interesting easy-to-implement solution is to return a set of behavioral characteristics per GTU type, where the behavioral characteristics of a truck can differ from that of a car.

Returns:

the behavioral characteristics that represent the expected behavior of the observed GTU

getSpeedLimitInfo

public final SpeedLimitInfo getSpeedLimitInfo()

Many models that observe a GTU need to predict the imminent behavior of that GTU. Having a model of the speed info profile for the observed GTU can help with predicting its future behavior. The speed limit info that is returned can be on a continuum between the actual speed limit model of the observed GTU and the own speed limit model of the observing GTU, not making any assumptions about the observed GTU. When successive observations of the GTU take place, parameters about its behavior, such as the maximum speed it accepts, can be estimated more accurately. Another interesting easy-to-implement solution is to return a speed limit info object per GTU type, where the returned information of a truck -- with a maximum allowed speed on 80 km/h -- can differ from that of a car -- which can have a maximum allowed speed of 100 km/h on the same road.

Returns:

a speed limit model that helps in determining the expected behavior of the observed GTU

getRoute

public final org.opentrafficsim.core.network.route.Route getRoute()

Models responding to other GTU may assume a route of the vehicle, for instance at intersections. The route may be short, i.e. only over the next intersection. Implementations may return anything from the actual route, a route based on indicators and other assumptions, or null if simply not known/estimated.

Returns:

route of gtu

moved

public AbstractHeadwayGTU moved(org.djunits.value.vdouble.scalar.Length headway,
                                org.djunits.value.vdouble.scalar.Speed speed,
                                org.djunits.value.vdouble.scalar.Acceleration acceleration)

Creates a copy with different headway, speed and possibly acceleration. It may not be alongside. This method is used to anticipate movement of a neighboring GTU.

Parameters:

headway - headway

speed - speed

acceleration - acceleration

Returns:

copy with different headway, speed and possibly acceleration