Class NativeRealDoubleMatrixStorage

java.lang.Object

org.episteme.nativ.mathematics.linearalgebra.matrices.storage.NativeRealDoubleMatrixStorage

All Implemented Interfaces:

AutoCloseable, MatrixStorage<Real>, RealDoubleMatrixStorage, NativeSegmentProxy

public class NativeRealDoubleMatrixStorage
extends Object
implements RealDoubleMatrixStorage, NativeSegmentProxy, AutoCloseable

A dense matrix backed by off-heap native memory for 64-bit Reals.

This class provides zero-copy access for native libraries (BLAS, LAPACK) via Project Panama's Foreign Function invalid input: '&' Memory API.

Constructor Summary

Constructors

Constructor	Description
NativeRealDoubleMatrixStorage(int rows, int cols)
NativeRealDoubleMatrixStorage(int rows, int cols, Arena arena)
NativeRealDoubleMatrixStorage(MemorySegment data, int rows, int cols, Arena arena)

Method Summary

Modifier and Type	Method	Description
Arena	arena()	Returns the Arena managing the lifecycle of the segment.
NativeRealDoubleMatrixStorage	clone()	Creates a deep copy of this storage.
void	close()	Closes the storage and releases any native resources if applicable.
int	cols()	Returns the number of columns.
Real	get(int row, int col)	Returns the element at the specified position.
DoubleBuffer	getBuffer()	Returns a DoubleBuffer view of the storage data.
double	getDouble(int row, int col)	Gets the value at the specified position as a primitive double.
int	leadingDimension()
NativeRealDoubleMatrixStorage	reshape(int newRows, int newCols)
int	rows()	Returns the number of rows.
MemorySegment	segment()	Returns the underlying native memory segment.
void	set(int row, int col, Real value)	Sets the element at the specified position.
void	setAll(double[] values)
void	setDouble(int row, int col, double value)	Sets the value at the specified position as a primitive double.
long	sizeBytes()
double[]	toArray()
double[]	toDoubleArray()	Copies the underlying data to a new double array.
NativeRealDoubleMatrixStorage	transpose()

Methods inherited from class Object

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

Methods inherited from interface NativeSegmentProxy

isAlive

Methods inherited from interface RealDoubleMatrixStorage

getData

Constructor Details

NativeRealDoubleMatrixStorage

public NativeRealDoubleMatrixStorage(int rows,
 int cols,
 Arena arena)

NativeRealDoubleMatrixStorage

public NativeRealDoubleMatrixStorage(int rows,
 int cols)

NativeRealDoubleMatrixStorage

public NativeRealDoubleMatrixStorage(MemorySegment data,
 int rows,
 int cols,
 Arena arena)

Method Details

segment

public MemorySegment segment()

Description copied from interface: NativeSegmentProxy

Returns the underlying native memory segment.

Specified by:

segment in interface NativeSegmentProxy

arena

public Arena arena()

Description copied from interface: NativeSegmentProxy

Returns the Arena managing the lifecycle of the segment.

Specified by:

arena in interface NativeSegmentProxy

rows

public int rows()

Description copied from interface: MatrixStorage

Returns the number of rows.

Specified by:

rows in interface MatrixStorage<Real>

Returns:

the row count

cols

public int cols()

Description copied from interface: MatrixStorage

Returns the number of columns.

Specified by:

cols in interface MatrixStorage<Real>

Returns:

the column count

get

public Real get(int row,
 int col)

Description copied from interface: MatrixStorage

Returns the element at the specified position.

Specified by:

get in interface MatrixStorage<Real>

Parameters:

row - the row index

col - the column index

Returns:

the element at [row, col]

set

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

Description copied from interface: MatrixStorage

Sets the element at the specified position.

Specified by:

set in interface MatrixStorage<Real>

Parameters:

row - the row index

col - the column index

value - the value to set

getBuffer

public DoubleBuffer getBuffer()

Description copied from interface: RealDoubleMatrixStorage

Returns a DoubleBuffer view of the storage data.

Specified by:

getBuffer in interface RealDoubleMatrixStorage

toDoubleArray

public double[] toDoubleArray()

Description copied from interface: RealDoubleMatrixStorage

Copies the underlying data to a new double array.

Specified by:

toDoubleArray in interface RealDoubleMatrixStorage

clone

public NativeRealDoubleMatrixStorage clone()

Description copied from interface: MatrixStorage

Creates a deep copy of this storage.

Specified by:

clone in interface MatrixStorage<Real>

Overrides:

clone in class Object

Returns:

a clone of this storage

sizeBytes

public long sizeBytes()

getDouble

public double getDouble(int row,
 int col)

Description copied from interface: RealDoubleMatrixStorage

Gets the value at the specified position as a primitive double.

Specified by:

getDouble in interface RealDoubleMatrixStorage

setDouble

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

Description copied from interface: RealDoubleMatrixStorage

Sets the value at the specified position as a primitive double.

Specified by:

setDouble in interface RealDoubleMatrixStorage

setAll

public void setAll(double[] values)

toArray

public double[] toArray()

leadingDimension

public int leadingDimension()

reshape

public NativeRealDoubleMatrixStorage reshape(int newRows,
 int newCols)

transpose

public NativeRealDoubleMatrixStorage transpose()

close

public void close()

Description copied from interface: RealDoubleMatrixStorage

Closes the storage and releases any native resources if applicable.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface RealDoubleMatrixStorage