Enum LinAlgError 

pub enum LinAlgError {
    FactorizationFailed(String),
    SingularMatrix(String),
    SparseMatrixCreation(String),
    MatrixConversion(String),
    InvalidInput(String),
    InvalidState(String),
}

Linear algebra specific error types for apex-solver

Variants

FactorizationFailed(String)

Matrix factorization failed (Cholesky, QR, etc.)

SingularMatrix(String)

Singular or near-singular matrix detected

SparseMatrixCreation(String)

Failed to create sparse matrix from triplets

MatrixConversion(String)

Matrix format conversion failed

InvalidInput(String)

Invalid input provided to linear solver

InvalidState(String)

Solver in invalid state (e.g., initialized incorrectly)

Implementations

impl LinAlgError

pub fn log(self) -> Self

Log the error with tracing::error and return self for chaining

This method allows for a consistent error logging pattern throughout the linalg module, ensuring all errors are properly recorded.

Example

operation()
    .map_err(|e| e.log())?;

pub fn log_with_source<E: Debug>(self, source_error: E) -> Self

Log the error with the original source error from a third-party library

This method logs both the LinAlgError and the underlying error from external libraries (e.g., faer’s FaerError, LltError, CreationError). This provides full debugging context when errors occur in third-party code.

Arguments

• source_error - The original error from the third-party library (must implement Debug)

Example

symbolic_llt_op()
    .map_err(|e| {
        LinAlgError::FactorizationFailed(
            "Symbolic Cholesky decomposition failed".to_string()
        )
        .log_with_source(e)
    })?;

Trait Implementations

impl Clone for LinAlgError

fn clone(&self) -> LinAlgError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LinAlgError

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

Formats the value using the given formatter.

impl Display for LinAlgError

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

Formats the value using the given formatter.

impl Error for LinAlgError

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<LinAlgError> for ApexSolverError

fn from(source: LinAlgError) -> Self

Converts to this type from the input type.

impl From<LinAlgError> for OptimizerError

fn from(source: LinAlgError) -> Self

Converts to this type from the input type.