Package org.opentrafficsim.kpi.sampling

Class Trajectory<G extends GtuData>

java.lang.Object
org.opentrafficsim.kpi.sampling.Trajectory<G>
Type Parameters:
G - GTU data type
public final class Trajectory<G extends GtuData> extends Object
Contains position, speed, acceleration and time data of a GTU, over some section. Position is relative to the start of the lane in the direction of travel.

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

  • Constructor Details

    • Trajectory

      public Trajectory(GtuData gtu, Map<FilterDataType<?,? super G>,Object> filterData, Set<ExtendedDataType<?,?,?,? super G>> extendedData)
      Constructor.
      Parameters:
      gtu - GTU of this trajectory, only the id is stored.
      filterData - filter data
      extendedData - types of extended data

  • Method Details

    • add

      public void add(Length position, Speed speed, Acceleration acceleration, Duration time)
      Adds values of position, speed, acceleration and time.
      Parameters:
      position - position is relative to the start of the lane in the direction of the design line, i.e. irrespective of the travel direction, also when trajectories have been truncated at a position x > 0
      speed - speed
      acceleration - acceleration
      time - time

    • add

      public void add(Length position, Speed speed, Acceleration acceleration, Duration time, G gtu)
      Adds values of position, speed, acceleration, time and extended data.
      Parameters:
      position - position is relative to the start of the lane in the direction of the design line
      speed - speed
      acceleration - acceleration
      time - time
      gtu - gtu to add extended data for

    • size

      public int size()
      The size of the underlying data.
      Returns:
      size of the underlying trajectory data

    • getGtuId

      public String getGtuId()
      Returns the GTU id.
      Returns:
      GTU id

    • getGtuTypeId

      public String getGtuTypeId()
      Returns the GTU type id.
      Returns:
      GTU type id

    • getX

      public float[] getX()
      Returns the position array.
      Returns:
      si position values.

    • getV

      public float[] getV()
      Returns the speed array.
      Returns:
      si speed values

    • getA

      public float[] getA()
      Returns the acceleration array.
      Returns:
      si acceleration values

    • getT

      public float[] getT()
      Returns the time array.
      Returns:
      si time values

    • binarySearchX

      public int binarySearchX(float position)
      Returns the last index with a position smaller than or equal to the given position.
      Parameters:
      position - position
      Returns:
      last index with a position smaller than or equal to the given position

    • binarySearchT

      public int binarySearchT(float time)
      Returns the last index with a time smaller than or equal to the given time.
      Parameters:
      time - time
      Returns:
      last index with a time smaller than or equal to the given time

    • getX

      public float getX(int index)
      Returns x value of a single sample.
      Parameters:
      index - index
      Returns:
      x value of a single sample

    • getV

      public float getV(int index)
      Returns v value of a single sample.
      Parameters:
      index - index
      Returns:
      v value of a single sample

    • getA

      public float getA(int index)
      Returns a value of a single sample.
      Parameters:
      index - index
      Returns:
      a value of a single sample

    • getT

      public float getT(int index)
      Returns t value of a single sample.
      Parameters:
      index - index
      Returns:
      t value of a single sample

    • getExtendedData

      public <T, S> T getExtendedData(ExtendedDataType<T,?,S,?> extendedDataType, int index)
      Returns extended data type value of a single sample.
      Type Parameters:
      T - scalar type of extended data type
      S - storage type of extended data type
      Parameters:
      extendedDataType - data type from which to retrieve the data
      index - index for which to retrieve the data
      Returns:
      extended data type value of a single sample

    • getPosition

      public FloatLengthVector getPosition()
      Returns strongly type position array.
      Returns:
      strongly typed position array.

    • getSpeed

      public FloatSpeedVector getSpeed()
      Returns strongly typed speed array.
      Returns:
      strongly typed speed array.

    • getAcceleration

      public FloatAccelerationVector getAcceleration()
      Returns strongly typed acceleration array.
      Returns:
      strongly typed acceleration array.

    • getTime

      public FloatTimeVector getTime()
      Returns strongly typed time array.
      Returns:
      strongly typed time array.

    • getTotalLength

      public Length getTotalLength()
      Returns the length of the data.
      Returns:
      total length of this trajectory

    • getTotalDuration

      public Duration getTotalDuration()
      Returns the total duration span.
      Returns:
      total duration of this trajectory

    • contains

      public boolean contains(FilterDataType<?,?> filterDataType)
      Returns whether the filter data is contained.
      Parameters:
      filterDataType - filter data type
      Returns:
      whether the trajectory contains the filter data of give type

    • getFilterData

      public <T> T getFilterData(FilterDataType<T,?> filterDataType)
      Returns the value of the filter data.
      Type Parameters:
      T - class of filter data
      Parameters:
      filterDataType - filter data type
      Returns:
      value of filter data

    • getFilterDataTypes

      public Set<FilterDataType<?,? super G>> getFilterDataTypes()
      Returns the included filter data types.
      Returns:
      included filter data types

    • contains

      public boolean contains(ExtendedDataType<?,?,?,?> extendedDataType)
      Returns whether ths extended data type is contained.
      Parameters:
      extendedDataType - extended data type
      Returns:
      whether the trajectory contains the extended data of give type

    • getExtendedData

      public <O, S> O getExtendedData(ExtendedDataType<?,O,S,?> extendedDataType) throws SamplingException
      Returns the output data of the extended data type.
      Type Parameters:
      O - output type
      S - storage type
      Parameters:
      extendedDataType - extended data type to return
      Returns:
      values of extended data type
      Throws:
      SamplingException - if the extended data type is not in the trajectory

    • getExtendedDataTypes

      public Set<ExtendedDataType<?,?,?,? super G>> getExtendedDataTypes()
      Returns the included extended data types.
      Returns:
      included extended data types

    • getSpaceTimeView

      public Trajectory.SpaceTimeView getSpaceTimeView()
      Returns a space-time view of this trajectory. This is much more efficient than getX() as no array is copied. The limitation is that only distance and time (and mean speed) in the space-time view can be obtained.
      Returns:
      space-time view of this trajectory

    • getSpaceTimeView

      public Trajectory.SpaceTimeView getSpaceTimeView(Length startPosition, Length endPosition, Duration startTime, Duration endTime)
      Returns a space-time view of this trajectory as contained within the defined space-time region. This is much more efficient than subSet() as no trajectory is copied. The limitation is that only distance and time (and mean speed) in the space-time view can be obtained.
      Parameters:
      startPosition - start position
      endPosition - end position
      startTime - start time
      endTime - end time
      Returns:
      space-time view of this trajectory

    • subSet

      public Trajectory<G> subSet(Length startPosition, Length endPosition)
      Copies the trajectory but with a subset of the data. Longitudinal entry is only true if the original trajectory has true, and the subset is from the start.
      Parameters:
      startPosition - start position
      endPosition - end position
      Returns:
      subset of the trajectory
      Throws:
      NullPointerException - if an input is null
      IllegalArgumentException - of minLength is smaller than maxLength

    • subSet

      public Trajectory<G> subSet(Duration startTime, Duration endTime)
      Copies the trajectory but with a subset of the data.
      Parameters:
      startTime - start time
      endTime - end time
      Returns:
      subset of the trajectory
      Throws:
      NullPointerException - if an input is null
      IllegalArgumentException - of minTime is smaller than maxTime

    • subSet

      public Trajectory<G> subSet(Length startPosition, Length endPosition, Duration startTime, Duration endTime)
      Copies the trajectory but with a subset of the data that is contained in the given space-time region.
      Parameters:
      startPosition - start position
      endPosition - end position
      startTime - start time
      endTime - end time
      Returns:
      subset of the trajectory
      Throws:
      NullPointerException - if an input is null
      IllegalArgumentException - of minLength/Time is smaller than maxLength/Time

    • getTimeAtPosition

      public Duration getTimeAtPosition(Length position)
      Returns an interpolated time at the given position.
      Parameters:
      position - position
      Returns:
      interpolated time at the given position

    • getSpeedAtPosition

      public Speed getSpeedAtPosition(Length position)
      Returns an interpolated speed at the given position.
      Parameters:
      position - position
      Returns:
      interpolated speed at the given position

    • getAccelerationAtPosition

      public Acceleration getAccelerationAtPosition(Length position)
      Returns an interpolated acceleration at the given position.
      Parameters:
      position - position
      Returns:
      interpolated acceleration at the given position

    • getPositionAtTime

      public Length getPositionAtTime(Duration time)
      Returns an interpolated position at the given time.
      Parameters:
      time - time
      Returns:
      interpolated position at the given time

    • getSpeedAtTime

      public Speed getSpeedAtTime(Duration time)
      Returns an interpolated speed at the given time.
      Parameters:
      time - time
      Returns:
      interpolated speed at the given time

    • getAccelerationAtTime

      public Acceleration getAccelerationAtTime(Duration time)
      Returns an interpolated acceleration at the given time.
      Parameters:
      time - time
      Returns:
      interpolated acceleration at the given time

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object

    • equals

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

    • toString

      public String toString()
      Overrides:
      toString in class Object