AutoMovie API
    Preparing search index...

    Finite fitted coefficients with independent convergence and observation accounting.

    interface Result {
        activeEnclosureControls: number;
        controls: (readonly [number, number, number])[];
        dataQrDiagonalRatio: number | null;
        dataRowRank: number | null;
        dependentEnclosureViolationMm: number;
        diagnostics: string[];
        fixedSupportMaximumMm: number;
        freeSupportMaximumMm: number;
        gramPivotRatio: number | null;
        hessianNonzeros: number;
        iterations: number;
        maximumLocation:
            | { fixedSupport: boolean; patch: number; u: number; v: number }
            | null;
        maximumMm: number;
        maximumRowTerms: number;
        maximumWitness:
            | {
                coefficientExpressions: {
                    constant: readonly [number, number, number];
                    terms: { id: number; weight: number }[];
                }[];
                coefficients: number[];
                constantMm: readonly [number, number, number];
                controlIds: number[];
                controlsMm: (readonly [number, number, number])[];
                fittedPointMm: readonly [number, number, number];
                globalUV: [number, number] | null;
                leafBounds: readonly [number, number, number, number] | null;
                localUV: [number, number];
                lowerMm: readonly [number, number, number];
                originalSourceFace: null;
                patch: number;
                patchId: string | null;
                reachable: {
                    absoluteWeightSum: number;
                    diagnostic: string;
                    infeasibleAtTolerance: boolean;
                    lowerMm: [number, number, number];
                    minimumDistanceMm: number;
                    terms: number;
                    upperMm: [number, number, number];
                    weightSum: number;
                };
                sampledRows: {
                    physicalJet: | {
                        directions: readonly {
                            du: number;
                            dv: number;
                            targetMm: readonly [number, number, number];
                        }[];
                    }
                    | null
                    | undefined;
                    targetMm: readonly [number, number, number];
                    u: number;
                    v: number;
                }[];
                targetMm: readonly [number, number, number];
                terms: {
                    id: number;
                    valueMm: readonly [number, number, number];
                    weight: number;
                }[];
                upperMm: readonly [number, number, number];
            }
            | null;
        objectiveRmsMm: number;
        observationRank: number
        | null;
        optimality: {
            boxSupportGap: number;
            gradientInfinity: number;
            leastSquaresConstant: number;
            normalizationOriginMm: readonly [number, number, number];
            normalizationScaleMm: number;
            objective: number;
            physicalObjectiveGapUpperMm2: number;
        };
        patchFreeSupportMaximumMm: number[];
        patchMaximumLocations: ([number, number] | null)[];
        patchMaximumMm: number[];
        physicalJetRmsMm: number;
        physicalJetRows: number;
        projectedGradient: number;
        qualified: boolean;
        rankTolerance: number;
        relationDiagnostics: {
            maximumDepth: number;
            maximumTerms: number;
            maximumWeightSumError: number;
            minimumWeight: number;
        };
        rmsMm: number;
        solve: {
            maximumDiagonal: number;
            minimumPositiveDiagonal: number
            | null;
            originalLipschitz: number;
            restarts: number;
            scaledLipschitz: number;
        };
        unknownControls: number;
        unsupportedControls: number;
    }
    Index
    activeEnclosureControls: number

    Unknown vector controls touching at least one declared enclosure coordinate.

    controls: (readonly [number, number, number])[]

    Millimetre registry in input order, preserving all fixed entries exactly.

    dataQrDiagonalRatio: number | null

    Accepted data QR diagonal ratio; neither this nor a Gram pivot is a condition number.

    dataRowRank: number | null

    Column-scaled, twice-reorthogonalized data-row rank, or null at the work limit.

    dependentEnclosureViolationMm: number

    Largest dependent-control excursion outside the original millimetre enclosure.

    diagnostics: string[]

    Unobserved controls and incomplete convergence remain explicit; rank is not certified.

    fixedSupportMaximumMm: number

    Maximum over rows supported entirely by fixed coefficients, millimetres.

    freeSupportMaximumMm: number

    Maximum over rows with positive unknown coefficient support, millimetres.

    gramPivotRatio: number | null

    Smallest accepted over largest Cholesky pivot; not a singular-value condition number.

    hessianNonzeros: number

    Actual stored sparse Hessian entries, including symmetric partners.

    iterations: number

    Actual projected-gradient iterations.

    maximumLocation:
        | { fixedSupport: boolean; patch: number; u: number; v: number }
        | null

    Generated patch and local parameters of the largest checked correspondence.

    Type Declaration

    • { fixedSupport: boolean; patch: number; u: number; v: number }
      • fixedSupport: boolean

        True when every coefficient contributing to this correspondence is fixed by external authority.

      • patch: number

        Patch identity or zero-based patch ordinal, according to this record, addressing the supplied coefficient-patch registry.

      • u: number

        Normalized u coordinate in the declared local patch or unit source chart.

      • v: number

        Normalized v coordinate in the declared local patch or unit source chart.

    • null
    maximumMm: number

    Largest supplied point-correspondence residual, millimetres.

    maximumRowTerms: number

    Largest assembled reduced observation stencil; the explicit row-work cap includes exact-zero terms.

    maximumWitness:
        | {
            coefficientExpressions: {
                constant: readonly [number, number, number];
                terms: { id: number; weight: number }[];
            }[];
            coefficients: number[];
            constantMm: readonly [number, number, number];
            controlIds: number[];
            controlsMm: (readonly [number, number, number])[];
            fittedPointMm: readonly [number, number, number];
            globalUV: [number, number] | null;
            leafBounds: readonly [number, number, number, number] | null;
            localUV: [number, number];
            lowerMm: readonly [number, number, number];
            originalSourceFace: null;
            patch: number;
            patchId: string | null;
            reachable: {
                absoluteWeightSum: number;
                diagnostic: string;
                infeasibleAtTolerance: boolean;
                lowerMm: [number, number, number];
                minimumDistanceMm: number;
                terms: number;
                upperMm: [number, number, number];
                weightSum: number;
            };
            sampledRows: {
                physicalJet: | {
                    directions: readonly {
                        du: number;
                        dv: number;
                        targetMm: readonly [number, number, number];
                    }[];
                }
                | null
                | undefined;
                targetMm: readonly [number, number, number];
                u: number;
                v: number;
            }[];
            targetMm: readonly [number, number, number];
            terms: {
                id: number;
                valueMm: readonly [number, number, number];
                weight: number;
            }[];
            upperMm: readonly [number, number, number];
        }
        | null

    One private worst correspondence and its original affine feasible range; never consumer geometry.

    Type Declaration

    • {
          coefficientExpressions: {
              constant: readonly [number, number, number];
              terms: { id: number; weight: number }[];
          }[];
          coefficients: number[];
          constantMm: readonly [number, number, number];
          controlIds: number[];
          controlsMm: (readonly [number, number, number])[];
          fittedPointMm: readonly [number, number, number];
          globalUV: [number, number] | null;
          leafBounds: readonly [number, number, number, number] | null;
          localUV: [number, number];
          lowerMm: readonly [number, number, number];
          originalSourceFace: null;
          patch: number;
          patchId: string | null;
          reachable: {
              absoluteWeightSum: number;
              diagnostic: string;
              infeasibleAtTolerance: boolean;
              lowerMm: [number, number, number];
              minimumDistanceMm: number;
              terms: number;
              upperMm: [number, number, number];
              weightSum: number;
          };
          sampledRows: {
              physicalJet: | {
                  directions: readonly {
                      du: number;
                      dv: number;
                      targetMm: readonly [number, number, number];
                  }[];
              }
              | null
              | undefined;
              targetMm: readonly [number, number, number];
              u: number;
              v: number;
          }[];
          targetMm: readonly [number, number, number];
          terms: {
              id: number;
              valueMm: readonly [number, number, number];
              weight: number;
          }[];
          upperMm: readonly [number, number, number];
      }
      • coefficientExpressions: {
            constant: readonly [number, number, number];
            terms: { id: number; weight: number }[];
        }[]

        Fixed constants and independent-control terms expressing each retained original control.

      • coefficients: number[]

        Signed Bernstein row weights in original control order; derivative rows are not position convex combinations.

      • constantMm: readonly [number, number, number]

        Fixed contribution to the affine coefficient row, in registered millimetres.

      • controlIds: number[]

        Indices into the shared control registry; bicubic nets use sixteen IDs with u varying fastest.

      • controlsMm: (readonly [number, number, number])[]

        Bernstein control positions in the common registered millimetre frame, ordered by control registry ID.

      • fittedPointMm: readonly [number, number, number]

        Evaluated fitted position at the retained correspondence, in registered millimetres.

      • globalUV: [number, number] | null

        Global normalized chart coordinates, or null when the patch has no declared global bounds.

      • leafBounds: readonly [number, number, number, number] | null

        Global normalized bounds of the containing refinement leaf, or null when no leaf layout is supplied.

      • localUV: [number, number]

        Normalized local patch coordinates [u,v] of the retained correspondence.

      • lowerMm: readonly [number, number, number]

        Lower physical support or componentwise enclosure bound, in the declared registered millimetre frame.

      • originalSourceFace: null

        Always null: this coefficient-fit witness does not claim original source-face identity.

      • patch: number

        Patch identity or zero-based patch ordinal, according to this record, addressing the supplied coefficient-patch registry.

      • patchId: string | null

        Declared patch identity, or null when the caller supplied only positional patch indices.

      • reachable: {
            absoluteWeightSum: number;
            diagnostic: string;
            infeasibleAtTolerance: boolean;
            lowerMm: [number, number, number];
            minimumDistanceMm: number;
            terms: number;
            upperMm: [number, number, number];
            weightSum: number;
        }

        Single-row affine-box feasibility observation; it does not certify joint fit or continuous source support.

        • absoluteWeightSum: number

          Binary64 sum of absolute combined weights, in first-address order.

        • diagnostic: string

          Predicate scope and diagnostic precision qualification.

        • infeasibleAtTolerance: boolean

          Exact strict distance-squared comparison for the combined binary64 row.

        • lowerMm: [number, number, number]

          Outward-rounded lower endpoints, millimetres.

        • minimumDistanceMm: number

          Approximate distance to the exact row image, millimetres.

        • terms: number

          Unique original addresses, including exact-zero cancellations.

        • upperMm: [number, number, number]

          Outward-rounded upper endpoints, millimetres.

        • weightSum: number

          Binary64 sum of combined weights, in first-address order.

      • sampledRows: {
            physicalJet:
                | {
                    directions: readonly {
                        du: number;
                        dv: number;
                        targetMm: readonly [number, number, number];
                    }[];
                }
                | null
                | undefined;
            targetMm: readonly [number, number, number];
            u: number;
            v: number;
        }[]

        Original position/physical-gradient correspondences used to diagnose this patch's retained worst witness.

      • targetMm: readonly [number, number, number]

        Observed target in the operation's millimetre exchange scale; derivative rows retain their physical directional meaning.

      • terms: { id: number; valueMm: readonly [number, number, number]; weight: number }[]

        Sparse affine contributions in original control IDs; duplicate IDs and signed weights retain the owning operation's declared combination rule.

      • upperMm: readonly [number, number, number]

        Upper physical support or componentwise enclosure bound, in the declared registered millimetre frame.

    • null
    objectiveRmsMm: number

    Position-plus-physical-gradient objective RMS in the declared millimetre exchange scale.

    observationRank: number | null

    Numerical Gram rank, or null when the explicit dense diagnostic limit is exceeded.

    optimality: {
        boxSupportGap: number;
        gradientInfinity: number;
        leastSquaresConstant: number;
        normalizationOriginMm: readonly [number, number, number];
        normalizationScaleMm: number;
        objective: number;
        physicalObjectiveGapUpperMm2: number;
    }

    Binary64 tangent-plane box gap for the assembled normalized objective; not a rigorous error-bounded certificate.

    Type Declaration

    • boxSupportGap: number

      Tangent-plane support gap over the feasible normalized box; a numerical bound, not an outward-rounded certificate.

    • gradientInfinity: number

      Infinity norm of the original normalized objective gradient.

    • leastSquaresConstant: number

      Constant term of the assembled normalized least-squares objective.

    • normalizationOriginMm: readonly [number, number, number]

      Physical millimetre origin subtracted before the normalized solve.

    • normalizationScaleMm: number

      Positive millimetre scale dividing physical position residuals in the normalized solve.

    • objective: number

      Current normalized quadratic objective value under the declared row weights.

    • physicalObjectiveGapUpperMm2: number

      Reported objective-gap upper estimate restored to square-millimetre scale.

    patchFreeSupportMaximumMm: number[]

    Per-patch maximum restricted to rows with unknown coefficient support.

    patchMaximumLocations: ([number, number] | null)[]

    Actual local UV of each patch maximum, used by the declared residual refinement wave.

    patchMaximumMm: number[]

    Per-patch maximum over fit and additional validation correspondences, millimetres.

    physicalJetRmsMm: number

    Millimetre exchange-length-scaled physical-gradient RMS, separate from position RMS.

    physicalJetRows: number

    Actual transient signed derivative rows assembled without expanding the observation table.

    projectedGradient: number

    Infinity norm of the normalized projected-gradient mapping.

    qualified: boolean

    True only when numerical full observation rank, gradient termination and supplied residual pass.

    rankTolerance: number

    Relative Gram pivot threshold; this is not an exact rank certificate.

    relationDiagnostics: {
        maximumDepth: number;
        maximumTerms: number;
        maximumWeightSumError: number;
        minimumWeight: number;
    }

    Affine substitution accounting; this does not certify convex weights.

    Type Declaration

    • maximumDepth: number

      Deepest affine dependency expansion actually traversed.

    • maximumTerms: number

      Largest retained affine substitution expression in original control IDs.

    • maximumWeightSumError: number

      Largest absolute deviation of an affine expression's weight sum from one.

    • minimumWeight: number

      Smallest retained affine weight; negative values remain explicit and do not imply convexity.

    rmsMm: number

    Weighted RMS of all supplied point correspondences, millimetres.

    solve: {
        maximumDiagonal: number;
        minimumPositiveDiagonal: number | null;
        originalLipschitz: number;
        restarts: number;
        scaledLipschitz: number;
    }

    Original and diagonally transformed spectral estimates and actual restart count, not condition numbers.

    Type Declaration

    • maximumDiagonal: number

      Largest Hessian diagonal used in scaling and diagnostics.

    • minimumPositiveDiagonal: number | null

      Smallest positive Hessian diagonal; null means no positive entry was observed.

    • originalLipschitz: number

      Row-sum spectral upper estimate for the original Hessian, not a condition number.

    • restarts: number

      Actual acceleration-momentum resets after objective increase.

    • scaledLipschitz: number

      Row-sum spectral upper estimate after diagonal congruence, not a condition number.

    unknownControls: number

    Unknown coefficient count after fixed shared controls are eliminated.

    unsupportedControls: number

    Controls with no positive observation basis support, independent of rank work limits.