///|
fn distance_direction(
  displacement : @types.Point2,
) -> (Double, @types.Point2) raise @types.GroundError {
  let scale = displacement.x.abs().max(displacement.y.abs())
  if scale == 0.0 {
    raise @types.InvalidInput(
      "distance sensitivity requires distinct represented ground endpoints",
    )
  }
  let x = sensitivity_divide(displacement.x, scale)
  let y = sensitivity_divide(displacement.y, scale)
  let norm = (x * x + y * y).sqrt()
  let distance = sensitivity_product(scale, norm)
  let direction = @types.Point2::new(
    sensitivity_divide(x, norm),
    sensitivity_divide(y, norm),
  )
  (distance, direction)
}

///|
/// Distance between two explicitly supplied already-undistorted pixels in the
/// closed ROI. Uses the existing shared parameter projection domain. A zero
/// ground displacement is rejected because the Euclidean norm has no unique
/// derivative there, including when no modes were supplied.
pub fn HomographySensitivity::distance(
  self : HomographySensitivity,
  first_pixel : @types.Point2,
  second_pixel : @types.Point2,
) -> CalibrationDistanceSensitivity raise @types.GroundError {
  let pair = self.evaluate_pair(first_pixel, second_pixel)
  let (distance_m, direction) = distance_direction(pair.displacement_m)
  let distance_responses : Array[Double] = []
  for i in 0.. CalibrationDistanceComparison raise @types.GroundError {
  let first = self.distance(first_start, first_end)
  let second = self.distance(second_start, second_end)
  let ratio = sensitivity_divide(first.distance_m, second.distance_m)
  let difference_responses : Array[Double] = []
  let ratio_responses : Array[Double] = []
  for i in 0..