Class RealDoubleMatrix

java.lang.Object

org.episteme.core.mathematics.linearalgebra.matrices.GenericMatrix<Real>

org.episteme.core.mathematics.linearalgebra.matrices.RealDoubleMatrix

All Implemented Interfaces:

AutoCloseable, Matrix<Real>, AbelianGroup<Matrix<Real>>, AbelianMonoid<Matrix<Real>>, Group<Matrix<Real>>, Magma<Matrix<Real>>, Monoid<Matrix<Real>>, Ring<Matrix<Real>>, Semiring<Matrix<Real>>, Set<Matrix<Real>>, Module<Matrix<Real>, Real>

public class RealDoubleMatrix
extends GenericMatrix<Real>
implements AutoCloseable

A specialized Matrix implementation for Doubles with SIMD and Native optimization.

Since:

1.0

Author:

Silvere Martin-Michiellot, Gemini AI (Google DeepMind)

Field Summary

Fields inherited from class GenericMatrix

provider, ring, storage

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	RealDoubleMatrix(RealDoubleMatrixStorage storage)	Internal constructor.
	RealDoubleMatrix(RealDoubleMatrixStorage storage, LinearAlgebraProvider<Real> provider)	Public constructor for Providers and internal use.

Method Summary

Modifier and Type	Method	Description
Matrix<Real>	add(Matrix<Real> other)	Returns the sum of this matrix and another.
CholeskyResult<Real>	cholesky()	Computes the Cholesky decomposition of this matrix.
void	close()
static RealDoubleMatrix	diagonal(double[] data)	Creates a diagonal RealDoubleMatrix from a double array.
static RealDoubleMatrix	direct(int rows, int cols)	Creates a RealDoubleMatrix intended for direct/native usage.
EigenResult<Real>	eigen()	Computes the eigenvalue decomposition of this matrix.
DoubleBuffer	getBuffer()
RealDoubleMatrixStorage	getDoubleStorage()
Field<Real>	getField()
RealDoubleMatrix	inverse()	Returns the multiplicative inverse of this matrix.
boolean	isDirect()
LUResult<Real>	lu()	Computes the LU decomposition of this matrix.
RealDoubleMatrix	multiply(RealDoubleMatrix other)	Optimized matrix multiplication (GEMM).
Matrix<Real>	multiply(Matrix<Real> other)	Returns the product of this matrix and another.
RealDoubleVector	multiply(Vector<Real> vector)	Multiplies this matrix by a vector.
static RealDoubleMatrix	of(double[][] values)	Creates a RealDoubleMatrix from a 2D double array (Heap Storage).
static RealDoubleMatrix	of(double[] data, int rows, int cols)	Creates a RealDoubleMatrix from a flattened double array.
static RealDoubleMatrix	of(double[] data, int rows, int cols, LinearAlgebraProvider<Real> provider)
static RealDoubleMatrix	of(RealDoubleMatrixStorage storage)	Creates a RealDoubleMatrix from a specialized storage.
QRResult<Real>	qr()	Computes the QR decomposition of this matrix.
RealDoubleMatrix	scale(Real scalar)	Convenience scalar multiplication (scalar × this).
void	set(int row, int col, double value)
RealDoubleVector	solve(Vector<Real> b)
RealDoubleMatrix	subtract(RealDoubleMatrix other)
SVDResult<Real>	svd()	Computes the Singular Value Decomposition (SVD) of this matrix.
double[][]	to2DDoubleArray()	Returns the elements of this matrix as a 2D double array.
double[]	toDoubleArray()	Returns the elements of this matrix as a flattened double array.
RealDoubleMatrix	transpose()	Returns the transpose of this matrix.

Methods inherited from class GenericMatrix

cols, contains, description, determinant, get, getColumn, getProvider, getRow, getScalarRing, getStorage, getSubMatrix, negate, one, rows, scale, set, trace, withProvider, zero

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface AbelianGroup

negate, subtract

Methods inherited from interface Matrix

add, identity, inverse, isCommutative, isEmpty, isMultiplicationCommutative, map, multiply, operate, subtract, toTensor

Methods inherited from interface Monoid

isAssociative

Methods inherited from interface Ring

hasUnity

Methods inherited from interface Semiring

pow

Constructor Details

RealDoubleMatrix

protected RealDoubleMatrix(RealDoubleMatrixStorage storage)

Internal constructor.

NOTE: This constructor eagerly looks up the "best system provider" for internal element-wise and BLAS operations (like add, subtract). This is separate from the provider selected by higher-level algorithms like Benchmarks.

RealDoubleMatrix

public RealDoubleMatrix(RealDoubleMatrixStorage storage,
 LinearAlgebraProvider<Real> provider)

Public constructor for Providers and internal use.

Method Details

of

public static RealDoubleMatrix of(double[][] values)

Creates a RealDoubleMatrix from a 2D double array (Heap Storage).

Parameters:

values - the values

Returns:

the matrix

of

public static RealDoubleMatrix of(double[] data,
 int rows,
 int cols)

Creates a RealDoubleMatrix from a flattened double array. NOTE: Assumes data is already row-major.

of

public static RealDoubleMatrix of(double[] data,
 int rows,
 int cols,
 LinearAlgebraProvider<Real> provider)

direct

public static RealDoubleMatrix direct(int rows,
 int cols)

Creates a RealDoubleMatrix intended for direct/native usage.

of

public static RealDoubleMatrix of(RealDoubleMatrixStorage storage)

Creates a RealDoubleMatrix from a specialized storage.

diagonal

public static RealDoubleMatrix diagonal(double[] data)

Creates a diagonal RealDoubleMatrix from a double array.

getField

public Field<Real> getField()

Overrides:

getField in class GenericMatrix<Real>

isDirect

public boolean isDirect()

getDoubleStorage

public RealDoubleMatrixStorage getDoubleStorage()

set

public void set(int row,
 int col,
 double value)

getBuffer

public DoubleBuffer getBuffer()

toDoubleArray

public double[] toDoubleArray()

Returns the elements of this matrix as a flattened double array.

to2DDoubleArray

public double[][] to2DDoubleArray()

Returns the elements of this matrix as a 2D double array.

multiply

public Matrix<Real> multiply(Matrix<Real> other)

Description copied from interface: Matrix

Returns the product of this matrix and another.

Specified by:

multiply in interface Matrix<Real>

Overrides:

multiply in class GenericMatrix<Real>

multiply

public RealDoubleMatrix multiply(RealDoubleMatrix other)

Optimized matrix multiplication (GEMM).

add

public Matrix<Real> add(Matrix<Real> other)

Description copied from interface: Matrix

Returns the sum of this matrix and another.

Specified by:

add in interface Matrix<Real>

Overrides:

add in class GenericMatrix<Real>

subtract

public RealDoubleMatrix subtract(RealDoubleMatrix other)

scale

public RealDoubleMatrix scale(Real scalar)

Description copied from interface: Matrix

Convenience scalar multiplication (scalar × this).

Specified by:

scale in interface Matrix<Real>

Specified by:

scale in interface Module<Matrix<Real>, Real>

Parameters:

scalar - the scalar

Returns:

scalar × this

solve

public RealDoubleVector solve(Vector<Real> b)

transpose

public RealDoubleMatrix transpose()

Description copied from interface: Matrix

Returns the transpose of this matrix.

Specified by:

transpose in interface Matrix<Real>

Overrides:

transpose in class GenericMatrix<Real>

inverse

public RealDoubleMatrix inverse()

Description copied from interface: Matrix

Returns the multiplicative inverse of this matrix.

Specified by:

inverse in interface Matrix<Real>

Overrides:

inverse in class GenericMatrix<Real>

multiply

public RealDoubleVector multiply(Vector<Real> vector)

Description copied from interface: Matrix

Multiplies this matrix by a vector.

Specified by:

multiply in interface Matrix<Real>

Overrides:

multiply in class GenericMatrix<Real>

lu

public LUResult<Real> lu()

Description copied from interface: Matrix

Computes the LU decomposition of this matrix.

Specified by:

lu in interface Matrix<Real>

Overrides:

lu in class GenericMatrix<Real>

qr

public QRResult<Real> qr()

Description copied from interface: Matrix

Computes the QR decomposition of this matrix.

Specified by:

qr in interface Matrix<Real>

Overrides:

qr in class GenericMatrix<Real>

svd

public SVDResult<Real> svd()

Description copied from interface: Matrix

Computes the Singular Value Decomposition (SVD) of this matrix.

Specified by:

svd in interface Matrix<Real>

Overrides:

svd in class GenericMatrix<Real>

cholesky

public CholeskyResult<Real> cholesky()

Description copied from interface: Matrix

Computes the Cholesky decomposition of this matrix.

Specified by:

cholesky in interface Matrix<Real>

Overrides:

cholesky in class GenericMatrix<Real>

eigen

public EigenResult<Real> eigen()

Description copied from interface: Matrix

Computes the eigenvalue decomposition of this matrix.

Specified by:

eigen in interface Matrix<Real>

Overrides:

eigen in class GenericMatrix<Real>

close

public void close()

Specified by:

close in interface AutoCloseable