///|
/// Bounded, reproducible consensus search in ground metres. Trial counts are
/// computational budgets, rather than statistical confidence guarantees.
pub struct RobustFitOptions {
  inlier_threshold_m : Double
  min_inlier_ratio : Double
  max_trials : Int32
  seed : Int32
} derive(Debug)

///|
pub extend RobustFitOptions with @debug.Debug::{to_repr}

///|
pub fn RobustFitOptions::new(
  inlier_threshold_m~ : Double = 0.05,
  min_inlier_ratio~ : Double = 0.6,
  max_trials~ : Int32 = 512,
  seed~ : Int32 = 1,
) -> RobustFitOptions raise @types.GroundError {
  if !@types.is_finite(inlier_threshold_m) ||
    inlier_threshold_m <= 0.0 ||
    !@types.is_finite(min_inlier_ratio) ||
    min_inlier_ratio <= 0.0 ||
    min_inlier_ratio > 1.0 ||
    max_trials < 1 ||
    max_trials > 4096 ||
    seed < 1 {
    raise @types.InvalidInput("invalid robust calibration options")
  }
  { inlier_threshold_m, min_inlier_ratio, max_trials, seed, }
}

///|
/// Validated calibration and diagnostics in the original control-pair order.
/// Residuals are forward ground distances conditional on the fixed camera.
pub struct RobustCalibration {
  priv calibration_value : GroundCalibration
  priv mask_value : Array[Bool]
  priv errors_value : Array[Double]
  priv inlier_count_value : Int32
  priv trials_value : Int32
  priv valid_hypotheses_value : Int32
  priv refinement_steps_value : Int32
}

///|
pub fn RobustCalibration::calibration(
  self : RobustCalibration,
) -> GroundCalibration {
  self.calibration_value
}

///|
pub fn RobustCalibration::inlier_mask(self : RobustCalibration) -> Array[Bool] {
  self.mask_value.copy()
}

///|
pub fn RobustCalibration::control_errors_m(
  self : RobustCalibration,
) -> Array[Double] {
  self.errors_value.copy()
}

///|
pub fn RobustCalibration::inlier_count(self : RobustCalibration) -> Int32 {
  self.inlier_count_value
}

///|
/// Draws attempted, including degenerate or repeated subsets.
pub fn RobustCalibration::trials_run(self : RobustCalibration) -> Int32 {
  self.trials_value
}

///|
/// Candidates solved, passing the complete ROI policy, with finite residuals.
pub fn RobustCalibration::valid_hypotheses(self : RobustCalibration) -> Int32 {
  self.valid_hypotheses_value
}

///|
/// Refit-and-reclassify passes, including the pass establishing a fixed mask.
pub fn RobustCalibration::refinement_steps(self : RobustCalibration) -> Int32 {
  self.refinement_steps_value
}