Enum NumraError 

#[non_exhaustive]
pub enum NumraError {
    Linalg(LinalgError),
    Convergence(ConvergenceError),
    InvalidInput(String),
    StepSizeTooSmall {
        h: f64,
        h_min: f64,
    },
    MaxIterations {
        iterations: usize,
        max: usize,
    },
    Stiffness {
        t: f64,
        message: String,
    },
    EventTermination {
        t: f64,
        event_index: usize,
    },
    NumericalOptim(OptimizationError),
    Ode(String),
    Optim(String),
    Ocp(String),
    Fit(String),
    Signal(String),
    LineSearch(String),
    Interp(String),
    Integrate(String),
    Special(String),
    Stats(String),
}

Errors that can occur in Numra operations.

NumraError is the workspace-wide error type into which every fallible crate’s error converts via a From<…> for NumraError impl. This lets a user write solve_ode(...)?.integrate(...)?.fit(...)? and have ? work uniformly across crate boundaries.

Variants fall into two tiers:

• Low-level numerics-failure modes from numra-core (structurally preserved): Linalg, Convergence, NumericalOptim.
• Crate-level user-facing errors (stringified, tagged by source crate): Ode, Optim, Ocp, Fit, Signal, LineSearch, Interp, Integrate, Special, Stats.

The NumericalOptim variant wraps numra-core’s OptimizationError (line-search / descent / convergence failures that happen inside algorithms regardless of which crate hosts them); the Optim variant carries numra-optim::OptimError (the optimization crate’s API-level failures: missing objective, infeasibility, unbounded, etc.). The two are distinct concerns; do not confuse them.

NumraError is #[non_exhaustive]; new variants may be added in minor releases. Match arms must include a _ => … catch-all.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Linalg(LinalgError)

Linear algebra error from numra-linalg / numra-core.

Convergence(ConvergenceError)

Convergence failure from a Newton or fixed-point iteration.

InvalidInput(String)

Invalid input that doesn’t fit a more specific variant.

StepSizeTooSmall

Step size became too small.

Fields

h: f64

h_min: f64

MaxIterations

Maximum iterations exceeded.

Fields

iterations: usize

max: usize

Stiffness

Integration reached a singularity or stiffness.

Fields

t: f64

message: String

EventTermination

Event caused termination.

Fields

t: f64

event_index: usize

NumericalOptim(OptimizationError)

Numerical-optimization failure from inside an algorithm (line search, descent, convergence). See OptimizationError.

Ode(String)

ODE solver error from numra-ode.

Optim(String)

Optimization error from numra-optim (API-level failures).

Ocp(String)

ODE-constrained-optimization error from numra-ocp.

Fit(String)

Curve-fitting error from numra-fit.

Signal(String)

Signal-processing error from numra-signal.

LineSearch(String)

Line-search error from numra-nonlinear.

Interp(String)

Interpolation error from numra-interp.

Integrate(String)

Numerical-integration (quadrature) error from numra-integrate.

Special(String)

Special-function evaluation error from numra-special.

Stats(String)

Statistics error from numra-stats.

Trait Implementations

impl Clone for NumraError

fn clone(&self) -> NumraError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NumraError

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

Formats the value using the given formatter.

impl Display for NumraError

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

Formats the value using the given formatter.

impl Error for NumraError

Available on crate feature std only.

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<ConvergenceError> for NumraError

fn from(e: ConvergenceError) -> Self

Converts to this type from the input type.

impl From<LinalgError> for NumraError

fn from(e: LinalgError) -> Self

Converts to this type from the input type.

impl From<OptimizationError> for NumraError

fn from(e: OptimizationError) -> Self

Converts to this type from the input type.

impl PartialEq for NumraError

fn eq(&self, other: &NumraError) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for NumraError