org.djunits.value.vdouble.vector

Class MutableLinearDensityVector

java.lang.Object

org.djunits.value.AbstractValue<U>

org.djunits.value.vdouble.vector.DoubleVector<U>

org.djunits.value.vdouble.vector.MutableDoubleVector<U>

org.djunits.value.vdouble.vector.MutableDoubleVector.Rel<LinearDensityUnit>

org.djunits.value.vdouble.vector.MutableLinearDensityVector

All Implemented Interfaces:

Serializable, FunctionsRel<LinearDensityUnit,DoubleVector.Abs<LinearDensityUnit>,DoubleVector.Rel<LinearDensityUnit>>, MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>, Relative, Value<LinearDensityUnit>, DoubleMathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>, DoubleVectorInterface<LinearDensityUnit>, MutableDoubleVectorInterface<LinearDensityUnit>

Direct Known Subclasses:

MutableLinearDensityVector.Dense, MutableLinearDensityVector.Sparse

public abstract class MutableLinearDensityVector
extends MutableDoubleVector.Rel<LinearDensityUnit>

Mutable LinearDensity Vector.

Copyright (c) 2013-2015 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See DJUNITS License.

$LastChangedDate: 2015-09-29 14:14:28 +0200 (Tue, 29 Sep 2015) $, @version $Revision: 73 $, by $Author: pknoppers $, initial version Sep 5, 2015

Author:

Alexander Verbraeck, Peter Knoppers

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MutableLinearDensityVector.Dense Double Dense Relative Immutable LinearDensity class.
static class	MutableLinearDensityVector.Sparse Double Sparse Relative Immutable LinearDensity class.

Nested classes/interfaces inherited from class org.djunits.value.vdouble.vector.MutableDoubleVector

MutableDoubleVector.Abs<U extends Unit<U>>, MutableDoubleVector.Rel<U extends Unit<U>>

Field Summary

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

data

Constructor Summary

Constructors

Constructor and Description
MutableLinearDensityVector(LinearDensityUnit unit)

Method Summary

Modifier and Type	Method and Description
MutableLinearDensityVector	abs() Set the value(s) to their absolute value.
MutableLinearDensityVector	acos() Set the value(s) to the arc cosine of the value(s); the resulting angle is in the range 0.0 through pi.
MutableLinearDensityVector	asin() Set the value(s) to the arc sine of the value(s); the resulting angle is in the range -pi/2 through pi/2.
MutableLinearDensityVector	atan() Set the value(s) to the arc tangent of the value(s); the resulting angle is in the range -pi/2 through pi/2.
MutableLinearDensityVector	cbrt() Set the value(s) to the(ir) cube root.
MutableLinearDensityVector	ceil() Set the value(s) to the smallest (closest to negative infinity) value(s) that are greater than or equal to the argument and equal to a mathematical integer.
MutableLinearDensityVector	copy() Create a deep copy of this MutableDoubleVector.
MutableLinearDensityVector	cos() Set the value(s) to the trigonometric cosine of the value(s).
MutableLinearDensityVector	cosh() Set the value(s) to the hyperbolic cosine of the value(s).
LinearDensityVector	divide(LinearDensityVector rel) Divide this Relative value by a Relative value for a vector or matrix.
LinearDensityVector	divide(MutableLinearDensityVector rel) Divide this Relative value by a Relative value for a vector or matrix.
MutableLinearDensityVector	divideBy(double constant) Scale the value(s) by the inverse of a factor; i.e.
MutableLinearDensityVector	exp() Set the value(s) to Euler's number e raised to the power of the value(s).
MutableLinearDensityVector	expm1() Set the value(s) to Euler's number e raised to the power of the value(s) minus 1 (e^x - 1).
MutableLinearDensityVector	floor() Set the value(s) to the largest (closest to positive infinity) value(s) that are less than or equal to the argument and equal to a mathematical integer.
LinearDensity	get(int index) Retrieve the value stored at a specified index as a DoubleScalar.
abstract LinearDensityVector	immutable() Create a immutable version of this MutableDoubleVector.
MutableLinearDensityVector	inv() Set the value(s) to the complement (1.0/x) of the value(s).
MutableLinearDensityVector	log() Set the value(s) to the natural logarithm (base e) of the value(s).
MutableLinearDensityVector	log10() Set the value(s) to the base 10 logarithm of the value(s).
MutableLinearDensityVector	log1p() Set the value(s) to the natural logarithm of the sum of the value(s) and 1.
LinearDensityVector	minus(LinearDensityVector rel) Subtract a Relative value from this Relative value for a vector or matrix.
LinearDensityVector	minus(MutableLinearDensityVector rel) Subtract a Relative value from this Relative value for a vector or matrix.
MutableLinearDensityVector	multiplyBy(double constant) Scale the value(s) by a factor.
abstract MutableLinearDensityVector	mutable() Create a mutable version of this DoubleVector.
LinearDensityVector	plus(LinearDensityVector rel) Add a Relative value to this Relative value for a vector or matrix.
LinearDensityVector	plus(MutableLinearDensityVector rel) Add a Relative value to this Relative value for a vector or matrix.
MutableLinearDensityVector	pow(double x) Set the value(s) to the value(s) raised to the power of the argument.
MutableLinearDensityVector	rint() Set the value(s) to the value(s) that are closest in value to the argument and equal to a mathematical integer.
MutableLinearDensityVector	round() Set the value(s) to the closest long to the argument with ties rounding up.
MutableLinearDensityVector	signum() Set the value(s) to the signum function of the value(s); zero if the argument is zero, 1.0 if the argument is greater than zero, -1.0 if the argument is less than zero.
MutableLinearDensityVector	sin() Set the value(s) to the trigonometric sine of the value(s).
MutableLinearDensityVector	sinh() Set the value(s) to the hyperbolic sine of the value(s).
MutableLinearDensityVector	sqrt() Set the value(s) to the correctly rounded positive square root of the value(s).
MutableLinearDensityVector	tan() Set the value(s) to the trigonometric tangent of the value(s).
MutableLinearDensityVector	tanh() Set the value(s) to the hyperbolic tangent of the value(s).
LinearDensityVector	times(LinearDensityVector rel) Multiply a Relative value with this Relative value for a vector or matrix.
LinearDensityVector	times(MutableLinearDensityVector rel) Multiply a Relative value with this Relative value for a vector or matrix.
MutableLinearDensityVector	toDegrees() Set the value(s) to approximately equivalent angle(s) measured in degrees.
abstract MutableLinearDensityVector	toDense() Create a dense version of this DoubleVector.
MutableLinearDensityVector	toRadians() Set the value(s) to approximately equivalent angle(s) measured in radians.
abstract MutableLinearDensityVector	toSparse() Create a sparse version of this DoubleVector.

Methods inherited from class org.djunits.value.vdouble.vector.MutableDoubleVector.Rel

decrementBy, divide, incrementBy, minus, plus, plus, times

Methods inherited from class org.djunits.value.vdouble.vector.MutableDoubleVector

assign, checkCopyOnWrite, decrementByImpl, incrementByImpl, normalize, scaleValueByValue, scaleValueByValue, set, setInUnit, setSI

Methods inherited from class org.djunits.value.vdouble.vector.DoubleVector

cardinality, checkIndex, checkSize, checkSize, equals, getData, getInUnit, getInUnit, getSI, getValuesInUnit, getValuesInUnit, getValuesSI, hashCode, initializeSparse, initializeSparseMA, initializeSparseMR, safeGet, safeSet, size, toString, toString, toString, toString, zSum

Methods inherited from class org.djunits.value.AbstractValue

expressAsSIUnit, expressAsSpecifiedUnit, getUnit, isAbsolute, isRelative

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.djunits.value.vdouble.vector.DoubleVectorInterface

cardinality, getInUnit, getInUnit, getSI, getValuesInUnit, getValuesInUnit, getValuesSI, size, toString, toString, toString, toString, zSum

Constructor Detail

MutableLinearDensityVector

public MutableLinearDensityVector(LinearDensityUnit unit)

Parameters:

unit - the unit to use

Method Detail

mutable

public abstract MutableLinearDensityVector 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.

Specified by:

mutable in interface DoubleVectorInterface<LinearDensityUnit>

Specified by:

mutable in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

MutableDoubleVector<U>; mutable version of this DoubleVector

immutable

public abstract LinearDensityVector immutable()

Create a immutable version of this MutableDoubleVector.

Specified by:

immutable in interface MutableDoubleVectorInterface<LinearDensityUnit>

Specified by:

immutable in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

DoubleVector<U>; mutable version of this MutableDoubleVector

toDense

public abstract MutableLinearDensityVector toDense()

Create a dense version of this DoubleVector.

Specified by:

toDense in interface DoubleVectorInterface<LinearDensityUnit>

Specified by:

toDense in interface MutableDoubleVectorInterface<LinearDensityUnit>

Specified by:

toDense in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

MutableDoubleVector<U>; dense version of this DoubleVector

toSparse

public abstract MutableLinearDensityVector toSparse()

Create a sparse version of this DoubleVector.

Specified by:

toSparse in interface DoubleVectorInterface<LinearDensityUnit>

Specified by:

toSparse in interface MutableDoubleVectorInterface<LinearDensityUnit>

Specified by:

toSparse in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

MutableDoubleVector<U>; sparse version of this DoubleVector

get

public final LinearDensity get(int index)
                        throws ValueException

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

Specified by:

get in interface DoubleVectorInterface<LinearDensityUnit>

Overrides:

get in class MutableDoubleVector.Rel<LinearDensityUnit>

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())

copy

public final MutableLinearDensityVector copy()

Create a deep copy of this MutableDoubleVector.

Specified by:

copy in interface MutableDoubleVectorInterface<LinearDensityUnit>

Specified by:

copy in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

DoubleVector<U>; deep copy of this MutableDoubleVector

plus

public final LinearDensityVector plus(LinearDensityVector rel)
                               throws ValueException

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

Parameters:

rel - the right operand

Returns:

the addition of this vector and the operand

Throws:

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

minus

public final LinearDensityVector minus(LinearDensityVector rel)
                                throws ValueException

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

Parameters:

rel - the right operand

Returns:

the subtraction of this vector and the operand

Throws:

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

times

public final LinearDensityVector times(LinearDensityVector rel)
                                throws ValueException

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.

Parameters:

rel - the right operand

Returns:

the multiplication of this vector and the operand

Throws:

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

divide

public final LinearDensityVector divide(LinearDensityVector rel)
                                 throws ValueException

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.

Parameters:

rel - the right operand

Returns:

the division of this vector and the operand

Throws:

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

plus

public final LinearDensityVector plus(MutableLinearDensityVector rel)
                               throws ValueException

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

Parameters:

rel - the right operand

Returns:

the addition of this vector and the operand

Throws:

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

minus

public final LinearDensityVector minus(MutableLinearDensityVector rel)
                                throws ValueException

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

Parameters:

rel - the right operand

Returns:

the subtraction of this vector and the operand

Throws:

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

times

public final LinearDensityVector times(MutableLinearDensityVector rel)
                                throws ValueException

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.

Parameters:

rel - the right operand

Returns:

the multiplication of this vector and the operand

Throws:

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

divide

public final LinearDensityVector divide(MutableLinearDensityVector rel)
                                 throws ValueException

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.

Parameters:

rel - the right operand

Returns:

the division of this vector and the operand

Throws:

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

abs

public final MutableLinearDensityVector abs()

Set the value(s) to their absolute value.

Specified by:

abs in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

abs in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

T; the modified T

acos

public final MutableLinearDensityVector acos()

Set the value(s) to the arc cosine of the value(s); the resulting angle is in the range 0.0 through pi.

Specified by:

acos in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

acos in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

T; the modified T

asin

public final MutableLinearDensityVector asin()

Set the value(s) to the arc sine of the value(s); the resulting angle is in the range -pi/2 through pi/2.

Specified by:

asin in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

asin in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

T; the modified T

atan

public final MutableLinearDensityVector atan()

Set the value(s) to the arc tangent of the value(s); the resulting angle is in the range -pi/2 through pi/2.

Specified by:

atan in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

atan in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

T; the modified T

cbrt

public final MutableLinearDensityVector cbrt()

Set the value(s) to the(ir) cube root.

Specified by:

cbrt in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

cbrt in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

T; the modified T

ceil

public final MutableLinearDensityVector ceil()

Set the value(s) to the smallest (closest to negative infinity) value(s) that are greater than or equal to the argument and equal to a mathematical integer.

Specified by:

ceil in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

ceil in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

T; the modified T

cos

public final MutableLinearDensityVector cos()

Set the value(s) to the trigonometric cosine of the value(s).

Specified by:

cos in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

cos in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

T; the modified T

cosh

public final MutableLinearDensityVector cosh()

Set the value(s) to the hyperbolic cosine of the value(s).

Specified by:

cosh in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

cosh in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

T; the modified T

exp

public final MutableLinearDensityVector exp()

Set the value(s) to Euler's number e raised to the power of the value(s).

Specified by:

exp in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

exp in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

T; the modified T

expm1

public final MutableLinearDensityVector expm1()

Set the value(s) to Euler's number e raised to the power of the value(s) minus 1 (e^x - 1).

Specified by:

expm1 in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

expm1 in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

T; the modified T

floor

public final MutableLinearDensityVector floor()

Set the value(s) to the largest (closest to positive infinity) value(s) that are less than or equal to the argument and equal to a mathematical integer.

Specified by:

floor in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

floor in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

T; the modified T

log

public final MutableLinearDensityVector log()

Set the value(s) to the natural logarithm (base e) of the value(s).

Specified by:

log in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

log in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

T; the modified T

log10

public final MutableLinearDensityVector log10()

Set the value(s) to the base 10 logarithm of the value(s).

Specified by:

log10 in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

log10 in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

T; the modified T

log1p

public final MutableLinearDensityVector log1p()

Set the value(s) to the natural logarithm of the sum of the value(s) and 1.

Specified by:

log1p in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

log1p in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

T; the modified T

pow

public final MutableLinearDensityVector pow(double x)

Set the value(s) to the value(s) raised to the power of the argument.

Specified by:

pow in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

pow in class MutableDoubleVector.Rel<LinearDensityUnit>

Parameters:

x - double; the value to use as the power

Returns:

T; the modified T

rint

public final MutableLinearDensityVector rint()

Set the value(s) to the value(s) that are closest in value to the argument and equal to a mathematical integer.

Specified by:

rint in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

rint in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

T; the modified T

round

public final MutableLinearDensityVector round()

Set the value(s) to the closest long to the argument with ties rounding up.

Specified by:

round in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

round in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

T; the modified T

signum

public final MutableLinearDensityVector signum()

Set the value(s) to the signum function of the value(s); zero if the argument is zero, 1.0 if the argument is greater than zero, -1.0 if the argument is less than zero.

Specified by:

signum in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

signum in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

T; the modified T

sin

public final MutableLinearDensityVector sin()

Set the value(s) to the trigonometric sine of the value(s).

Specified by:

sin in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

sin in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

T; the modified T

sinh

public final MutableLinearDensityVector sinh()

Set the value(s) to the hyperbolic sine of the value(s).

Specified by:

sinh in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

sinh in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

T; the modified T

sqrt

public final MutableLinearDensityVector sqrt()

Set the value(s) to the correctly rounded positive square root of the value(s).

Specified by:

sqrt in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

sqrt in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

T; the modified T

tan

public final MutableLinearDensityVector tan()

Set the value(s) to the trigonometric tangent of the value(s).

Specified by:

tan in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

tan in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

T; the modified T

tanh

public final MutableLinearDensityVector tanh()

Set the value(s) to the hyperbolic tangent of the value(s).

Specified by:

tanh in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

tanh in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

T; the modified T

toDegrees

public final MutableLinearDensityVector toDegrees()

Set the value(s) to approximately equivalent angle(s) measured in degrees.

Specified by:

toDegrees in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

toDegrees in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

T; the modified T

toRadians

public final MutableLinearDensityVector toRadians()

Set the value(s) to approximately equivalent angle(s) measured in radians.

Specified by:

toRadians in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

toRadians in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

T; the modified T

inv

public final MutableLinearDensityVector inv()

Set the value(s) to the complement (1.0/x) of the value(s).

Specified by:

inv in interface MathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

inv in class MutableDoubleVector.Rel<LinearDensityUnit>

Returns:

T; the modified T

multiplyBy

public final MutableLinearDensityVector multiplyBy(double constant)

Scale the value(s) by a factor.

Specified by:

multiplyBy in interface DoubleMathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

multiplyBy in class MutableDoubleVector.Rel<LinearDensityUnit>

Parameters:

constant - double; the multiplier

Returns:

T; the modified T

divideBy

public final MutableLinearDensityVector divideBy(double constant)

Scale the value(s) by the inverse of a factor; i.e. a divisor.

Specified by:

divideBy in interface DoubleMathFunctions<MutableDoubleVector.Rel<LinearDensityUnit>>

Overrides:

divideBy in class MutableDoubleVector.Rel<LinearDensityUnit>

Parameters:

constant - double; the divisor

Returns:

T; the modified T