Enum SolverError 

pub enum SolverError {
    NonConvergence {
        iterations: usize,
        residual: f64,
        tolerance: f64,
    },
    NumericalInstability {
        iteration: usize,
        detail: String,
    },
    BudgetExhausted {
        reason: String,
        elapsed: Duration,
    },
    InvalidInput(ValidationError),
    SpectralRadiusExceeded {
        spectral_radius: f64,
        limit: f64,
        algorithm: Algorithm,
    },
    BackendError(String),
}

Primary error type for solver operations.

Variants

NonConvergence

The iterative solver did not converge within the allowed iteration budget.

Fields

iterations: usize

Number of iterations completed before the budget was exhausted.

residual: f64

Final residual norm at termination.

tolerance: f64

Target tolerance that was not reached.

NumericalInstability

A numerical instability was detected (NaN, Inf, or loss of precision).

Fields

iteration: usize

Iteration at which the instability was detected.

detail: String

Human-readable explanation.

BudgetExhausted

The compute budget (wall-time, iterations, or memory) was exhausted.

Fields

reason: String

Which budget limit was hit.

elapsed: Duration

Wall-clock time elapsed before the budget was hit.

InvalidInput(ValidationError)

The caller supplied invalid input (dimensions, parameters, etc.).

SpectralRadiusExceeded

The matrix spectral radius exceeds the threshold required by the algorithm.

Fields

spectral_radius: f64

Estimated spectral radius of the iteration matrix.

limit: f64

Maximum spectral radius the algorithm tolerates.

algorithm: Algorithm

Algorithm that detected the violation.

BackendError(String)

A backend-specific error (e.g. nalgebra or BLAS).

Trait Implementations

impl Debug for SolverError

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

Formats the value using the given formatter.

impl Display for SolverError

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

Formats the value using the given formatter.

impl Error for SolverError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<ValidationError> for SolverError

fn from(source: ValidationError) -> Self

Converts to this type from the input type.