AutoMovie API
    Preparing search index...

    Function refineRecoveryEpipolarModel

    • Refine a calibrated consensus candidate with at most three inlier refits. Each fixed-subset optimizer must terminate, and the final inlier population must stabilize within this declared refit budget. A changed subset never inherits a previous local convergence claim.

      Parameters

      • matrix: readonly number[]
      • initialScore: { indices: number[]; medianPx: number | null; p90Px: number | null }
        • indices: number[]

          Original correspondence ordinals passing the declared residual gate, in stable input order.

        • medianPx: number | null

          Median accepted residual in pixels, or null for an empty accepted population.

        • p90Px: number | null

          Ninetieth-percentile accepted residual in pixels, or null for an empty accepted population.

      • firstPoints: readonly (readonly [number, number])[]
      • secondPoints: readonly (readonly [number, number])[]
      • first: { inverse: number[]; matrix: number[] }
        • inverse: number[]

          Analytic inverse of the supplied pinhole K, mapping pixel homogeneous coordinates to camera rays.

        • matrix: number[]

          Row-major 3 by 3 supplied pinhole intrinsic matrix K in the resident pixel-centre chart.

      • second: { inverse: number[]; matrix: number[] }
        • inverse: number[]

          Analytic inverse of the supplied pinhole K, mapping pixel homogeneous coordinates to camera rays.

        • matrix: number[]

          Row-major 3 by 3 supplied pinhole intrinsic matrix K in the resident pixel-centre chart.

      • policy: IAutoMovieRecoveryCameraPolicy
      • budget: IAutoMovieRecoveryCameraBudget

      Returns {
          converged: boolean;
          fits: {
              acceptedSteps: number;
              converged: boolean;
              finalCost: number;
              fundamental: number[];
              initialCost: number;
              iterations: number;
              minimumLocalDesignRatio: number;
              rotation: number[];
              termination: "gradient" | "step" | "cost" | "iteration-budget";
              translation: [number, number, number];
          }[];
          matrix: number[];
          refusal: | "optimizer-termination"
          | "inlier-refit-budget"
          | "insufficient-refined-support"
          | null;
          score: { indices: number[]; medianPx: number
          | null; p90Px: number | null };
      }

      • converged: boolean

        True only when the stated numerical termination predicate was met; it does not certify scene geometry.

      • fits: {
            acceptedSteps: number;
            converged: boolean;
            finalCost: number;
            fundamental: number[];
            initialCost: number;
            iterations: number;
            minimumLocalDesignRatio: number;
            rotation: number[];
            termination: "gradient" | "step" | "cost" | "iteration-budget";
            translation: [number, number, number];
        }[]

        Pose-refinement attempts retained in execution order, including unsuccessful termination.

      • matrix: number[]

        Row-major 3 by 3 epipolar model in the declared image charts; homogeneous scale is arbitrary.

      • refusal:
            | "optimizer-termination"
            | "inlier-refit-budget"
            | "insufficient-refined-support"
            | null

        Explicit refinement failure category, or null when the requested refinement was admitted.

      • score: { indices: number[]; medianPx: number | null; p90Px: number | null }

        Residual-gated original correspondence indices and their pixel quantiles for the current model.

        • indices: number[]

          Original correspondence ordinals passing the declared residual gate, in stable input order.

        • medianPx: number | null

          Median accepted residual in pixels, or null for an empty accepted population.

        • p90Px: number | null

          Ninetieth-percentile accepted residual in pixels, or null for an empty accepted population.