org.djunits.value.vdouble.matrix

Class MutableDoubleMatrix<U extends Unit<U>>

java.lang.Object

org.djunits.value.AbstractValue<U>

org.djunits.value.vdouble.matrix.DoubleMatrix<U>

org.djunits.value.vdouble.matrix.MutableDoubleMatrix<U>

Type Parameters:

U - Unit; the unit of this MutableDoubleMatrix

All Implemented Interfaces:

Serializable, MathFunctions<MutableDoubleMatrix<U>>, Value<U>, DoubleMathFunctions<MutableDoubleMatrix<U>>, ReadOnlyDoubleMatrixFunctions<U>, WriteDoubleMatrixFunctions<U>

Direct Known Subclasses:

MutableDoubleMatrix.Abs, MutableDoubleMatrix.Rel

public abstract class MutableDoubleMatrix<U extends Unit<U>>
extends DoubleMatrix<U>
implements WriteDoubleMatrixFunctions<U>, DoubleMathFunctions<MutableDoubleMatrix<U>>

MutableDoubleMatrix.

This file was generated by the djunits value classes generator, 26 jun, 2015

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

$LastChangedDate: 2015-10-04 05:23:13 +0200 (Sun, 04 Oct 2015) $, @version $Revision: 81 $, by $Author: averbraeck $, initial version 26 jun, 2015

Author:

Alexander Verbraeck, Peter Knoppers

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MutableDoubleMatrix.Abs<U extends Unit<U>>
static class	MutableDoubleMatrix.Rel<U extends Unit<U>>

Field Summary

Fields inherited from class org.djunits.value.vdouble.matrix.DoubleMatrix

data

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	MutableDoubleMatrix(U unit) Construct a new MutableDoubleMatrix.

Method Summary

Modifier and Type	Method and Description
void	assign(DoubleFunction doubleFunction) Execute a function on a cell by cell basis.
protected void	checkCopyOnWrite() Check the copyOnWrite flag and, if it is set, make a deep copy of the data and clear the flag.
protected MutableDoubleMatrix<U>	decrementByImpl(DoubleMatrix.Rel<U> rel) Decrement the corresponding values of this Relative DoubleMatrix from the values of this MutableDoubleMatrix.
abstract DoubleMatrix<U>	immutable() Make (immutable) DoubleMatrix equivalent for any type of MutableDoubleMatrix.
protected MutableDoubleMatrix<U>	incrementByImpl(DoubleMatrix.Rel<U> rel) Increment the values in this MutableDoubleMatrix by the corresponding values in a Relative DoubleMatrix.
void	normalize() Normalize the matrix, i.e.
protected MutableDoubleMatrix<U>	scaleValueByValue(double[][] factor) Scale the values in this MutableDoubleMatrix by the corresponding values in a double array.
protected void	scaleValueByValue(DoubleMatrix<?> factor) Scale the values in this MutableDoubleMatrix by the corresponding values in a DoubleMatrix.
void	set(int row, int column, DoubleScalar<U> value) Replace the value at row, column by the supplied value which is in a compatible unit.
void	setInUnit(int row, int column, double value, U valueUnit) Replace the value at row, column by the supplied value which is expressed in a supplied (compatible) unit.
void	setSI(int row, int column, double valueSI) Replace the value at row, column by the supplied value which is expressed in the standard SI unit.

Methods inherited from class org.djunits.value.vdouble.matrix.DoubleMatrix

cardinality, checkIndex, checkNonEmpty, checkSize, checkSize, columns, denseToSparse, denseToSparse, determinant, equals, getData, getInUnit, getInUnit, getSI, getValuesInUnit, getValuesInUnit, getValuesSI, hashCode, initializeDense, initializeDense, initializeSparse, initializeSparse, interpolate, interpolate, interpolate, interpolate, minus, minus, minus, minus, minus, minus, mutable, plus, plus, plus, plus, plus, plus, rows, safeGet, safeSet, sparseToDense, sparseToDense, times, times, times, times, times, times, times, times, times, times, 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.matrix.WriteDoubleMatrixFunctions

copy

Methods inherited from interface org.djunits.value.vdouble.DoubleMathFunctions

divideBy, multiplyBy

Methods inherited from interface org.djunits.value.MathFunctions

abs, acos, asin, atan, cbrt, ceil, cos, cosh, exp, expm1, floor, inv, log, log10, log1p, pow, rint, round, signum, sin, sinh, sqrt, tan, tanh, toDegrees, toRadians

Methods inherited from interface org.djunits.value.vdouble.matrix.ReadOnlyDoubleMatrixFunctions

get

Constructor Detail

MutableDoubleMatrix

protected MutableDoubleMatrix(U unit)

Construct a new MutableDoubleMatrix.

Parameters:

unit - U; the unit of the new MutableDoubleMatrix

Method Detail

immutable

public abstract DoubleMatrix<U> immutable()

Make (immutable) DoubleMatrix equivalent for any type of MutableDoubleMatrix.

Returns:

DoubleMatrix<U>; immutable version of this DoubleMatrix

checkCopyOnWrite

protected final void checkCopyOnWrite()

Check the copyOnWrite flag and, if it is set, make a deep copy of the data and clear the flag.

setSI

public final void setSI(int row,
                        int column,
                        double valueSI)
                 throws ValueException

Replace the value at row, column by the supplied value which is expressed in the standard SI unit.

Specified by:

setSI in interface WriteDoubleMatrixFunctions<U extends Unit<U>>

Parameters:

row - int; row of the value to replace

column - int; column of the value to replace

valueSI - double; the value to store (expressed in the standard SI unit)

Throws:

ValueException - when row or column out of range (row < 0 or row >= rows() or column < 0 or column >= columns())

set

public final void set(int row,
                      int column,
                      DoubleScalar<U> value)
               throws ValueException

Replace the value at row, column by the supplied value which is in a compatible unit.

Specified by:

set in interface WriteDoubleMatrixFunctions<U extends Unit<U>>

Parameters:

row - int; row of the value to replace

column - int; column of the value to replace

value - DoubleScalar<U>; the strongly typed value to store

Throws:

ValueException - when row or column out of range (row < 0 or row >= rows() or column < 0 or column >= columns())

setInUnit

public final void setInUnit(int row,
                            int column,
                            double value,
                            U valueUnit)
                     throws ValueException

Replace the value at row, column by the supplied value which is expressed in a supplied (compatible) unit.

Specified by:

setInUnit in interface WriteDoubleMatrixFunctions<U extends Unit<U>>

Parameters:

row - int; row of the value to replace

column - int; column of the value to replace

value - double; the value to store (which is expressed in valueUnit)

valueUnit - U; unit of the supplied value

Throws:

ValueException - when row or column out of range (row < 0 or row >= rows() or column < 0 or column >= columns())

assign

public final void assign(DoubleFunction doubleFunction)

Execute a function on a cell by cell basis. Note: because many functions have to act on zero cells or can generate cells with a zero value, the functions have to be applied on a dense dataset which has to be transformed back to a dense dataset if necessary.

Parameters:

doubleFunction - the function to apply

incrementByImpl

protected final MutableDoubleMatrix<U> incrementByImpl(DoubleMatrix.Rel<U> rel)
                                                throws ValueException

Increment the values in this MutableDoubleMatrix by the corresponding values in a Relative DoubleMatrix.
Only Relative values are allowed; adding an Absolute value to an Absolute value is not allowed. Adding an Absolute value to an existing Relative value would require the result to become Absolute, which is a type change that is impossible. For that operation use a static method.

Parameters:

rel - DoubleMatrix.Rel<U>; the Relative DoubleMatrix

Returns:

MutableDoubleMatrix<U>; this modified MutableDoubleMatrix

Throws:

ValueException - when the matrices do not have the same size

decrementByImpl

protected final MutableDoubleMatrix<U> decrementByImpl(DoubleMatrix.Rel<U> rel)
                                                throws ValueException

Decrement the corresponding values of this Relative DoubleMatrix from the values of this MutableDoubleMatrix.
Only Relative values are allowed; subtracting an Absolute value from a Relative value is not allowed. Subtracting an Absolute value from an existing Absolute value would require the result to become Relative, which is a type change that is impossible. For that operation use a static method.

Parameters:

rel - DoubleMatrix.Rel<U>; the Relative DoubleMatrix

Returns:

MutableDoubleMatrix<U>; this modified MutableDoubleMatrix

Throws:

ValueException - when the matrices do not have the same size

scaleValueByValue

protected final void scaleValueByValue(DoubleMatrix<?> factor)
                                throws ValueException

Scale the values in this MutableDoubleMatrix by the corresponding values in a DoubleMatrix.

Parameters:

factor - DoubleMatrix<?>; contains the values by which to scale the corresponding values in this MutableDoubleMatrix

Throws:

ValueException - when the matrices do not have the same size

scaleValueByValue

protected final MutableDoubleMatrix<U> scaleValueByValue(double[][] factor)
                                                  throws ValueException

Scale the values in this MutableDoubleMatrix by the corresponding values in a double array.

Parameters:

factor - double[][]; contains the values by which to scale the corresponding values in this MutableDoubleMatrix

Returns:

MutableDoubleMatrix<U>; this modified MutableDoubleMatrix

Throws:

ValueException - when the matrix and the array do not have the same size

normalize

public final void normalize()
                     throws ValueException

Normalize the matrix, i.e. scale the values to make the sum equal to 1.

Specified by:

normalize in interface WriteDoubleMatrixFunctions<U extends Unit<U>>

Throws:

ValueException - when the sum of the values is zero and normalization is not possible