Struct ScaleTiers 

pub struct ScaleTiers(pub Vec<ScaleTier>);

An ordered set of scale tiers for multi-scale adaptive detection.

Each tier runs one full detection pass (fit + decode + projective centers). Results from all tiers are merged with size-consistency-aware dedup, then global filter, completion, and final H refit run once on the merged pool.

Use the preset constructors for common scenarios:

• ScaleTiers::four_tier_wide — 8–220 px, full range (27:1 ratio)
• ScaleTiers::two_tier_standard — 14–100 px, moderate variation (7:1)
• ScaleTiers::single — single-pass equivalent, no merge overhead
• ScaleTiers::from_detected_radii — built from a scale-probe result

See crate::Detector::detect_adaptive and crate::Detector::detect_multiscale.

Tuple Fields

0: Vec<ScaleTier>

Implementations

impl ScaleTiers

pub fn four_tier_wide() -> Self

Four overlapping tiers covering 8–220 px (27:1 diameter ratio).

Tier boundaries: [8,24], [20,60], [50,130], [110,220] px. Each tier has ratio ≤ 3:1. Overlapping boundaries ensure markers in the 20–24, 50–60, and 110–130 px range are detected by two tiers.

Use when marker apparent size is unknown or spans a very wide range.

pub fn two_tier_standard() -> Self

Two overlapping tiers covering 14–100 px (~7:1 diameter ratio).

Tier boundaries: [14,42], [36,100] px. Faster than four_tier_wide for moderate scale variation.

pub fn single(prior: MarkerScalePrior) -> Self

Single tier wrapping the given prior — no multi-scale overhead.

Equivalent to single-pass detection. Use when marker scale is approximately known.

pub fn from_detected_radii(probe_radii: &[f32]) -> Self

Construct tiers from dominant code-band radii estimated by the scale probe.

Clusters probe_radii into groups where max/min ≤ 3.0, converts each cluster to an outer-ring diameter estimate (probe radii land in the code band at ~0.8× the outer ring radius), and pads each tier by ±30 %.

Falls back to single(MarkerScalePrior::default()) when probe_radii is empty or contains no finite positive values.

pub fn tiers(&self) -> &[ScaleTier]

Access the ordered tier list.

Trait Implementations

impl Clone for ScaleTiers

fn clone(&self) -> ScaleTiers

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ScaleTiers

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ScaleTiers

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ScaleTiers

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

where __S: Serializer,

Serialize this value into the given Serde serializer.