Struct TopologicalParams 

#[non_exhaustive]
pub struct TopologicalParams {
    pub axis_align_tol_rad: f32,
    pub max_axis_sigma_rad: f32,
    pub opposing_edge_ratio_max: f32,
    pub edge_length_min_rel: f32,
    pub edge_length_max_rel: f32,
    pub min_corners_for_component: usize,
    pub min_quads_per_component: usize,
    pub axis_cluster_centers: Option<[f32; 2]>,
    pub cluster_axis_tol_rad: f32,
}

Tuning knobs for the axis-driven topological pipeline.

Defaults are conservative values pinned by the crate’s regression tests. Adding new fields is non-breaking via #[non_exhaustive]; literal-construction from outside the crate goes through Self::default

• struct-update syntax or Self::new.

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.

axis_align_tol_rad: f32

Maximum angular distance, in radians, between an edge’s direction and a corner’s axis for the edge to classify as a grid edge at that corner. Default: 15° = 0.262 rad.

max_axis_sigma_rad: f32

Maximum 1σ axis uncertainty (radians) for a feature axis to be considered informative. Features whose both axes have sigma_rad ≥ max_axis_sigma_rad are excluded from Delaunay; classification skips individual axes above the threshold. Default: 0.6 ≈ 34°. sigma_rad = None is treated as informative.

opposing_edge_ratio_max: f32

Reject quads whose opposing edges differ in length by more than this factor (paper’s parallelogram test). Default: 1.5.

edge_length_min_rel: f32

Lower bound on a quad’s perimeter edge length, expressed as a fraction of the per-component median quad edge length. Quads with any edge shorter than edge_length_min_rel * component_median are rejected as “below local cell scale”. Default: 0.4. Set to 0.0 to disable the lower bound entirely.

edge_length_max_rel: f32

Upper bound on a quad’s perimeter edge length, expressed as a fraction of the per-component median quad edge length. Quads with any edge longer than edge_length_max_rel * component_median are rejected as “above local cell scale” (typically a quad formed across a missing corner). Default: 2.5. Set to +inf to disable the upper bound entirely.

min_corners_for_component: usize

Discard labelled components with fewer than this many corners. Default: 4 (one quad of four corners).

min_quads_per_component: usize

Discard connected quad-mesh components below this size. Default: 1 (keep all). Set higher to reject isolated noise quads.

axis_cluster_centers: Option<[f32; 2]>

Optional global grid-direction centers, in radians, interpreted modulo π. When Some([θ₀, θ₁]), a feature is admitted to Delaunay only if at least one of its informative axes is within Self::cluster_axis_tol_rad of one of the centers. When None, the gate is skipped.

cluster_axis_tol_rad: f32

Per-axis admission tolerance against Self::axis_cluster_centers, in radians. Only consulted when axis_cluster_centers.is_some(). Default: 16° = 0.279.

Implementations

impl TopologicalParams

pub fn new(axis_align_tol_rad: f32, max_axis_sigma_rad: f32) -> Self

Construct topological params from the two most commonly tuned knobs; the remaining fields take their defaults.

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

Builder-style override for Self::axis_align_tol_rad.

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

Builder-style override for Self::max_axis_sigma_rad.

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

Builder-style override for Self::opposing_edge_ratio_max.

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

Builder-style override for Self::edge_length_min_rel.

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

Builder-style override for Self::edge_length_max_rel.

pub fn with_edge_length_band(self, min_rel: f32, max_rel: f32) -> Self

Set both edge-length bounds in one call. Equivalent to .with_edge_length_min_rel(min_rel).with_edge_length_max_rel(max_rel).

Pass min_rel = 0.0 to disable the lower bound; pass max_rel = f32::INFINITY to disable the upper bound.

pub fn with_min_corners_for_component(self, value: usize) -> Self

Builder-style override for Self::min_corners_for_component.

pub fn with_min_quads_per_component(self, value: usize) -> Self

Builder-style override for Self::min_quads_per_component.

pub fn with_axis_cluster_centers(self, centers: [f32; 2]) -> Self

Builder-style override for Self::axis_cluster_centers. The two centers are stored as supplied; the caller is responsible for wrapping them into [0, π) if their source might emit signed angles. The internal alignment check works modulo π so either convention is accepted.

pub fn with_cluster_axis_tol_rad(self, tol_rad: f32) -> Self

Builder-style override for Self::cluster_axis_tol_rad.

Trait Implementations

impl Clone for TopologicalParams

fn clone(&self) -> TopologicalParams

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for TopologicalParams

impl Debug for TopologicalParams

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

Formats the value using the given formatter.

impl Default for TopologicalParams

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TopologicalParams

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for TopologicalParams

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for TopologicalParams

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for TopologicalParams