AutoMovie API
    Preparing search index...

    Function refineRecoveryCameraPose

    • Bounded local calibrated-pose least squares on a fixed correspondence subset. Soft-L1 loss has caller-supplied pixel scale. A column-scaled original Jacobian is rank-checked before a damped augmented least-squares step is solved by SVD; damping cannot repair an unobservable local parameter direction. Accepted steps update SO3 and the unit translation sphere. Termination is local only.

      Parameters

      • initial: { rotation: readonly number[]; translation: readonly [number, number, number] }
        • rotation: readonly number[]

          Row-major 3 by 3 camera rotation in the operation's declared source-to-camera convention.

        • translation: readonly [number, number, number]

          Camera translation in the operation's admitted reconstruction scale; two-view direction alone has no metric length.

      • 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: {
            lossScalePx: number;
            maxIterations: number;
            maxSweeps: number;
            minimumDesignRatio: number;
        }
        • lossScalePx: number

          Positive pixel scale of the declared robust residual loss.

        • maxIterations: number

          Explicit positive numerical iteration ceiling; exhaustion remains a reported termination, not convergence.

        • maxSweeps: number

          Explicit ceiling on Jacobi factorization sweeps; unresolved rank remains a numerical refusal.

        • minimumDesignRatio: number

          Smallest accepted normalized design singular ratio; dimensionless and independent of residual magnitude.

      Returns {
          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];
      }

      • acceptedSteps: number

        Number of candidate updates actually accepted by the objective and feasibility checks.

      • converged: boolean

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

      • finalCost: number

        The same robust objective evaluated at the last accepted pose.

      • fundamental: number[]

        Row-major 3 by 3 fundamental matrix in the declared pixel charts; homogeneous scale has no metric meaning.

      • initialCost: number

        Robust objective evaluated at the supplied initial pose under the unchanged observation policy.

      • iterations: number

        Actual numerical iterations attempted, including iterations without an accepted update.

      • minimumLocalDesignRatio: number

        Smallest admitted design singular ratio across attempted local pose updates.

      • rotation: number[]

        Row-major 3 by 3 camera rotation in the operation's declared source-to-camera convention.

      • termination: "gradient" | "step" | "cost" | "iteration-budget"

        Predicate ending refinement; iteration-budget is an incomplete solve rather than convergence.

      • translation: [number, number, number]

        Camera translation in the operation's admitted reconstruction scale; two-view direction alone has no metric length.