Struct HomographyQuality 

#[non_exhaustive]
pub struct HomographyQuality<F: Float = f32> {
    pub max_singular_value: F,
    pub min_singular_value: F,
    pub condition: F,
    pub determinant: F,
}

Numerical quality of a homography matrix.

Computed from the SVD of the 3×3 matrix H. Use these fields to gate downstream consumers (mesh cells, validators) against degenerate solutions: a near-singular H arises when the source or destination quad has three near-collinear points and would lead to large re-projection error away from the fitted points.

condition is a unitless ratio; the other two are in the same units as H’s entries.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

max_singular_value: F

Largest singular value of H.

min_singular_value: F

Smallest singular value of H. Approaches zero as the source or destination quad degenerates (three collinear points).

condition: F

Condition number max_singular_value / min_singular_value. Healthy homographies for calibration targets sit below ~100; values above ~10⁴ indicate the fit is dominated by noise on the smallest principal direction.

determinant: F

Determinant of H. Sign indicates orientation; |det| decays to zero as the map becomes singular.

Implementations

impl<F: Float> HomographyQuality<F>

pub fn from_homography(h: &Homography<F>) -> Self

Compute quality from a homography matrix.

pub fn is_ill_conditioned(&self, min_singular_value_threshold: F) -> bool

true when min_singular_value < threshold. Useful as a single boolean gate for mesh::from_corners_with_min_singular_value and similar opt-in conditioning checks.

Trait Implementations

impl<F: Clone + Float> Clone for HomographyQuality<F>

fn clone(&self) -> HomographyQuality<F>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<F: Debug + Float> Debug for HomographyQuality<F>

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

Formats the value using the given formatter.

impl<F: Copy + Float> Copy for HomographyQuality<F>