NextControl Linear Algebra/dev.nextftc.linalg/DynamicMatrix

DynamicMatrix

open class DynamicMatrix(simple: SimpleMatrix)(source)

Represents a matrix of doubles with dynamic (runtime-checked) dimensions. Internally represented as a SimpleMatrix from EJML.

Inheritors

Constructors

constructor(simple: SimpleMatrix)

constructor(data: Array<DoubleArray>)

Constructor to create a DynamicMatrix from a 2D array.

constructor(data: Collection<Collection<Double>>)

Constructor to create a DynamicMatrix from a list of lists.

Types

object Companion

Properties

@get:JvmName(name = "inverse")

val inverse: DynamicMatrix

The inverse of this matrix. The matrix must be square and invertible. If the matrix is not square, use pseudoInverse instead.

@get:JvmName(name = "norm")

val norm: Double

Returns the Frobenius norm of this matrix. The Frobenius norm is the square root of the sum of squares of all elements.

val numColumns: Int

The number of columns in the matrix.

val numRows: Int

The number of rows in the matrix.

@get:JvmName(name = "pseudoInverse")

val pseudoInverse: DynamicMatrix

The pseudo-inverse of this matrix. The matrix must be square and invertible.

val size: Pair<Int, Int>

The size of the matrix.

@get:JvmName(name = "transpose")

val transpose: DynamicMatrix

The transpose of this matrix.

Functions

fun column(n: Int): DynamicMatrix

Returns the nth column of the matrix.

open fun copy(): DynamicMatrix

Returns a copy of this matrix.

fun diagonals(): DynamicMatrix

Returns the diagonal elements of this matrix.

open operator fun div(scalar: Double): DynamicMatrix

open operator fun div(scalar: Number): DynamicMatrix

Divides this matrix by a scalar.

open operator override fun equals(other: Any?): Boolean

fun exp(): DynamicMatrix

Computes the matrix exponential of this matrix, using the Padé approximant.

operator fun get(i: Int, j: Int): Double

Returns the element at the given indices.

open override fun hashCode(): Int

fun ldlt(): LDLTDecomposition

Returns the LDLT decomposition of this matrix. Only works for symmetric matrices.

fun llt(): LLTDecomposition

Returns the LLT (Cholesky) decomposition of this matrix. Only works for symmetric, positive-definite matrices. Provides in-place rank-1 update/downdate methods.

fun lu(): LUDecomposition

Returns the LU decomposition of this matrix.

operator fun minus(other: DynamicMatrix): DynamicMatrix

Subtracts another matrix from this matrix. The matrices must have the same dimensions.

operator fun plus(other: DynamicMatrix): DynamicMatrix

Adds another matrix to this matrix. The matrices must have the same dimensions.

fun qr(): QRDecomposition

Returns the QR decomposition of this matrix.

fun row(n: Int): DynamicMatrix

Returns the nth row of the matrix.

operator fun set(i: Int, j: Int, value: Double)

Sets the element at the given indices to the given value.

fun slice(startRow: Int, endRow: Int, startCol: Int, endCol: Int): DynamicMatrix

Returns a submatrix of this matrix.

fun solve(other: DynamicMatrix): DynamicMatrix

operator fun times(other: DynamicMatrix): DynamicMatrix

Multiplies this matrix by another matrix. The number of columns in this matrix must match the number of rows in the other matrix.

open operator fun times(scalar: Double): DynamicMatrix

open operator fun times(scalar: Number): DynamicMatrix

Multiplies this matrix by a scalar.

fun <R : Nat, C : Nat> toSizedMatrix(rows: R, cols: C): Matrix<R, C>

Returns a Matrix with the same dimensions as this matrix. The dimensions are checked at runtime.

open override fun toString(): String

open operator fun unaryMinus(): DynamicMatrix

Returns the matrix with all elements negated. This is equivalent to multiplying the matrix by -1.