kmath-core/space.kscience.kmath.linear/VirtualMatrix

VirtualMatrix

class VirtualMatrix<out T : Any>(val rowNum: Int, val colNum: Int, val generator: (i: Int, j: Int) -> T) : Structure2D<T> (source)

The matrix where each element is evaluated each time when is being accessed.

Constructors

constructor(rowNum: Int, colNum: Int, generator: (i: Int, j: Int) -> T)

Functions

fun <T> StructureND<T>.as1D(): Structure1D<T>

Represent a StructureND as Structure1D. Throw error in case of dimension mismatch.

fun <T> StructureND<T>.as2D(): Structure2D<T>

Represents a StructureND as Structure2D. Throws runtime error in case of dimension mismatch.

@UnstableKMathAPI

fun <T> Structure2D<T>.asColumnarData(mapping: Map<Symbol, Int>): ColumnarData<T>

A zero-copy method to represent a Structure2D as a two-column x-y data. There could more than two columns in the structure.

fun <T : Any> Matrix<T>.asVector(): Point<T>

Convert matrix to vector if it is possible.

@UnstableKMathAPI

fun <T> Structure2D<T>.asXYData(xIndex: Int = 0, yIndex: Int = 1): XYColumnarData<T, T, T>

A zero-copy method to represent a Structure2D as a two-column x-y data. There could more than two columns in the structure.

open operator override fun StructureND<Double>.div(arg: Double): DoubleBufferND

Divides an ND structure by an element of it.

open operator override fun StructureND<Double>.div(k: Number): DoubleBufferND

Division of this element by scalar.

open operator override fun StructureND<Double>.div(arg: StructureND<Double>): DoubleBufferND

Division of two elements.

open infix override fun Matrix<Double>.dot(other: Matrix<Double>): Matrix<Double>

Computes the dot product of this matrix and another one.

open infix override fun Matrix<Double>.dot(vector: Point<Double>): DoubleBuffer

Computes the dot product of this matrix and a vector.

@PerformancePitfall

open override fun elements(): Sequence<Pair<IntArray, T>>

Returns the sequence of all the elements associated by their indices.

open operator override fun get(i: Int, j: Int): T

Retrieves an element from the structure by two indices.

@PerformancePitfall

open operator override fun get(index: IntArray): T

Returns the value at the specified indices.

@PerformancePitfall

operator fun <T> StructureND<T>.get(vararg index: Int): T

Returns the value at the specified indices.

operator fun StructureND<Double>.get(vararg index: Int): Double

operator fun StructureND<Int>.get(vararg index: Int): Int

fun StructureND<Double>.getDouble(index: IntArray): Double

Optimized method to access primitive without boxing if possible

open override fun <F : StructureFeature> getFeature(type: KClass<out F>): F?

Feature is some additional structure information that allows to access it special properties or hints. If the feature is not present, null is returned.

fun StructureND<Int>.getInt(index: IntArray): Int

@PerformancePitfall(message = "Very slow on remote execution algebras")

open fun StructureND<Int>.map(transform: IntRing.(Int) -> Int): StructureND<Int>

Maps elements from one structure to another one by applying transform to them.

@PerformancePitfall(message = "Very slow on remote execution algebras")

open fun StructureND<Short>.map(transform: ShortRing.(Short) -> Short): StructureND<Short>

Maps elements from one structure to another one by applying transform to them.

open override fun StructureND<Double>.map(transform: DoubleField.(Double) -> Double): BufferND<Double>

Maps elements from one structure to another one by applying transform to them.

@PerformancePitfall(message = "Very slow on remote execution algebras")

open fun StructureND<Double>.mapIndexed(transform: DoubleField.(index: IntArray, Double) -> Double): StructureND<Double>

Maps elements from one structure to another one by applying transform to them alongside with their indices.

@PerformancePitfall(message = "Very slow on remote execution algebras")

open fun StructureND<Int>.mapIndexed(transform: IntRing.(index: IntArray, Int) -> Int): StructureND<Int>

Maps elements from one structure to another one by applying transform to them alongside with their indices.

@PerformancePitfall(message = "Very slow on remote execution algebras")

open fun StructureND<Short>.mapIndexed(transform: ShortRing.(index: IntArray, Short) -> Short): StructureND<Short>

Maps elements from one structure to another one by applying transform to them alongside with their indices.

open operator override fun Matrix<Double>.minus(other: Matrix<Double>): Matrix<Double>

Matrix subtraction

open operator override fun StructureND<Double>.minus(arg: Double): StructureND<Double>

open operator fun StructureND<Int>.minus(arg: Int): StructureND<Int>

open operator fun StructureND<Short>.minus(arg: Short): StructureND<Short>

Subtracts an element from ND structure of it.

open operator override fun StructureND<Double>.minus(arg: StructureND<Double>): DoubleBufferND

open operator fun StructureND<Int>.minus(arg: StructureND<Int>): StructureND<Int>

open operator fun StructureND<Short>.minus(arg: StructureND<Short>): StructureND<Short>

Subtraction of two elements.

fun <T> Matrix<T>.named(symbols: List<Symbol>): NamedMatrix<T>

fun <T> Matrix<T>.named(indexer: SymbolIndexer): NamedMatrix<T>

fun <T> StructureND<T>.permute(permutation: (IntArray) -> IntArray): PermutedStructureND<T>

operator fun <T : Any> Matrix<T>.~~plus~~(newFeature: MatrixFeature): MatrixWrapper<T>

open operator override fun Matrix<Double>.plus(other: Matrix<Double>): Matrix<Double>

Matrix sum

open operator override fun StructureND<Double>.plus(arg: Double): DoubleBufferND

open operator fun StructureND<Int>.plus(arg: Int): StructureND<Int>

open operator fun StructureND<Short>.plus(arg: Short): StructureND<Short>

Adds an ND structure to an element of it.

open operator override fun StructureND<Double>.plus(arg: StructureND<Double>): DoubleBufferND

open operator fun StructureND<Int>.plus(arg: StructureND<Int>): StructureND<Int>

open operator fun StructureND<Short>.plus(arg: StructureND<Short>): StructureND<Short>

Addition of two elements.

open infix fun StructureND<Double>.pow(pow: Number): StructureND<Double>

Raises this value to the power pow.

fun <T> StructureND<T>.roll(axis: Int, step: Int = 1): StructureND<T>

fun <T> StructureND<T>.roll(pair: Pair<Int, Int>, vararg others: Pair<Int, Int>): StructureND<T>

open operator override fun Matrix<Double>.times(value: Double): Matrix<Double>

Multiplies a matrix by its element.

open operator override fun StructureND<Double>.times(k: Number): DoubleBufferND

Multiplication of this element by a scalar.

open operator override fun StructureND<Double>.times(arg: StructureND<Double>): DoubleBufferND

open operator fun StructureND<Int>.times(arg: StructureND<Int>): StructureND<Int>

open operator fun StructureND<Short>.times(arg: StructureND<Short>): StructureND<Short>

Multiplies this element by scalar.

open operator fun StructureND<Double>.times(arg: Double): StructureND<Double>

open operator fun StructureND<Int>.times(arg: Int): StructureND<Int>

open operator fun StructureND<Short>.times(arg: Short): StructureND<Short>

Multiplies an ND structure by an element of it.

open fun StructureND<Int>.toBufferND(): BufferND<Int>

open fun StructureND<Short>.toBufferND(): BufferND<Short>

open override fun StructureND<Double>.toBufferND(): DoubleBufferND

fun <T : Any> Matrix<T>.transpose(): Matrix<T>

Create a virtual transposed matrix without copying anything. A.transpose().transpose() === A

open operator override fun Matrix<Double>.unaryMinus(): Matrix<Double>

open operator override fun StructureND<Int>.unaryMinus(): StructureND<Int>

open operator override fun StructureND<Short>.unaryMinus(): StructureND<Short>

open operator override fun StructureND<Double>.unaryMinus(): DoubleBufferND

The negation of this element.

open operator override fun StructureND<Double>.unaryPlus(): DoubleBufferND

open operator fun StructureND<Int>.unaryPlus(): StructureND<Int>

open operator fun StructureND<Short>.unaryPlus(): StructureND<Short>

Returns this value.

fun <T : Any> Matrix<T>.withFeature(newFeature: MatrixFeature): MatrixWrapper<T>

Add a single feature to a Matrix

fun <T : Any> Matrix<T>.withFeatures(newFeatures: Iterable<MatrixFeature>): MatrixWrapper<T>

Add a collection of features to a Matrix

Properties

open override val colNum: Int

The number of columns in this structure.

@PerformancePitfall

open val columns: List<Buffer<T>>

The buffer of columns of this structure. It gets elements from the structure dynamically.

open val dimension: Int

The count of dimensions in this structure. It should be equal to size of shape.

val generator: (i: Int, j: Int) -> T

the function that provides elements.

open val indices: ShapeIndexer

@UnstableKMathAPI

val <T : Any> Matrix<T>.origin: Matrix<T>

Return the original matrix. If this is a wrapper, return its origin. If not, this matrix. Origin does not necessary store all features.

open override val rowNum: Int

The number of rows in this structure.

@PerformancePitfall

open val rows: List<Buffer<T>>

The buffer of rows of this structure. It gets elements from the structure dynamically.

open override val shape: ShapeND

The shape of structure i.e., non-empty sequence of non-negative integers that specify sizes of dimensions of this structure.