Class ProviderExecutionMode

java.lang.Object

org.episteme.core.technical.algorithm.ProviderExecutionMode

public final class ProviderExecutionMode
extends Object

Thread-local execution mode flag for provider fallback control.

In ProviderExecutionMode.Mode.NORMAL mode, providers may fall back to alternative implementations (e.g., CPU fallback when CUDA fails). In ProviderExecutionMode.Mode.BENCHMARK or ProviderExecutionMode.Mode.AUTOTUNING mode, fallbacks are disabled and failures surface as exceptions, ensuring honest performance measurements.

ProviderExecutionMode.set(Mode.BENCHMARK);
try {
    provider.multiply(a, b); // will throw if CUDA fails
} finally {
    ProviderExecutionMode.reset();
}

Since:

2.0

Author:

Silvere Martin-Michiellot, Gemini AI (Google DeepMind)

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	ProviderExecutionMode.Mode	Execution modes that control fallback behavior.

Method Summary

Modifier and Type	Method	Description
static ProviderExecutionMode.Mode	get()	Returns the current execution mode for this thread.
static boolean	isFallbackAllowed()	Returns true if the current mode allows fallback to alternative implementations.
static void	reset()	Resets the execution mode to ProviderExecutionMode.Mode.NORMAL and removes the thread-local.
static void	set(ProviderExecutionMode.Mode mode)	Sets the execution mode for this thread.

Methods inherited from class Object

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

Method Details

get

public static ProviderExecutionMode.Mode get()

Returns the current execution mode for this thread.

set

public static void set(ProviderExecutionMode.Mode mode)

Sets the execution mode for this thread.

isFallbackAllowed

public static boolean isFallbackAllowed()

Returns true if the current mode allows fallback to alternative implementations. Only ProviderExecutionMode.Mode.NORMAL permits fallbacks.

reset

public static void reset()

Resets the execution mode to ProviderExecutionMode.Mode.NORMAL and removes the thread-local.