Struct GeometricError 

pub struct GeometricError {
    pub distance: f64,
    pub gradient: [f64; 3],
    pub correction: [f64; 8],
    pub description: String,
}

Geometric error information for test failures

Unlike boolean test failures, geometric errors tell you:

1. How far the state is from being valid (distance)
2. Which direction to move to become valid (gradient)
3. What the nearest valid state would be (correction)

Fields

distance: f64

Distance from expected manifold (scalar)

gradient: [f64; 3]

Gradient pointing toward valid states

This is the direction of steepest descent toward the manifold. Stored as coefficients [e1, e2, e3] for the vector part.

correction: [f64; 8]

Projected correction to nearest valid state

If you add this to the invalid state, you get the nearest valid state. Stored as full multivector coefficients.

description: String

Human-readable description of the error

Implementations

impl GeometricError

pub fn new(distance: f64, description: impl Into<String>) -> Self

Create a new geometric error

pub fn with_gradient(self, gradient: [f64; 3]) -> Self

Create error with gradient information

pub fn with_correction(self, correction: [f64; 8]) -> Self

Create error with correction information

pub fn from_multivector(error_mv: &GA3, description: impl Into<String>) -> Self

Create error from a GA3 multivector representing the error

Note: In GA3, basis blade indices use binary representation:

• 0 = scalar, 1 = e1, 2 = e2, 3 = e12, 4 = e3, 5 = e13, 6 = e23, 7 = e123

pub fn is_within_tolerance(&self, epsilon: f64) -> bool

Check if this error is within tolerance

pub fn gradient_as_ga3(&self) -> GA3

Get the gradient as a GA3 vector

pub fn correction_as_ga3(&self) -> GA3

Get the correction as a GA3 multivector

Trait Implementations

impl Clone for GeometricError

fn clone(&self) -> GeometricError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GeometricError

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GeometricError

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for GeometricError

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

Formats the value using the given formatter.

impl Error for GeometricError

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 Serialize for GeometricError

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.