KernelCompilationError

class brainevent.KernelCompilationError

Raised when a kernel fails to compile on the target backend.

This exception indicates that the backend is available but the kernel source could not be compiled, for example due to unsupported operations, shape mismatches, or backend-specific limitations.

Parameters:

message (str) – A human-readable description of the compilation failure, including the backend name and the underlying error details.

See also

KernelNotAvailableError

Raised when the backend itself is missing.

KernelExecutionError

Raised when a compiled kernel fails at runtime.

Notes

Compilation errors are backend-specific. For example, Pallas kernels may fail if unsupported JAX operations (like dynamic_slice on Triton) are used, while Warp kernels may fail on type mismatches.

Examples

>>> from brainevent._error import KernelCompilationError
>>> raise KernelCompilationError(
...     "Pallas kernel compilation failed: dynamic_slice not supported on Triton"
... )