@photivra/engine 0.5.1 → 1.0.0

package/dist/motion/capture-translation-parallax-temporal-quadrature.js

@@ -0,0 +1,263 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Module boundary and integration notes.
+ * Evaluates depth-dependent translational parallax at deterministic midpoint nodes over each scene
+ * point's authoritative local exposure window. The model is deliberately per point. Camera translation
+ * and optional subject translation coexist through relative linear motion; neither is redefined as the
+ * other. Camera rotation and visibility/occlusion remain separate models.
+ * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
+ * limits.
+ */
+import { approximationResult } from "../core/calculation-result.js";
+import { InvalidScientificInputError, requirePositiveFinite, requirePositiveInteger } from "../core/validation.js";
+import { transformNativeRasterVectorToOriented } from "../output/capture-geometry.js";
+import { calculateThinLensImageDistance } from "../optics/thin-lens.js";
+function requireFiniteVector(value, path) {
+    for (const axis of ["x", "y", "z"]) {
+        if (!Number.isFinite(value[axis])) {
+            throw new InvalidScientificInputError(path +
+                "." +
+                axis +
+                " must be finite.");
+        }
+    }
+    return {
+        ...value
+    };
+}
+function requireNonEmptyString(value, path) {
+    if (typeof value !== "string" ||
+        value.trim().length === 0) {
+        throw new InvalidScientificInputError(path +
+            " must be a non-empty string.");
+    }
+    return value.trim();
+}
+function samePoint(a, b) {
+    return (a.x === b.x &&
+        a.y === b.y);
+}
+function projectPoint(positionM, projectionDistanceMm, path) {
+    if (positionM.z <= 0) {
+        throw new InvalidScientificInputError(path +
+            " must remain in front of the camera plane.");
+    }
+    const mapped = {
+        x: projectionDistanceMm *
+            (positionM.x /
+                positionM.z),
+        y: projectionDistanceMm *
+            (positionM.y /
+                positionM.z)
+    };
+    if (!Number.isFinite(mapped.x) ||
+        !Number.isFinite(mapped.y)) {
+        throw new InvalidScientificInputError(path +
+            " projection must remain finite.");
+    }
+    return mapped;
+}
+function localExposureForPoint(timing, point) {
+    const matches = timing.exposureWindows.samples.filter((sample) => samePoint(sample.pointNative, point));
+    if (matches.length !== 1) {
+        throw new InvalidScientificInputError("Each translation/parallax scene sample must match exactly one committed exposure-window sample point.");
+    }
+    return matches[0];
+}
+/**
+ * Evaluates depth-dependent translational parallax at deterministic midpoint
+ * nodes over each scene point's authoritative local exposure window.
+ *
+ * The model is deliberately per point. Camera translation and optional subject
+ * translation coexist through relative linear motion; neither is redefined as
+ * the other. Camera rotation and visibility/occlusion remain separate models.
+ */
+export function calculateCaptureTranslationParallaxTemporalQuadrature(input) {
+    requirePositiveFinite("imagingArea.widthMm", input.imagingArea.widthMm);
+    requirePositiveFinite("imagingArea.heightMm", input.imagingArea.heightMm);
+    requirePositiveFinite("focalLengthMm", input.focalLengthMm);
+    requirePositiveInteger("temporalSampleCount", input.temporalSampleCount);
+    if (!Array.isArray(input.sceneSamples) ||
+        input.sceneSamples.length === 0) {
+        throw new InvalidScientificInputError("sceneSamples must be a non-empty array.");
+    }
+    const ids = input.sceneSamples.map((sample) => requireNonEmptyString(sample.sampleId, "sceneSamples[].sampleId"));
+    if (new Set(ids).size !==
+        ids.length) {
+        throw new InvalidScientificInputError("sceneSamples must not contain duplicate sampleId values.");
+    }
+    const cameraVelocity = requireFiniteVector(input
+        .cameraTranslationVelocityMps, "cameraTranslationVelocityMps");
+    const projectionDistanceMm = input.focusDistanceM ===
+        undefined
+        ? input.focalLengthMm
+        : calculateThinLensImageDistance({
+            focalLengthMm: input.focalLengthMm,
+            objectDistanceM: input.focusDistanceM
+        }).value.imageDistanceMm;
+    const pitchX = input.imagingArea.widthMm /
+        input.timing.nativeRaster
+            .pixelWidth;
+    const pitchY = input.imagingArea.heightMm /
+        input.timing.nativeRaster
+            .pixelHeight;
+    if (!Number.isFinite(pitchX) ||
+        !Number.isFinite(pitchY) ||
+        pitchX <= 0 ||
+        pitchY <= 0) {
+        throw new InvalidScientificInputError("Resolved translation/parallax sampling pitch must remain finite and positive.");
+    }
+    const samples = input.sceneSamples.map((sceneSample, sampleIndex) => {
+        const samplePath = "sceneSamples[" +
+            sampleIndex +
+            "]";
+        const sampleId = requireNonEmptyString(sceneSample.sampleId, samplePath +
+            ".sampleId");
+        const referencePosition = requireFiniteVector(sceneSample
+            .positionCameraM, samplePath +
+            ".positionCameraM");
+        if (referencePosition.z <= 0) {
+            throw new InvalidScientificInputError(samplePath +
+                ".positionCameraM.z must place the scene point in front of the camera.");
+        }
+        const subjectVelocity = sceneSample
+            .subjectVelocityMps ===
+            undefined
+            ? {
+                x: 0,
+                y: 0,
+                z: 0
+            }
+            : requireFiniteVector(sceneSample
+                .subjectVelocityMps, samplePath +
+                ".subjectVelocityMps");
+        const exposure = localExposureForPoint(input.timing, sceneSample
+            .destinationPointNative);
+        const duration = exposure
+            .localExposureDurationSeconds;
+        if (!Number.isFinite(duration) ||
+            duration <= 0) {
+            throw new InvalidScientificInputError("Translation/parallax requires a positive finite local exposure duration.");
+        }
+        const referenceImagePoint = projectPoint(referencePosition, projectionDistanceMm, samplePath +
+            ".positionCameraM");
+        const normalizedTimeWeight = 1 /
+            input.temporalSampleCount;
+        const timeMeasureSeconds = duration /
+            input.temporalSampleCount;
+        const nodes = Array.from({
+            length: input.temporalSampleCount
+        }, (_, temporalSampleIndex) => {
+            const localExposurePhase = (temporalSampleIndex +
+                0.5) /
+                input.temporalSampleCount;
+            const captureTime = exposure
+                .startOffsetSecondsFromOpeningReference +
+                localExposurePhase *
+                    duration;
+            const relativePosition = {
+                x: referencePosition.x +
+                    (subjectVelocity.x -
+                        cameraVelocity.x) *
+                        captureTime,
+                y: referencePosition.y +
+                    (subjectVelocity.y -
+                        cameraVelocity.y) *
+                        captureTime,
+                z: referencePosition.z +
+                    (subjectVelocity.z -
+                        cameraVelocity.z) *
+                        captureTime
+            };
+            const mapped = projectPoint(relativePosition, projectionDistanceMm, samplePath +
+                ".relativePositionCameraM");
+            const deltaMm = {
+                x: mapped.x -
+                    referenceImagePoint.x,
+                y: mapped.y -
+                    referenceImagePoint.y
+            };
+            const deltaNative = {
+                x: deltaMm.x /
+                    pitchX,
+                y: -deltaMm.y /
+                    pitchY
+            };
+            const oriented = transformNativeRasterVectorToOriented({
+                vector: deltaNative,
+                orientation: input.orientation
+            });
+            return {
+                temporalSampleIndex,
+                localExposurePhase,
+                captureTimeSecondsFromReference: captureTime,
+                normalizedTimeWeight,
+                timeMeasureSeconds,
+                relativePositionCameraM: relativePosition,
+                mappedImagePointMm: mapped,
+                deltaFromReferenceImagePlaneMm: {
+                    ...deltaMm,
+                    distance: Math.hypot(deltaMm.x, deltaMm.y)
+                },
+                deltaNativeSamples: {
+                    ...deltaNative,
+                    distance: Math.hypot(deltaNative.x, deltaNative.y)
+                },
+                deltaOrientedSamples: {
+                    ...oriented,
+                    distance: Math.hypot(oriented.x, oriented.y)
+                }
+            };
+        });
+        return {
+            sampleId,
+            destinationPointNative: {
+                ...sceneSample
+                    .destinationPointNative
+            },
+            referencePositionCameraM: referencePosition,
+            subjectVelocityMps: subjectVelocity,
+            localExposureWindow: {
+                startSecondsFromCaptureReference: exposure
+                    .startOffsetSecondsFromOpeningReference,
+                endSecondsFromCaptureReference: exposure
+                    .endOffsetSecondsFromOpeningReference,
+                durationSeconds: duration
+            },
+            referenceImagePointMm: referenceImagePoint,
+            nodes
+        };
+    });
+    return approximationResult({
+        timeReference: "first-opening-boundary-phase",
+        timingProfileIdentity: {
+            profileId: input.timing
+                .timingProfileId,
+            profileVersion: input.timing
+                .timingProfileVersion,
+            captureModeId: input.timing
+                .captureModeId
+        },
+        orientation: input.orientation,
+        projectionDistanceMm,
+        temporalSampleCount: input.temporalSampleCount,
+        cameraTranslationVelocityMps: cameraVelocity,
+        samples,
+        geometryModel: "metric-depth-dependent-constant-linear-translation",
+        relativeMotionComposition: "subject-minus-camera-translation",
+        metricSceneDepthRequired: true,
+        oneGlobalHomographyAuthorized: false,
+        cameraRotationComposed: false,
+        visibilityOcclusionModeled: false,
+        sensorReadoutTimingUsedAsExposureTiming: false
+    }, "capture-translation-parallax-temporal-quadrature", "1.0.0", [
+        "Translation is evaluated independently for each metric scene point because translational image motion depends on depth.",
+        "Camera and subject translation coexist as explicit relative linear motion; subject motion is not reclassified as camera motion.",
+        "The camera-axis basis is fixed at the first-opening-boundary phase; camera rotation remains a separate model.",
+        "The destination native point selects the authoritative local exposure window; sensor data-readout timing is not substituted for exposure time.",
+        "Oriented sample displacement is a coordinate transform of the same physical image-plane mapping and does not change the translation physics.",
+        "No one global homography/warp is authorized for arbitrary 3D scenes.",
+        "Visibility, occlusion, deformation, acceleration and rolling scene geometry remain outside this model."
+    ]);
+}
+//# sourceMappingURL=capture-translation-parallax-temporal-quadrature.js.map

package/dist/motion/capture-translation-parallax-temporal-quadrature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-translation-parallax-temporal-quadrature.js","sourceRoot":"","sources":["../../src/motion/capture-translation-parallax-temporal-quadrature.ts"],"names":[],"mappings":"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"}

package/dist/motion/extended-object-projection.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Module boundary and integration notes.
+ * Evaluates multiple explicit metric points on one rigidly translating object at deterministic
+ * physical times. This is geometry only. It does not synthesize a blur kernel, visibility, radiance
+ * integration, deformation, camera rotation or a universal scale.
+ * Evaluates extended-object projection at deterministic midpoint nodes inside each point's
+ * authoritative #12 local exposure window.
+ * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
+ * limits.
+ */
+import { type CalculationResult } from "../core/calculation-result.js";
+import type { RasterPoint } from "../output/capture-geometry.js";
+import type { Vector3 } from "../schema/scene.js";
+import type { ResolvedCaptureModeTiming } from "../sensor/capture-mode-timing.js";
+export interface ExtendedObjectMetricPoint {
+    pointId: string;
+    /**
+     * Metric camera-space point at the common reference phase.
+     *
+     * +X right, +Y up, +Z forward/away from the camera.
+     */
+    positionCameraM: Vector3;
+}
+export interface ExtendedObjectFrontoparallelPlaneDeclaration {
+    kind: "fronto-parallel-planar-patch";
+    referenceDepthM: number;
+}
+export interface CalculateExtendedObjectProjectionTrajectoryInput {
+    objectId: string;
+    focalLengthMm: number;
+    focusDistanceM?: number;
+    objectTranslationVelocityMps: Vector3;
+    cameraTranslationVelocityMps: Vector3;
+    sampleTimesSecondsFromReference: readonly number[];
+    points: readonly ExtendedObjectMetricPoint[];
+    frontoparallelPlane?: ExtendedObjectFrontoparallelPlaneDeclaration;
+}
+export interface ExtendedObjectProjectionNode {
+    sampleIndex: number;
+    timeSecondsFromReference: number;
+    relativePositionCameraM: Vector3;
+    mappedImagePointMm: {
+        x: number;
+        y: number;
+    };
+    deltaFromReferenceImagePlaneMm: {
+        x: number;
+        y: number;
+        distance: number;
+    };
+    depthM: number;
+    planarMagnificationScaleFromReference: number | null;
+}
+export interface ExtendedObjectPointProjectionTrajectory {
+    pointId: string;
+    referencePositionCameraM: Vector3;
+    referenceImagePointMm: {
+        x: number;
+        y: number;
+    };
+    nodes: readonly ExtendedObjectProjectionNode[];
+}
+export interface ExtendedObjectPlanarMagnificationDiagnostic {
+    geometry: "declared-fronto-parallel-planar-patch";
+    referenceDepthM: number;
+    uniformScaleAuthorizedWithinDeclaredPatch: true;
+    scaleByTime: readonly {
+        sampleIndex: number;
+        timeSecondsFromReference: number;
+        scaleFromReference: number;
+    }[];
+    lateralRigidTranslationDoesNotChangePatchScale: true;
+    notAuthorizedForArbitrary3dGeometry: true;
+}
+export interface ExtendedObjectProjectionTrajectory {
+    objectId: string;
+    timeReference: "caller-declared-common-reference-phase";
+    projectionDistanceMm: number;
+    objectTranslationVelocityMps: Vector3;
+    cameraTranslationVelocityMps: Vector3;
+    relativeTranslationVelocityMps: Vector3;
+    rigidTranslationOnly: true;
+    pointTrajectories: readonly ExtendedObjectPointProjectionTrajectory[];
+    planarMagnificationDiagnostic: ExtendedObjectPlanarMagnificationDiagnostic | null;
+    metricSceneDepthRequired: true;
+    oneGlobalHomographyAuthorized: false;
+    oneGlobalScaleAuthorizedForArbitrary3dGeometry: false;
+    cameraRotationComposed: false;
+    visibilityOcclusionModeled: false;
+    deformationModeled: false;
+    accelerationModeled: false;
+    blurKernelCalculated: false;
+    radianceIntegrated: false;
+    timeVaryingDefocusMayBeRequired: boolean;
+}
+export interface CaptureExtendedObjectMetricPoint extends ExtendedObjectMetricPoint {
+    /**
+     * Native destination point selecting the authoritative #12 local exposure
+     * window for this object point.
+     */
+    destinationPointNative: RasterPoint;
+}
+export interface CalculateCaptureExtendedObjectTemporalProjectionInput {
+    objectId: string;
+    timing: ResolvedCaptureModeTiming;
+    focalLengthMm: number;
+    focusDistanceM?: number;
+    objectTranslationVelocityMps: Vector3;
+    cameraTranslationVelocityMps: Vector3;
+    temporalSampleCount: number;
+    points: readonly CaptureExtendedObjectMetricPoint[];
+    frontoparallelPlane?: ExtendedObjectFrontoparallelPlaneDeclaration;
+}
+export interface CaptureExtendedObjectTemporalNode extends ExtendedObjectProjectionNode {
+    localExposurePhase: number;
+    normalizedTimeWeight: number;
+    timeMeasureSeconds: number;
+}
+export interface CaptureExtendedObjectPointTrajectory {
+    pointId: string;
+    destinationPointNative: RasterPoint;
+    referencePositionCameraM: Vector3;
+    referenceImagePointMm: {
+        x: number;
+        y: number;
+    };
+    localExposureWindow: {
+        startSecondsFromCaptureReference: number;
+        endSecondsFromCaptureReference: number;
+        durationSeconds: number;
+    };
+    nodes: readonly CaptureExtendedObjectTemporalNode[];
+}
+export interface CaptureExtendedObjectTemporalProjection {
+    objectId: string;
+    timeReference: "first-opening-boundary-phase";
+    timingProfileIdentity: {
+        profileId: string;
+        profileVersion: string;
+        captureModeId: string;
+    };
+    projectionDistanceMm: number;
+    temporalSampleCount: number;
+    objectTranslationVelocityMps: Vector3;
+    cameraTranslationVelocityMps: Vector3;
+    relativeTranslationVelocityMps: Vector3;
+    rigidTranslationOnly: true;
+    pointTrajectories: readonly CaptureExtendedObjectPointTrajectory[];
+    planarMagnificationDiagnosticAvailable: boolean;
+    metricSceneDepthRequired: true;
+    oneGlobalHomographyAuthorized: false;
+    oneGlobalScaleAuthorizedForArbitrary3dGeometry: false;
+    cameraRotationComposed: false;
+    visibilityOcclusionModeled: false;
+    deformationModeled: false;
+    accelerationModeled: false;
+    blurKernelCalculated: false;
+    radianceIntegrated: false;
+    sensorReadoutTimingUsedAsExposureTiming: false;
+    timeVaryingDefocusMayBeRequired: boolean;
+}
+/**
+ * Evaluates multiple explicit metric points on one rigidly translating object
+ * at deterministic physical times.
+ *
+ * This is geometry only. It does not synthesize a blur kernel, visibility,
+ * radiance integration, deformation, camera rotation or a universal scale.
+ */
+export declare function calculateExtendedObjectProjectionTrajectory(input: CalculateExtendedObjectProjectionTrajectoryInput): CalculationResult<ExtendedObjectProjectionTrajectory>;
+/**
+ * Evaluates extended-object projection at deterministic midpoint nodes inside
+ * each point's authoritative #12 local exposure window.
+ */
+export declare function calculateCaptureExtendedObjectTemporalProjection(input: CalculateCaptureExtendedObjectTemporalProjectionInput): CalculationResult<CaptureExtendedObjectTemporalProjection>;
+//# sourceMappingURL=extended-object-projection.d.ts.map

package/dist/motion/extended-object-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extended-object-projection.d.ts","sourceRoot":"","sources":["../../src/motion/extended-object-projection.ts"],"names":[],"mappings":"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"}