Enum SolverError 

#[non_exhaustive]
pub enum SolverError {
    DimensionMismatch {
        lhs: u32,
        rhs: u32,
    },
    InvalidDimension,
    InvalidInput,
    NonFiniteInput,
    UnsupportedProblemStructure,
    SingularMatrix,
    IllConditioned,
    NumericalDomain,
    Overflow,
    WorkspaceTooSmall,
    Cancelled,
    BackendUnavailable,
    InternalInvariantViolation,
}

Allocation-free, copyable error categories shared across every Loeres crate.

Marked #[non_exhaustive]: downstream matches must include a wildcard arm, so future solvers can add categories without a breaking change.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

DimensionMismatch

Two shapes that had to agree did not. Payloads are the mismatched extents.

Fields

lhs: u32

Left-hand extent.

rhs: u32

Right-hand extent.

InvalidDimension

A single dimension was itself invalid (e.g. zero where positive required).

InvalidInput

Input violated a declared domain or problem contract.

NonFiniteInput

A floating-like input was NaN or infinite.

UnsupportedProblemStructure

The problem is well-formed but unsupported by the selected solver/profile.

SingularMatrix

The system matrix was singular under the selected solver.

IllConditioned

Conditioning exceeded the solver’s declared stability threshold.

NumericalDomain

An operation would leave the solver’s valid numerical domain — division by zero, square root of a negative, or logarithm of a non-positive value.

Overflow

A checked scalar or storage operation overflowed.

WorkspaceTooSmall

The caller-provided workspace cannot hold the required scratch state.

Cancelled

A cluster cancellation token was observed.

BackendUnavailable

An optional backend was unavailable.

InternalInvariantViolation

A library invariant was violated — a bug, surfaced as an error rather than a panic so device callers can fail closed.

Implementations

impl SolverError

pub const fn is_input_error(self) -> bool

True for malformed caller input — bad dimensions, or non-finite / otherwise invalid values supplied to a public entry point.

pub const fn is_numerical_error(self) -> bool

True for numerical failures encountered while solving.

pub const fn is_resource_error(self) -> bool

True for resource / availability failures (workspace, cancellation, backend).

Trait Implementations

impl Clone for SolverError

fn clone(&self) -> SolverError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for SolverError

impl Debug for SolverError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for SolverError

impl PartialEq for SolverError

fn eq(&self, other: &SolverError) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for SolverError