Enum OdeError 

pub enum OdeError {
    StepSizeUnderflow,
    MaxStepsExceeded(usize),
    NonFiniteState,
}

Failure modes of an adaptive integration.

Variants

StepSizeUnderflow

The step size shrank below machine epsilon while trying to meet the error tolerance — the system is too stiff for the chosen solver, or the tolerances are unattainable.

MaxStepsExceeded(usize)

The interval could not be spanned within max_steps sub-steps; carries the number of steps taken.

NonFiniteState

The system produced a non-finite (NaN or infinite) error estimate, so the state cannot be trusted and integration stopped.

The usual cause is derivatives or jacobian returning a non-finite value — for example a numerically-differenced Jacobian (crate::math::differentiate::NumericalJacobian) that could not form a column, or an evaluation that left the model’s valid range.

Why this variant exists

Before bead op-ad6h this case did not error at all: it returned Ok(()) with a NaN state, because the per-equation error fold used f64::max, which discards NaN. A wrong answer reported as success is the worst failure mode available to a solver, so it is now a distinct error rather than being folded into StepSizeUnderflow, which would have named the wrong cause.

Trait Implementations

impl Clone for OdeError

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OdeError

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

Formats the value using the given formatter.

impl Display for OdeError

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

Formats the value using the given formatter.

impl Error for OdeError

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 PartialEq for OdeError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for OdeError