Enum CoreError 

pub enum CoreError {
    ResidualBlock(String),
    Variable(String),
    FactorLinearization(String),
    SymbolicStructure(String),
    ParallelComputation(String),
    DimensionMismatch(String),
    InvalidConstraint(String),
    LossFunction(String),
    InvalidInput(String),
}

Core module error types for optimization problems and factors

Variants

ResidualBlock(String)

Residual block operation failed

Variable(String)

Variable initialization or constraint error

FactorLinearization(String)

Factor linearization failed

SymbolicStructure(String)

Symbolic structure construction failed

ParallelComputation(String)

Parallel computation error (thread/mutex failures)

DimensionMismatch(String)

Dimension mismatch between residual/Jacobian/variables

InvalidConstraint(String)

Invalid constraint specification (bounds, fixed indices)

LossFunction(String)

Loss function error

InvalidInput(String)

Invalid input parameter or configuration

Implementations

impl CoreError

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 core 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 CoreError and the underlying error from external libraries. 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

matrix_operation()
    .map_err(|e| {
        CoreError::SymbolicStructure(
            "Failed to build sparse matrix structure".to_string()
        )
        .log_with_source(e)
    })?;

Trait Implementations

impl Clone for CoreError

fn clone(&self) -> CoreError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CoreError

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

Formats the value using the given formatter.

impl Display for CoreError

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

Formats the value using the given formatter.

impl Error for CoreError

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

fn from(source: CoreError) -> Self

Converts to this type from the input type.