Enum SimError 

pub enum SimError {
    NonFiniteValue {
        location: String,
    },
    EnergyDrift {
        drift: f64,
        tolerance: f64,
    },
    ConstraintViolation {
        name: String,
        violation: f64,
        tolerance: f64,
    },
    Config {
        message: String,
    },
    YamlParse(Error),
    Validation(ValidationErrors),
    CheckpointIntegrity,
    CheckpointNotFound(SimTime),
    Journal(String),
    Io(Error),
    Serialization(String),
    Physics(String),
    MonteCarlo(String),
    Optimization(String),
    HypothesisFalsified {
        reason: String,
        p_value: f64,
    },
}

Unified error type for all simular operations.

Design

Following Toyota’s Jidoka principle, errors are:

1. Immediately detectable (type-safe)
2. Self-documenting (descriptive variants)
3. Actionable (contain recovery hints)

Variants

NonFiniteValue

Numerical instability detected (NaN or Inf).

Fields

location: String

Location where the non-finite value was detected.

EnergyDrift

Energy conservation violated beyond tolerance.

Fields

drift: f64

Relative energy drift from initial state.

tolerance: f64

Configured tolerance threshold.

ConstraintViolation

Constraint violation detected.

Fields

name: String

Name of the violated constraint.

violation: f64

Amount of violation.

tolerance: f64

Configured tolerance.

Config

Invalid configuration parameter.

Fields

message: String

Description of the configuration error.

YamlParse(Error)

YAML parsing error.

Validation(ValidationErrors)

Validation error.

CheckpointIntegrity

Checkpoint integrity violation.

CheckpointNotFound(SimTime)

Checkpoint not found.

Journal(String)

Journal read error.

Io(Error)

File I/O error.

Serialization(String)

Serialization error.

Physics(String)

Physics engine error.

MonteCarlo(String)

Monte Carlo error.

Optimization(String)

Optimization error.

HypothesisFalsified

Hypothesis falsified.

Fields

reason: String

Reason for falsification.

p_value: f64

Statistical p-value.

Implementations

impl SimError

pub fn config(message: impl Into<String>) -> Self

Create a configuration error with a message.

pub fn serialization(message: impl Into<String>) -> Self

Create a serialization error.

pub fn journal(message: impl Into<String>) -> Self

Create a journal error.

pub fn optimization(message: impl Into<String>) -> Self

Create an optimization error.

pub fn jidoka(message: impl Into<String>) -> Self

Create a Jidoka violation error (requires immediate stop).

pub fn io(message: impl Into<String>) -> Self

Create an I/O error with a message (wraps in std::io::Error).

pub const fn is_jidoka_violation(&self) -> bool

Check if this error is a Jidoka violation (requires immediate stop).

Trait Implementations

impl Debug for SimError

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

Formats the value using the given formatter.

impl Display for SimError

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

Formats the value using the given formatter.

impl Error for SimError

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<Error> for SimError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SimError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<JidokaViolation> for SimError

fn from(v: JidokaViolation) -> Self

Converts to this type from the input type.

impl From<ValidationErrors> for SimError

fn from(source: ValidationErrors) -> Self

Converts to this type from the input type.