Trajectory (OpenTrafficSim KPI Module 0.13.04 API)

java.lang.Object
- org.opentrafficsim.kpi.sampling.Trajectory

```
public final class Trajectory
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, also when trajectories have been truncated at a position x > 0. Note that this regards internal data and output. Input position always refers to the design line of the lane. This class internally flips input positions and boundaries.
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 Sep 21, 2016

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

Constructor Summary

Constructors
Constructor and Description
`Trajectory(GtuDataInterface gtu, MetaData metaData, Set<ExtendedDataType<?>> extendedData, KpiLaneDirection kpiLaneDirection)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`add(org.djunits.value.vdouble.scalar.Length position, org.djunits.value.vdouble.scalar.Speed speed, org.djunits.value.vdouble.scalar.Acceleration acceleration, org.djunits.value.vdouble.scalar.Time time)` Adds values of position, speed, acceleration and time.
`void`	`add(org.djunits.value.vdouble.scalar.Length position, org.djunits.value.vdouble.scalar.Speed speed, org.djunits.value.vdouble.scalar.Acceleration acceleration, org.djunits.value.vdouble.scalar.Time time, GtuDataInterface gtu)` Adds values of position, speed, acceleration and time.
`boolean`	`contains(ExtendedDataType<?> extendedDataType)`
`boolean`	`contains(MetaDataType<?> metaDataType)`
`boolean`	`equals(Object obj)`
`float[]`	`getA()`
`org.djunits.value.vfloat.vector.FloatAccelerationVector`	`getAcceleration()`
`<T> List<T>`	`getExtendedData(ExtendedDataType<T> extendedDataType)`
`String`	`getGtuId()`
`<T> T`	`getMetaData(MetaDataType<T> metaDataType)`
`org.djunits.value.vfloat.vector.FloatLengthVector`	`getPosition()`
`org.djunits.value.vfloat.vector.FloatSpeedVector`	`getSpeed()`
`float[]`	`getT()`
`org.djunits.value.vfloat.vector.FloatTimeVector`	`getTime()`
`org.djunits.value.vdouble.scalar.Duration`	`getTotalDuration()`
`org.djunits.value.vdouble.scalar.Length`	`getTotalLength()`
`float[]`	`getV()`
`float[]`	`getX()`
`int`	`hashCode()`
`int`	`size()`
`Trajectory`	`subSet(org.djunits.value.vdouble.scalar.Length startPosition, org.djunits.value.vdouble.scalar.Length endPosition)` Copies the trajectory but with a subset of the data.
`Trajectory`	`subSet(org.djunits.value.vdouble.scalar.Length startPosition, org.djunits.value.vdouble.scalar.Length endPosition, org.djunits.value.vdouble.scalar.Time startTime, org.djunits.value.vdouble.scalar.Time endTime)` Copies the trajectory but with a subset of the data.
`Trajectory`	`subSet(org.djunits.value.vdouble.scalar.Time startTime, org.djunits.value.vdouble.scalar.Time endTime)` Copies the trajectory but with a subset of the data.
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - Trajectory
```
public Trajectory(GtuDataInterface gtu,
                  MetaData metaData,
                  Set<ExtendedDataType<?>> extendedData,
                  KpiLaneDirection kpiLaneDirection)
```
    Parameters:
    
    gtu - GTU of this trajectory, only the id is stored.
    
    metaData - meta data
    
    extendedData - types of extended data
    
    kpiLaneDirection - direction of travel
- Method Detail
  - add
```
public void add(org.djunits.value.vdouble.scalar.Length position,
                org.djunits.value.vdouble.scalar.Speed speed,
                org.djunits.value.vdouble.scalar.Acceleration acceleration,
                org.djunits.value.vdouble.scalar.Time 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(org.djunits.value.vdouble.scalar.Length position,
                org.djunits.value.vdouble.scalar.Speed speed,
                org.djunits.value.vdouble.scalar.Acceleration acceleration,
                org.djunits.value.vdouble.scalar.Time time,
                GtuDataInterface gtu)
```
    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
    
    gtu - gtu to add extended data for
  - size
```
public int size()
```
    Returns:
    
    size of the underlying trajectory data
  - getGtuId
```
public String getGtuId()
```
    Returns:
    
    GTU id
  - getX
```
public float[] getX()
```
    Returns:
    
    si position values, position is relative to the start of the lane, also when trajectories have been truncated at a position x > 0
  - getV
```
public float[] getV()
```
    Returns:
    
    si speed values
  - getA
```
public float[] getA()
```
    Returns:
    
    si acceleration values
  - getT
```
public float[] getT()
```
    Returns:
    
    si time values
  - getPosition
```
public org.djunits.value.vfloat.vector.FloatLengthVector getPosition()
```
    Returns:
    
    strongly typed copy of position, position is relative to the start of the lane, also when trajectories have been truncated at a position x > 0
  - getSpeed
```
public org.djunits.value.vfloat.vector.FloatSpeedVector getSpeed()
```
    Returns:
    
    strongly typed copy of speed
  - getAcceleration
```
public org.djunits.value.vfloat.vector.FloatAccelerationVector getAcceleration()
```
    Returns:
    
    strongly typed copy of acceleration
  - getTime
```
public org.djunits.value.vfloat.vector.FloatTimeVector getTime()
```
    Returns:
    
    strongly typed copy of time
  - getTotalLength
```
public org.djunits.value.vdouble.scalar.Length getTotalLength()
```
    Returns:
    
    total length of this trajectory
    
    Throws:
    
    IllegalStateException - if trajectory is empty
  - getTotalDuration
```
public org.djunits.value.vdouble.scalar.Duration getTotalDuration()
```
    Returns:
    
    total duration of this trajectory
    
    Throws:
    
    IllegalStateException - if trajectory is empty
  - contains
```
public boolean contains(MetaDataType<?> metaDataType)
```
    Parameters:
    
    metaDataType - meta data type
    
    Returns:
    
    whether the trajectory contains the meta data of give type
  - getMetaData
```
public <T> T getMetaData(MetaDataType<T> metaDataType)
```
    Type Parameters:
    
    T - class of meta data
    
    Parameters:
    
    metaDataType - meta data type
    
    Returns:
    
    value of meta data
  - contains
```
public boolean contains(ExtendedDataType<?> extendedDataType)
```
    Parameters:
    
    extendedDataType - extended data type
    
    Returns:
    
    whether the trajectory contains the extended data of give type
  - getExtendedData
```
public <T> List<T> getExtendedData(ExtendedDataType<T> extendedDataType)
                            throws SamplingException
```
    Type Parameters:
    
    T - value type of the extended data 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
  - subSet
```
public Trajectory subSet(org.djunits.value.vdouble.scalar.Length startPosition,
                         org.djunits.value.vdouble.scalar.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 subSet(org.djunits.value.vdouble.scalar.Time startTime,
                         org.djunits.value.vdouble.scalar.Time endTime)
```
    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:
    
    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 subSet(org.djunits.value.vdouble.scalar.Length startPosition,
                         org.djunits.value.vdouble.scalar.Length endPosition,
                         org.djunits.value.vdouble.scalar.Time startTime,
                         org.djunits.value.vdouble.scalar.Time endTime)
```
    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
    
    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
  - 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

Class Trajectory

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Trajectory

Method Detail

add

add

size

getGtuId

getX

getV

getA

getT

getPosition

getSpeed

getAcceleration

getTime

getTotalLength

getTotalDuration

contains

getMetaData

contains

getExtendedData

subSet

subSet

subSet

hashCode

equals

toString