Enum PhysicsError 

pub enum PhysicsError {
    NumericalDivergence {
        message: String,
    },
    InvalidInput {
        field: String,
        reason: String,
    },
    OutOfBounds {
        index: usize,
        max: usize,
    },
    ConvergenceFailed {
        iterations: usize,
        tolerance: f64,
        residual: f64,
    },
    MeshError {
        message: String,
    },
    MaterialError {
        message: String,
    },
    CollisionError {
        message: String,
    },
    IoError {
        message: String,
    },
    FemElementError {
        element_id: usize,
        message: String,
    },
    FemAssemblyError {
        message: String,
    },
    FemBoundaryConditionError {
        node_id: usize,
        message: String,
    },
    LbmLatticeError {
        message: String,
    },
    LbmDistributionError {
        cell_id: usize,
        message: String,
    },
    LbmStabilityError {
        parameter: String,
        value: f64,
        limit: f64,
    },
    SphKernelError {
        message: String,
    },
    SphNeighborError {
        particle_id: usize,
        message: String,
    },
    SphDensityError {
        particle_id: usize,
        density: f64,
    },
    MdForceFieldError {
        atom_types: (String, String),
        message: String,
    },
    MdIntegrationError {
        step: usize,
        message: String,
    },
    MdNeighborListError {
        message: String,
    },
    WithContext {
        source: Box<PhysicsError>,
        context: String,
    },
}

Unified error type for the physics engine.

Variants

NumericalDivergence

Solver diverged.

Fields

message: String

Description of the divergence.

InvalidInput

Invalid parameter.

Fields

field: String

Name of the field that was invalid.

reason: String

Reason it was invalid.

OutOfBounds

Index out of bounds.

Fields

index: usize

The index that was accessed.

max: usize

The exclusive upper bound.

ConvergenceFailed

Iterative solver failed to converge.

Fields

iterations: usize

Number of iterations performed.

tolerance: f64

Target tolerance.

residual: f64

Final residual achieved.

MeshError

Mesh topology error.

Fields

message: String

Description of the mesh error.

MaterialError

Invalid material state.

Fields

message: String

Description of the material error.

CollisionError

Collision detection failure.

Fields

message: String

Description of the collision error.

IoError

I/O error wrapper.

Fields

message: String

Description of the I/O error.

FemElementError

FEM element error (degenerate element, negative Jacobian, etc.)

Fields

element_id: usize

Element index.

message: String

Description.

FemAssemblyError

FEM assembly error (stiffness matrix assembly failed).

Fields

message: String

Description.

FemBoundaryConditionError

FEM boundary condition error.

Fields

node_id: usize

Node or DOF index.

message: String

Description.

LbmLatticeError

LBM lattice configuration error.

Fields

message: String

Description.

LbmDistributionError

LBM distribution function error (negative density, non-physical state).

Fields

cell_id: usize

Cell index.

message: String

Description.

LbmStabilityError

LBM stability violation (CFL, Mach number exceeded).

Fields

parameter: String

The violated parameter name.

value: f64

The value that caused the violation.

limit: f64

The allowed limit.

SphKernelError

SPH kernel error (radius too small, invalid kernel type).

Fields

message: String

Description.

SphNeighborError

SPH neighbor search error.

Fields

particle_id: usize

Particle index.

message: String

Description.

SphDensityError

SPH density computation error (negative density, tensile instability).

Fields

particle_id: usize

Particle index.

density: f64

Computed density value.

MdForceFieldError

MD force field error (missing parameters, invalid potential).

Fields

atom_types: (String, String)

Atom type pair.

message: String

Description.

MdIntegrationError

MD integration error (energy drift, temperature blowup).

Fields

step: usize

Time step at which the error occurred.

message: String

Description.

MdNeighborListError

MD neighbor list error.

Fields

message: String

Description.

WithContext

Error with additional context.

Fields

source: Box<PhysicsError>

The original error.

context: String

Additional context message.

Implementations

impl PhysicsError

pub fn with_context(self, context: impl Into<String>) -> Self

Wrap this error with additional context.

pub fn root_cause(&self) -> &PhysicsError

Get the root cause error, unwrapping all context layers.

pub fn context_chain(&self) -> Vec<&str>

Get the chain of context messages from outermost to innermost.

pub fn domain(&self) -> &'static str

Returns the domain name for this error variant.

pub fn recovery_suggestion(&self) -> &'static str

Returns a recovery suggestion for this error.

pub fn severity(&self) -> ErrorSeverity

Returns the severity level of this error.

Trait Implementations

impl Clone for PhysicsError

fn clone(&self) -> PhysicsError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PhysicsError

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

Formats the value using the given formatter.

impl Display for PhysicsError

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

Formats the value using the given formatter.

impl Error for PhysicsError

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 PhysicsError

fn eq(&self, other: &PhysicsError) -> 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 PhysicsError