Struct ValidationParams 

#[non_exhaustive]
pub struct ValidationParams {
    pub line_tol_rel: f32,
    pub line_min_members: usize,
    pub local_h_tol_rel: f32,
    pub use_step_aware: bool,
    pub step_deviation_thresh_rel: f32,
    pub edge_shape: Option<EdgeShapeParams>,
}

Tolerances for the validation pass.

All spatial tolerances are expressed as ratios of either the caller-supplied global cell_size or — when use_step_aware is set — the per-corner local step derived from labelled grid neighbours.

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.

line_tol_rel: f32

Straight-line fit collinearity tolerance (fraction of the per-corner scale).

line_min_members: usize

Minimum members required to fit a line / column.

local_h_tol_rel: f32

Local-H prediction tolerance (fraction of the per-corner scale).

use_step_aware: bool

When true, line and local-H thresholds use a per-corner local step computed from labelled grid neighbours via central or one-sided finite differences ((step_u + step_v) / 2). Corners without enough labelled neighbours fall back to the global cell_size.

Set this when the grid is non-uniform in pixel space — perspective foreshortening, radial distortion, or rectified- then-rasterised images. Has no effect on uniform grids.

step_deviation_thresh_rel: f32

When > 0 and use_step_aware is set, an additional flag fires for corners whose local step deviates from the labelled- set median by more than step_deviation_thresh_rel (relative). E.g. 0.5 flags corners whose step is < 1/(1+0.5) of the median or > (1+0.5)× the median.

Combined with line flags via the existing attribution rules (rule 4: step-deviation flag + ≥ 1 line flag → outlier). Set to 0.0 to disable.

edge_shape: Option<EdgeShapeParams>

Optional final-gate checks for local square-grid edge shape.

Disabled by default to preserve the conservative grow-time validator. Enable this only for final precision gates that may remove labels or refuse the whole detection.

Implementations

impl ValidationParams

pub fn new( line_tol_rel: f32, line_min_members: usize, local_h_tol_rel: f32, ) -> Self

Construct fully-specified core tolerances. Step-aware mode is off by default; call with_step_aware to enable it.

pub fn with_step_aware(self, deviation_thresh_rel: f32) -> Self

Enable per-corner step-aware thresholds. Pass deviation_thresh_rel = 0.0 for thresholds-only without the extra step-deviation flag.

pub fn with_line_tol_rel(self, value: f32) -> Self

Builder-style override for Self::line_tol_rel. Set to f32::INFINITY to disable the line-collinearity check.

pub fn with_local_h_tol_rel(self, value: f32) -> Self

Builder-style override for Self::local_h_tol_rel. Set to f32::INFINITY to disable the local-H residual check.

pub fn with_edge_length_band_rel(self, _value: f32) -> Self

Builder-style no-op kept for facade compatibility.

The advanced validator has no unconditional edge-length-band gate (the historical generic validate did; the advanced validator replaces it with the opt-in Self::with_edge_shape_gate). This builder accepts the value so callers that disable validation by pushing every tolerance to f32::INFINITY keep compiling and keep their intent — there is simply no band gate to widen here. To disable the validator entirely, set line_tol_rel and local_h_tol_rel to f32::INFINITY and leave the edge-shape gate off (the default).

pub fn with_edge_shape_gate(self, edge_shape: EdgeShapeParams) -> Self

Enable local edge-shape validation for final labelled-grid precision gates.

Trait Implementations

impl Clone for ValidationParams

fn clone(&self) -> ValidationParams

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ValidationParams

impl Debug for ValidationParams

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

Formats the value using the given formatter.

impl Default for ValidationParams

fn default() -> Self

Returns the “default value” for a type.