Package org.djunits.value.vdouble.vector

Class DurationVector

java.lang.Object

org.djunits.value.IndexedValue<U,S,V,D>

org.djunits.value.base.Vector<U,S,V,DoubleVectorData>

org.djunits.value.vdouble.vector.base.DoubleVector<U,S,RV>

org.djunits.value.vdouble.vector.base.DoubleVectorRel<RU,R,RV>

org.djunits.value.vdouble.vector.base.DoubleVectorRelWithAbs<TimeUnit,Time,TimeVector,DurationUnit,Duration,DurationVector>

org.djunits.value.vdouble.vector.DurationVector

All Implemented Interfaces:

Serializable, Cloneable, Iterable<Duration>, Relative<DurationUnit,DurationVector>, RelWithAbs<TimeUnit,TimeVector,DurationUnit,DurationVector>, Value<DurationUnit,DurationVector>

@Generated(value="org.djunits.generator.GenerateDJUNIT",
           date="2023-07-23T14:06:38.224104100Z")
public class DurationVector
extends DoubleVectorRelWithAbs<TimeUnit,Time,TimeVector,DurationUnit,Duration,DurationVector>

Double DurationVector, a vector of values with a DurationUnit.

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

Author:

Alexander Verbraeck, Peter Knoppers

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.djunits.value.vdouble.vector.base.DoubleVector

DoubleVector.Itr

Field Summary

Fields inherited from class org.djunits.value.vdouble.vector.base.DoubleVector

data

Constructor Summary

Constructors

Constructor	Description
DurationVector(double[] data)	Construct an DurationVector from a double[] object with SI-unit values.
DurationVector(double[] data, DurationUnit displayUnit)	Construct an DurationVector from a double[] object.
DurationVector(double[] data, DurationUnit displayUnit, StorageType storageType)	Construct an DurationVector from a double[] object.
DurationVector(double[] data, StorageType storageType)	Construct an DurationVector from a double[] object with SI-unit values.
DurationVector(List<? extends Number> data)	Construct an DurationVector from a list of Number objects or a list of Duration objects.
DurationVector(List<? extends Number> data, DurationUnit displayUnit)	Construct an DurationVector from a list of Number objects or a list of Duration objects.
DurationVector(List<? extends Number> data, DurationUnit displayUnit, StorageType storageType)	Construct an DurationVector from a list of Number objects or a list of Duration objects.
DurationVector(List<? extends Number> data, StorageType storageType)	Construct an DurationVector from a list of Number objects or a list of Duration objects.
DurationVector(Map<Integer,? extends Number> data, int size)	Construct an DurationVector from a (sparse) map of index values to Number objects or a (sparse) map of index values to of Duration objects.
DurationVector(Map<Integer,? extends Number> data, int size, DurationUnit displayUnit)	Construct an DurationVector from a (sparse) map of index values to Number objects or a (sparse) map of index values to of Duration objects.
DurationVector(Map<Integer,? extends Number> data, int size, DurationUnit displayUnit, StorageType storageType)	Construct an DurationVector from a (sparse) map of index values to Number objects or a (sparse) map of index values to of Duration objects.
DurationVector(Map<Integer,? extends Number> data, int size, StorageType storageType)	Construct an DurationVector from a (sparse) map of index values to Number objects or a (sparse) map of index values to of Duration objects.
DurationVector(Duration[] data)	Construct an DurationVector from an array of Duration objects.
DurationVector(Duration[] data, DurationUnit displayUnit)	Construct an DurationVector from an array of Duration objects.
DurationVector(Duration[] data, DurationUnit displayUnit, StorageType storageType)	Construct an DurationVector from an array of Duration objects.
DurationVector(Duration[] data, StorageType storageType)	Construct an DurationVector from an array of Duration objects.
DurationVector(DoubleVectorData data, DurationUnit displayUnit)	Construct an DurationVector from an internal data object.

Method Summary

Modifier and Type	Method	Description
Class<Duration>	getScalarClass()	Return the class of the corresponding scalar.
Time	instantiateScalarAbsSI(double valueSI, TimeUnit displayUnit)	Instantiate a new absolute scalar for the class of this relative vector.
Duration	instantiateScalarSI(double valueSI, DurationUnit displayUnit)	Instantiate a new scalar for the class of this vector.
DurationVector	instantiateVector(DoubleVectorData dvd, DurationUnit displayUnit)	Instantiate a new vector of the class of this vector.
TimeVector	instantiateVectorAbs(DoubleVectorData dvd, TimeUnit displayUnit)	Instantiate a new absolute vector of the class of this relative vector.

Methods inherited from class org.djunits.value.vdouble.vector.base.DoubleVectorRelWithAbs

plus

Methods inherited from class org.djunits.value.vdouble.vector.base.DoubleVectorRel

decrementBy, decrementBy, divide, divide, divide, divideBy, incrementBy, incrementBy, minus, multiplyBy, plus, times, times, times, zSum

Methods inherited from class org.djunits.value.vdouble.vector.base.DoubleVector

abs, assign, ceil, checkIndex, checkSize, equals, floor, get, getData, getInUnit, getInUnit, getScalars, getSI, getValuesInUnit, getValuesInUnit, getValuesSI, hashCode, iterator, neg, rint, set, setData, setInUnit, setInUnit, setSI, size, toDense, toSparse, toString, toString, toString, toString

Methods inherited from class org.djunits.value.IndexedValue

cardinality, checkCopyOnWrite, clone, getDisplayUnit, getStorageType, immutable, isCopyOnWrite, isDense, isMutable, isSparse, mutable, setCopyOnWrite, setDisplayUnit, setMutable

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Methods inherited from interface org.djunits.value.Relative

divide, divide, minus, plus, times, times

Methods inherited from interface org.djunits.value.Value

isAbsolute, isRelative

Constructor Details

DurationVector

public DurationVector(DoubleVectorData data,
 DurationUnit displayUnit)

Construct an DurationVector from an internal data object.

Parameters:

data - DoubleVectorData; the internal data object for the vector

displayUnit - DurationUnit; the display unit of the vector data

DurationVector

public DurationVector(double[] data,
 DurationUnit displayUnit,
 StorageType storageType)

Construct an DurationVector from a double[] object. The double values are expressed in the displayUnit, and will be printed using the displayUnit.

Parameters:

data - double[]; the data for the vector, expressed in the displayUnit

displayUnit - DurationUnit; the unit of the values in the data array, and display unit when printing

storageType - StorageType; the StorageType (SPARSE or DENSE) to use for constructing the Vector

DurationVector

public DurationVector(double[] data,
 DurationUnit displayUnit)

Construct an DurationVector from a double[] object. The double values are expressed in the displayUnit. Assume that the StorageType is DENSE since we offer the data as an array.

Parameters:

data - double[]; the data for the vector

displayUnit - DurationUnit; the unit of the values in the data array, and display unit when printing

DurationVector

public DurationVector(double[] data,
 StorageType storageType)

Construct an DurationVector from a double[] object with SI-unit values.

Parameters:

data - double[]; the data for the vector, in SI units

storageType - StorageType; the StorageType (SPARSE or DENSE) to use for constructing the Vector

DurationVector

public DurationVector(double[] data)

Construct an DurationVector from a double[] object with SI-unit values. Assume that the StorageType is DENSE since we offer the data as an array.

Parameters:

data - double[]; the data for the vector, in SI units

DurationVector

public DurationVector(Duration[] data,
 DurationUnit displayUnit,
 StorageType storageType)

Construct an DurationVector from an array of Duration objects. The Duration values are each expressed in their own unit, but will be internally stored as SI values, all expressed in the displayUnit when printing.

Parameters:

data - Duration[]; the data for the vector

displayUnit - DurationUnit; the display unit of the values when printing

storageType - StorageType; the StorageType (SPARSE or DENSE) to use for constructing the Vector

DurationVector

public DurationVector(Duration[] data,
 DurationUnit displayUnit)

Construct an DurationVector from an array of Duration objects. The Duration values are each expressed in their own unit, but will be internally stored as SI values, all expressed in the displayUnit when printing. Assume that the StorageType is DENSE since we offer the data as an array.

Parameters:

data - Duration[]; the data for the vector

displayUnit - DurationUnit; the display unit of the values when printing

DurationVector

public DurationVector(Duration[] data,
 StorageType storageType)

Construct an DurationVector from an array of Duration objects. The Duration values are each expressed in their own unit, but will be internally stored as SI values, and expressed using SI units when printing. since we offer the data as an array.

Parameters:

data - Duration[]; the data for the vector

storageType - StorageType; the StorageType (SPARSE or DENSE) to use for constructing the Vector

DurationVector

public DurationVector(Duration[] data)

Construct an DurationVector from an array of Duration objects. The Duration values are each expressed in their own unit, but will be internally stored as SI values, and expressed using SI units when printing. Assume that the StorageType is DENSE since we offer the data as an array.

Parameters:

data - Duration[]; the data for the vector

DurationVector

public DurationVector(List<? extends Number> data,
 DurationUnit displayUnit,
 StorageType storageType)

Construct an DurationVector from a list of Number objects or a list of Duration objects. Note that the displayUnit has a different meaning depending on whether the list contains Number objects (e.g., Double objects) or Duration objects. In case the list contains Number objects, the displayUnit indicates the unit in which the values in the list are expressed, as well as the unit in which they will be printed. In case the list contains Duration objects, each Duration has its own unit, and the displayUnit is just used for printing. The values but will always be internally stored as SI values or base values, and expressed using the display unit or base unit when printing.

Parameters:

data - List<Double> or List<Duration>; the data for the vector

displayUnit - DurationUnit; the display unit of the vector data, and the unit of the data points when the data is expressed as List<Double> or List<Number> in general

storageType - StorageType; the StorageType (SPARSE or DENSE) to use for constructing the Vector

DurationVector

public DurationVector(List<? extends Number> data,
 DurationUnit displayUnit)

Construct an DurationVector from a list of Number objects or a list of Duration objects. Note that the displayUnit has a different meaning depending on whether the list contains Number objects (e.g., Double objects) or Duration objects. In case the list contains Number objects, the displayUnit indicates the unit in which the values in the list are expressed, as well as the unit in which they will be printed. In case the list contains Duration objects, each Duration has its own unit, and the displayUnit is just used for printing. The values but will always be internally stored as SI values or base values, and expressed using the display unit or base unit when printing. Assume the storage type is DENSE since we offer the data as a List.

Parameters:

data - List<Double> or List<Duration>; the data for the vector

displayUnit - DurationUnit; the display unit of the vector data, and the unit of the data points when the data is expressed as List<Double> or List<Number> in general

DurationVector

public DurationVector(List<? extends Number> data,
 StorageType storageType)

Construct an DurationVector from a list of Number objects or a list of Duration objects. When data contains numbers such as Double, assume that they are expressed using SI units. When the data consists of Duration objects, they each have their own unit, but will be printed using SI units or base units. The values but will always be internally stored as SI values or base values, and expressed using the display unit or base unit when printing.

Parameters:

data - List<Double> or List<Duration>; the data for the vector

storageType - StorageType; the StorageType (SPARSE or DENSE) to use for constructing the Vector

DurationVector

public DurationVector(List<? extends Number> data)

Construct an DurationVector from a list of Number objects or a list of Duration objects. When data contains numbers such as Double, assume that they are expressed using SI units. When the data consists of Duration objects, they each have their own unit, but will be printed using SI units or base units. The values but will always be internally stored as SI values or base values, and expressed using the display unit or base unit when printing. Assume the storage type is DENSE since we offer the data as a List.

Parameters:

data - List<Double> or List<Duration>; the data for the vector

DurationVector

public DurationVector(Map<Integer,? extends Number> data,
 int size,
 DurationUnit displayUnit,
 StorageType storageType)

Construct an DurationVector from a (sparse) map of index values to Number objects or a (sparse) map of index values to of Duration objects. Using index values is particularly useful for sparse vectors. The size parameter indicates the size of the vector, since the largest index does not have to be part of the map. Note that the displayUnit has a different meaning depending on whether the map contains Number objects (e.g., Double objects) or Duration objects. In case the map contains Number objects, the displayUnit indicates the unit in which the values in the map are expressed, as well as the unit in which they will be printed. In case the map contains Duration objects, each Duration has its own unit, and the displayUnit is just used for printing. The values but will always be internally stored as SI values or base values, and expressed using the display unit or base unit when printing.

Parameters:

data - Map<Integer, Double> or Map<Integer, Duration>; the data for the vector

size - int; the size off the vector, i.e., the highest index

displayUnit - DurationUnit; the display unit of the vector data, and the unit of the data points when the data is expressed as List<Double> or List<Number> in general

storageType - StorageType; the StorageType (SPARSE or DENSE) to use for constructing the Vector

DurationVector

public DurationVector(Map<Integer,? extends Number> data,
 int size,
 DurationUnit displayUnit)

Construct an DurationVector from a (sparse) map of index values to Number objects or a (sparse) map of index values to of Duration objects. Using index values is particularly useful for sparse vectors. The size parameter indicates the size of the vector, since the largest index does not have to be part of the map. Note that the displayUnit has a different meaning depending on whether the map contains Number objects (e.g., Double objects) or Duration objects. In case the map contains Number objects, the displayUnit indicates the unit in which the values in the map are expressed, as well as the unit in which they will be printed. In case the map contains Duration objects, each Duration has its own unit, and the displayUnit is just used for printing. The values but will always be internally stored as SI values or base values, and expressed using the display unit or base unit when printing. Assume the storage type is SPARSE since we offer the data as a Map.

Parameters:

data - Map<Integer, Double> or Map<Integer, Duration>; the data for the vector

size - int; the size off the vector, i.e., the highest index

displayUnit - DurationUnit; the display unit of the vector data, and the unit of the data points when the data is expressed as List<Double> or List<Number> in general

DurationVector

public DurationVector(Map<Integer,? extends Number> data,
 int size,
 StorageType storageType)

Construct an DurationVector from a (sparse) map of index values to Number objects or a (sparse) map of index values to of Duration objects. Using index values is particularly useful for sparse vectors. The size parameter indicates the size of the vector, since the largest index does not have to be part of the map. When data contains numbers such as Double, assume that they are expressed using SI units. When the data consists of Duration objects, they each have their own unit, but will be printed using SI units or base units. The values but will always be internally stored as SI values or base values, and expressed using the display unit or base unit when printing.

Parameters:

data - Map<Integer, Double> or Map<Integer, Duration>; the data for the vector

size - int; the size off the vector, i.e., the highest index

storageType - StorageType; the StorageType (SPARSE or DENSE) to use for constructing the Vector

DurationVector

public DurationVector(Map<Integer,? extends Number> data,
 int size)

Construct an DurationVector from a (sparse) map of index values to Number objects or a (sparse) map of index values to of Duration objects. Using index values is particularly useful for sparse vectors. The size parameter indicates the size of the vector, since the largest index does not have to be part of the map. When data contains numbers such as Double, assume that they are expressed using SI units. When the data consists of Duration objects, they each have their own unit, but will be printed using SI units or base units. The values but will always be internally stored as SI values or base values, and expressed using the display unit or base unit when printing. Assume the storage type is SPARSE since we offer the data as a Map.

Parameters:

data - Map<Integer, Double> or Map<Integer, Duration>; the data for the vector

size - int; the size off the vector, i.e., the highest index

Method Details

getScalarClass

public Class<Duration> getScalarClass()

Return the class of the corresponding scalar.

Specified by:

getScalarClass in class IndexedValue<DurationUnit,Duration,DurationVector,DoubleVectorData>

Returns:

Class<S>; the class of the corresponding scalar

instantiateVector

public DurationVector instantiateVector(DoubleVectorData dvd,
 DurationUnit displayUnit)

Instantiate a new vector of the class of this vector. This can be used instead of the DoubleVector.instiantiate() methods in case another vector of this class is known. The method is faster than DoubleVector.instantiate, and it will also work if the vector is user-defined.

Specified by:

instantiateVector in class DoubleVector<DurationUnit,Duration,DurationVector>

Parameters:

dvd - DoubleVectorData; the data used to instantiate the vector

displayUnit - U; the display unit of the vector

Returns:

V; a vector of the correct type

instantiateScalarSI

public Duration instantiateScalarSI(double valueSI,
 DurationUnit displayUnit)

Instantiate a new scalar for the class of this vector. This can be used instead of the DoubleScalar.instiantiate() methods in case a vector of this class is known. The method is faster than DoubleScalar.instantiate, and it will also work if the vector and/or scalar are user-defined.

Specified by:

instantiateScalarSI in class DoubleVector<DurationUnit,Duration,DurationVector>

Parameters:

valueSI - double; the SI value of the scalar

displayUnit - U; the unit in which the value will be displayed

Returns:

S; a scalar of the correct type, belonging to the vector type

instantiateVectorAbs

public TimeVector instantiateVectorAbs(DoubleVectorData dvd,
 TimeUnit displayUnit)

Instantiate a new absolute vector of the class of this relative vector. This can be used instead of the DoubleVector.instiantiate() methods in case another vector of this relative with absolute class is known. The method is faster than DoubleVector.instantiate, and it will also work if the vector is user-defined.

Specified by:

instantiateVectorAbs in class DoubleVectorRelWithAbs<TimeUnit,Time,TimeVector,DurationUnit,Duration,DurationVector>

Parameters:

dvd - DoubleVectorData; the data used to instantiate the vector

displayUnit - AU; the display unit of the absolute vector

Returns:

AV; an absolute vector of the correct type, belonging to this relative vector type

instantiateScalarAbsSI

public Time instantiateScalarAbsSI(double valueSI,
 TimeUnit displayUnit)

Instantiate a new absolute scalar for the class of this relative vector. This can be used instead of the DoubleScalar.instiantiate() methods in case a vector of this class is known. The method is faster than DoubleScalar.instantiate, and it will also work if the vector and/or scalar are user-defined.

Specified by:

instantiateScalarAbsSI in class DoubleVectorRelWithAbs<TimeUnit,Time,TimeVector,DurationUnit,Duration,DurationVector>

Parameters:

valueSI - double; the SI value of the absolute scalar

displayUnit - AU; the unit in which the absolute value will be displayed

Returns:

A; an absolute scalar of the correct type, belonging to this relative vector type