Enum SubstrateError 

pub enum SubstrateError {
    SingularMatrix {
        size: usize,
        det: f64,
    },
    StabilizationFailed {
        size: usize,
        ridge: f64,
    },
    DimensionMismatch {
        expected: usize,
        actual: usize,
    },
}

Recoverable math failures surface through this enum instead of panic!.

The substrate’s runtime layers (orchestrator, ensemble, daemon, reconciler) treat every variant as a soft signal — either by retrying with regularised inputs or by gracefully degrading to a no-op so a degenerate telemetry sample never kills the daemon process.

Lives in shivya-hodge (Layer 0) because both the discrete-exterior-calculus operators and the higher-layer matrix inverter need a shared error vocabulary; shivya-flux re-exports it so existing call sites keep working.

Variants

SingularMatrix

Covariance / precision matrix was singular at the listed size. det is the determinant at the point of failure.

Fields

size: usize

det: f64

StabilizationFailed

Even after a ridge of ridge the matrix remained ill-conditioned; the math path fell back to the identity (= maximum-entropy prior).

Fields

size: usize

ridge: f64

DimensionMismatch

Combining vectors/matrices with mismatched extents.

Fields

expected: usize

actual: usize

Trait Implementations

impl Clone for SubstrateError

fn clone(&self) -> SubstrateError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SubstrateError

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

Formats the value using the given formatter.

impl Display for SubstrateError

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

Formats the value using the given formatter.

impl Error for SubstrateError

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.