org.opentrafficsim.kpi.sampling

Class Trajectory

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

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