NextControl Linear Algebra/dev.nextftc.linalg/DynamicVector

DynamicVector

class DynamicVector : DynamicMatrix(source)

Represents a column vector of doubles with dynamic (runtime-checked) dimensions. This is essentially a DynamicMatrix with a single column.

Constructors

constructor(data: DoubleArray)

Constructor to create a DynamicVector from an array of values.

constructor(data: Collection<Double>)

Constructor to create a DynamicVector from a collection of values.

Types

object Companion

Properties

val dimension: Int

The dimension (length) of this vector.

@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 = "magnitude")

val magnitude: Double

Returns the Euclidean norm (magnitude) of this vector.

@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 override fun copy(): DynamicVector

Returns a copy of this vector.

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.

fun dot(other: DynamicVector): Double

Computes the dot product of this vector with another vector.

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.

operator fun get(i: Int): Double

Returns the element at the given index.

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 minus(other: DynamicVector): DynamicVector

Subtracts another vector from this vector.

fun normalized(): DynamicVector

Returns a normalized (unit) vector in the same direction.

operator fun plus(other: DynamicMatrix): DynamicMatrix

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

operator fun plus(other: DynamicVector): DynamicVector

Adds another vector to this vector.

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.

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

Sets the element at the given index.

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 override fun times(scalar: Double): DynamicVector

open operator override fun times(scalar: Number): DynamicVector

Multiplies this vector 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 override fun unaryMinus(): DynamicVector

Negates all elements of this vector.