Enum SparseError 

pub enum SparseError {
    DimensionMismatch {
        expected: (usize, usize),
        got: (usize, usize),
        context: String,
    },
    NotSquare {
        dims: (usize, usize),
    },
    InvalidInput {
        reason: String,
    },
    StructurallySingular {
        column: usize,
    },
    NumericalSingularity {
        pivot_index: usize,
        value: f64,
    },
    AnalysisFailure {
        reason: String,
    },
    IoError {
        source: String,
        path: String,
    },
    ParseError {
        reason: String,
        path: String,
        line: Option<usize>,
    },
    MatrixNotFound {
        name: String,
    },
    SolveBeforeFactor {
        context: String,
    },
}

Errors that can occur during sparse solver operations.

Note: PartialEq is intentionally not derived because the NumericalSingularity variant contains f64, where NaN != NaN would cause subtle comparison bugs. Use matches!() for pattern-matching assertions in tests.

Variants

DimensionMismatch

Matrix dimensions are incompatible.

Fields

expected: (usize, usize)

Expected dimensions (rows, cols).

got: (usize, usize)

Actual dimensions (rows, cols).

context: String

Description of where the mismatch occurred.

NotSquare

A matrix that should be square is not.

Fields

dims: (usize, usize)

Actual dimensions (rows, cols).

InvalidInput

Input contains NaN, Inf, or other invalid floating-point values.

Fields

reason: String

Description of the invalid input.

StructurallySingular

The matrix is structurally singular (symbolic analysis detected zero diagonal).

Fields

column: usize

Zero-diagonal column index.

NumericalSingularity

Numeric factorization encountered a zero or near-zero pivot.

Fields

pivot_index: usize

Index of the singular pivot.

value: f64

The near-zero pivot value.

AnalysisFailure

An ordering or analysis algorithm failed.

Fields

reason: String

Description of the failure.

IoError

An IO operation failed (file not found, permission denied, etc.).

Fields

source: String

Error description.

path: String

File path that caused the error.

ParseError

A file could not be parsed (malformed Matrix Market, invalid JSON, etc.).

Fields

reason: String

Description of the parse failure.

path: String

File path that could not be parsed.

line: Option<usize>

Line number where parsing failed, if available.

MatrixNotFound

A named matrix was not found in the registry.

Fields

name: String

Name that was looked up.

SolveBeforeFactor

Solve was called before factor() completed.

Fields

context: String

Description of the premature solve attempt.

Trait Implementations

impl Clone for SparseError

fn clone(&self) -> SparseError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SparseError

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

Formats the value using the given formatter.

impl Display for SparseError

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

Formats the value using the given formatter.

impl Error for SparseError

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.