Enum AnalysisError 

pub enum AnalysisError {
    FailedToConverge {
        step: usize,
    },
    SingularSystem,
    InvalidConstraint,
    InvalidModeCount {
        requested: usize,
        free_dofs: usize,
    },
    InvalidOption {
        field: &'static str,
    },
    UnsupportedLoadSeries,
    ZeroLoadSensitivity,
    InitialStateNotInEquilibrium {
        measure: f64,
    },
    MissingSeedDirection,
    CutbacksExhausted {
        step: usize,
        attempts: usize,
        radius: f64,
        last_failure: ArcFailure,
    },
    ContinuationComplete,
    InvalidModel(ModelError),
}

Real error enum, not sentinel integers. Carries the context an OpenSees-style -1..-5 return code would otherwise leave to out-of-band documentation.

Variants

FailedToConverge

Fields

step: usize

SingularSystem

InvalidConstraint

An Integrator::DisplacementControl’s controlled DOF is fixed (not part of the free-DOF system), so there’s no equation to control.

InvalidModeCount

modal_analysis was asked for more modes than the model has free DOFs (or zero modes) — there’s no such Krylov subspace to build.

Fields

requested: usize

free_dofs: usize

InvalidOption

A configuration value is out of range, nonfinite, or not supported in combination with the rest of the analysis. field names the option in its wire-format spelling (e.g. "integrator.minRadius").

Fields

field: &'static str

UnsupportedLoadSeries

Arc-length continuation found an unfrozen LoadSeries::Path pattern (its slope isn’t valid across a load reversal or breakpoint).

ZeroLoadSensitivity

Arc-length continuation’s combined reference-load sensitivity is zero on every free equation: there is no load to continue.

InitialStateNotInEquilibrium

Arc-length continuation must start from equilibrium. measure is the force-test measure at entry (||r|| for NormUnbalance, the largest scaled component for Combined).

Fields

measure: f64

MissingSeedDirection

The first arc-length tangent is singular and no seed direction was configured to orient it.

CutbacksExhausted

Every arc-length attempt for this step failed and the radius can’t be reduced further (or the retry budget is spent). last_failure says why the final attempt failed.

Fields

step: usize

attempts: usize

radius: f64

last_failure: ArcFailure

ContinuationComplete

An arc-length stop criterion was already met; the phase is over and further steps are refused without changing any state.

InvalidModel(ModelError)

The model failed Domain::validate (for example a nodal load on a DOF no element stiffens).

Trait Implementations

impl Clone for AnalysisError

fn clone(&self) -> AnalysisError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for AnalysisError

impl Debug for AnalysisError

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

Formats the value using the given formatter.

impl PartialEq for AnalysisError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for AnalysisError