Package org.djunits.value.vfloat.vector.base

Class FloatVectorRel<U extends Unit<U>,S extends FloatScalarRel<U,S>,RV extends FloatVectorRel<U,S,RV>>

java.lang.Object

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

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

org.djunits.value.vfloat.vector.base.FloatVector<U,S,RV>

org.djunits.value.vfloat.vector.base.FloatVectorRel<U,S,RV>

Type Parameters:

U - the unit

S - the scalar type belonging to the vector type

RV - the relative vector type with this unit

All Implemented Interfaces:

Serializable, Cloneable, Iterable<S>, Relative<U,RV>, Value<U,RV>

Direct Known Subclasses:

FloatAbsorbedDoseVector, FloatAccelerationVector, FloatAmountOfSubstanceVector, FloatAngularAccelerationVector, FloatAngularVelocityVector, FloatAreaVector, FloatCatalyticActivityVector, FloatDensityVector, FloatDimensionlessVector, FloatElectricalCapacitanceVector, FloatElectricalChargeVector, FloatElectricalConductanceVector, FloatElectricalCurrentVector, FloatElectricalInductanceVector, FloatElectricalPotentialVector, FloatElectricalResistanceVector, FloatEnergyVector, FloatEquivalentDoseVector, FloatFlowMassVector, FloatFlowVolumeVector, FloatForceVector, FloatFrequencyVector, FloatIlluminanceVector, FloatLinearDensityVector, FloatLuminousFluxVector, FloatLuminousIntensityVector, FloatMagneticFluxDensityVector, FloatMagneticFluxVector, FloatMassVector, FloatMomentumVector, FloatPowerVector, FloatPressureVector, FloatRadioActivityVector, FloatSIVector, FloatSolidAngleVector, FloatSpeedVector, FloatTorqueVector, FloatVectorRelWithAbs, FloatVolumeVector

public abstract class FloatVectorRel<U extends Unit<U>,S extends FloatScalarRel<U,S>,RV extends FloatVectorRel<U,S,RV>>
extends FloatVector<U,S,RV>
implements Relative<U,RV>

AbstractMutableFloatVectorRel.java.

Copyright (c) 2019-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

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.djunits.value.vfloat.vector.base.FloatVector

FloatVector.Itr

Field Summary

Fields inherited from class org.djunits.value.vfloat.vector.base.FloatVector

data

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	FloatVectorRel(FloatVectorData data, U unit)	Construct a new Relative Mutable FloatVector.

Method Summary

Modifier and Type	Method	Description
RV	decrementBy(RV decrement)	Decrement all values of this vector by the decrement on a value by value basis.
RV	decrementBy(S decrement)	Decrement all values of this vector by the decrement.
RV	divide(double divisor)	Returns a new scalar/vector/matrix with value(s) divided by a factor.
RV	divide(float divisor)	Returns a new scalar/vector/matrix with value(s) divided by a factor.
final <UT extends Unit<UT>, ST extends FloatScalarRel<UT, ST>, VT extends FloatVectorRel<UT, ST, VT> & Relative<UT, VT>> FloatSIVector	divide(VT rel)	Divide this Relative value by a Relative value for a vector or matrix.
RV	divideBy(double divisor)	Divide all values of this vector by the divisor.
RV	divideBy(float divisor)	Divide all values of this vector by the divisor.
RV	incrementBy(RV increment)	Increment all values of this vector by the increment on a value by value basis.
RV	incrementBy(S increment)	Increment all values of this vector by the increment.
final RV	minus(RV rel)	Subtract a Relative value from this Relative value.
RV	multiplyBy(double multiplier)	Multiply all values of this vector by the multiplier.
RV	multiplyBy(float multiplier)	Multiply all values of this vector by the multiplier.
final RV	plus(RV rel)	Add a Relative value to this Relative value.
RV	times(double multiplier)	Returns a new scalar/vector/matrix with value(s) multiplied by a factor.
RV	times(float multiplier)	Returns a new scalar/vector/matrix with value(s) multiplied by a factor.
final <UT extends Unit<UT>, ST extends FloatScalarRel<UT, ST>, VT extends FloatVectorRel<UT, ST, VT> & Relative<UT, VT>> FloatSIVector	times(VT rel)	Multiply a Relative value with this Relative value for a vector or matrix.
final S	zSum()	Compute the sum of all SI values of this vector.

Methods inherited from class org.djunits.value.vfloat.vector.base.FloatVector

abs, assign, ceil, checkIndex, checkSize, equals, floor, get, getData, getInUnit, getInUnit, getScalars, getSI, getValuesInUnit, getValuesInUnit, getValuesSI, hashCode, instantiateScalarSI, instantiateVector, 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, getScalarClass, 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.Value

isAbsolute, isRelative

Constructor Details

FloatVectorRel

protected FloatVectorRel(FloatVectorData data,
 U unit)

Construct a new Relative Mutable FloatVector.

Parameters:

data - FloatVectorData; an internal data object

unit - U; the unit

Method Details

zSum

public final S zSum()

Compute the sum of all SI values of this vector.

Returns:

S; the sum of all values of this vector with the same display unit as this vector

plus

public final RV plus(RV rel)
              throws ValueRuntimeException

Add a Relative value to this Relative value. A new value is returned due to immutability.

Specified by:

plus in interface Relative<U extends Unit<U>,S extends FloatScalarRel<U,S>>

Parameters:

rel - R; the value to add

Returns:

R; the sum of this value and the operand as a new object

Throws:

ValueRuntimeException

minus

public final RV minus(RV rel)
               throws ValueRuntimeException

Subtract a Relative value from this Relative value. A new value is returned due to immutability.

Specified by:

minus in interface Relative<U extends Unit<U>,S extends FloatScalarRel<U,S>>

Parameters:

rel - R; the value to subtract

Returns:

R; the difference of this value and the operand

Throws:

ValueRuntimeException

incrementBy

public RV incrementBy(S increment)

Increment all values of this vector by the increment. This only works if the vector is mutable.

Parameters:

increment - S; the scalar by which to increment all values

Returns:

RV; this modified vector

Throws:

ValueRuntimeException - in case this vector is immutable

incrementBy

public RV incrementBy(RV increment)

Increment all values of this vector by the increment on a value by value basis. This only works if this vector is mutable.

Parameters:

increment - RV; the vector that contains the values by which to increment the corresponding values

Returns:

RV; this modified vector

Throws:

ValueRuntimeException - in case this vector is immutable or when the sizes of the vectors differ

decrementBy

public RV decrementBy(S decrement)

Decrement all values of this vector by the decrement. This only works if the vector is mutable.

Parameters:

decrement - S; the scalar by which to decrement all values

Returns:

RV; this modified vector

Throws:

ValueRuntimeException - in case this vector is immutable

decrementBy

public RV decrementBy(RV decrement)

Decrement all values of this vector by the decrement on a value by value basis. This only works if this vector is mutable.

Parameters:

decrement - RV; the vector that contains the values by which to decrement the corresponding values

Returns:

RV; this modified vector

Throws:

ValueRuntimeException - in case this vector is immutable or when the sizes of the vectors differ

multiplyBy

public RV multiplyBy(float multiplier)

Multiply all values of this vector by the multiplier. This only works if the vector is mutable.

Parameters:

multiplier - float; the factor by which to multiply all values

Returns:

RV; this modified vector

Throws:

ValueRuntimeException - in case the vector is immutable

divideBy

public RV divideBy(float divisor)

Divide all values of this vector by the divisor. This only works if the vector is mutable.

Parameters:

divisor - float; the value by which to divide all values

Returns:

RV; this modified vector

Throws:

ValueRuntimeException - in case the vector is immutable

multiplyBy

public RV multiplyBy(double multiplier)

Multiply all values of this vector by the multiplier. This only works if the vector is mutable.

Parameters:

multiplier - double; the factor by which to multiply all values

Returns:

RV; this modified vector

Throws:

ValueRuntimeException - in case the vector is immutable

divideBy

public RV divideBy(double divisor)

Divide all values of this vector by the divisor. This only works if the vector is mutable.

Parameters:

divisor - double; the value by which to divide all values

Returns:

RV; this modified vector

Throws:

ValueRuntimeException - in case the vector is immutable

times

public final <UT extends Unit<UT>,
ST extends FloatScalarRel<UT,
ST>,
VT extends FloatVectorRel<UT,
ST,
VT> & Relative<UT,
VT>>
FloatSIVector times(VT rel)
             throws ValueRuntimeException,
UnitException

Multiply a Relative value with this Relative value for a vector or matrix. The multiplication is done value by value and store the result in a new Relative value. If both operands are dense, the result is a dense vector or matrix, otherwise the result is a sparse vector or matrix.

Type Parameters:

UT - the unit type of the multiplier

ST - the scalar type of the multiplier

VT - the vector type of the multiplier

Parameters:

rel - VT; the right operand, which can be any vector type

Returns:

FloatSIVector; the multiplication of this vector and the operand

Throws:

ValueRuntimeException - in case this vector or matrix and the operand have a different size

UnitException - on unit error

divide

public final <UT extends Unit<UT>,
ST extends FloatScalarRel<UT,
ST>,
VT extends FloatVectorRel<UT,
ST,
VT> & Relative<UT,
VT>>
FloatSIVector divide(VT rel)
              throws ValueRuntimeException,
UnitException

Divide this Relative value by a Relative value for a vector or matrix. The division is done value by value and store the result in a new Relative value. If both operands are dense, the result is a dense vector or matrix, otherwise the result is a sparse vector or matrix.

Type Parameters:

UT - the unit type of the multiplier

ST - the scalar type of the multiplier

VT - the vector type of the multiplier

Parameters:

rel - VT; the right operand, which can be any vector type

Returns:

FloatSIVector; the division of this vector and the operand

Throws:

ValueRuntimeException - in case this vector or matrix and the operand have a different size

UnitException - on unit error

times

public RV times(double multiplier)

Returns a new scalar/vector/matrix with value(s) multiplied by a factor.

Specified by:

times in interface Relative<U extends Unit<U>,S extends FloatScalarRel<U,S>>

Parameters:

multiplier - double; the multiplier

Returns:

T; a new scalar/vector/matrix

divide

public RV divide(double divisor)

Returns a new scalar/vector/matrix with value(s) divided by a factor.

Specified by:

divide in interface Relative<U extends Unit<U>,S extends FloatScalarRel<U,S>>

Parameters:

divisor - double; the divisor

Returns:

T; the modified T

times

public RV times(float multiplier)

Returns a new scalar/vector/matrix with value(s) multiplied by a factor.

Specified by:

times in interface Relative<U extends Unit<U>,S extends FloatScalarRel<U,S>>

Parameters:

multiplier - float; the multiplier

Returns:

T; a new scalar/vector/matrix

divide

public RV divide(float divisor)

Returns a new scalar/vector/matrix with value(s) divided by a factor.

Specified by:

divide in interface Relative<U extends Unit<U>,S extends FloatScalarRel<U,S>>

Parameters:

divisor - float; the divisor

Returns:

T; the modified T