org.djunits.value.vfloat.vector

Interface FloatVectorInterface<U extends Unit<U>>

Type Parameters:

U - the unit

All Known Subinterfaces:

MutableFloatVectorInterface<U>

All Known Implementing Classes:

AbstractFloatVector, AbstractFloatVectorAbs, AbstractFloatVectorRel, AbstractMutableFloatVectorAbs, AbstractMutableFloatVectorRel, FloatAbsoluteTemperatureVector, FloatAccelerationVector, FloatAngleSolidVector, FloatAngleVector, FloatAreaVector, FloatDensityVector, FloatDimensionlessVector, FloatDirectionVector, FloatDurationVector, FloatElectricalChargeVector, FloatElectricalCurrentVector, FloatElectricalPotentialVector, FloatElectricalResistanceVector, FloatEnergyVector, FloatFlowMassVector, FloatFlowVolumeVector, FloatForceVector, FloatFrequencyVector, FloatLengthVector, FloatLinearDensityVector, FloatMassVector, FloatMoneyPerAreaVector, FloatMoneyPerDurationVector, FloatMoneyPerEnergyVector, FloatMoneyPerLengthVector, FloatMoneyPerMassVector, FloatMoneyPerVolumeVector, FloatMoneyVector, FloatPositionVector, FloatPowerVector, FloatPressureVector, FloatSpeedVector, FloatTemperatureVector, FloatTimeVector, FloatTorqueVector, FloatVector.Abs, FloatVector.Rel, FloatVolumeVector, MutableFloatAbsoluteTemperatureVector, MutableFloatAccelerationVector, MutableFloatAngleSolidVector, MutableFloatAngleVector, MutableFloatAreaVector, MutableFloatDensityVector, MutableFloatDimensionlessVector, MutableFloatDirectionVector, MutableFloatDurationVector, MutableFloatElectricalChargeVector, MutableFloatElectricalCurrentVector, MutableFloatElectricalPotentialVector, MutableFloatElectricalResistanceVector, MutableFloatEnergyVector, MutableFloatFlowMassVector, MutableFloatFlowVolumeVector, MutableFloatForceVector, MutableFloatFrequencyVector, MutableFloatLengthVector, MutableFloatLinearDensityVector, MutableFloatMassVector, MutableFloatMoneyPerAreaVector, MutableFloatMoneyPerDurationVector, MutableFloatMoneyPerEnergyVector, MutableFloatMoneyPerLengthVector, MutableFloatMoneyPerMassVector, MutableFloatMoneyPerVolumeVector, MutableFloatMoneyVector, MutableFloatPositionVector, MutableFloatPowerVector, MutableFloatPressureVector, MutableFloatSpeedVector, MutableFloatTemperatureVector, MutableFloatTimeVector, MutableFloatTorqueVector, MutableFloatVector.Abs, MutableFloatVector.Rel, MutableFloatVolumeVector

public interface FloatVectorInterface<U extends Unit<U>>

Interface for the Immutable and Mutable FloatVector classes.

Copyright (c) 2013-2019 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).
float	getInUnit(int index) Retrieve the value stored at a specified position in the original unit.
float	getInUnit(int index, U targetUnit) Retrieve the value stored at a specified position converted into a specified unit.
float	getSI(int index) Retrieve the value stored at a specified position in the standard SI unit.
float[]	getValuesInUnit() Create a float[] array filled with the values in the original unit.
float[]	getValuesInUnit(U targetUnit) Create a float[] array filled with the values converted into a specified unit.
float[]	getValuesSI() Create a float[] array filled with the values in the standard SI unit.
MutableFloatVectorInterface<U>	mutable() return a mutable version of this vector.
int	size() Retrieve the size of the vector.
FloatVectorInterface<U>	toDense() return a dense version of this vector.
FloatVectorInterface<U>	toSparse() return a sparse version of this vector.
String	toString()
String	toString(boolean verbose, boolean withUnit) Print this FloatVector with optional type and unit information.
String	toString(U displayUnit) Print this FloatVector with the values expressed in the specified unit.
String	toString(U displayUnit, boolean verbose, boolean withUnit) Print this FloatVector with the values expressed in the specified unit.
float	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

float 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:

float; value at position index in the standard SI unit

Throws:

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

getInUnit

float 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:

float; value at position index in the original unit

Throws:

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

getInUnit

float 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:

float; value at position index converted into the specified unit

Throws:

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

mutable

MutableFloatVectorInterface<U> mutable()

return a mutable version of this vector.

Returns:

a mutable version of this vector

toSparse

FloatVectorInterface<U> toSparse()

return a sparse version of this vector.

Returns:

a sparse version of this vector

toDense

FloatVectorInterface<U> toDense()

return a dense version of this vector.

Returns:

a dense version of this vector

zSum

float zSum()

Compute the sum of all values of this vector.

Returns:

float; the sum of all values of this vector

getValuesSI

float[] getValuesSI()

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

Returns:

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

getValuesInUnit

float[] getValuesInUnit()

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

Returns:

float[]; the values in the original unit

getValuesInUnit

float[] getValuesInUnit(U targetUnit)

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

Parameters:

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

Returns:

float[]; 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 FloatVector 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 FloatVector 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 FloatVector 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