AutoMovie API
    Preparing search index...

    Function fitRecoveryEpipolarConsensus

    • Estimate a calibrated pixel epipolar consensus with bounded local refinement. Every proposal is projected to the supplied-calibration essential manifold before scoring. The first bounded proposals with at least eight calibrated inliers receive local refinement before comparison with the current winner; a raw score cannot bound the result of local optimization. Final re-estimation invalidates an older sampling target; any larger target resumes proposals within the same total trial budget.

      Parameters

      • 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
      • checkpoint: (completed: number, total: number) => void

      Returns {
          conditionalTrialTargetMet: boolean;
          finalReestimations: number;
          finalRefinement:
              | {
                  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;
                  };
              }
              | null;
          localRefinementRefusals: number;
          localRefinements: number;
          matrix: number[]
          | null;
          numericalRefusals: number;
          requiredTrialsAtFinalSupport: number | null;
          score: { indices: number[]; medianPx: number | null; p90Px: number | null };
          trials: number;
      }

      • conditionalTrialTargetMet: boolean

        Whether actual trials met the conditional target; this is conditional on the assumed sampling/support model.

      • finalReestimations: number

        Actual final-support reestimations, separate from sampled hypotheses.

      • finalRefinement:
            | {
                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;
                };
            }
            | null

        Last final-support refinement report, or null when no refinement was admitted.

      • localRefinementRefusals: number

        Local refinements refused by numerical or support admission.

      • localRefinements: number

        Number of local consensus refinements actually attempted.

      • matrix: number[] | null

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

      • numericalRefusals: number

        Attempted hypotheses rejected for numerical admission or degeneracy.

      • requiredTrialsAtFinalSupport: number | null

        Conditional trial requirement computed from final observed support, or null when it is not representable.

      • 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.

      • trials: number

        Actual random-sample hypotheses attempted under the caller's explicit work ceiling.