@photivra/engine 1.4.0 → 2.0.0

package/dist/sensor/exposure-window.js

@@ -1,21 +1,27 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Module boundary and integration notes.
- * Resolves local capture exposure windows from independent opening and closing boundary schedules. The
- * returned time basis is seconds from the first opening-boundary phase. This is intentionally not the
- * existing camera-rotation API's global "exposure start" semantic; a later integration layer must bind
- * those time bases explicitly. The mechanism identifies whether each boundary is mechanical or
- * electronic, but does not supply any traversal duration or direction. Every non-simultaneous timing
- * value and direction is caller-declared with evidence. The first model supports simultaneous
- * boundaries and uniform-linear single-axis native-sensor scans only. It does not model curtain
- * acceleration, segmented/nonlinear electronic schedules, flash/flicker, rolling-shutter image
- * distortion, shutter shock, or EFCS-specific pupil/bokeh behavior.
+ * Exposure windows: when each point on the sensor starts and stops collecting light.
+ *
+ * The shutter has an opening boundary and a closing boundary, each with its own schedule. With a
+ * rolling or curtain shutter the boundaries sweep across the sensor, so each point has its own
+ * (local) window. Times are seconds from the first opening boundary. That is deliberately not the
+ * same as the camera-rotation API's global "exposure start"; a later layer must link the two
+ * explicitly.
+ *
+ * The mechanism records whether each boundary is mechanical or electronic, but supplies no sweep
+ * duration or direction. Every timing value and direction for a non-simultaneous boundary is declared
+ * by the caller, with evidence. Only simultaneous boundaries and a uniform linear sweep along one
+ * native sensor axis are supported. Not modelled: curtain acceleration, segmented or non-linear
+ * electronic schedules, flash or flicker, rolling-shutter image distortion, shutter shock, and
+ * EFCS (electronic first-curtain shutter) effects on the pupil or bokeh.
  * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
  * limits.
  */
 import { approximationResult } from "../core/calculation-result.js";
 import { parseEvidenceList } from "../core/evidence-provenance.js";
 import { InvalidScientificInputError, requirePositiveInteger } from "../core/validation.js";
+import { requireInputObject, requireInputKeys, rejectUnknownFields } from "../core/record-validation.js";
+import { InvalidConfigurationError } from "../core/configuration-error.js";
 const SHUTTER_MECHANISMS = new Set([
     "mechanical",
     "electronic-first-curtain",
@@ -31,10 +37,12 @@ const BOUNDARY_KINDS = new Set([
     "simultaneous",
     "uniform-linear-native-scan"
 ]);
-function requireRecord(value, path) {
+function requireRecord(value, path, allowedKeys) {
     if (typeof value !== "object" || value === null || Array.isArray(value)) {
-        throw new InvalidScientificInputError(path + " must be an object.");
+        throw new InvalidConfigurationError(path + " must be an object.");
     }
+    if (allowedKeys !== null)
+        rejectUnknownFields(value, allowedKeys, path);
     return value;
 }
 function requireNonNegativeInteger(name, value) {
@@ -48,10 +56,11 @@ function requirePositiveFinite(name, value) {
     }
     return value;
 }
-function parseSecondsFact(value, path) {
-    const record = requireRecord(value, path);
+/** Parses a sourced duration in seconds (`{ unit: "s", value, evidence }`). Not a root export. */
+export function parseSecondsFact(value, path) {
+    const record = requireRecord(value, path, ["unit", "value", "evidence"]);
     if (record.unit !== "s") {
-        throw new InvalidScientificInputError(path + '.unit must be "s".');
+        throw new InvalidConfigurationError(path + '.unit must be "s".');
     }
     return {
         value: requirePositiveFinite(path + ".value", record.value),
@@ -60,21 +69,23 @@ function parseSecondsFact(value, path) {
     };
 }
 function parseDirectionFact(value, path) {
-    const record = requireRecord(value, path);
+    const record = requireRecord(value, path, ["value", "evidence"]);
     if (typeof record.value !== "string" ||
         !SCAN_DIRECTIONS.has(record.value)) {
-        throw new InvalidScientificInputError(path + ".value is invalid.");
+        throw new InvalidConfigurationError(path + ".value is invalid.");
     }
     return {
         value: record.value,
         evidence: parseEvidenceList(record.evidence, path + ".evidence")
     };
 }
-function parseBoundarySchedule(value, path) {
-    const record = requireRecord(value, path);
+/** Parses one exposure boundary schedule (opening or closing). Not a root export. */
+export function parseBoundarySchedule(value, path) {
+    // unitVectorNative is the derived field of a resolved schedule; it may be passed back if it matches.
+    const record = requireRecord(value, path, ["kind", "directionNative", "traversalDurationSeconds", "unitVectorNative"]);
     if (typeof record.kind !== "string" ||
         !BOUNDARY_KINDS.has(record.kind)) {
-        throw new InvalidScientificInputError(path + ".kind is invalid.");
+        throw new InvalidConfigurationError(path + ".kind is invalid.");
     }
     if (record.kind === "simultaneous") {
         if (record.directionNative !== undefined) {
@@ -84,15 +95,27 @@ function parseBoundarySchedule(value, path) {
             throw new InvalidScientificInputError(path +
                 ".traversalDurationSeconds must be omitted for a simultaneous boundary.");
         }
+        if (record.unitVectorNative !== undefined) {
+            throw new InvalidScientificInputError(path + ".unitVectorNative must be omitted for a simultaneous boundary.");
+        }
         return { kind: "simultaneous" };
     }
+    const directionNative = parseDirectionFact(record.directionNative, path + ".directionNative");
+    if (record.unitVectorNative !== undefined) {
+        const supplied = requireRecord(record.unitVectorNative, path + ".unitVectorNative", ["x", "y"]);
+        const derived = scanVector(directionNative.value);
+        if (supplied.x !== derived.x || supplied.y !== derived.y) {
+            throw new InvalidConfigurationError(path + ".unitVectorNative must match directionNative.");
+        }
+    }
     return {
         kind: "uniform-linear-native-scan",
-        directionNative: parseDirectionFact(record.directionNative, path + ".directionNative"),
+        directionNative,
         traversalDurationSeconds: parseSecondsFact(record.traversalDurationSeconds, path + ".traversalDurationSeconds")
     };
 }
 function validateNativeRaster(raster) {
+    requireInputObject(raster, "raster input");
     requirePositiveInteger("nativeRaster.pixelWidth", raster.pixelWidth);
     requirePositiveInteger("nativeRaster.pixelHeight", raster.pixelHeight);
 }
@@ -117,7 +140,7 @@ function validateActiveCaptureRect(rect, raster) {
 function validateShutterMechanism(value) {
     if (typeof value !== "string" ||
         !SHUTTER_MECHANISMS.has(value)) {
-        throw new InvalidScientificInputError("shutterMechanism is invalid.");
+        throw new InvalidConfigurationError("shutterMechanism is invalid.");
     }
 }
 function validatePointWithinActiveCapture(point, rect, path) {
@@ -234,24 +257,25 @@ function activeRectCorners(rect) {
     ];
 }
 /**
- * Resolves local capture exposure windows from independent opening and closing
- * boundary schedules.
+ * Works out each point's local exposure window from separate opening and
+ * closing boundary schedules.
  *
- * The returned time basis is seconds from the first opening-boundary phase.
- * This is intentionally not the existing camera-rotation API's global
- * "exposure start" semantic; a later integration layer must bind those time
- * bases explicitly.
+ * Times are seconds from the first opening boundary. This is deliberately not
+ * the camera-rotation API's global "exposure start"; a later layer must link the
+ * two explicitly.
  *
- * The mechanism identifies whether each boundary is mechanical or electronic,
- * but does not supply any traversal duration or direction. Every non-simultaneous
- * timing value and direction is caller-declared with evidence.
+ * The mechanism records whether each boundary is mechanical or electronic, but
+ * supplies no sweep duration or direction. Every timing value and direction for
+ * a non-simultaneous boundary is declared by the caller, with evidence.
  *
- * The first model supports simultaneous boundaries and uniform-linear
- * single-axis native-sensor scans only. It does not model curtain acceleration,
- * segmented/nonlinear electronic schedules, flash/flicker, rolling-shutter
- * image distortion, shutter shock, or EFCS-specific pupil/bokeh behavior.
+ * Only simultaneous boundaries and a uniform linear sweep along one native
+ * sensor axis are supported. Not modelled: curtain acceleration, segmented or
+ * non-linear electronic schedules, flash or flicker, rolling-shutter image
+ * distortion, shutter shock, and EFCS (electronic first-curtain shutter)
+ * effects on the pupil or bokeh.
  */
 export function calculateCaptureExposureWindows(input) {
+    requireInputKeys(input, "calculateCaptureExposureWindows", ["nativeRaster", "activeCaptureRect", "shutterMechanism", "nominalExposureDurationSeconds", "opening", "closing", "samplePointsNative"]);
     validateNativeRaster(input.nativeRaster);
     validateShutterMechanism(input.shutterMechanism);
     const nominalExposureDurationSeconds = parseSecondsFact(input.nominalExposureDurationSeconds, "nominalExposureDurationSeconds");
@@ -261,7 +285,7 @@ export function calculateCaptureExposureWindows(input) {
     validateActiveCaptureRect(activeCaptureRect, input.nativeRaster);
     if (input.samplePointsNative !== undefined &&
         !Array.isArray(input.samplePointsNative)) {
-        throw new InvalidScientificInputError("samplePointsNative must be an array when supplied.");
+        throw new InvalidConfigurationError("samplePointsNative must be an array when supplied.");
     }
     const cornerSamples = activeRectCorners(activeCaptureRect).map((point) => createWindowSample(point, activeCaptureRect, opening, closing, nominalExposureDurationSeconds.value));
     const localDurations = cornerSamples.map((sample) => sample.localExposureDurationSeconds);
@@ -302,4 +326,21 @@ export function calculateCaptureExposureWindows(input) {
         "This model does not include curtain acceleration, segmented/nonlinear electronic timing, rolling-shutter image distortion, motion integration, flash/flicker interaction, shutter shock, or EFCS-specific pupil/bokeh behavior."
     ]);
 }
+/**
+ * Internal, for the faster ("lean") native environment executor (a 2.0 performance change). It checks a
+ * schedule once with every check of calculateCaptureExposureWindows, then returns a per-point sampler that
+ * uses the same point validation and the same createWindowSample arithmetic. So each sampled window is
+ * identical to what calculateCaptureExposureWindows returns for that point. Not exported from the package.
+ */
+export function prepareCaptureExposureWindowSampler(input) {
+    const admitted = calculateCaptureExposureWindows({ ...input, samplePointsNative: [] }).value;
+    const rect = { ...admitted.activeCaptureRect };
+    const opening = parseBoundarySchedule(input.opening, "opening");
+    const closing = parseBoundarySchedule(input.closing, "closing");
+    const nominal = admitted.nominalExposureDurationSeconds.value;
+    return (point) => {
+        validatePointWithinActiveCapture(point, rect, "samplePointsNative[0]");
+        return createWindowSample(point, rect, opening, closing, nominal);
+    };
+}
 //# sourceMappingURL=exposure-window.js.map

package/dist/sensor/exposure-window.js.map

@@ -1 +1 @@
-{"version":3,"file":"exposure-window.js","sourceRoot":"","sources":["../../src/sensor/exposure-window.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"exposure-window.js","sourceRoot":"","sources":["../../src/sensor/exposure-window.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Exposure windows: when each point on the sensor starts and stops collecting light.\n *\n * The shutter has an opening boundary and a closing boundary, each with its own schedule. With a\n * rolling or curtain shutter the boundaries sweep across the sensor, so each point has its own\n * (local) window. Times are seconds from the first opening boundary. That is deliberately not the\n * same as the camera-rotation API's global \"exposure start\"; a later layer must link the two\n * explicitly.\n *\n * The mechanism records whether each boundary is mechanical or electronic, but supplies no sweep\n * duration or direction. Every timing value and direction for a non-simultaneous boundary is declared\n * by the caller, with evidence. Only simultaneous boundaries and a uniform linear sweep along one\n * native sensor axis are supported. Not modelled: curtain acceleration, segmented or non-linear\n * electronic schedules, flash or flicker, rolling-shutter image distortion, shutter shock, and\n * EFCS (electronic first-curtain shutter) effects on the pupil or bokeh.\n * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support\n * limits.\n */\n\nimport {\n  approximationResult,\n  type CalculationResult\n} from \"../core/calculation-result.js\";\nimport {\n  parseEvidenceList,\n  type EvidenceBackedFact\n} from \"../core/evidence-provenance.js\";\nimport {\n  InvalidScientificInputError,\n  requirePositiveInteger\n} from \"../core/validation.js\";\nimport type {\n  RasterPoint,\n  RasterRect,\n  RasterVector\n} from \"../output/capture-geometry.js\";\nimport type { NativeImageRaster } from \"./sensor-geometry.js\";\nimport type {\n  CaptureShutterMechanism,\n  NativeSensorReadoutScanDirection,\n  SourcedSensorTimingSeconds\n} from \"./readout-timing.js\";\nimport { requireInputObject, requireInputKeys, rejectUnknownFields } from \"../core/record-validation.js\";\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\n\nexport type CaptureExposureBoundaryActuator = \"mechanical\" | \"electronic\";\n\nexport type SourcedCaptureTimingSeconds = SourcedSensorTimingSeconds;\n\nexport type SourcedCaptureBoundaryDirection =\n  EvidenceBackedFact<NativeSensorReadoutScanDirection>;\n\nexport interface SimultaneousExposureBoundarySchedule {\n  kind: \"simultaneous\";\n  directionNative?: never;\n  traversalDurationSeconds?: never;\n}\n\nexport interface UniformLinearExposureBoundarySchedule {\n  kind: \"uniform-linear-native-scan\";\n  directionNative: SourcedCaptureBoundaryDirection;\n  traversalDurationSeconds: SourcedCaptureTimingSeconds;\n}\n\nexport type ExposureBoundarySchedule =\n  | SimultaneousExposureBoundarySchedule\n  | UniformLinearExposureBoundarySchedule;\n\nexport interface CalculateCaptureExposureWindowsInput {\n  nativeRaster: NativeImageRaster;\n  /**\n   * Active capture rectangle, in fixed native pixel coordinates.\n   *\n   * Defaults to the whole native image. Sweep timing is never worked out by\n   * scaling a full-frame timing value to this rectangle.\n   */\n  activeCaptureRect?: RasterRect;\n  shutterMechanism: CaptureShutterMechanism;\n  /**\n   * Nominal time between the opening and closing reference points (phase zero).\n   *\n   * A point's local exposure can differ from this when the opening and closing\n   * boundaries sweep differently across the sensor.\n   */\n  nominalExposureDurationSeconds: SourcedCaptureTimingSeconds;\n  opening: ExposureBoundarySchedule;\n  closing: ExposureBoundarySchedule;\n  /**\n   * Optional points, in continuous native pixel coordinates measured from pixel\n   * edges, to report windows for. A pixel centre is at +0.5.\n   */\n  samplePointsNative?: readonly RasterPoint[];\n}\n\nexport interface ResolvedCaptureExposureBoundary {\n  actuator: CaptureExposureBoundaryActuator;\n  schedule:\n    | {\n        kind: \"simultaneous\";\n      }\n    | {\n        kind: \"uniform-linear-native-scan\";\n        directionNative: SourcedCaptureBoundaryDirection;\n        unitVectorNative: RasterVector;\n        traversalDurationSeconds: SourcedCaptureTimingSeconds;\n      };\n}\n\nexport interface CaptureExposureWindowSample {\n  pointNative: RasterPoint;\n  openingNormalizedScanPosition: number | null;\n  closingNormalizedScanPosition: number | null;\n  /**\n   * Seconds from the first opening boundary.\n   */\n  startOffsetSecondsFromOpeningReference: number;\n  /**\n   * Seconds from the first opening boundary.\n   */\n  endOffsetSecondsFromOpeningReference: number;\n  localExposureDurationSeconds: number;\n}\n\nexport interface CaptureExposureWindows {\n  shutterMechanism: CaptureShutterMechanism;\n  timeReference: \"first-opening-boundary-phase\";\n  nativeRaster: NativeImageRaster;\n  activeCaptureRect: RasterRect;\n  nominalExposureDurationSeconds: SourcedCaptureTimingSeconds;\n  opening: ResolvedCaptureExposureBoundary;\n  closing: ResolvedCaptureExposureBoundary;\n  localExposureDurationRangeSeconds: {\n    minimum: number;\n    maximum: number;\n  };\n  samples: readonly CaptureExposureWindowSample[];\n}\n\ntype UnknownRecord = Record<string, unknown>;\n\nconst SHUTTER_MECHANISMS = new Set<CaptureShutterMechanism>([\n  \"mechanical\",\n  \"electronic-first-curtain\",\n  \"electronic\"\n]);\n\nconst SCAN_DIRECTIONS = new Set<NativeSensorReadoutScanDirection>([\n  \"top-to-bottom\",\n  \"bottom-to-top\",\n  \"left-to-right\",\n  \"right-to-left\"\n]);\n\nconst BOUNDARY_KINDS = new Set<ExposureBoundarySchedule[\"kind\"]>([\n  \"simultaneous\",\n  \"uniform-linear-native-scan\"\n]);\n\nfunction requireRecord(\n  value: unknown,\n  path: string,\n  allowedKeys: readonly string[] | null\n): UnknownRecord {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    throw new InvalidConfigurationError(path + \" must be an object.\");\n  }\n  if (allowedKeys !== null) rejectUnknownFields(value, allowedKeys, path);\n  return value as UnknownRecord;\n}\n\nfunction requireNonNegativeInteger(name: string, value: number): void {\n  if (!Number.isSafeInteger(value) || value < 0) {\n    throw new InvalidScientificInputError(\n      name + \" must be a non-negative safe integer.\"\n    );\n  }\n}\n\nfunction requirePositiveFinite(name: string, value: unknown): number {\n  if (typeof value !== \"number\" || !Number.isFinite(value) || value <= 0) {\n    throw new InvalidScientificInputError(\n      name + \" must be a finite number greater than zero.\"\n    );\n  }\n  return value;\n}\n\n/** Parses a sourced duration in seconds (`{ unit: \"s\", value, evidence }`). Not a root export. */\nexport function parseSecondsFact(\n  value: unknown,\n  path: string\n): SourcedCaptureTimingSeconds {\n  const record = requireRecord(value, path, [\"unit\", \"value\", \"evidence\"]);\n  if (record.unit !== \"s\") {\n    throw new InvalidConfigurationError(path + '.unit must be \"s\".');\n  }\n\n  return {\n    value: requirePositiveFinite(path + \".value\", record.value),\n    unit: \"s\",\n    evidence: parseEvidenceList(record.evidence, path + \".evidence\")\n  };\n}\n\nfunction parseDirectionFact(\n  value: unknown,\n  path: string\n): SourcedCaptureBoundaryDirection {\n  const record = requireRecord(value, path, [\"value\", \"evidence\"]);\n  if (\n    typeof record.value !== \"string\" ||\n    !SCAN_DIRECTIONS.has(\n      record.value as NativeSensorReadoutScanDirection\n    )\n  ) {\n    throw new InvalidConfigurationError(path + \".value is invalid.\");\n  }\n\n  return {\n    value: record.value as NativeSensorReadoutScanDirection,\n    evidence: parseEvidenceList(record.evidence, path + \".evidence\")\n  };\n}\n\n/** Parses one exposure boundary schedule (opening or closing). Not a root export. */\nexport function parseBoundarySchedule(\n  value: unknown,\n  path: string\n): ExposureBoundarySchedule {\n  // unitVectorNative is the derived field of a resolved schedule; it may be passed back if it matches.\n  const record = requireRecord(value, path, [\"kind\", \"directionNative\", \"traversalDurationSeconds\", \"unitVectorNative\"]);\n  if (\n    typeof record.kind !== \"string\" ||\n    !BOUNDARY_KINDS.has(record.kind as ExposureBoundarySchedule[\"kind\"])\n  ) {\n    throw new InvalidConfigurationError(path + \".kind is invalid.\");\n  }\n\n  if (record.kind === \"simultaneous\") {\n    if (record.directionNative !== undefined) {\n      throw new InvalidScientificInputError(\n        path + \".directionNative must be omitted for a simultaneous boundary.\"\n      );\n    }\n    if (record.traversalDurationSeconds !== undefined) {\n      throw new InvalidScientificInputError(\n        path +\n          \".traversalDurationSeconds must be omitted for a simultaneous boundary.\"\n      );\n    }\n    if (record.unitVectorNative !== undefined) {\n      throw new InvalidScientificInputError(\n        path + \".unitVectorNative must be omitted for a simultaneous boundary.\"\n      );\n    }\n\n    return { kind: \"simultaneous\" };\n  }\n\n  const directionNative = parseDirectionFact(\n    record.directionNative,\n    path + \".directionNative\"\n  );\n  if (record.unitVectorNative !== undefined) {\n    const supplied = requireRecord(record.unitVectorNative, path + \".unitVectorNative\", [\"x\", \"y\"]);\n    const derived = scanVector(directionNative.value);\n    if (supplied.x !== derived.x || supplied.y !== derived.y) {\n      throw new InvalidConfigurationError(path + \".unitVectorNative must match directionNative.\");\n    }\n  }\n  return {\n    kind: \"uniform-linear-native-scan\",\n    directionNative,\n    traversalDurationSeconds: parseSecondsFact(\n      record.traversalDurationSeconds,\n      path + \".traversalDurationSeconds\"\n    )\n  };\n}\n\nfunction validateNativeRaster(raster: NativeImageRaster): void {\n  requireInputObject(raster, \"raster input\");\n  requirePositiveInteger(\"nativeRaster.pixelWidth\", raster.pixelWidth);\n  requirePositiveInteger(\"nativeRaster.pixelHeight\", raster.pixelHeight);\n}\n\nfunction fullRect(raster: NativeImageRaster): RasterRect {\n  return {\n    x: 0,\n    y: 0,\n    width: raster.pixelWidth,\n    height: raster.pixelHeight\n  };\n}\n\nfunction validateActiveCaptureRect(\n  rect: RasterRect,\n  raster: NativeImageRaster\n): void {\n  requireNonNegativeInteger(\"activeCaptureRect.x\", rect.x);\n  requireNonNegativeInteger(\"activeCaptureRect.y\", rect.y);\n  requirePositiveInteger(\"activeCaptureRect.width\", rect.width);\n  requirePositiveInteger(\"activeCaptureRect.height\", rect.height);\n\n  if (\n    rect.x + rect.width > raster.pixelWidth ||\n    rect.y + rect.height > raster.pixelHeight\n  ) {\n    throw new InvalidScientificInputError(\n      \"activeCaptureRect must fit entirely within nativeRaster.\"\n    );\n  }\n}\n\nfunction validateShutterMechanism(\n  value: unknown\n): asserts value is CaptureShutterMechanism {\n  if (\n    typeof value !== \"string\" ||\n    !SHUTTER_MECHANISMS.has(value as CaptureShutterMechanism)\n  ) {\n    throw new InvalidConfigurationError(\"shutterMechanism is invalid.\");\n  }\n}\n\nfunction validatePointWithinActiveCapture(\n  point: RasterPoint,\n  rect: RasterRect,\n  path: string\n): void {\n  if (!Number.isFinite(point.x) || !Number.isFinite(point.y)) {\n    throw new InvalidScientificInputError(\n      path + \" coordinates must be finite.\"\n    );\n  }\n\n  if (\n    point.x < rect.x ||\n    point.x > rect.x + rect.width ||\n    point.y < rect.y ||\n    point.y > rect.y + rect.height\n  ) {\n    throw new InvalidScientificInputError(\n      path + \" must lie within activeCaptureRect edge-coordinate bounds.\"\n    );\n  }\n}\n\nfunction scanVector(\n  direction: NativeSensorReadoutScanDirection\n): RasterVector {\n  switch (direction) {\n    case \"top-to-bottom\":\n      return { x: 0, y: 1 };\n    case \"bottom-to-top\":\n      return { x: 0, y: -1 };\n    case \"left-to-right\":\n      return { x: 1, y: 0 };\n    case \"right-to-left\":\n      return { x: -1, y: 0 };\n  }\n}\n\nfunction normalizedScanPosition(\n  point: RasterPoint,\n  rect: RasterRect,\n  direction: NativeSensorReadoutScanDirection\n): number {\n  switch (direction) {\n    case \"top-to-bottom\":\n      return (point.y - rect.y) / rect.height;\n    case \"bottom-to-top\":\n      return 1 - (point.y - rect.y) / rect.height;\n    case \"left-to-right\":\n      return (point.x - rect.x) / rect.width;\n    case \"right-to-left\":\n      return 1 - (point.x - rect.x) / rect.width;\n  }\n}\n\nfunction boundaryPhase(\n  point: RasterPoint,\n  rect: RasterRect,\n  schedule: ExposureBoundarySchedule\n): {\n  normalizedScanPosition: number | null;\n  phaseOffsetSeconds: number;\n} {\n  if (schedule.kind === \"simultaneous\") {\n    return {\n      normalizedScanPosition: null,\n      phaseOffsetSeconds: 0\n    };\n  }\n\n  const normalized = normalizedScanPosition(\n    point,\n    rect,\n    schedule.directionNative.value\n  );\n\n  return {\n    normalizedScanPosition: normalized,\n    phaseOffsetSeconds:\n      normalized * schedule.traversalDurationSeconds.value\n  };\n}\n\nfunction resolveBoundaryActuators(\n  mechanism: CaptureShutterMechanism\n): {\n  opening: CaptureExposureBoundaryActuator;\n  closing: CaptureExposureBoundaryActuator;\n} {\n  switch (mechanism) {\n    case \"mechanical\":\n      return {\n        opening: \"mechanical\",\n        closing: \"mechanical\"\n      };\n    case \"electronic-first-curtain\":\n      return {\n        opening: \"electronic\",\n        closing: \"mechanical\"\n      };\n    case \"electronic\":\n      return {\n        opening: \"electronic\",\n        closing: \"electronic\"\n      };\n  }\n}\n\nfunction resolveBoundary(\n  actuator: CaptureExposureBoundaryActuator,\n  schedule: ExposureBoundarySchedule\n): ResolvedCaptureExposureBoundary {\n  if (schedule.kind === \"simultaneous\") {\n    return {\n      actuator,\n      schedule: {\n        kind: \"simultaneous\"\n      }\n    };\n  }\n\n  return {\n    actuator,\n    schedule: {\n      kind: \"uniform-linear-native-scan\",\n      directionNative: schedule.directionNative,\n      unitVectorNative: scanVector(schedule.directionNative.value),\n      traversalDurationSeconds: schedule.traversalDurationSeconds\n    }\n  };\n}\n\nfunction createWindowSample(\n  point: RasterPoint,\n  rect: RasterRect,\n  opening: ExposureBoundarySchedule,\n  closing: ExposureBoundarySchedule,\n  nominalExposureDurationSeconds: number\n): CaptureExposureWindowSample {\n  const openingPhase = boundaryPhase(point, rect, opening);\n  const closingPhase = boundaryPhase(point, rect, closing);\n  const startOffsetSecondsFromOpeningReference =\n    openingPhase.phaseOffsetSeconds;\n  const endOffsetSecondsFromOpeningReference =\n    nominalExposureDurationSeconds + closingPhase.phaseOffsetSeconds;\n  const localExposureDurationSeconds =\n    endOffsetSecondsFromOpeningReference -\n    startOffsetSecondsFromOpeningReference;\n\n  return {\n    pointNative: { ...point },\n    openingNormalizedScanPosition:\n      openingPhase.normalizedScanPosition,\n    closingNormalizedScanPosition:\n      closingPhase.normalizedScanPosition,\n    startOffsetSecondsFromOpeningReference,\n    endOffsetSecondsFromOpeningReference,\n    localExposureDurationSeconds\n  };\n}\n\nfunction activeRectCorners(rect: RasterRect): readonly RasterPoint[] {\n  return [\n    { x: rect.x, y: rect.y },\n    { x: rect.x + rect.width, y: rect.y },\n    { x: rect.x, y: rect.y + rect.height },\n    {\n      x: rect.x + rect.width,\n      y: rect.y + rect.height\n    }\n  ];\n}\n\n/**\n * Works out each point's local exposure window from separate opening and\n * closing boundary schedules.\n *\n * Times are seconds from the first opening boundary. This is deliberately not\n * the camera-rotation API's global \"exposure start\"; a later layer must link the\n * two explicitly.\n *\n * The mechanism records whether each boundary is mechanical or electronic, but\n * supplies no sweep duration or direction. Every timing value and direction for\n * a non-simultaneous boundary is declared by the caller, with evidence.\n *\n * Only simultaneous boundaries and a uniform linear sweep along one native\n * sensor axis are supported. Not modelled: curtain acceleration, segmented or\n * non-linear electronic schedules, flash or flicker, rolling-shutter image\n * distortion, shutter shock, and EFCS (electronic first-curtain shutter)\n * effects on the pupil or bokeh.\n */\nexport function calculateCaptureExposureWindows(\n  input: CalculateCaptureExposureWindowsInput\n): CalculationResult<CaptureExposureWindows> {\n  requireInputKeys(input, \"calculateCaptureExposureWindows\", [\"nativeRaster\", \"activeCaptureRect\", \"shutterMechanism\", \"nominalExposureDurationSeconds\", \"opening\", \"closing\", \"samplePointsNative\"]);\n  validateNativeRaster(input.nativeRaster);\n  validateShutterMechanism(input.shutterMechanism);\n\n  const nominalExposureDurationSeconds = parseSecondsFact(\n    input.nominalExposureDurationSeconds,\n    \"nominalExposureDurationSeconds\"\n  );\n  const opening = parseBoundarySchedule(input.opening, \"opening\");\n  const closing = parseBoundarySchedule(input.closing, \"closing\");\n\n  const activeCaptureRect =\n    input.activeCaptureRect ?? fullRect(input.nativeRaster);\n  validateActiveCaptureRect(activeCaptureRect, input.nativeRaster);\n\n  if (\n    input.samplePointsNative !== undefined &&\n    !Array.isArray(input.samplePointsNative)\n  ) {\n    throw new InvalidConfigurationError(\n      \"samplePointsNative must be an array when supplied.\"\n    );\n  }\n\n  const cornerSamples = activeRectCorners(activeCaptureRect).map(\n    (point) =>\n      createWindowSample(\n        point,\n        activeCaptureRect,\n        opening,\n        closing,\n        nominalExposureDurationSeconds.value\n      )\n  );\n\n  const localDurations = cornerSamples.map(\n    (sample) => sample.localExposureDurationSeconds\n  );\n  const minimumLocalExposureDurationSeconds = Math.min(...localDurations);\n  const maximumLocalExposureDurationSeconds = Math.max(...localDurations);\n\n  if (\n    !Number.isFinite(minimumLocalExposureDurationSeconds) ||\n    minimumLocalExposureDurationSeconds <= 0\n  ) {\n    throw new InvalidScientificInputError(\n      \"The declared opening/closing schedules produce a zero or negative local exposure duration somewhere within activeCaptureRect.\"\n    );\n  }\n\n  const samples = (input.samplePointsNative ?? []).map((point, index) => {\n    validatePointWithinActiveCapture(\n      point,\n      activeCaptureRect,\n      \"samplePointsNative[\" + index + \"]\"\n    );\n\n    return createWindowSample(\n      point,\n      activeCaptureRect,\n      opening,\n      closing,\n      nominalExposureDurationSeconds.value\n    );\n  });\n\n  const actuators = resolveBoundaryActuators(input.shutterMechanism);\n\n  return approximationResult(\n    {\n      shutterMechanism: input.shutterMechanism,\n      timeReference: \"first-opening-boundary-phase\",\n      nativeRaster: { ...input.nativeRaster },\n      activeCaptureRect: { ...activeCaptureRect },\n      nominalExposureDurationSeconds,\n      opening: resolveBoundary(actuators.opening, opening),\n      closing: resolveBoundary(actuators.closing, closing),\n      localExposureDurationRangeSeconds: {\n        minimum: minimumLocalExposureDurationSeconds,\n        maximum: maximumLocalExposureDurationSeconds\n      },\n      samples\n    },\n    \"capture-exposure-window-schedule\",\n    \"1.0.0\",\n    [\n      \"Time is reported in seconds from the first opening-boundary phase, not from a universal local exposure-start event.\",\n      \"Nominal exposure duration, opening traversal, and closing traversal are independent declared quantities.\",\n      \"Mechanical, electronic-first-curtain, and electronic mechanisms determine boundary actuator categories only; they do not supply timing or direction.\",\n      \"Uniform-linear scan boundaries are an explicit approximation over continuous effective native-raster coordinates and do not assert one raster row/column equals one physical curtain line, photodiode row, or hardware readout line.\",\n      \"Opening and closing directions and traversal durations are independent and may produce spatially varying local exposure duration.\",\n      \"The complete active rectangle is validated using the extrema of the affine boundary schedules, so unsampled invalid corners cannot pass.\",\n      \"Active-capture timing is caller-declared and is not inferred by scaling full-frame timing from crop dimensions.\",\n      \"Physical camera orientation and digital output crop/resolution remain downstream of the invariant native timing schedule.\",\n      \"Sensor readout timing remains a separate contract; this model does not automatically equate a sensor readout phase with an exposure boundary.\",\n      \"This model does not include curtain acceleration, segmented/nonlinear electronic timing, rolling-shutter image distortion, motion integration, flash/flicker interaction, shutter shock, or EFCS-specific pupil/bokeh behavior.\"\n    ]\n  );\n}\n\n/**\n * Internal, for the faster (\"lean\") native environment executor (a 2.0 performance change). It checks a\n * schedule once with every check of calculateCaptureExposureWindows, then returns a per-point sampler that\n * uses the same point validation and the same createWindowSample arithmetic. So each sampled window is\n * identical to what calculateCaptureExposureWindows returns for that point. Not exported from the package.\n */\nexport function prepareCaptureExposureWindowSampler(\n  input: Omit<CalculateCaptureExposureWindowsInput, \"samplePointsNative\">\n): (point: RasterPoint) => CaptureExposureWindowSample {\n  const admitted = calculateCaptureExposureWindows({ ...input, samplePointsNative: [] }).value;\n  const rect = { ...admitted.activeCaptureRect };\n  const opening = parseBoundarySchedule(input.opening, \"opening\");\n  const closing = parseBoundarySchedule(input.closing, \"closing\");\n  const nominal = admitted.nominalExposureDurationSeconds.value;\n  return (point) => {\n    validatePointWithinActiveCapture(point, rect, \"samplePointsNative[0]\");\n    return createWindowSample(point, rect, opening, closing, nominal);\n  };\n}\n"]}

package/dist/sensor/fixed-pattern-noise.d.ts

@@ -0,0 +1,108 @@
+import { type EvidenceBackedFact, type EvidenceProvenance } from "../core/evidence-provenance.js";
+export declare const SENSOR_FIXED_PATTERN_NOISE_PROFILE_SCHEMA_VERSION: "0.1.0";
+/** Versioned identity of the pattern-generation equations and seed schedule. */
+export declare const SENSOR_FIXED_PATTERN_NOISE_MODEL: Readonly<{
+    readonly id: "photivra-sensor-fixed-pattern";
+    readonly version: "1.0.0";
+}>;
+/**
+ * Explicit fixed-pattern parameters for one sensor instance. Every component is required; a zero
+ * standard deviation, fraction or RMS disables that component.
+ */
+export interface SensorFixedPatternNoiseProfile {
+    schemaVersion: typeof SENSOR_FIXED_PATTERN_NOISE_PROFILE_SCHEMA_VERSION;
+    profileId: string;
+    /** The colour-sampling grid whose absolute site coordinates index the pattern. */
+    colorSamplingProfileId: string;
+    scientificStatus: "approximation";
+    /** Identifies the physical sensor. Independent of every per-capture noise seed. */
+    sensorInstanceSeedUint32: number;
+    /** EMVA 1288 PRNU: spatial standard deviation of the photo response divided by its mean. */
+    photoResponseNonUniformity: {
+        relativeStandardDeviation: EvidenceBackedFact<number>;
+    };
+    /** Spatial standard deviation of the dark-current rate divided by the population-mean rate. */
+    darkSignalNonUniformity: {
+        relativeStandardDeviation: EvidenceBackedFact<number>;
+    };
+    /** Fraction of sites whose dark-current rate is the population mean times the multiplier. */
+    hotPixels: {
+        siteFraction: EvidenceBackedFact<number>;
+        darkCurrentMultiplier: EvidenceBackedFact<number>;
+    };
+    /** Fixed readout offset per row, in input-referred electrons, normally distributed with zero mean. */
+    rowOffset: {
+        rmsElectrons: EvidenceBackedFact<number>;
+    };
+    /** Fixed readout offset per column, in input-referred electrons, normally distributed with zero mean. */
+    columnOffset: {
+        rmsElectrons: EvidenceBackedFact<number>;
+    };
+    patternDistribution: "normal-factors-truncated-at-zero";
+    evidence: readonly EvidenceProvenance[];
+    limitations: readonly string[];
+}
+/** The deterministic pattern values of one colour-sampling site. */
+export interface SensorFixedPatternSiteValues {
+    profileId: string;
+    modelId: typeof SENSOR_FIXED_PATTERN_NOISE_MODEL.id;
+    modelVersion: typeof SENSOR_FIXED_PATTERN_NOISE_MODEL.version;
+    site: {
+        x: number;
+        y: number;
+    };
+    /** Multiplies the expected photo charge (1 = no PRNU); never negative. */
+    photoResponseGainFactor: number;
+    /** Multiplies the population-mean dark expectation (1 = no DSNU); never negative. */
+    darkCurrentFactor: number;
+    hotPixel: boolean;
+    rowOffsetElectrons: number;
+    columnOffsetElectrons: number;
+    /** rowOffsetElectrons + columnOffsetElectrons, added at readout. */
+    readoutOffsetElectrons: number;
+}
+/**
+ * Validates an untrusted fixed-pattern noise profile. Unknown keys, out-of-range parameters and
+ * missing evidence are rejected. The PRNU and DSNU relative standard deviations are limited to 0.5
+ * and 5, and the hot-pixel multiplier to 1–1e6.
+ * @param value - Untrusted data. TypeScript types alone are not validation.
+ * @returns The validated profile.
+ * @see docs/MOTION_AND_SIGNAL.md for the model and its sources.
+ */
+export declare function parseSensorFixedPatternNoiseProfile(value: unknown): SensorFixedPatternNoiseProfile;
+/**
+ * Computes the fixed-pattern values of one absolute colour-sampling site.
+ *
+ * - PRNU gain g = max(0, 1 + σ_PRNU·z₁);
+ * - hot pixel when u < f_hot, then dark factor d = m_hot; otherwise d = max(0, 1 + σ_DSNU·z₂);
+ * - row offset σ_row·z(row y), column offset σ_col·z(column x), in input-referred electrons.
+ *
+ * Each z is a standard normal value and u a uniform value, each from its own stream hashed with
+ * MurmurHash3 from (sensorInstanceSeed, x, y, stream). Row values use x = 0 and column values y = 0,
+ * so a whole row or column shares one value. Cutting negative factors off at zero shifts the mean
+ * factor by less than 1e-6 for σ ≤ 0.2.
+ * @param input - A parsed or untrusted profile plus a nonnegative integer site.
+ * @returns The site's fixed-pattern values.
+ */
+export declare function calculateSensorFixedPatternSite(input: {
+    profile: SensorFixedPatternNoiseProfile;
+    site: {
+        x: number;
+        y: number;
+    };
+}): SensorFixedPatternSiteValues;
+/** Internal: the PRNU gain, dark-current factor and hot-pixel state of one site (no readout offsets). */
+export declare function evaluateFixedPatternSiteFactors(profile: SensorFixedPatternNoiseProfile, x: number, y: number): {
+    photoResponseGainFactor: number;
+    darkCurrentFactor: number;
+    hotPixel: boolean;
+};
+/** Internal: the fixed readout offset of row `y`, in input-referred electrons. */
+export declare function evaluateFixedPatternRowOffset(profile: SensorFixedPatternNoiseProfile, y: number): number;
+/** Internal: the fixed readout offset of column `x`, in input-referred electrons. */
+export declare function evaluateFixedPatternColumnOffset(profile: SensorFixedPatternNoiseProfile, x: number): number;
+/** Internal: the same calculation for an already parsed profile. */
+export declare function evaluateParsedFixedPatternSite(profile: SensorFixedPatternNoiseProfile, site: {
+    x: number;
+    y: number;
+}): SensorFixedPatternSiteValues;

package/dist/sensor/fixed-pattern-noise.js

@@ -0,0 +1,166 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Fixed-pattern noise (FPN): the part of sensor noise that stays the same from shot to shot for one
+ * physical sensor. It covers photo-response non-uniformity (PRNU), dark-signal non-uniformity (DSNU),
+ * hot pixels and row and column readout offsets, as defined in EMVA Standard 1288 Release 4.0 (spatial
+ * non-uniformity of the photo response and of the dark signal).
+ *
+ * The pattern is deterministic. It is seeded from an explicit sensor-instance seed and absolute
+ * colour-sampling site coordinates, never from the per-capture noise seed, so the same sensor shows
+ * the same pattern in every capture.
+ *
+ * Application points in the readout chain (see raw-readout.ts):
+ * - PRNU multiplies the expected photo charge before photo shot-noise sampling;
+ * - DSNU and hot pixels multiply the population-mean dark-current expectation before dark shot-noise
+ *   sampling, so their excess charge scales with exposure duration and with the declared
+ *   temperature model of the dark-current profile;
+ * - row and column offsets are input-referred electron offsets added with read noise, before the
+ *   pre-ADC threshold.
+ *
+ * The dark-current model itself stays a population mean; this module is a separate spatial model that
+ * must be attached explicitly. Values are declared by the caller (or are synthetic preset values).
+ * Nothing here is a measured calibration.
+ * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
+ * limits.
+ */
+import { InvalidConfigurationError } from "../core/configuration-error.js";
+import { parseEvidenceList } from "../core/evidence-provenance.js";
+import { requireAllowlistedRecord, requirePublicOpaqueId, requireInputKeys } from "../core/record-validation.js";
+import { InvalidScientificInputError } from "../core/validation.js";
+import { createDeterministicUniformStream, deriveSensorFixedPatternSeedUint32, sampleDeterministicStandardNormal, SENSOR_FIXED_PATTERN_COLUMN_STREAM_ID, SENSOR_FIXED_PATTERN_DSNU_STREAM_ID, SENSOR_FIXED_PATTERN_HOT_PIXEL_STREAM_ID, SENSOR_FIXED_PATTERN_PRNU_STREAM_ID, SENSOR_FIXED_PATTERN_ROW_STREAM_ID } from "./stochastic-seed.js";
+export const SENSOR_FIXED_PATTERN_NOISE_PROFILE_SCHEMA_VERSION = "0.1.0";
+/** Versioned identity of the pattern-generation equations and seed schedule. */
+export const SENSOR_FIXED_PATTERN_NOISE_MODEL = Object.freeze({ id: "photivra-sensor-fixed-pattern", version: "1.0.0" });
+const FACT_KEYS = ["value", "evidence"];
+function fact(value, path, maximum, minimum = 0) {
+    const record = requireAllowlistedRecord(value, FACT_KEYS, path + " must be an evidence-backed fact.");
+    const v = record.value;
+    if (typeof v !== "number" || !Number.isFinite(v) || v < minimum || v > maximum) {
+        throw new InvalidConfigurationError(path + ".value must be finite from " + minimum + " through " + maximum + ".");
+    }
+    return { value: v, evidence: parseEvidenceList(record.evidence, path + ".evidence") };
+}
+function limitations(value) {
+    if (!Array.isArray(value) || value.some((entry) => typeof entry !== "string" || entry.trim().length === 0)) {
+        throw new InvalidConfigurationError("sensorFixedPatternNoise.limitations must be an array of non-empty strings.");
+    }
+    if (new Set(value).size !== value.length) {
+        throw new InvalidConfigurationError("sensorFixedPatternNoise.limitations must not contain duplicates.");
+    }
+    return value.map((entry) => entry.trim());
+}
+/**
+ * Validates an untrusted fixed-pattern noise profile. Unknown keys, out-of-range parameters and
+ * missing evidence are rejected. The PRNU and DSNU relative standard deviations are limited to 0.5
+ * and 5, and the hot-pixel multiplier to 1–1e6.
+ * @param value - Untrusted data. TypeScript types alone are not validation.
+ * @returns The validated profile.
+ * @see docs/MOTION_AND_SIGNAL.md for the model and its sources.
+ */
+export function parseSensorFixedPatternNoiseProfile(value) {
+    const r = requireAllowlistedRecord(value, ["schemaVersion", "profileId", "colorSamplingProfileId", "scientificStatus",
+        "sensorInstanceSeedUint32", "photoResponseNonUniformity", "darkSignalNonUniformity", "hotPixels", "rowOffset", "columnOffset",
+        "patternDistribution", "evidence", "limitations"], "Invalid sensor fixed-pattern noise profile fields.");
+    if (r.schemaVersion !== SENSOR_FIXED_PATTERN_NOISE_PROFILE_SCHEMA_VERSION) {
+        throw new InvalidConfigurationError('sensorFixedPatternNoise.schemaVersion must be "' + SENSOR_FIXED_PATTERN_NOISE_PROFILE_SCHEMA_VERSION + '".');
+    }
+    if (r.scientificStatus !== "approximation") {
+        throw new InvalidConfigurationError('sensorFixedPatternNoise.scientificStatus must be "approximation".');
+    }
+    if (r.patternDistribution !== "normal-factors-truncated-at-zero") {
+        throw new InvalidConfigurationError('sensorFixedPatternNoise.patternDistribution must be "normal-factors-truncated-at-zero".');
+    }
+    const seed = r.sensorInstanceSeedUint32;
+    if (typeof seed !== "number" || !Number.isSafeInteger(seed) || seed < 0 || seed > 0xffff_ffff) {
+        throw new InvalidConfigurationError("sensorFixedPatternNoise.sensorInstanceSeedUint32 must be an unsigned 32-bit integer.");
+    }
+    const prnu = requireAllowlistedRecord(r.photoResponseNonUniformity, ["relativeStandardDeviation"], "Invalid PRNU fields.");
+    const dsnu = requireAllowlistedRecord(r.darkSignalNonUniformity, ["relativeStandardDeviation"], "Invalid DSNU fields.");
+    const hot = requireAllowlistedRecord(r.hotPixels, ["siteFraction", "darkCurrentMultiplier"], "Invalid hot-pixel fields.");
+    const row = requireAllowlistedRecord(r.rowOffset, ["rmsElectrons"], "Invalid row-offset fields.");
+    const column = requireAllowlistedRecord(r.columnOffset, ["rmsElectrons"], "Invalid column-offset fields.");
+    return {
+        schemaVersion: SENSOR_FIXED_PATTERN_NOISE_PROFILE_SCHEMA_VERSION,
+        profileId: requirePublicOpaqueId(r.profileId, "sensorFixedPatternNoise.profileId must be a public opaque identifier."),
+        colorSamplingProfileId: requirePublicOpaqueId(r.colorSamplingProfileId, "sensorFixedPatternNoise.colorSamplingProfileId must be a public opaque identifier."),
+        scientificStatus: "approximation",
+        sensorInstanceSeedUint32: seed,
+        photoResponseNonUniformity: { relativeStandardDeviation: fact(prnu.relativeStandardDeviation, "photoResponseNonUniformity.relativeStandardDeviation", 0.5) },
+        darkSignalNonUniformity: { relativeStandardDeviation: fact(dsnu.relativeStandardDeviation, "darkSignalNonUniformity.relativeStandardDeviation", 5) },
+        hotPixels: { siteFraction: fact(hot.siteFraction, "hotPixels.siteFraction", 1),
+            darkCurrentMultiplier: fact(hot.darkCurrentMultiplier, "hotPixels.darkCurrentMultiplier", 1e6, 1) },
+        rowOffset: { rmsElectrons: fact(row.rmsElectrons, "rowOffset.rmsElectrons", 1e6) },
+        columnOffset: { rmsElectrons: fact(column.rmsElectrons, "columnOffset.rmsElectrons", 1e6) },
+        patternDistribution: "normal-factors-truncated-at-zero",
+        evidence: parseEvidenceList(r.evidence, "sensorFixedPatternNoise.evidence"),
+        limitations: limitations(r.limitations)
+    };
+}
+function normal(seed, x, y, stream) {
+    return sampleDeterministicStandardNormal(createDeterministicUniformStream(deriveSensorFixedPatternSeedUint32(seed, x, y, stream)));
+}
+/**
+ * Computes the fixed-pattern values of one absolute colour-sampling site.
+ *
+ * - PRNU gain g = max(0, 1 + σ_PRNU·z₁);
+ * - hot pixel when u < f_hot, then dark factor d = m_hot; otherwise d = max(0, 1 + σ_DSNU·z₂);
+ * - row offset σ_row·z(row y), column offset σ_col·z(column x), in input-referred electrons.
+ *
+ * Each z is a standard normal value and u a uniform value, each from its own stream hashed with
+ * MurmurHash3 from (sensorInstanceSeed, x, y, stream). Row values use x = 0 and column values y = 0,
+ * so a whole row or column shares one value. Cutting negative factors off at zero shifts the mean
+ * factor by less than 1e-6 for σ ≤ 0.2.
+ * @param input - A parsed or untrusted profile plus a nonnegative integer site.
+ * @returns The site's fixed-pattern values.
+ */
+export function calculateSensorFixedPatternSite(input) {
+    requireInputKeys(input, "calculateSensorFixedPatternSite", ["profile", "site"]);
+    const profile = parseSensorFixedPatternNoiseProfile(input.profile);
+    return evaluateParsedFixedPatternSite(profile, input.site);
+}
+/** Internal: the PRNU gain, dark-current factor and hot-pixel state of one site (no readout offsets). */
+export function evaluateFixedPatternSiteFactors(profile, x, y) {
+    const seed = profile.sensorInstanceSeedUint32;
+    const prnuSd = profile.photoResponseNonUniformity.relativeStandardDeviation.value;
+    const dsnuSd = profile.darkSignalNonUniformity.relativeStandardDeviation.value;
+    const hotFraction = profile.hotPixels.siteFraction.value;
+    const photoResponseGainFactor = prnuSd === 0 ? 1 : Math.max(0, 1 + prnuSd * normal(seed, x, y, SENSOR_FIXED_PATTERN_PRNU_STREAM_ID));
+    const hotPixel = hotFraction > 0 &&
+        createDeterministicUniformStream(deriveSensorFixedPatternSeedUint32(seed, x, y, SENSOR_FIXED_PATTERN_HOT_PIXEL_STREAM_ID)).next() < hotFraction;
+    const darkCurrentFactor = hotPixel ? profile.hotPixels.darkCurrentMultiplier.value :
+        dsnuSd === 0 ? 1 : Math.max(0, 1 + dsnuSd * normal(seed, x, y, SENSOR_FIXED_PATTERN_DSNU_STREAM_ID));
+    return { photoResponseGainFactor, darkCurrentFactor, hotPixel };
+}
+/** Internal: the fixed readout offset of row `y`, in input-referred electrons. */
+export function evaluateFixedPatternRowOffset(profile, y) {
+    const rms = profile.rowOffset.rmsElectrons.value;
+    return rms === 0 ? 0 : rms * normal(profile.sensorInstanceSeedUint32, 0, y, SENSOR_FIXED_PATTERN_ROW_STREAM_ID);
+}
+/** Internal: the fixed readout offset of column `x`, in input-referred electrons. */
+export function evaluateFixedPatternColumnOffset(profile, x) {
+    const rms = profile.columnOffset.rmsElectrons.value;
+    return rms === 0 ? 0 : rms * normal(profile.sensorInstanceSeedUint32, x, 0, SENSOR_FIXED_PATTERN_COLUMN_STREAM_ID);
+}
+/** Internal: the same calculation for an already parsed profile. */
+export function evaluateParsedFixedPatternSite(profile, site) {
+    const { x, y } = site ?? {};
+    if (!Number.isSafeInteger(x) || !Number.isSafeInteger(y) || x < 0 || y < 0 || x > 0xffff_ffff || y > 0xffff_ffff) {
+        throw new InvalidScientificInputError("Fixed-pattern site coordinates must be nonnegative uint32 integers.");
+    }
+    const { photoResponseGainFactor, darkCurrentFactor, hotPixel } = evaluateFixedPatternSiteFactors(profile, x, y);
+    const rowOffsetElectrons = evaluateFixedPatternRowOffset(profile, y);
+    const columnOffsetElectrons = evaluateFixedPatternColumnOffset(profile, x);
+    return {
+        profileId: profile.profileId,
+        modelId: SENSOR_FIXED_PATTERN_NOISE_MODEL.id,
+        modelVersion: SENSOR_FIXED_PATTERN_NOISE_MODEL.version,
+        site: { x, y },
+        photoResponseGainFactor,
+        darkCurrentFactor,
+        hotPixel,
+        rowOffsetElectrons,
+        columnOffsetElectrons,
+        readoutOffsetElectrons: rowOffsetElectrons + columnOffsetElectrons
+    };
+}
+//# sourceMappingURL=fixed-pattern-noise.js.map