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

Class AbstractHeadwayCopy

java.lang.Object
org.opentrafficsim.road.gtu.lane.perception.headway.AbstractHeadway
org.opentrafficsim.road.gtu.lane.perception.headway.AbstractHeadwayCopy
All Implemented Interfaces:
Serializable, Comparable<Headway>, org.djutils.base.Identifiable, PerceivedObject, Headway
Direct Known Subclasses:
AbstractHeadwayGtu, AbstractHeadwayLaneBasedObject, HeadwayObject
public abstract class AbstractHeadwayCopy extends AbstractHeadway
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.
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.

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

Author:
Alexander Verbraeck, Peter Knoppers, Wouter Schakel
See Also:

  • Nested Class Summary

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

    Headway.ObjectType

  • Constructor Summary

    Constructors
    Constructor
    Description
    AbstractHeadwayCopy(Headway.ObjectType objectType, String id, org.djunits.value.vdouble.scalar.Length distance)
    Construct a new Headway information object, for a non-moving object ahead of us or behind us.
    AbstractHeadwayCopy(Headway.ObjectType objectType, String id, org.djunits.value.vdouble.scalar.Length distance, org.djunits.value.vdouble.scalar.Length length)
    Construct a new Headway information object, for a non-moving object ahead of us or behind us.
    AbstractHeadwayCopy(Headway.ObjectType objectType, String id, org.djunits.value.vdouble.scalar.Length overlapFront, org.djunits.value.vdouble.scalar.Length overlap, org.djunits.value.vdouble.scalar.Length overlapRear)
    Construct a new Headway information object, for a non-moving object parallel with us.
    AbstractHeadwayCopy(Headway.ObjectType objectType, String id, 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)
    Construct a new Headway information object, for a non-moving object parallel with us.
    AbstractHeadwayCopy(Headway.ObjectType objectType, String id, 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)
    Construct a new Headway information object, for a moving object parallel with us.
    AbstractHeadwayCopy(Headway.ObjectType objectType, String id, 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.Speed speed, org.djunits.value.vdouble.scalar.Acceleration acceleration)
    Construct a new Headway information object, for a moving object parallel with us.
    AbstractHeadwayCopy(Headway.ObjectType objectType, String id, 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)
    Construct a new Headway information object, for a moving object ahead of us or behind us.
    AbstractHeadwayCopy(Headway.ObjectType objectType, String id, org.djunits.value.vdouble.scalar.Length distance, org.djunits.value.vdouble.scalar.Speed speed, org.djunits.value.vdouble.scalar.Acceleration acceleration)
    Construct a new Headway information object, for a moving object ahead of us or behind us.

  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
    equals(Object obj)
    final org.djunits.value.vdouble.scalar.Acceleration
    getAcceleration()
    final String
    getId()
    final org.djunits.value.vdouble.scalar.Length
    getLength()
    final Headway.ObjectType
    getObjectType()
    final org.djunits.value.vdouble.scalar.Speed
    getSpeed()
    int
    hashCode()

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

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

    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

  • Constructor Details

    • AbstractHeadwayCopy

      public AbstractHeadwayCopy(Headway.ObjectType objectType, String id, org.djunits.value.vdouble.scalar.Length distance, org.djunits.value.vdouble.scalar.Speed speed, org.djunits.value.vdouble.scalar.Acceleration acceleration) throws GtuException
      Construct a new Headway information object, for a moving object ahead of us or behind us.
      Parameters:
      objectType - ObjectType; the perceived object type, can be null if object type unknown.
      id - String; the id of the object for comparison purposes, can not be null.
      distance - the distance to the other object; if this constructor is used, distance 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.
      Throws:
      GtuException - when id is null, or parameters are inconsistent

    • AbstractHeadwayCopy

      public AbstractHeadwayCopy(Headway.ObjectType objectType, String id, org.djunits.value.vdouble.scalar.Length distance) throws GtuException
      Construct a new Headway information object, for a non-moving object ahead of us or behind us.
      Parameters:
      objectType - ObjectType; the perceived object type, can be null if object type unknown.
      id - String; the id of the object for comparison purposes, can not be null.
      distance - the distance to the other object; if this constructor is used, distance cannot be null.
      Throws:
      GtuException - when id is null, or parameters are inconsistent

    • AbstractHeadwayCopy

      public AbstractHeadwayCopy(Headway.ObjectType objectType, String id, 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.Speed speed, org.djunits.value.vdouble.scalar.Acceleration acceleration) throws GtuException
      Construct a new Headway information object, for a moving object parallel with us.
      Parameters:
      objectType - ObjectType; the perceived object type, can be null if object type unknown.
      id - String; the id of the object for comparison purposes, can not be null.
      overlapFront - the front-front distance to the other object; if this constructor is used, this value cannot be null.
      overlap - the 'center' overlap with the other object; if this constructor is used, this value cannot be null.
      overlapRear - the rear-rear distance to the other object; if this constructor is used, this value 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.
      Throws:
      GtuException - when id is null, or parameters are inconsistent

    • AbstractHeadwayCopy

      public AbstractHeadwayCopy(Headway.ObjectType objectType, String id, org.djunits.value.vdouble.scalar.Length overlapFront, org.djunits.value.vdouble.scalar.Length overlap, org.djunits.value.vdouble.scalar.Length overlapRear) throws GtuException
      Construct a new Headway information object, for a non-moving object parallel with us.
      Parameters:
      objectType - ObjectType; the perceived object type, can be null if object type unknown.
      id - String; the id of the object for comparison purposes, can not be null.
      overlapFront - the front-front distance to the other object; if this constructor is used, this value cannot be null.
      overlap - the 'center' overlap with the other object; if this constructor is used, this value cannot be null.
      overlapRear - the rear-rear distance to the other object; if this constructor is used, this value cannot be null.
      Throws:
      GtuException - when id is null, or parameters are inconsistent

    • AbstractHeadwayCopy

      public AbstractHeadwayCopy(Headway.ObjectType objectType, String id, 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) throws GtuException
      Construct a new Headway information object, for a moving object ahead of us or behind us.
      Parameters:
      objectType - ObjectType; the perceived object type, can be null if object type unknown.
      id - String; the id of the object for comparison purposes, can not be null.
      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.
      Throws:
      GtuException - when id is null, or parameters are inconsistent

    • AbstractHeadwayCopy

      public AbstractHeadwayCopy(Headway.ObjectType objectType, String id, org.djunits.value.vdouble.scalar.Length distance, org.djunits.value.vdouble.scalar.Length length) throws GtuException
      Construct a new Headway information object, for a non-moving object ahead of us or behind us.
      Parameters:
      objectType - ObjectType; the perceived object type, can be null if object type unknown.
      id - String; the id of the object for comparison purposes, can not be null.
      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.
      Throws:
      GtuException - when id is null, or parameters are inconsistent

    • AbstractHeadwayCopy

      public AbstractHeadwayCopy(Headway.ObjectType objectType, String id, 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) throws GtuException
      Construct a new Headway information object, for a moving object parallel with us.
      Parameters:
      objectType - ObjectType; the perceived object type, can be null if object type unknown.
      id - String; the id of the object for comparison purposes, can not be null.
      overlapFront - the front-front distance to the other object; if this constructor is used, this value cannot be null.
      overlap - the 'center' overlap with the other object; if this constructor is used, this value cannot be null.
      overlapRear - the rear-rear distance to the other object; 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 object; can be null if unknown.
      acceleration - the (perceived) acceleration of the other object; can be null if unknown.
      Throws:
      GtuException - when id is null, or parameters are inconsistent

    • AbstractHeadwayCopy

      public AbstractHeadwayCopy(Headway.ObjectType objectType, String id, 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) throws GtuException
      Construct a new Headway information object, for a non-moving object parallel with us.
      Parameters:
      objectType - ObjectType; the perceived object type, can be null if object type unknown.
      id - String; the id of the object for comparison purposes, can not be null.
      overlapFront - the front-front distance to the other object; if this constructor is used, this value cannot be null.
      overlap - the 'center' overlap with the other object; if this constructor is used, this value cannot be null.
      overlapRear - the rear-rear distance to the other object; 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.
      Throws:
      GtuException - when id is null, or parameters are inconsistent

  • Method Details

    • getId

      public final String getId()
      Returns:
      String; the id of the other object for comparison purposes, cannot be null.

    • getLength

      public final org.djunits.value.vdouble.scalar.Length getLength()
      Returns:
      Length; the length of the other object; can be null if unknown.

    • getSpeed

      public final org.djunits.value.vdouble.scalar.Speed getSpeed()
      Returns:
      Speed; the (perceived) speed of the other object; can be null if unknown.

    • getObjectType

      public final Headway.ObjectType getObjectType()
      Returns:
      Length; the (perceived) object Type, can be null if no object type unknown.

    • getAcceleration

      public final org.djunits.value.vdouble.scalar.Acceleration getAcceleration()
      Returns:
      Acceleration; acceleration the (perceived) acceleration of the other object; can be null if unknown.

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class AbstractHeadway

    • equals

      public boolean equals(Object obj)
      Overrides:
      equals in class AbstractHeadway