Package org.djunits.value.vdouble.vector.base

Class DoubleVectorRel<U extends Unit<U>,S extends DoubleScalarRel<U,S>,RV extends DoubleVectorRel<U,S,RV>>

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

AbsorbedDoseVector, AccelerationVector, AmountOfSubstanceVector, AngularAccelerationVector, AngularVelocityVector, AreaVector, CatalyticActivityVector, DensityVector, DimensionlessVector, DoubleVectorRelWithAbs, ElectricalCapacitanceVector, ElectricalChargeVector, ElectricalConductanceVector, ElectricalCurrentVector, ElectricalInductanceVector, ElectricalPotentialVector, ElectricalResistanceVector, EnergyVector, EquivalentDoseVector, FlowMassVector, FlowVolumeVector, ForceVector, FrequencyVector, IlluminanceVector, LinearDensityVector, LuminousFluxVector, LuminousIntensityVector, MagneticFluxDensityVector, MagneticFluxVector, MassVector, MomentumVector, PowerVector, PressureVector, RadioActivityVector, SIVector, SolidAngleVector, SpeedVector, TorqueVector, VolumeVector

public abstract class DoubleVectorRel<U extends Unit<U>,S extends DoubleScalarRel<U,S>,RV extends DoubleVectorRel<U,S,RV>>
extends DoubleVector<U,S,RV>
implements Relative<U,RV>

AbstractMutableDoubleVectorRel.java.

Copyright (c) 2019-2025 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.vdouble.vector.base.DoubleVector

DoubleVector.Itr

Field Summary

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

data

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	DoubleVectorRel(DoubleVectorData data, U unit)	Construct a new Relative Mutable DoubleVector.

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 DoubleScalarRel<UT, ST>, VT extends DoubleVectorRel<UT, ST, VT>> SIVector	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	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.
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 DoubleScalarRel<UT, ST>, VT extends DoubleVectorRel<UT, ST, VT> & Relative<UT, VT>> SIVector	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.vdouble.vector.base.DoubleVector

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

DoubleVectorRel

protected DoubleVectorRel(DoubleVectorData data,
 U unit)

Construct a new Relative Mutable DoubleVector.

Parameters:

data - an internal data object

unit - the unit

Method Details

zSum

public final S zSum()

Compute the sum of all SI values of this vector.

Returns:

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

plus

public final RV plus(RV rel)
              throws ValueRuntimeException

Description copied from interface: Relative

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 DoubleScalarRel<U,S>>

Parameters:

rel - the value to add

Returns:

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

Throws:

ValueRuntimeException

minus

public final RV minus(RV rel)
               throws ValueRuntimeException

Description copied from interface: Relative

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 DoubleScalarRel<U,S>>

Parameters:

rel - the value to subtract

Returns:

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 - the scalar by which to increment all values

Returns:

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 - the vector that contains the values by which to increment the corresponding values

Returns:

this modified vector

Throws:

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

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 - the scalar by which to decrement all values

Returns:

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 - the vector that contains the values by which to decrement the corresponding values

Returns:

this modified vector

Throws:

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

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 - the factor by which to multiply all values

Returns:

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 - the value by which to divide all values

Returns:

this modified vector

Throws:

ValueRuntimeException - in case the vector is immutable

times

public final <UT extends Unit<UT>,
ST extends DoubleScalarRel<UT,
ST>,
VT extends DoubleVectorRel<UT,
ST,
VT> & Relative<UT,
VT>>
SIVector 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 - the right operand, which can be any vector type

Returns:

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 DoubleScalarRel<UT,
ST>,
VT extends DoubleVectorRel<UT,
ST,
VT>>
SIVector 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 - the right operand, which can be any vector type

Returns:

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)

Description copied from interface: Relative

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 DoubleScalarRel<U,S>>

Parameters:

multiplier - the multiplier

Returns:

a new scalar/vector/matrix

divide

public RV divide(double divisor)

Description copied from interface: Relative

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 DoubleScalarRel<U,S>>

Parameters:

divisor - the divisor

Returns:

the modified T

times

public RV times(float multiplier)

Description copied from interface: Relative

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 DoubleScalarRel<U,S>>

Parameters:

multiplier - the multiplier

Returns:

a new scalar/vector/matrix

divide

public RV divide(float divisor)

Description copied from interface: Relative

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 DoubleScalarRel<U,S>>

Parameters:

divisor - the divisor

Returns:

the modified T