Enum OptimizerError 

pub enum OptimizerError {
    LinearSolveFailed(String),
    MaxIterationsReached {
        max_iters: usize,
    },
    TrustRegionFailure {
        radius: f64,
        min_radius: f64,
    },
    DampingFailure {
        damping: f64,
        max_damping: f64,
    },
    CostIncrease {
        old_cost: f64,
        new_cost: f64,
    },
    JacobianFailed(String),
    InvalidParameters(String),
    NumericalInstability(String),
    LinAlg(LinAlgError),
    Core(CoreError),
    Linearizer(LinearizerError),
    EmptyProblem,
    NoResidualBlocks,
    JacobiScalingCreation(String),
    JacobiScalingNotInitialized,
    UnknownLinearSolver(String),
}

Optimizer-specific error types for apex-solver

Variants

LinearSolveFailed(String)

Linear system solve failed during optimization

MaxIterationsReached

Maximum iterations reached without achieving convergence

Fields

max_iters: usize

TrustRegionFailure

Trust region radius became too small

Fields

radius: f64

min_radius: f64

DampingFailure

Damping parameter became too large (LM-specific)

Fields

damping: f64

max_damping: f64

CostIncrease

Cost increased unexpectedly when it should decrease

Fields

old_cost: f64

new_cost: f64

JacobianFailed(String)

Jacobian computation failed

InvalidParameters(String)

Invalid optimization parameters provided

NumericalInstability(String)

Numerical instability detected (NaN, Inf in cost, gradient, or parameters)

LinAlg(LinAlgError)

Linear algebra operation failed

Convention: When a LinAlgError occurs during optimization, it wraps here via ? to preserve optimizer context. This ensures the error propagates as ApexSolverError::Optimizer(OptimizerError::LinAlg(...)) at the API level, not ApexSolverError::LinearAlgebra(...).

Core(CoreError)

Core module error (problem construction, factor linearization)

Wraps errors from the core module that occur during optimization, such as symbolic structure failures or parallel computation errors.

Linearizer(LinearizerError)

Linearizer error (Jacobian assembly, symbolic structure)

Wraps errors from the linearizer module that occur during optimization, such as symbolic structure failures or variable mapping errors.

EmptyProblem

Problem has no variables to optimize

NoResidualBlocks

Problem has no residual blocks

JacobiScalingCreation(String)

Jacobi scaling matrix creation failed

JacobiScalingNotInitialized

Jacobi scaling not initialized when expected

UnknownLinearSolver(String)

Unknown or unsupported linear solver type

Trait Implementations

impl Clone for OptimizerError

fn clone(&self) -> OptimizerError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OptimizerError

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

Formats the value using the given formatter.

impl Display for OptimizerError

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

Formats the value using the given formatter.

impl Error for OptimizerError

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 OptimizerError

fn from(source: CoreError) -> 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.

impl From<LinearizerError> for OptimizerError

fn from(source: LinearizerError) -> Self

Converts to this type from the input type.

impl From<OptimizerError> for ApexSolverError

fn from(source: OptimizerError) -> Self

Converts to this type from the input type.