Thrown when an operation requires a GPU but the Metal backend is unavailable.
Sources include: a build with the GPU backend compiled out, a host with no
Metal-capable device, or a Metal command-queue initialisation failure at
runtime. Mapped to lucid._C.engine.GpuNotAvailable on the Python
side.
Parameters
reasonstd::stringShort human-readable explanation appended to the
"GpuNotAvailable: " prefix when building the final message.Examples
`
throw GpuNotAvailable("MLX failed to acquire default Metal device");
`Constructors
1ctor
GpuNotAvailable
void GpuNotAvailable(int reason)Construct a GpuNotAvailable error from a short human-readable reason the call site captured (e.g. "MLX failed to acquire default Metal device"). Prefixed with "GpuNotAvailable: " when formatted into what().