Struct InnerAsOuterRecoveryConfig 

pub struct InnerAsOuterRecoveryConfig {
    pub enable: bool,
    pub ratio_threshold: f32,
    pub k_neighbors: usize,
    pub min_theta_consistency: f32,
    pub min_theta_coverage: f32,
    pub min_ring_depth: f32,
    pub refine_halfwidth_px: f32,
    pub size_gate_tolerance: f32,
}

Configuration for automatic recovery of markers where the inner edge was incorrectly fitted as the outer ellipse.

After all markers are finalized, each marker’s outer radius is compared to the median outer radius of its k nearest neighbors. A ratio well below 1.0 (see ratio_threshold) indicates the outer fit locked onto the inner ring edge. When enabled, the detector re-attempts the outer fit for flagged markers using the neighbor median radius as the corrected expected radius.

The recovery re-fit uses a tight 4 px search window (to exclude the inner ring) combined with relaxed quality gates (min_theta_consistency, min_ring_depth, refine_halfwidth_px) suited to the blurry/soft edges that typically cause inner-as-outer confusion. A post-fit size gate (size_gate_tolerance) prevents the relaxed estimator from re-locking onto the inner ring even under the relaxed thresholds.

Fields

enable: bool

Enable inner-as-outer recovery (default: true).

ratio_threshold: f32

Neighbor-radius ratio below which a marker is considered anomalous and a re-fit is attempted.

Default: 0.75. Markers with own_radius / neighbor_median < 0.75 are flagged. A value of ~0.64 is expected for an inner-as-outer confusion (inner radius ≈ 0.49 × outer radius → ratio = 0.49 / 0.77 ≈ 0.64 when inner accounts for the inner/outer ratio of the ring marker geometry).

k_neighbors: usize

Number of nearest neighbors used to compute the median outer radius.

Default: 6 (matching the hex-lattice neighbor count). Self is always excluded by passing k+1 to the neighbor function.

min_theta_consistency: f32

Minimum fraction of angular samples (rays) whose radial peak must agree with the selected hypothesis radius during the recovery re-estimation.

Lower than the production default (0.35) because blurry outer edges scatter per-θ peaks more widely. Default: 0.18.

min_theta_coverage: f32

Minimum fraction of angular rays with valid (in-bounds) samples during the recovery re-estimation. Default: 0.40.

min_ring_depth: f32

Minimum signed intensity depth at a candidate outer edge point during recovery edge collection. Lower than production (0.05) to tolerate blur-smeared intensity gradients. Default: 0.02.

refine_halfwidth_px: f32

Per-ray radius refinement half-width (pixels) during recovery. Wider than production (1.0 px) to catch the flat-topped derivative peaks that occur under blur. Default: 2.5.

size_gate_tolerance: f32

Maximum allowed fractional deviation of the recovered outer radius from the neighbor-median corrected radius: |r_recovered - r_corrected| / r_corrected ≤ size_gate_tolerance. Prevents the relaxed estimator from accepting a re-locked inner-ring fit. Default: 0.25.

Trait Implementations

impl Clone for InnerAsOuterRecoveryConfig

fn clone(&self) -> InnerAsOuterRecoveryConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InnerAsOuterRecoveryConfig

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

Formats the value using the given formatter.

impl Default for InnerAsOuterRecoveryConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for InnerAsOuterRecoveryConfig

where InnerAsOuterRecoveryConfig: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for InnerAsOuterRecoveryConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.