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

Class AbstractDoubleVectorRel<U extends Unit<U>,​S extends AbstractDoubleScalarRel<U,​S>,​RV extends AbstractDoubleVectorRel<U,​S,​RV>>

java.lang.Object
org.djunits.value.AbstractValue<U,​T>
org.djunits.value.AbstractIndexedValue<U,​S,​V,​DoubleVectorData>
org.djunits.value.vdouble.vector.base.AbstractDoubleVector<U,​S,​RV>
org.djunits.value.vdouble.vector.base.AbstractDoubleVectorRel<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>, Vector<U,​S,​RV>, Vector.Rel<U,​S,​RV>, ValueFunctions<U,​RV>, IndexedValue<U,​S,​RV>, Relative<U,​RV>, Value<U,​RV>, DoubleVectorInterface<U,​S,​RV>
Direct Known Subclasses:
AbsorbedDoseVector, AbstractDoubleVectorRelWithAbs, AccelerationVector, AmountOfSubstanceVector, AngularAccelerationVector, AngularVelocityVector, AreaVector, CatalyticActivityVector, DensityVector, DimensionlessVector, 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 AbstractDoubleVectorRel<U extends Unit<U>,​S extends AbstractDoubleScalarRel<U,​S>,​RV extends AbstractDoubleVectorRel<U,​S,​RV>>
extends AbstractDoubleVector<U,​S,​RV>
implements Vector.Rel<U,​S,​RV>, Relative<U,​RV>
AbstractMutableDoubleVectorRel.java.

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

  • Constructor Details

    • AbstractDoubleVectorRel

      protected AbstractDoubleVectorRel​(DoubleVectorData data, U unit)
      Construct a new Relative Mutable DoubleVector.
      Parameters:
      data - DoubleVectorData; 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 SI values of this vector with the same display unit as this vector

    • plus

      public final RV plus​(RV rel) throws ValueRuntimeException
      Add a relative vector to this relative mutable vector. A new vector is returned. When the vector itself needs to be changed, use the increaseBy(V) method instead. The addition is done value by value and the result is stored in a new vector. If both operands are sparse, the result is a sparse vector, otherwise the result is a dense vector.
      Specified by:
      plus in interface Vector.Rel<U extends Unit<U>,​S extends AbstractDoubleScalarRel<U,​S>,​RV extends AbstractDoubleVectorRel<U,​S,​RV>>
      Parameters:
      rel - RV; the relative vector (mutable or immutable, sparse or dense) to add
      Returns:
      RMV; the sum of this vector and the operand as a new relative, mutable vector
      Throws:
      ValueRuntimeException - in case this vector and the operand have a different size

    • minus

      public final RV minus​(RV rel) throws ValueRuntimeException
      Subtract a relative vector from this relative mutable vector. The display unit of the result is the display unit of this absolute vector. The subtraction is done value by value and the result is stored in a new vector. If both operands are sparse, the result is a sparse vector, otherwise the result is a dense vector.
      Specified by:
      minus in interface Vector.Rel<U extends Unit<U>,​S extends AbstractDoubleScalarRel<U,​S>,​RV extends AbstractDoubleVectorRel<U,​S,​RV>>
      Parameters:
      rel - RV; the value to subtract
      Returns:
      RMV; the difference of this vector and the operand as a new relative, mutable vector
      Throws:
      ValueRuntimeException - in case this vector and the operand have a different size

    • 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, 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 - 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, 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.
      Specified by:
      multiplyBy in interface Vector.Rel<U extends Unit<U>,​S extends AbstractDoubleScalarRel<U,​S>,​RV extends AbstractDoubleVectorRel<U,​S,​RV>>
      Parameters:
      multiplier - double; the factor by which to multiply all values
      Returns:
      V; this modified vector

    • divideBy

      public RV divideBy​(double divisor)
      Divide all values of this vector by the divisor. This only works if the vector is mutable.
      Specified by:
      divideBy in interface Vector.Rel<U extends Unit<U>,​S extends AbstractDoubleScalarRel<U,​S>,​RV extends AbstractDoubleVectorRel<U,​S,​RV>>
      Parameters:
      divisor - double; the value by which to divide all values
      Returns:
      V; this modified vector

    • times

      public final <UT extends Unit<UT>,​ ST extends AbstractDoubleScalarRel<UT,​ ST>,​ VT extends AbstractDoubleVectorRel<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 - VT; the right operand, which can be any vector type
      Returns:
      SIVector; 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 AbstractDoubleScalarRel<UT,​ ST>,​ VT extends AbstractDoubleVectorRel<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 - VT; the right operand, which can be any vector type
      Returns:
      SIVector; 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 AbstractDoubleScalarRel<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 AbstractDoubleScalarRel<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 AbstractDoubleScalarRel<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 AbstractDoubleScalarRel<U,​S>>
      Parameters:
      divisor - float; the divisor
      Returns:
      T; the modified T