Class NativeCPUTensorBackend

java.lang.Object

org.episteme.nativ.mathematics.tensors.backends.NativeCPUTensorBackend

All Implemented Interfaces:

TensorProvider, AlgorithmProvider, Backend, ComputeBackend, CPUBackend, NativeBackend

@AutoService({Backend.class,ComputeBackend.class,CPUBackend.class,NativeBackend.class,TensorProvider.class})
public class NativeCPUTensorBackend
extends Object
implements TensorProvider, CPUBackend, NativeBackend

Native CPU Tensor Backend using Project Panama (FFM) for native acceleration.

Attempts to load 'dnnl' (oneDNN) or 'mkl_rt' for acceleration. If not found, it falls back to Java-based off-heap operations (via NativeTensor). Implements CPUBackend and NativeBackend.

Since:

1.2

Author:

Silvere Martin-Michiellot, Gemini AI (Google DeepMind)

Constructor Summary

Constructors

Constructor	Description
NativeCPUTensorBackend()

Method Summary

Modifier and Type	Method	Description
<T> Tensor<T>	create(T[] data, int... shape)
ExecutionContext	createContext()	Creates an execution context for running operations.
String	getDescription()	Returns a description of the backend.
String	getId()	Returns the unique identifier for this backend (e.g., "javafx", "jmol", "cuda").
Map<String,String>	getMetadata()	Returns metadata about the provider's performance and capabilities.
String	getName()	Returns the display name for UI presentation.
String	getNativeLibraryName()	Returns the name of the native library this backend depends on.
int	getPriority()	Returns the execution priority (higher is better).
boolean	isAvailable()	Checks if the provider is available in the current environment.
boolean	isLoaded()	Checks if the native library is loaded and available.
<T> Tensor<T>	ones(Class<T> elementType, int... shape)
void	shutdown()	Called when the provider is no longer needed (e.g., application shutdown).
<T> Tensor<T>	zeros(Class<T> elementType, int... shape)

Methods inherited from class Object

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

Methods inherited from interface AlgorithmProvider

description, score

Methods inherited from interface Backend

getAlgorithmProviders, getStatusMessage, isExplicitlyDisabled

Methods inherited from interface ComputeBackend

createBackend

Methods inherited from interface CPUBackend

getAcceleratorType, getType, supportsComplexNumbers, supportsFloatingPoint, supportsParallelOps

Methods inherited from interface TensorProvider

getAlgorithmType

Constructor Details

NativeCPUTensorBackend

public NativeCPUTensorBackend()

Method Details

isLoaded

public boolean isLoaded()

Description copied from interface: NativeBackend

Checks if the native library is loaded and available.

Specified by:

isLoaded in interface NativeBackend

Returns:

true if the native library has been successfully loaded

getNativeLibraryName

public String getNativeLibraryName()

Description copied from interface: NativeBackend

Returns the name of the native library this backend depends on.

Specified by:

getNativeLibraryName in interface NativeBackend

Returns:

library name (e.g., "openblas", "cuda", "fftw3")

getId

public String getId()

Description copied from interface: Backend

Returns the unique identifier for this backend (e.g., "javafx", "jmol", "cuda").

Specified by:

getId in interface Backend

Specified by:

getId in interface ComputeBackend

getName

public String getName()

Description copied from interface: Backend

Returns the display name for UI presentation.

Specified by:

getName in interface AlgorithmProvider

Specified by:

getName in interface Backend

Specified by:

getName in interface TensorProvider

getDescription

public String getDescription()

Description copied from interface: Backend

Returns a description of the backend.

Specified by:

getDescription in interface Backend

Specified by:

getDescription in interface ComputeBackend

isAvailable

public boolean isAvailable()

Description copied from interface: AlgorithmProvider

Checks if the provider is available in the current environment.

Specified by:

isAvailable in interface AlgorithmProvider

Specified by:

isAvailable in interface Backend

getPriority

public int getPriority()

Description copied from interface: AlgorithmProvider

Returns the execution priority (higher is better).

Specified by:

getPriority in interface AlgorithmProvider

Specified by:

getPriority in interface Backend

createContext

public ExecutionContext createContext()

Description copied from interface: ComputeBackend

Creates an execution context for running operations.

The context should be used within a try-with-resources block to ensure proper cleanup of resources.

Specified by:

createContext in interface ComputeBackend

Returns:

new execution context

zeros

public <T> Tensor<T> zeros(Class<T> elementType,
 int... shape)

Specified by:

zeros in interface TensorProvider

ones

public <T> Tensor<T> ones(Class<T> elementType,
 int... shape)

Specified by:

ones in interface TensorProvider

create

public <T> Tensor<T> create(T[] data,
 int... shape)

Specified by:

create in interface TensorProvider

shutdown

public void shutdown()

Description copied from interface: AlgorithmProvider

Called when the provider is no longer needed (e.g., application shutdown). Use this to release local resources or close native segments.

Specified by:

shutdown in interface AlgorithmProvider

Specified by:

shutdown in interface Backend

getMetadata

public Map<String,String> getMetadata()

Description copied from interface: AlgorithmProvider

Returns metadata about the provider's performance and capabilities. This can be used for advanced matching in the ProviderSelector.

Specified by:

getMetadata in interface AlgorithmProvider

Returns:

a map of metadata keys and values