AutoMovie API
    Preparing search index...

    Function refineRecoveryResection

    • Refine one camera against a fixed existing 3D landmark population. Supplied intrinsics and noisy triangulated points remain fixed, so this is a conditional estimate before joint refinement. Soft-L1 weights use a complete two-coordinate residual norm, with analytic SO3/additive-t derivatives.

      Parameters

      Returns {
          acceptedSteps: number;
          converged: boolean;
          finalCost: number;
          initialCost: number;
          iterations: number;
          minimumDesignRatio: number;
          pose: IAutoMovieRecoveryMapPose;
          termination: "gradient" | "step" | "cost" | "iteration-budget";
      }

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

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

      • minimumDesignRatio: number

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

      • pose: IAutoMovieRecoveryMapPose

        Last admitted camera pose, retaining the current map's coordinate and gauge convention.

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

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