Class SIMDRealDoubleMatrix

java.lang.Object

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

org.episteme.core.mathematics.linearalgebra.matrices.SIMDRealDoubleMatrix

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 SIMDRealDoubleMatrix
extends GenericMatrix<Real>
implements AutoCloseable

SIMD-accelerated Matrix implementation using JDK Vector API.

This matrix stores data in a flat double array and uses CPU vector instructions (AVX-512, NEON) for element-wise operations and matrix multiplication.

Since:

1.2

Author:

Silvere Martin-Michiellot, Gemini AI (Google DeepMind)

Field Summary

Fields inherited from class GenericMatrix

provider, ring, storage

Constructor Summary

Constructors

Constructor	Description
SIMDRealDoubleMatrix(int rows, int cols)
SIMDRealDoubleMatrix(int rows, int cols, double[] data)

Method Summary

Modifier and Type	Method	Description
Matrix<Real>	abs()
Matrix<Real>	acos()
Matrix<Real>	acosh()
Matrix<Real>	add(Matrix<Real> other)	Returns the sum of this matrix and another.
Matrix<Real>	asin()
Matrix<Real>	asinh()
Matrix<Real>	atan()
Matrix<Real>	atanh()
Matrix<Real>	cbrt()
void	close()
int	cols()	Returns the number of columns in this matrix.
boolean	contains(Matrix<Real> element)	Tests whether this set contains the specified element.
Matrix<Real>	cos()
Matrix<Real>	cosh()
String	description()	Returns a human-readable description of this set.
Real	determinant()	Returns the determinant of this matrix.
double	doubleMax()
double	doubleMin()
double	doubleSum()
Matrix<Real>	exp()
static SIMDRealDoubleMatrix	from(Matrix<Real> m)
Real	get(int row, int col)	Returns the element at the specified row and column.
Vector<Real>	getColumn(int col)	Returns the column at the specified index as a vector.
double[]	getInternalData()
Vector<Real>	getRow(int row)	Returns the row at the specified index as a vector.
double[]	getRowData(int row)
Ring<Real>	getScalarRing()	Returns the ring of scalars for this module.
MatrixStorage<Real>	getStorage()	Returns the underlying storage of this matrix.
Matrix<Real>	getSubMatrix(int rs, int re, int cs, int ce)	Returns a submatrix of this matrix.
Matrix<Real>	inverse()	Returns the multiplicative inverse of this matrix.
Matrix<Real>	log()
Matrix<Real>	log10()
Matrix<Real>	multiply(Matrix<Real> other)	Returns the product of this matrix and another.
Vector<Real>	multiply(Vector<Real> vector)	Multiplies this matrix by a vector.
Matrix<Real>	negate()	Returns the negation of this matrix (-this).
Matrix<Real>	one()	Returns the multiplicative identity (one element).
Matrix<Real>	powScalar(double exponent)
int	rows()	Returns the number of rows in this matrix.
Matrix<Real>	scale(double scalar)
Matrix<Real>	scale(Real scalar, Matrix<Real> element)	Scalar multiplication (r × m).
void	set(int row, int col, double val)
void	set(int row, int col, Real val)
void	setRowData(int row, double[] rowData)
Matrix<Real>	sin()
Matrix<Real>	sinh()
Matrix<Real>	sqrt()
Matrix<Real>	subtract(Matrix<Real> other)	Returns the difference of this matrix and another.
Matrix<Real>	tan()
Matrix<Real>	tanh()
Real	trace()	Returns the trace of this matrix (sum of diagonal elements).
Matrix<Real>	transpose()	Returns the transpose of this matrix.
Matrix<Real>	zero()	Returns the zero matrix of the same dimensions.

Methods inherited from class GenericMatrix

cholesky, eigen, getField, getProvider, lu, qr, svd, withProvider

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, scale, toTensor

Methods inherited from interface Monoid

isAssociative

Methods inherited from interface Ring

hasUnity

Methods inherited from interface Semiring

pow

Constructor Details

SIMDRealDoubleMatrix

public SIMDRealDoubleMatrix(int rows,
 int cols)

SIMDRealDoubleMatrix

public SIMDRealDoubleMatrix(int rows,
 int cols,
 double[] data)

Method Details

from

public static SIMDRealDoubleMatrix from(Matrix<Real> m)

close

public void close()

Specified by:

close in interface AutoCloseable

rows

public int rows()

Description copied from interface: Matrix

Returns the number of rows in this matrix.

Specified by:

rows in interface Matrix<Real>

Overrides:

rows in class GenericMatrix<Real>

cols

public int cols()

Description copied from interface: Matrix

Returns the number of columns in this matrix.

Specified by:

cols in interface Matrix<Real>

Overrides:

cols in class GenericMatrix<Real>

get

public Real get(int row,
 int col)

Description copied from interface: Matrix

Returns the element at the specified row and column.

Specified by:

get in interface Matrix<Real>

Overrides:

get in class GenericMatrix<Real>

set

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

set

public void set(int row,
 int col,
 Real val)

Overrides:

set in class GenericMatrix<Real>

abs

public Matrix<Real> abs()

sqrt

public Matrix<Real> sqrt()

log

public Matrix<Real> log()

exp

public Matrix<Real> exp()

sin

public Matrix<Real> sin()

cos

public Matrix<Real> cos()

tan

public Matrix<Real> tan()

asin

public Matrix<Real> asin()

acos

public Matrix<Real> acos()

atan

public Matrix<Real> atan()

sinh

public Matrix<Real> sinh()

cosh

public Matrix<Real> cosh()

tanh

public Matrix<Real> tanh()

asinh

public Matrix<Real> asinh()

acosh

public Matrix<Real> acosh()

atanh

public Matrix<Real> atanh()

cbrt

public Matrix<Real> cbrt()

log10

public Matrix<Real> log10()

powScalar

public Matrix<Real> powScalar(double exponent)

scale

public Matrix<Real> scale(double scalar)

doubleSum

public double doubleSum()

doubleMin

public double doubleMin()

doubleMax

public double doubleMax()

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>

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>

transpose

public Matrix<Real> 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>

subtract

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

Description copied from interface: Matrix

Returns the difference of this matrix and another.

Specified by:

subtract in interface Matrix<Real>

trace

public Real trace()

Description copied from interface: Matrix

Returns the trace of this matrix (sum of diagonal elements).

Specified by:

trace in interface Matrix<Real>

Overrides:

trace in class GenericMatrix<Real>

getSubMatrix

public Matrix<Real> getSubMatrix(int rs,
 int re,
 int cs,
 int ce)

Description copied from interface: Matrix

Returns a submatrix of this matrix.

Specified by:

getSubMatrix in interface Matrix<Real>

Overrides:

getSubMatrix in class GenericMatrix<Real>

getInternalData

public double[] getInternalData()

getRowData

public double[] getRowData(int row)

setRowData

public void setRowData(int row,
 double[] rowData)

getRow

public Vector<Real> getRow(int row)

Description copied from interface: Matrix

Returns the row at the specified index as a vector.

Specified by:

getRow in interface Matrix<Real>

Overrides:

getRow in class GenericMatrix<Real>

getColumn

public Vector<Real> getColumn(int col)

Description copied from interface: Matrix

Returns the column at the specified index as a vector.

Specified by:

getColumn in interface Matrix<Real>

Overrides:

getColumn in class GenericMatrix<Real>

determinant

public Real determinant()

Description copied from interface: Matrix

Returns the determinant of this matrix.

Specified by:

determinant in interface Matrix<Real>

Overrides:

determinant in class GenericMatrix<Real>

inverse

public Matrix<Real> 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 Vector<Real> 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>

negate

public Matrix<Real> negate()

Description copied from interface: Matrix

Returns the negation of this matrix (-this).

Specified by:

negate in interface Matrix<Real>

Overrides:

negate in class GenericMatrix<Real>

zero

public Matrix<Real> zero()

Description copied from interface: Matrix

Returns the zero matrix of the same dimensions.

Specified by:

zero in interface AbelianMonoid<Matrix<Real>>

Specified by:

zero in interface Matrix<Real>

Overrides:

zero in class GenericMatrix<Real>

Returns:

the zero element

one

public Matrix<Real> one()

Description copied from interface: Semiring

Returns the multiplicative identity (one element).

Satisfies: 1 × a = a × 1 = a for all elements a.

Specified by:

one in interface Semiring<Matrix<Real>>

Overrides:

one in class GenericMatrix<Real>

Returns:

the multiplicative identity

getStorage

public MatrixStorage<Real> getStorage()

Description copied from interface: Matrix

Returns the underlying storage of this matrix.

Specified by:

getStorage in interface Matrix<Real>

Overrides:

getStorage in class GenericMatrix<Real>

Returns:

the matrix storage

getScalarRing

public Ring<Real> getScalarRing()

Description copied from interface: Module

Returns the ring of scalars for this module.

Specified by:

getScalarRing in interface Matrix<Real>

Specified by:

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

Overrides:

getScalarRing in class GenericMatrix<Real>

Returns:

the scalar ring

scale

public Matrix<Real> scale(Real scalar,
 Matrix<Real> element)

Description copied from interface: Module

Scalar multiplication (r × m).

Specified by:

scale in interface Matrix<Real>

Specified by:

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

Overrides:

scale in class GenericMatrix<Real>

Parameters:

scalar - the scalar r ∈ R

element - the module element m ∈ M

Returns:

r × m

contains

public boolean contains(Matrix<Real> element)

Description copied from interface: Set

Tests whether this set contains the specified element.

This is the fundamental operation of a set - membership testing.

Specified by:

contains in interface Set<Matrix<Real>>

Overrides:

contains in class GenericMatrix<Real>

Parameters:

element - the element to test for membership

Returns:

true if this set contains the element, false otherwise

See Also:

• Set.isEmpty()
• invalid reference

  #size()

description

public String description()

Description copied from interface: Set

Returns a human-readable description of this set.

Examples:

• "ℝ (Real Numbers)"
• "ℤ/12ℤ (Integers modulo 12)"
• "{1, 2, 3, 4, 5}"

Specified by:

description in interface Set<Matrix<Real>>

Overrides:

description in class GenericMatrix<Real>

Returns:

a description of this set