Struct MarkerSpec 

pub struct MarkerSpec {
    pub r_inner_expected: f32,
    pub inner_search_halfwidth: f32,
    pub inner_grad_polarity: GradPolarity,
    pub radial_samples: usize,
    pub theta_samples: usize,
    pub aggregator: AngularAggregator,
    pub min_theta_coverage: f32,
    pub min_theta_consistency: f32,
}

Marker spec in outer-normalized radius units.

NOTE: Defaults are derived from the synthetic renderer in tools/gen_synth.py and the current edge sampler semantics in ring::edge_sample::sample_edges.

In gen_synth.py the default synthetic marker uses:

• outer_radius = pitch_mm * 0.6
• inner_radius = pitch_mm * 0.4
• ring_half_thickness = outer_radius * 0.12

The edge sampler finds the boundary of the merged dark band under blur, so the expected (inner_edge / outer_edge) ratio in outer-normalized units is: r_inner_expected = (inner_radius - ring_half_thickness) / (outer_radius + ring_half_thickness)

Fields

r_inner_expected: f32

Expected inner radius as fraction of outer radius.

inner_search_halfwidth: f32

Allowed deviation in normalized radius around r_inner_expected.

inner_grad_polarity: GradPolarity

Expected sign of dI/dr at the inner edge.

radial_samples: usize

Number of radii samples per theta.

Same convention as crate::OuterEstimationConfig::radial_samples, calibrated independently for the inner estimation stage.

theta_samples: usize

Number of theta samples (rays) for inner-scale estimation.

Unlike the outer estimator (where ray count is set to edge_sample.n_rays at the call site), this value is used directly — the inner scan is not coupled to the edge-sampling resolution.

aggregator: AngularAggregator

Aggregator across theta.

Same convention as crate::OuterEstimationConfig::aggregator, applied to the inner radial profile.

min_theta_coverage: f32

Minimum fraction of theta samples required for a valid estimate.

Same convention as crate::OuterEstimationConfig::min_theta_coverage, calibrated independently for the inner estimation stage.

min_theta_consistency: f32

Minimum fraction of theta samples that must agree on the inner edge location (used as a quality gate).

Same convention as crate::OuterEstimationConfig::min_theta_consistency; the inner estimator uses a more permissive default (0.25) than the outer (0.35) because the inner edge is less anchored to a scale prior.

Kept separate from min_theta_coverage: “coverage” is about in-bounds sampling, while “consistency” is about peak agreement.

Implementations

impl MarkerSpec

pub fn search_window(&self) -> [f32; 2]

Return normalized radial search window around r_inner_expected.

Trait Implementations

impl Clone for MarkerSpec

fn clone(&self) -> MarkerSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MarkerSpec

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

Formats the value using the given formatter.

impl Default for MarkerSpec

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for MarkerSpec

where MarkerSpec: 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 MarkerSpec

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

where __S: Serializer,

Serialize this value into the given Serde serializer.