AutoMovie API
    Preparing search index...

    Interface IAutoMovieRecoveryResectionTrace

    Synchronous diagnostic evidence from the unchanged robust resection path. Each event is an owned snapshot, so observer mutation cannot alter the fit. The observer accounts for any retained history; observer errors propagate.

    interface IAutoMovieRecoveryResectionTrace {
        after: IAutoMovieRecoveryResectionScore | null;
        afterPose: IAutoMovieRecoveryMapPose | null;
        before: IAutoMovieRecoveryResectionScore | null;
        beforePose: IAutoMovieRecoveryMapPose | null;
        design: IAutoMovieRecoveryResectionDesignTrace | null;
        error: string | null;
        index: number;
        phase: "proposal" | "final-refit";
        refinement:
            | {
                acceptedSteps: number;
                converged: boolean;
                finalCost: number;
                initialCost: number;
                iterations: number;
                minimumDesignRatio: number;
                pose: IAutoMovieRecoveryMapPose;
                termination: "gradient"
                | "step"
                | "cost"
                | "iteration-budget";
            }
            | null;
        refinementAttempted: boolean;
        sample: readonly number[];
        stable: boolean
        | null;
    }
    Index

    Same-population score used after refinement; absent for a failed final refit.

    afterPose: IAutoMovieRecoveryMapPose | null

    Proposal retained by local comparison, or converged final-refit pose.

    Same-population score before refinement, absent after initialization failure.

    beforePose: IAutoMovieRecoveryMapPose | null

    Qualified initializer or current best pose before optional refinement.

    Partial initializer evidence, absent for a final refit.

    error: string | null

    Declared numerical refusal text; an unexpected error instead propagates.

    index: number

    Zero-based draw number or zero-based final-refit number.

    phase: "proposal" | "final-refit"

    Proposal draw or final fixed-subset refit.

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

    Actual local report, including nonconvergence; absent if unattempted or thrown.

    Type Declaration

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

    • null
    refinementAttempted: boolean

    Whether this event actually entered the fixed-subset nonlinear solver.

    sample: readonly number[]

    Copied six sampled indices, or complete input support of a final refit.

    stable: boolean | null

    Exact final-refit membership equality; null for proposals or failed refits.