org.opentrafficsim.road.network.sampling

Class Trajectory

java.lang.Object

org.opentrafficsim.road.network.sampling.Trajectory

public final class Trajectory
extends Object

Contains position, speed, acceleration and time data of a GTU, over some section.

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(org.opentrafficsim.core.gtu.GTU gtu, boolean longitudinalEntry, MetaData metaData)

Method Summary

Modifier and Type	Method and Description
void	add(float xSI, float vSI, float aSI, float tSI) Adds si values of distance, speed, acceleration and time.
void	add(org.djunits.value.vdouble.scalar.Length distance, org.djunits.value.vdouble.scalar.Speed speed, org.djunits.value.vdouble.scalar.Acceleration acceleration, org.djunits.value.vdouble.scalar.Duration time) Adds values of distance, speed, acceleration and time.
boolean	contains(MetaDataType<?> metaDataType)
boolean	equals(Object obj)
float[]	getA()
org.djunits.value.vfloat.vector.FloatAccelerationVector	getAcceleration()
org.djunits.value.vfloat.vector.FloatDurationVector	getDuration()
String	getGtuId()
org.djunits.value.vfloat.vector.FloatLengthVector	getLength()
<T> T	getMetaData(MetaDataType<T> metaDataType)
org.djunits.value.vfloat.vector.FloatSpeedVector	getSpeed()
float[]	getT()
org.djunits.value.vdouble.scalar.Duration	getTotalDuration()
org.djunits.value.vdouble.scalar.Length	getTotalLength()
float[]	getV()
float[]	getX()
int	hashCode()
boolean	isLongitudinalEntry() Returns whether GTU entered this trajectory longitudinally.
int	size()
Trajectory	subSet(org.djunits.value.vdouble.scalar.Duration minTime, org.djunits.value.vdouble.scalar.Duration maxTime) Copies the trajectory but with a subset of the data.
Trajectory	subSet(org.djunits.value.vdouble.scalar.Length minLength, org.djunits.value.vdouble.scalar.Length maxLength) Copies the trajectory but with a subset of the data.
Trajectory	subSet(org.djunits.value.vdouble.scalar.Length minLength, org.djunits.value.vdouble.scalar.Length maxLength, org.djunits.value.vdouble.scalar.Duration minTime, org.djunits.value.vdouble.scalar.Duration maxTime) 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(org.opentrafficsim.core.gtu.GTU gtu,
                  boolean longitudinalEntry,
                  MetaData metaData)

Parameters:

gtu - GTU of this trajectory, only the id is stored.

longitudinalEntry - whether GTU entered this trajectory longitudinally

metaData - meta data

Method Detail

isLongitudinalEntry

public boolean isLongitudinalEntry()

Returns whether GTU entered this trajectory longitudinally. The first point may then be connected to the last point in a previous trajectory.

Returns:

whether GTU entered this trajectory longitudinally

add

public void add(org.djunits.value.vdouble.scalar.Length distance,
                org.djunits.value.vdouble.scalar.Speed speed,
                org.djunits.value.vdouble.scalar.Acceleration acceleration,
                org.djunits.value.vdouble.scalar.Duration time)

Adds values of distance, speed, acceleration and time.

Parameters:

distance - distance

speed - speed

acceleration - acceleration

time - time

add

public void add(float xSI,
                float vSI,
                float aSI,
                float tSI)

Adds si values of distance, speed, acceleration and time.

Parameters:

xSI - si distance

vSI - si speed

aSI - si acceleration

tSI - si time

size

public int size()

Returns:

size of the underlying trajectory data

getGtuId

public String getGtuId()

Returns:

GTU id

getX

public float[] getX()

Returns:

si distance values

getV

public float[] getV()

Returns:

si speed values

getA

public float[] getA()

Returns:

si acceleration values

getT

public float[] getT()

Returns:

si time values

getLength

public org.djunits.value.vfloat.vector.FloatLengthVector getLength()

Returns:

strongly typed copy of length

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

getDuration

public org.djunits.value.vfloat.vector.FloatDurationVector getDuration()

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

subSet

public Trajectory subSet(org.djunits.value.vdouble.scalar.Length minLength,
                         org.djunits.value.vdouble.scalar.Length maxLength)

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:

minLength - minimum length

maxLength - maximum length

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.Duration minTime,
                         org.djunits.value.vdouble.scalar.Duration maxTime)

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:

minTime - minimum time

maxTime - maximum 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 minLength,
                         org.djunits.value.vdouble.scalar.Length maxLength,
                         org.djunits.value.vdouble.scalar.Duration minTime,
                         org.djunits.value.vdouble.scalar.Duration maxTime)

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:

minLength - minimum length

maxLength - maximum length

minTime - minimum time

maxTime - maximum 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