org.djunits.value.vdouble.vector

Interface DoubleVectorInterface<U extends Unit<U>>

Type Parameters:

U - the unit

All Known Subinterfaces:

MutableDoubleVectorInterface<U>

All Known Implementing Classes:

AccelerationVector, AccelerationVector.Dense, AccelerationVector.Sparse, AnglePlaneVector.Abs, AnglePlaneVector.Abs.Dense, AnglePlaneVector.Abs.Sparse, AnglePlaneVector.Rel, AnglePlaneVector.Rel.Dense, AnglePlaneVector.Rel.Sparse, AngleSlopeVector.Abs, AngleSlopeVector.Abs.Dense, AngleSlopeVector.Abs.Sparse, AngleSlopeVector.Rel, AngleSlopeVector.Rel.Dense, AngleSlopeVector.Rel.Sparse, AngleSolidVector, AngleSolidVector.Dense, AngleSolidVector.Sparse, AreaVector, AreaVector.Dense, AreaVector.Sparse, DensityVector, DensityVector.Dense, DensityVector.Sparse, DimensionlessVector.Abs, DimensionlessVector.Abs.Dense, DimensionlessVector.Abs.Sparse, DimensionlessVector.Rel, DimensionlessVector.Rel.Dense, DimensionlessVector.Rel.Sparse, DoubleVector, DoubleVector.Abs, DoubleVector.Abs.Dense, DoubleVector.Abs.Sparse, DoubleVector.Rel, DoubleVector.Rel.Dense, DoubleVector.Rel.Sparse, ElectricalChargeVector, ElectricalChargeVector.Dense, ElectricalChargeVector.Sparse, ElectricalCurrentVector, ElectricalCurrentVector.Dense, ElectricalCurrentVector.Sparse, ElectricalPotentialVector, ElectricalPotentialVector.Dense, ElectricalPotentialVector.Sparse, ElectricalResistanceVector, ElectricalResistanceVector.Dense, ElectricalResistanceVector.Sparse, EnergyVector, EnergyVector.Dense, EnergyVector.Sparse, FlowMassVector, FlowMassVector.Dense, FlowMassVector.Sparse, FlowVolumeVector, FlowVolumeVector.Dense, FlowVolumeVector.Sparse, ForceVector, ForceVector.Dense, ForceVector.Sparse, FrequencyVector, FrequencyVector.Dense, FrequencyVector.Sparse, LengthVector.Abs, LengthVector.Abs.Dense, LengthVector.Abs.Sparse, LengthVector.Rel, LengthVector.Rel.Dense, LengthVector.Rel.Sparse, LinearDensityVector, LinearDensityVector.Dense, LinearDensityVector.Sparse, MassVector, MassVector.Dense, MassVector.Sparse, MoneyPerAreaVector, MoneyPerAreaVector.Dense, MoneyPerAreaVector.Sparse, MoneyPerEnergyVector, MoneyPerEnergyVector.Dense, MoneyPerEnergyVector.Sparse, MoneyPerLengthVector, MoneyPerLengthVector.Dense, MoneyPerLengthVector.Sparse, MoneyPerMassVector, MoneyPerMassVector.Dense, MoneyPerMassVector.Sparse, MoneyPerTimeVector, MoneyPerTimeVector.Dense, MoneyPerTimeVector.Sparse, MoneyPerVolumeVector, MoneyPerVolumeVector.Dense, MoneyPerVolumeVector.Sparse, MoneyVector, MoneyVector.Dense, MoneyVector.Sparse, MutableAccelerationVector, MutableAccelerationVector.Dense, MutableAccelerationVector.Sparse, MutableAnglePlaneVector.Abs, MutableAnglePlaneVector.Abs.Dense, MutableAnglePlaneVector.Abs.Sparse, MutableAnglePlaneVector.Rel, MutableAnglePlaneVector.Rel.Dense, MutableAnglePlaneVector.Rel.Sparse, MutableAngleSlopeVector.Abs, MutableAngleSlopeVector.Abs.Dense, MutableAngleSlopeVector.Abs.Sparse, MutableAngleSlopeVector.Rel, MutableAngleSlopeVector.Rel.Dense, MutableAngleSlopeVector.Rel.Sparse, MutableAngleSolidVector, MutableAngleSolidVector.Dense, MutableAngleSolidVector.Sparse, MutableAreaVector, MutableAreaVector.Dense, MutableAreaVector.Sparse, MutableDensityVector, MutableDensityVector.Dense, MutableDensityVector.Sparse, MutableDimensionlessVector.Abs, MutableDimensionlessVector.Abs.Dense, MutableDimensionlessVector.Abs.Sparse, MutableDimensionlessVector.Rel, MutableDimensionlessVector.Rel.Dense, MutableDimensionlessVector.Rel.Sparse, MutableDoubleVector, MutableDoubleVector.Abs, MutableDoubleVector.Abs.Dense, MutableDoubleVector.Abs.Sparse, MutableDoubleVector.Rel, MutableDoubleVector.Rel.Dense, MutableDoubleVector.Rel.Sparse, MutableElectricalChargeVector, MutableElectricalChargeVector.Dense, MutableElectricalChargeVector.Sparse, MutableElectricalCurrentVector, MutableElectricalCurrentVector.Dense, MutableElectricalCurrentVector.Sparse, MutableElectricalPotentialVector, MutableElectricalPotentialVector.Dense, MutableElectricalPotentialVector.Sparse, MutableElectricalResistanceVector, MutableElectricalResistanceVector.Dense, MutableElectricalResistanceVector.Sparse, MutableEnergyVector, MutableEnergyVector.Dense, MutableEnergyVector.Sparse, MutableFlowMassVector, MutableFlowMassVector.Dense, MutableFlowMassVector.Sparse, MutableFlowVolumeVector, MutableFlowVolumeVector.Dense, MutableFlowVolumeVector.Sparse, MutableForceVector, MutableForceVector.Dense, MutableForceVector.Sparse, MutableFrequencyVector, MutableFrequencyVector.Dense, MutableFrequencyVector.Sparse, MutableLengthVector.Abs, MutableLengthVector.Abs.Dense, MutableLengthVector.Abs.Sparse, MutableLengthVector.Rel, MutableLengthVector.Rel.Dense, MutableLengthVector.Rel.Sparse, MutableLinearDensityVector, MutableLinearDensityVector.Dense, MutableLinearDensityVector.Sparse, MutableMassVector, MutableMassVector.Dense, MutableMassVector.Sparse, MutableMoneyPerAreaVector, MutableMoneyPerAreaVector.Dense, MutableMoneyPerAreaVector.Sparse, MutableMoneyPerEnergyVector, MutableMoneyPerEnergyVector.Dense, MutableMoneyPerEnergyVector.Sparse, MutableMoneyPerLengthVector, MutableMoneyPerLengthVector.Dense, MutableMoneyPerLengthVector.Sparse, MutableMoneyPerMassVector, MutableMoneyPerMassVector.Dense, MutableMoneyPerMassVector.Sparse, MutableMoneyPerTimeVector, MutableMoneyPerTimeVector.Dense, MutableMoneyPerTimeVector.Sparse, MutableMoneyPerVolumeVector, MutableMoneyPerVolumeVector.Dense, MutableMoneyPerVolumeVector.Sparse, MutableMoneyVector, MutableMoneyVector.Dense, MutableMoneyVector.Sparse, MutablePowerVector, MutablePowerVector.Dense, MutablePowerVector.Sparse, MutablePressureVector, MutablePressureVector.Dense, MutablePressureVector.Sparse, MutableSpeedVector, MutableSpeedVector.Dense, MutableSpeedVector.Sparse, MutableTemperatureVector.Abs, MutableTemperatureVector.Abs.Dense, MutableTemperatureVector.Abs.Sparse, MutableTemperatureVector.Rel, MutableTemperatureVector.Rel.Dense, MutableTemperatureVector.Rel.Sparse, MutableTimeVector.Abs, MutableTimeVector.Abs.Dense, MutableTimeVector.Abs.Sparse, MutableTimeVector.Rel, MutableTimeVector.Rel.Dense, MutableTimeVector.Rel.Sparse, MutableTorqueVector, MutableTorqueVector.Dense, MutableTorqueVector.Sparse, MutableVolumeVector, MutableVolumeVector.Dense, MutableVolumeVector.Sparse, PowerVector, PowerVector.Dense, PowerVector.Sparse, PressureVector, PressureVector.Dense, PressureVector.Sparse, SpeedVector, SpeedVector.Dense, SpeedVector.Sparse, TemperatureVector.Abs, TemperatureVector.Abs.Dense, TemperatureVector.Abs.Sparse, TemperatureVector.Rel, TemperatureVector.Rel.Dense, TemperatureVector.Rel.Sparse, TimeVector.Abs, TimeVector.Abs.Dense, TimeVector.Abs.Sparse, TimeVector.Rel, TimeVector.Rel.Dense, TimeVector.Rel.Sparse, TorqueVector, TorqueVector.Dense, TorqueVector.Sparse, VolumeVector, VolumeVector.Dense, VolumeVector.Sparse

public interface DoubleVectorInterface<U extends Unit<U>>

Copyright (c) 2013-2015 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 Oct 6, 2015

Author:

Alexander Verbraeck, Peter Knoppers

Method Summary

Modifier and Type	Method and Description
int	cardinality() Count the number of cells that have a non-zero value (ignores tolerance).
DoubleScalar<U>	get(int index) Retrieve the value stored at a specified index as a DoubleScalar.
double	getInUnit(int index) Retrieve the value stored at a specified position in the original unit.
double	getInUnit(int index, U targetUnit) Retrieve the value stored at a specified position converted into a specified unit.
double	getSI(int index) Retrieve the value stored at a specified position in the standard SI unit.
double[]	getValuesInUnit() Create a double[] array filled with the values in the original unit.
double[]	getValuesInUnit(U targetUnit) Create a double[] array filled with the values converted into a specified unit.
double[]	getValuesSI() Create a double[] array filled with the values in the standard SI unit.
MutableDoubleVectorInterface<U>	mutable() Create a mutable version of this DoubleVector.
int	size() Retrieve the size of the vector.
DoubleVectorInterface<U>	toDense() Create a dense version of this DoubleVector.
DoubleVectorInterface<U>	toSparse() Create a sparse version of this DoubleVector.
String	toString()
String	toString(boolean verbose, boolean withUnit) Print this DoubleVector with optional type and unit information.
String	toString(U displayUnit) Print this DoubleVector with the values expressed in the specified unit.
String	toString(U displayUnit, boolean verbose, boolean withUnit) Print this DoubleVector with the values expressed in the specified unit.
double	zSum() Compute the sum of all values of this vector.

Method Detail

size

int size()

Retrieve the size of the vector.

Returns:

int; the size of the vector

cardinality

int cardinality()

Count the number of cells that have a non-zero value (ignores tolerance).

Returns:

int; the number of cells having non-zero value

getSI

double getSI(int index)
      throws ValueException

Retrieve the value stored at a specified position in the standard SI unit.

Parameters:

index - int; index of the value to retrieve

Returns:

double; value at position index in the standard SI unit

Throws:

ValueException - when index out of range (index < 0 or index >= size())

getInUnit

double getInUnit(int index)
          throws ValueException

Retrieve the value stored at a specified position in the original unit.

Parameters:

index - int; index of the value to retrieve

Returns:

double; value at position index in the original unit

Throws:

ValueException - when index out of range (index < 0 or index >= size())

getInUnit

double getInUnit(int index,
                 U targetUnit)
          throws ValueException

Retrieve the value stored at a specified position converted into a specified unit.

Parameters:

index - int; index of the value to retrieve

targetUnit - U; the unit for the result

Returns:

double; value at position index converted into the specified unit

Throws:

ValueException - when index out of range (index < 0 or index >= size())

get

DoubleScalar<U> get(int index)
             throws ValueException

Retrieve the value stored at a specified index as a DoubleScalar.

Parameters:

index - int; index of the value to retrieve

Returns:

DoubleScalar<U>; the strongly typed value of the selected cell

Throws:

ValueException - when index out of range (index < 0 or index >= size())

zSum

double zSum()

Compute the sum of all values of this vector.

Returns:

double; the sum of all values of this vector

mutable

MutableDoubleVectorInterface<U> mutable()

Create a mutable version of this DoubleVector.
The mutable version is created with a shallow copy of the data and the internal copyOnWrite flag set. The first operation in the mutable version that modifies the data shall trigger a deep copy of the data.

Returns:

MutableDoubleVector<U>; mutable version of this DoubleVector

getValuesSI

double[] getValuesSI()

Create a double[] array filled with the values in the standard SI unit.

Returns:

double[]; array of values in the standard SI unit

getValuesInUnit

double[] getValuesInUnit()

Create a double[] array filled with the values in the original unit.

Returns:

double[]; the values in the original unit

getValuesInUnit

double[] getValuesInUnit(U targetUnit)

Create a double[] array filled with the values converted into a specified unit.

Parameters:

targetUnit - U; the unit into which the values are converted for use

Returns:

double[]; the values converted into the specified unit

toString

String toString()

Overrides:

toString in class Object

Returns:

a String with the Vector, non-verbose, with the unit attached.

toString

String toString(U displayUnit)

Print this DoubleVector with the values expressed in the specified unit.

Parameters:

displayUnit - U; the unit into which the values are converted for display

Returns:

String; printable string with the vector contents expressed in the specified unit

toString

String toString(boolean verbose,
                boolean withUnit)

Print this DoubleVector with optional type and unit information.

Parameters:

verbose - boolean; if true; include type info; if false; exclude type info

withUnit - boolean; if true; include the unit; of false; exclude the unit

Returns:

String; printable string with the vector contents

toString

String toString(U displayUnit,
                boolean verbose,
                boolean withUnit)

Print this DoubleVector with the values expressed in the specified unit.

Parameters:

displayUnit - U; the unit into which the values are converted for display

verbose - boolean; if true; include type info; if false; exclude type info

withUnit - boolean; if true; include the unit; of false; exclude the unit

Returns:

String; printable string with the vector contents

toDense

DoubleVectorInterface<U> toDense()

Create a dense version of this DoubleVector.

Returns:

MutableDoubleVector<U>; dense version of this DoubleVector

toSparse

DoubleVectorInterface<U> toSparse()

Create a sparse version of this DoubleVector.

Returns:

MutableDoubleVector<U>; sparse version of this DoubleVector