@photivra/engine 1.4.0 → 2.0.0

package/dist/sensor/sampling-aperture.js

@@ -1,15 +1,12 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Module boundary and integration notes.
- * Parses physical registration of the color-site lattice plus a first geometric
- * photosensitive-aperture model. Site-center pitch/origin are explicit facts and are never derived
- * from NativeImageRaster. The rectangle, when resolved, is a geometric sensitive region only. It does
- * not include microlens redirection, charge diffusion, electrical crosstalk, QE, throughput, spectral
- * response, or an effective radiometric collection area.
- * Resolves one geometric sampling aperture in native sensor physical space. The result provides a
- * normalized uniform-area spatial averaging footprint for future image sampling, plus its geometric
- * physical area/fill-fraction diagnostics. It deliberately does not promote that geometric area into
- * radiometric collection efficiency or physical photodiode truth.
+ * Sampling aperture: where the colour-sampling sites sit physically on the sensor, and the
+ * light-sensitive area of each site as a simple geometric shape.
+ *
+ * Site pitch and origin are declared facts, never derived from NativeImageRaster. The sensitive
+ * region, when known, is a plain geometric rectangle. It does not include microlens effects, charge
+ * diffusion, electrical crosstalk, QE (quantum efficiency), throughput, spectral response or an
+ * effective light-collection area.
  * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
  * limits.
  */
@@ -18,12 +15,15 @@ import { parseEvidenceList } from "../core/evidence-provenance.js";
 import { InvalidScientificInputError } from "../core/validation.js";
 import { resolveNativeEffectiveRasterColorSamplingBinding } from "./capture-color-sampling-binding.js";
 import { resolveColorSamplingSite } from "./color-sampling.js";
-function requireRecord(value, path) {
+import { requireInputObject, requireInputKeys, rejectUnknownFields } from "../core/record-validation.js";
+function requireRecord(value, path, allowedKeys) {
     if (typeof value !== "object" ||
         value === null ||
         Array.isArray(value)) {
         throw new InvalidConfigurationError(path + " must be an object.");
     }
+    if (allowedKeys !== null)
+        rejectUnknownFields(value, allowedKeys, path);
     return value;
 }
 function requireNonEmptyString(value, path) {
@@ -50,7 +50,7 @@ function requireFinite(value, path) {
     return value;
 }
 function parseSiteCenterLattice(value, path) {
-    const record = requireRecord(value, path);
+    const record = requireRecord(value, path, ["kind", "coordinateSystem", "firstSiteCenterFromImagingAreaTopLeftMicrometers", "pitchXMicrometers", "pitchYMicrometers", "evidence"]);
     if (record.kind !==
         "regular-rectangular-site-center-lattice") {
         throw new InvalidConfigurationError(path + ".kind is invalid.");
@@ -61,7 +61,7 @@ function parseSiteCenterLattice(value, path) {
             '.coordinateSystem must be "native-sensor-physical".');
     }
     const firstCenter = requireRecord(record.firstSiteCenterFromImagingAreaTopLeftMicrometers, path +
-        ".firstSiteCenterFromImagingAreaTopLeftMicrometers");
+        ".firstSiteCenterFromImagingAreaTopLeftMicrometers", ["x", "y"]);
     const firstX = requireFinite(firstCenter.x, path +
         ".firstSiteCenterFromImagingAreaTopLeftMicrometers.x");
     const firstY = requireFinite(firstCenter.y, path +
@@ -83,7 +83,7 @@ function parseSiteCenterLattice(value, path) {
     };
 }
 function parseGeometricSensitiveAperture(value, path, lattice) {
-    const record = requireRecord(value, path);
+    const record = requireRecord(value, path, ["kind", "widthMicrometers", "heightMicrometers", "centerOffsetFromSiteCenterMicrometers", "evidence"]);
     if (record.kind === "unresolved") {
         if (record.widthMicrometers !== undefined ||
             record.heightMicrometers !== undefined ||
@@ -104,7 +104,7 @@ function parseGeometricSensitiveAperture(value, path, lattice) {
     const widthMicrometers = requirePositiveFinite(record.widthMicrometers, path + ".widthMicrometers");
     const heightMicrometers = requirePositiveFinite(record.heightMicrometers, path + ".heightMicrometers");
     const offset = requireRecord(record.centerOffsetFromSiteCenterMicrometers, path +
-        ".centerOffsetFromSiteCenterMicrometers");
+        ".centerOffsetFromSiteCenterMicrometers", ["x", "y"]);
     const offsetX = requireFinite(offset.x, path +
         ".centerOffsetFromSiteCenterMicrometers.x");
     const offsetY = requireFinite(offset.y, path +
@@ -132,17 +132,16 @@ function parseGeometricSensitiveAperture(value, path, lattice) {
     };
 }
 /**
- * Parses physical registration of the color-site lattice plus a first geometric
- * photosensitive-aperture model.
+ * Parses where the colour-sampling sites sit physically, plus a simple geometric
+ * model of each site's light-sensitive area.
  *
- * Site-center pitch/origin are explicit facts and are never derived from
- * NativeImageRaster. The rectangle, when resolved, is a geometric sensitive
- * region only. It does not include microlens redirection, charge diffusion,
- * electrical crosstalk, QE, throughput, spectral response, or an effective
- * radiometric collection area.
+ * Site pitch and origin are declared facts, never derived from NativeImageRaster.
+ * The rectangle, when given, is a geometric sensitive region only. It does not
+ * include microlens effects, charge diffusion, electrical crosstalk, QE,
+ * throughput, spectral response or an effective light-collection area.
  */
 export function parseSensorSamplingApertureProfile(value) {
-    const profile = requireRecord(value, "sensorSamplingAperture");
+    const profile = requireRecord(value, "sensorSamplingAperture", ["schemaVersion", "siteCenterLattice", "profileId", "colorSamplingProfileId", "colorSamplingBindingId", "evidence", "geometricSensitiveAperture"]);
     if (profile.schemaVersion !== "0.1.0") {
         throw new InvalidConfigurationError('sensorSamplingAperture.schemaVersion must be "0.1.0".');
     }
@@ -167,6 +166,7 @@ function requireSiteIndex(value, path) {
     return value;
 }
 function requirePositiveImagingArea(imagingArea) {
+    requireInputObject(imagingArea, "imagingArea input");
     if (!Number.isFinite(imagingArea.widthMm) ||
         imagingArea.widthMm <= 0 ||
         !Number.isFinite(imagingArea.heightMm) ||
@@ -175,14 +175,15 @@ function requirePositiveImagingArea(imagingArea) {
     }
 }
 /**
- * Resolves one geometric sampling aperture in native sensor physical space.
+ * Resolves one site's geometric sampling aperture in native sensor physical space.
  *
- * The result provides a normalized uniform-area spatial averaging footprint for
- * future image sampling, plus its geometric physical area/fill-fraction
- * diagnostics. It deliberately does not promote that geometric area into
- * radiometric collection efficiency or physical photodiode truth.
+ * The result is a normalized footprint that averages evenly over its area, for
+ * image sampling, plus its physical area and fill fraction. That geometric area
+ * is deliberately not treated as light-collection efficiency or as the true
+ * photodiode shape.
  */
 export function resolveSensorSamplingAperture(input) {
+    requireInputKeys(input, "resolveSensorSamplingAperture", ["imagingArea", "nativeRaster", "colorSamplingProfile", "colorSamplingBindingProfile", "samplingApertureProfile", "site"]);
     requirePositiveImagingArea(input.imagingArea);
     const profile = parseSensorSamplingApertureProfile(input.samplingApertureProfile);
     const binding = resolveNativeEffectiveRasterColorSamplingBinding({

package/dist/sensor/sampling-aperture.js.map

@@ -1 +1 @@
-{"version":3,"file":"sampling-aperture.js","sourceRoot":"","sources":["../../src/sensor/sampling-aperture.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EACL,iBAAiB,EAElB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EACL,gDAAgD,EAEjD,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,wBAAwB,EAGzB,MAAM,qBAAqB,CAAC;AAoJ7B,SAAS,aAAa,CACpB,KAAc,EACd,IAAY;IAEZ,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EACpB,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI,GAAG,qBAAqB,CAC7B,CAAC;IACJ,CAAC;IACD,OAAO,KAAsB,CAAC;AAChC,CAAC;AAED,SAAS,qBAAqB,CAC5B,KAAc,EACd,IAAY;IAEZ,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EACzB,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI,GAAG,8BAA8B,CACtC,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,qBAAqB,CAC5B,KAAc,EACd,IAAY;IAEZ,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACvB,KAAK,IAAI,CAAC,EACV,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI;YACF,6CAA6C,CAChD,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CACpB,KAAc,EACd,IAAY;IAEZ,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EACvB,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI,GAAG,2BAA2B,CACnC,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,sBAAsB,CAC7B,KAAc,EACd,IAAY;IAEZ,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAE1C,IACE,MAAM,CAAC,IAAI;QACX,yCAAyC,EACzC,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI,GAAG,mBAAmB,CAC3B,CAAC;IACJ,CAAC;IACD,IACE,MAAM,CAAC,gBAAgB;QACvB,wBAAwB,EACxB,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI;YACF,qDAAqD,CACxD,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,aAAa,CAC/B,MAAM,CAAC,gDAAgD,EACvD,IAAI;QACF,mDAAmD,CACtD,CAAC;IAEF,MAAM,MAAM,GAAG,aAAa,CAC1B,WAAW,CAAC,CAAC,EACb,IAAI;QACF,qDAAqD,CACxD,CAAC;IACF,MAAM,MAAM,GAAG,aAAa,CAC1B,WAAW,CAAC,CAAC,EACb,IAAI;QACF,qDAAqD,CACxD,CAAC;IAEF,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,yBAAyB,CACjC,IAAI;YACF,yEAAyE,CAC5E,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EACF,yCAAyC;QAC3C,gBAAgB,EACd,wBAAwB;QAC1B,iBAAiB,EACf,qBAAqB,CACnB,MAAM,CAAC,iBAAiB,EACxB,IAAI,GAAG,oBAAoB,CAC5B;QACH,iBAAiB,EACf,qBAAqB,CACnB,MAAM,CAAC,iBAAiB,EACxB,IAAI,GAAG,oBAAoB,CAC5B;QACH,gDAAgD,EAC9C;YACE,CAAC,EAAE,MAAM;YACT,CAAC,EAAE,MAAM;SACV;QACH,QAAQ,EAAE,iBAAiB,CACzB,MAAM,CAAC,QAAQ,EACf,IAAI,GAAG,WAAW,CACnB;KACF,CAAC;AACJ,CAAC;AAED,SAAS,+BAA+B,CACtC,KAAc,EACd,IAAY,EACZ,OAA4C;IAE5C,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAE1C,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACjC,IACE,MAAM,CAAC,gBAAgB,KAAK,SAAS;YACrC,MAAM,CAAC,iBAAiB,KAAK,SAAS;YACtC,MAAM,CAAC,qCAAqC;gBAC1C,SAAS,EACX,CAAC;YACD,MAAM,IAAI,yBAAyB,CACjC,IAAI;gBACF,kDAAkD,CACrD,CAAC;QACJ,CAAC;QACD,OAAO;YACL,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE,iBAAiB,CACzB,MAAM,CAAC,QAAQ,EACf,IAAI,GAAG,WAAW,CACnB;SACF,CAAC;IACJ,CAAC;IAED,IACE,MAAM,CAAC,IAAI;QACX,gCAAgC,EAChC,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI,GAAG,mBAAmB,CAC3B,CAAC;IACJ,CAAC;IAED,MAAM,gBAAgB,GACpB,qBAAqB,CACnB,MAAM,CAAC,gBAAgB,EACvB,IAAI,GAAG,mBAAmB,CAC3B,CAAC;IACJ,MAAM,iBAAiB,GACrB,qBAAqB,CACnB,MAAM,CAAC,iBAAiB,EACxB,IAAI,GAAG,oBAAoB,CAC5B,CAAC;IACJ,MAAM,MAAM,GAAG,aAAa,CAC1B,MAAM,CAAC,qCAAqC,EAC5C,IAAI;QACF,wCAAwC,CAC3C,CAAC;IACF,MAAM,OAAO,GAAG,aAAa,CAC3B,MAAM,CAAC,CAAC,EACR,IAAI;QACF,0CAA0C,CAC7C,CAAC;IACF,MAAM,OAAO,GAAG,aAAa,CAC3B,MAAM,CAAC,CAAC,EACR,IAAI;QACF,0CAA0C,CAC7C,CAAC;IAEF,MAAM,SAAS,GACb,OAAO,CAAC,iBAAiB,GAAG,CAAC,CAAC;IAChC,MAAM,SAAS,GACb,OAAO,CAAC,iBAAiB,GAAG,CAAC,CAAC;IAEhC,IACE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;QACf,gBAAgB,GAAG,CAAC;QACpB,SAAS;QACX,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;YACf,iBAAiB,GAAG,CAAC;YACrB,SAAS,EACX,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI;YACF,8DAA8D,CACjE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EACF,gCAAgC;QAClC,gBAAgB;QAChB,iBAAiB;QACjB,qCAAqC,EACnC;YACE,CAAC,EAAE,OAAO;YACV,CAAC,EAAE,OAAO;SACX;QACH,QAAQ,EAAE,iBAAiB,CACzB,MAAM,CAAC,QAAQ,EACf,IAAI,GAAG,WAAW,CACnB;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kCAAkC,CAChD,KAAc;IAEd,MAAM,OAAO,GAAG,aAAa,CAC3B,KAAK,EACL,wBAAwB,CACzB,CAAC;IAEF,IAAI,OAAO,CAAC,aAAa,KAAK,OAAO,EAAE,CAAC;QACtC,MAAM,IAAI,yBAAyB,CACjC,uDAAuD,CACxD,CAAC;IACJ,CAAC;IAED,MAAM,iBAAiB,GACrB,sBAAsB,CACpB,OAAO,CAAC,iBAAiB,EACzB,0CAA0C,CAC3C,CAAC;IAEJ,OAAO;QACL,aAAa,EAAE,OAAO;QACtB,SAAS,EAAE,qBAAqB,CAC9B,OAAO,CAAC,SAAS,EACjB,kCAAkC,CACnC;QACD,sBAAsB,EACpB,qBAAqB,CACnB,OAAO,CAAC,sBAAsB,EAC9B,+CAA+C,CAChD;QACH,sBAAsB,EACpB,qBAAqB,CACnB,OAAO,CAAC,sBAAsB,EAC9B,+CAA+C,CAChD;QACH,QAAQ,EAAE,iBAAiB,CACzB,OAAO,CAAC,QAAQ,EAChB,iCAAiC,CAClC;QACD,iBAAiB;QACjB,0BAA0B,EACxB,+BAA+B,CAC7B,OAAO,CAAC,0BAA0B,EAClC,mDAAmD,EACnD,iBAAiB,CAClB;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CACvB,KAAc,EACd,IAAY;IAEZ,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;QAC5B,KAAK,GAAG,CAAC,EACT,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,IAAI;YACF,iEAAiE,CACpE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,0BAA0B,CACjC,WAA8B;IAE9B,IACE,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC;QACrC,WAAW,CAAC,OAAO,IAAI,CAAC;QACxB,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC;QACtC,WAAW,CAAC,QAAQ,IAAI,CAAC,EACzB,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,gEAAgE,CACjE,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAAyC;IAEzC,0BAA0B,CACxB,KAAK,CAAC,WAAW,CAClB,CAAC;IAEF,MAAM,OAAO,GACX,kCAAkC,CAChC,KAAK,CAAC,uBAAuB,CAC9B,CAAC;IACJ,MAAM,OAAO,GACX,gDAAgD,CAC9C;QACE,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,oBAAoB,EAClB,KAAK,CAAC,oBAAoB;QAC5B,cAAc,EACZ,KAAK,CAAC,2BAA2B;KACpC,CACF,CAAC;IAEJ,IACE,OAAO,CAAC,sBAAsB;QAC9B,OAAO,CAAC,sBAAsB,EAC9B,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,0FAA0F,CAC3F,CAAC;IACJ,CAAC;IACD,IACE,OAAO,CAAC,sBAAsB;QAC9B,OAAO,CAAC,SAAS,EACjB,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,0FAA0F,CAC3F,CAAC;IACJ,CAAC;IAED,IACE,OAAO,CAAC,0BAA0B,CAAC,IAAI;QACvC,YAAY,EACZ,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,6FAA6F,CAC9F,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,gBAAgB,CAC5B,KAAK,CAAC,IAAI,CAAC,CAAC,EACZ,QAAQ,CACT,CAAC;IACF,MAAM,KAAK,GAAG,gBAAgB,CAC5B,KAAK,CAAC,IAAI,CAAC,CAAC,EACZ,QAAQ,CACT,CAAC;IAEF,IACE,KAAK;QACH,OAAO,CAAC,qBAAqB,CAAC,UAAU;QAC1C,KAAK;YACH,OAAO,CAAC,qBAAqB,CAAC,WAAW,EAC3C,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,0DAA0D,CAC3D,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GACX,OAAO,CAAC,iBAAiB,CAAC;IAC5B,MAAM,SAAS,GACb,OAAO,CAAC,qBAAqB,CAAC,UAAU,CAAC;IAC3C,MAAM,UAAU,GACd,OAAO,CAAC,qBAAqB,CAAC,WAAW,CAAC;IAC5C,MAAM,uBAAuB,GAC3B,KAAK,CAAC,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;IACnC,MAAM,wBAAwB,GAC5B,KAAK,CAAC,WAAW,CAAC,QAAQ,GAAG,IAAI,CAAC;IAEpC,MAAM,WAAW,GACf,OAAO;SACJ,gDAAgD;SAChD,CAAC;QACJ,CAAC,SAAS,GAAG,CAAC,CAAC;YACb,OAAO,CAAC,iBAAiB,CAAC;IAC9B,MAAM,WAAW,GACf,OAAO;SACJ,gDAAgD;SAChD,CAAC;QACJ,CAAC,UAAU,GAAG,CAAC,CAAC;YACd,OAAO,CAAC,iBAAiB,CAAC;IAE9B,IACE,WAAW,GAAG,uBAAuB;QACrC,WAAW,GAAG,wBAAwB,EACtC,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,iFAAiF,CAClF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GACZ,OAAO,CAAC,0BAA0B,CAAC;IACrC,MAAM,eAAe,GACnB,QAAQ,CAAC,qCAAqC,CAAC,CAAC,CAAC;IACnD,MAAM,eAAe,GACnB,QAAQ,CAAC,qCAAqC,CAAC,CAAC,CAAC;IACnD,MAAM,iBAAiB,GACrB,QAAQ,CAAC,gBAAgB,GAAG,CAAC,CAAC;IAChC,MAAM,kBAAkB,GACtB,QAAQ,CAAC,iBAAiB,GAAG,CAAC,CAAC;IAEjC,MAAM,iBAAiB,GACrB,OAAO,CAAC,gDAAgD,CAAC,CAAC;QAC1D,eAAe;QACf,iBAAiB,CAAC;IACpB,MAAM,gBAAgB,GACpB,OAAO,CAAC,gDAAgD,CAAC,CAAC;QAC1D,eAAe;QACf,kBAAkB,CAAC;IACrB,MAAM,iBAAiB,GACrB,WAAW;QACX,eAAe;QACf,iBAAiB,CAAC;IACpB,MAAM,kBAAkB,GACtB,WAAW;QACX,eAAe;QACf,kBAAkB,CAAC;IAErB,IACE,iBAAiB,GAAG,CAAC;QACrB,gBAAgB,GAAG,CAAC;QACpB,iBAAiB,GAAG,uBAAuB;QAC3C,kBAAkB,GAAG,wBAAwB,EAC7C,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,6HAA6H,CAC9H,CAAC;IACJ,CAAC;IAED,MAAM,sBAAsB,GAC1B,OAAO;SACJ,gDAAgD;SAChD,CAAC;QACJ,KAAK,GAAG,OAAO,CAAC,iBAAiB,CAAC;IACpC,MAAM,sBAAsB,GAC1B,OAAO;SACJ,gDAAgD;SAChD,CAAC;QACJ,KAAK,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAEpC,MAAM,0BAA0B,GAC9B,sBAAsB;QACtB,QAAQ;aACL,qCAAqC;aACrC,CAAC,CAAC;IACP,MAAM,0BAA0B,GAC9B,sBAAsB;QACtB,QAAQ;aACL,qCAAqC;aACrC,CAAC,CAAC;IACP,MAAM,gBAAgB,GACpB,0BAA0B;QAC1B,QAAQ,CAAC,gBAAgB,GAAG,CAAC,CAAC;IAChC,MAAM,oBAAoB,GACxB,0BAA0B;QAC1B,QAAQ,CAAC,gBAAgB,GAAG,CAAC,CAAC;IAChC,MAAM,gBAAgB,GACpB,0BAA0B;QAC1B,QAAQ,CAAC,iBAAiB,GAAG,CAAC,CAAC;IACjC,MAAM,oBAAoB,GACxB,0BAA0B;QAC1B,QAAQ,CAAC,iBAAiB,GAAG,CAAC,CAAC;IAEjC,IACE,gBAAgB,GAAG,CAAC;QACpB,gBAAgB,GAAG,CAAC;QACpB,oBAAoB;YAClB,uBAAuB;QACzB,oBAAoB;YAClB,wBAAwB,EAC1B,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,0FAA0F,CAC3F,CAAC;IACJ,CAAC;IAED,MAAM,2BAA2B,GAAG;QAClC,CAAC,EACC,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,GAAG,CAAC;YAC9B,sBAAsB,GAAG,IAAI;QAC/B,CAAC,EACC,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,GAAG,CAAC;YAC/B,sBAAsB,GAAG,IAAI;KAChC,CAAC;IACF,MAAM,+BAA+B,GAAG;QACtC,CAAC,EACC,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,GAAG,CAAC;YAC9B,0BAA0B,GAAG,IAAI;QACnC,CAAC,EACC,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,GAAG,CAAC;YAC/B,0BAA0B,GAAG,IAAI;KACpC,CAAC;IACF,MAAM,uBAAuB,GAAG;QAC9B,IAAI,EACF,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,GAAG,CAAC;YAC9B,gBAAgB,GAAG,IAAI;QACzB,KAAK,EACH,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,GAAG,CAAC;YAC9B,oBAAoB,GAAG,IAAI;QAC7B,GAAG,EACD,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,GAAG,CAAC;YAC/B,gBAAgB,GAAG,IAAI;QACzB,MAAM,EACJ,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,GAAG,CAAC;YAC/B,oBAAoB,GAAG,IAAI;KAC9B,CAAC;IAEF,MAAM,qBAAqB,GACzB,QAAQ,CAAC,gBAAgB;QACzB,QAAQ,CAAC,iBAAiB,CAAC;IAC7B,MAAM,gCAAgC,GACpC,OAAO,CAAC,iBAAiB;QACzB,OAAO,CAAC,iBAAiB,CAAC;IAC5B,MAAM,2CAA2C,GAC/C,qBAAqB;QACrB,gCAAgC,CAAC;IAEnC,IACE,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAC;QACvC,CAAC,MAAM,CAAC,QAAQ,CACd,gCAAgC,CACjC;QACD,CAAC,MAAM,CAAC,QAAQ,CACd,2CAA2C,CAC5C,EACD,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,wDAAwD,CACzD,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GACX,wBAAwB,CAAC;QACvB,OAAO,EAAE,KAAK,CAAC,oBAAoB;QACnC,IAAI,EAAE;YACJ,CAAC,EAAE,KAAK;YACR,CAAC,EAAE,KAAK;SACT;KACF,CAAC,CAAC;IAEL,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,sBAAsB,EACpB,OAAO,CAAC,sBAAsB;QAChC,sBAAsB,EACpB,OAAO,CAAC,sBAAsB;QAChC,gBAAgB,EACd,wBAAwB;QAC1B,IAAI,EAAE;YACJ,CAAC,EAAE,KAAK;YACR,CAAC,EAAE,KAAK;SACT;QACD,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS;QACpC,QAAQ,EAAE;YACR,UAAU,EAAE,SAAS;YACrB,WAAW,EAAE,UAAU;SACxB;QACD,OAAO,EAAE;YACP,iBAAiB,EACf,OAAO,CAAC,iBAAiB;YAC3B,iBAAiB,EACf,OAAO,CAAC,iBAAiB;YAC3B,gDAAgD,EAC9C;gBACE,GAAG,OAAO;qBACP,gDAAgD;aACpD;YACH,2CAA2C,EACzC;gBACE,CAAC,EAAE,sBAAsB;gBACzB,CAAC,EAAE,sBAAsB;aAC1B;YACH,2BAA2B;YAC3B,gCAAgC;SACjC;QACD,0BAA0B,EAAE;YAC1B,IAAI,EACF,gCAAgC;YAClC,gBAAgB,EACd,QAAQ,CAAC,gBAAgB;YAC3B,iBAAiB,EACf,QAAQ,CAAC,iBAAiB;YAC5B,qCAAqC,EACnC;gBACE,GAAG,QAAQ;qBACR,qCAAqC;aACzC;YACH,uBAAuB,EACrB,+BAA+B;YACjC,uBAAuB;YACvB,qBAAqB;YACrB,2CAA2C;YAC3C,gBAAgB,EACd,2BAA2B;YAC7B,mCAAmC,EACjC,eAAe;SAClB;QACD,qCAAqC,EACnC,KAAK;QACP,4BAA4B,EAAE,KAAK;QACnC,4BAA4B,EAAE,KAAK;QACnC,sCAAsC,EACpC,KAAK;QACP,uBAAuB,EAAE,KAAK;QAC9B,2BAA2B,EAAE,KAAK;QAClC,wBAAwB,EAAE,KAAK;QAC/B,yBAAyB,EAAE,KAAK;QAChC,yBAAyB,EAAE,KAAK;QAChC,oCAAoC,EAClC,KAAK;QACP,qCAAqC,EACnC,KAAK;QACP,UAAU,EAAE;YACV,OAAO,EAAE,OAAO,CAAC,QAAQ;YACzB,OAAO,EAAE,OAAO,CAAC,QAAQ;YACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;SAC5B;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"sampling-aperture.js","sourceRoot":"","sources":["../../src/sensor/sampling-aperture.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EACL,iBAAiB,EAElB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EACL,gDAAgD,EAEjD,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,wBAAwB,EAGzB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AA8IzG,SAAS,aAAa,CACpB,KAAc,EACd,IAAY,EACZ,WAAqC;IAErC,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EACpB,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI,GAAG,qBAAqB,CAC7B,CAAC;IACJ,CAAC;IACD,IAAI,WAAW,KAAK,IAAI;QAAE,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;IACxE,OAAO,KAAsB,CAAC;AAChC,CAAC;AAED,SAAS,qBAAqB,CAC5B,KAAc,EACd,IAAY;IAEZ,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EACzB,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI,GAAG,8BAA8B,CACtC,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,qBAAqB,CAC5B,KAAc,EACd,IAAY;IAEZ,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACvB,KAAK,IAAI,CAAC,EACV,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI;YACF,6CAA6C,CAChD,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CACpB,KAAc,EACd,IAAY;IAEZ,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EACvB,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI,GAAG,2BAA2B,CACnC,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,sBAAsB,CAC7B,KAAc,EACd,IAAY;IAEZ,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,kBAAkB,EAAE,kDAAkD,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,UAAU,CAAC,CAAC,CAAC;IAElL,IACE,MAAM,CAAC,IAAI;QACX,yCAAyC,EACzC,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI,GAAG,mBAAmB,CAC3B,CAAC;IACJ,CAAC;IACD,IACE,MAAM,CAAC,gBAAgB;QACvB,wBAAwB,EACxB,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI;YACF,qDAAqD,CACxD,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,aAAa,CAC/B,MAAM,CAAC,gDAAgD,EACvD,IAAI;QACF,mDAAmD,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAClE,CAAC;IAEF,MAAM,MAAM,GAAG,aAAa,CAC1B,WAAW,CAAC,CAAC,EACb,IAAI;QACF,qDAAqD,CACxD,CAAC;IACF,MAAM,MAAM,GAAG,aAAa,CAC1B,WAAW,CAAC,CAAC,EACb,IAAI;QACF,qDAAqD,CACxD,CAAC;IAEF,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,yBAAyB,CACjC,IAAI;YACF,yEAAyE,CAC5E,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EACF,yCAAyC;QAC3C,gBAAgB,EACd,wBAAwB;QAC1B,iBAAiB,EACf,qBAAqB,CACnB,MAAM,CAAC,iBAAiB,EACxB,IAAI,GAAG,oBAAoB,CAC5B;QACH,iBAAiB,EACf,qBAAqB,CACnB,MAAM,CAAC,iBAAiB,EACxB,IAAI,GAAG,oBAAoB,CAC5B;QACH,gDAAgD,EAC9C;YACE,CAAC,EAAE,MAAM;YACT,CAAC,EAAE,MAAM;SACV;QACH,QAAQ,EAAE,iBAAiB,CACzB,MAAM,CAAC,QAAQ,EACf,IAAI,GAAG,WAAW,CACnB;KACF,CAAC;AACJ,CAAC;AAED,SAAS,+BAA+B,CACtC,KAAc,EACd,IAAY,EACZ,OAA4C;IAE5C,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,uCAAuC,EAAE,UAAU,CAAC,CAAC,CAAC;IAElJ,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACjC,IACE,MAAM,CAAC,gBAAgB,KAAK,SAAS;YACrC,MAAM,CAAC,iBAAiB,KAAK,SAAS;YACtC,MAAM,CAAC,qCAAqC;gBAC1C,SAAS,EACX,CAAC;YACD,MAAM,IAAI,yBAAyB,CACjC,IAAI;gBACF,kDAAkD,CACrD,CAAC;QACJ,CAAC;QACD,OAAO;YACL,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE,iBAAiB,CACzB,MAAM,CAAC,QAAQ,EACf,IAAI,GAAG,WAAW,CACnB;SACF,CAAC;IACJ,CAAC;IAED,IACE,MAAM,CAAC,IAAI;QACX,gCAAgC,EAChC,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI,GAAG,mBAAmB,CAC3B,CAAC;IACJ,CAAC;IAED,MAAM,gBAAgB,GACpB,qBAAqB,CACnB,MAAM,CAAC,gBAAgB,EACvB,IAAI,GAAG,mBAAmB,CAC3B,CAAC;IACJ,MAAM,iBAAiB,GACrB,qBAAqB,CACnB,MAAM,CAAC,iBAAiB,EACxB,IAAI,GAAG,oBAAoB,CAC5B,CAAC;IACJ,MAAM,MAAM,GAAG,aAAa,CAC1B,MAAM,CAAC,qCAAqC,EAC5C,IAAI;QACF,wCAAwC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CACvD,CAAC;IACF,MAAM,OAAO,GAAG,aAAa,CAC3B,MAAM,CAAC,CAAC,EACR,IAAI;QACF,0CAA0C,CAC7C,CAAC;IACF,MAAM,OAAO,GAAG,aAAa,CAC3B,MAAM,CAAC,CAAC,EACR,IAAI;QACF,0CAA0C,CAC7C,CAAC;IAEF,MAAM,SAAS,GACb,OAAO,CAAC,iBAAiB,GAAG,CAAC,CAAC;IAChC,MAAM,SAAS,GACb,OAAO,CAAC,iBAAiB,GAAG,CAAC,CAAC;IAEhC,IACE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;QACf,gBAAgB,GAAG,CAAC;QACpB,SAAS;QACX,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;YACf,iBAAiB,GAAG,CAAC;YACrB,SAAS,EACX,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI;YACF,8DAA8D,CACjE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EACF,gCAAgC;QAClC,gBAAgB;QAChB,iBAAiB;QACjB,qCAAqC,EACnC;YACE,CAAC,EAAE,OAAO;YACV,CAAC,EAAE,OAAO;SACX;QACH,QAAQ,EAAE,iBAAiB,CACzB,MAAM,CAAC,QAAQ,EACf,IAAI,GAAG,WAAW,CACnB;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kCAAkC,CAChD,KAAc;IAEd,MAAM,OAAO,GAAG,aAAa,CAC3B,KAAK,EACL,wBAAwB,EAAE,CAAC,eAAe,EAAE,mBAAmB,EAAE,WAAW,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,UAAU,EAAE,4BAA4B,CAAC,CAC5K,CAAC;IAEF,IAAI,OAAO,CAAC,aAAa,KAAK,OAAO,EAAE,CAAC;QACtC,MAAM,IAAI,yBAAyB,CACjC,uDAAuD,CACxD,CAAC;IACJ,CAAC;IAED,MAAM,iBAAiB,GACrB,sBAAsB,CACpB,OAAO,CAAC,iBAAiB,EACzB,0CAA0C,CAC3C,CAAC;IAEJ,OAAO;QACL,aAAa,EAAE,OAAO;QACtB,SAAS,EAAE,qBAAqB,CAC9B,OAAO,CAAC,SAAS,EACjB,kCAAkC,CACnC;QACD,sBAAsB,EACpB,qBAAqB,CACnB,OAAO,CAAC,sBAAsB,EAC9B,+CAA+C,CAChD;QACH,sBAAsB,EACpB,qBAAqB,CACnB,OAAO,CAAC,sBAAsB,EAC9B,+CAA+C,CAChD;QACH,QAAQ,EAAE,iBAAiB,CACzB,OAAO,CAAC,QAAQ,EAChB,iCAAiC,CAClC;QACD,iBAAiB;QACjB,0BAA0B,EACxB,+BAA+B,CAC7B,OAAO,CAAC,0BAA0B,EAClC,mDAAmD,EACnD,iBAAiB,CAClB;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CACvB,KAAc,EACd,IAAY;IAEZ,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;QAC5B,KAAK,GAAG,CAAC,EACT,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,IAAI;YACF,iEAAiE,CACpE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,0BAA0B,CACjC,WAA8B;IAE9B,kBAAkB,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;IACrD,IACE,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC;QACrC,WAAW,CAAC,OAAO,IAAI,CAAC;QACxB,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC;QACtC,WAAW,CAAC,QAAQ,IAAI,CAAC,EACzB,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,gEAAgE,CACjE,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAAyC;IAEzC,gBAAgB,CAAC,KAAK,EAAE,+BAA+B,EAAE,CAAC,aAAa,EAAE,cAAc,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,MAAM,CAAC,CAAC,CAAC;IACpL,0BAA0B,CACxB,KAAK,CAAC,WAAW,CAClB,CAAC;IAEF,MAAM,OAAO,GACX,kCAAkC,CAChC,KAAK,CAAC,uBAAuB,CAC9B,CAAC;IACJ,MAAM,OAAO,GACX,gDAAgD,CAC9C;QACE,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,oBAAoB,EAClB,KAAK,CAAC,oBAAoB;QAC5B,cAAc,EACZ,KAAK,CAAC,2BAA2B;KACpC,CACF,CAAC;IAEJ,IACE,OAAO,CAAC,sBAAsB;QAC9B,OAAO,CAAC,sBAAsB,EAC9B,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,0FAA0F,CAC3F,CAAC;IACJ,CAAC;IACD,IACE,OAAO,CAAC,sBAAsB;QAC9B,OAAO,CAAC,SAAS,EACjB,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,0FAA0F,CAC3F,CAAC;IACJ,CAAC;IAED,IACE,OAAO,CAAC,0BAA0B,CAAC,IAAI;QACvC,YAAY,EACZ,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,6FAA6F,CAC9F,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,gBAAgB,CAC5B,KAAK,CAAC,IAAI,CAAC,CAAC,EACZ,QAAQ,CACT,CAAC;IACF,MAAM,KAAK,GAAG,gBAAgB,CAC5B,KAAK,CAAC,IAAI,CAAC,CAAC,EACZ,QAAQ,CACT,CAAC;IAEF,IACE,KAAK;QACH,OAAO,CAAC,qBAAqB,CAAC,UAAU;QAC1C,KAAK;YACH,OAAO,CAAC,qBAAqB,CAAC,WAAW,EAC3C,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,0DAA0D,CAC3D,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GACX,OAAO,CAAC,iBAAiB,CAAC;IAC5B,MAAM,SAAS,GACb,OAAO,CAAC,qBAAqB,CAAC,UAAU,CAAC;IAC3C,MAAM,UAAU,GACd,OAAO,CAAC,qBAAqB,CAAC,WAAW,CAAC;IAC5C,MAAM,uBAAuB,GAC3B,KAAK,CAAC,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;IACnC,MAAM,wBAAwB,GAC5B,KAAK,CAAC,WAAW,CAAC,QAAQ,GAAG,IAAI,CAAC;IAEpC,MAAM,WAAW,GACf,OAAO;SACJ,gDAAgD;SAChD,CAAC;QACJ,CAAC,SAAS,GAAG,CAAC,CAAC;YACb,OAAO,CAAC,iBAAiB,CAAC;IAC9B,MAAM,WAAW,GACf,OAAO;SACJ,gDAAgD;SAChD,CAAC;QACJ,CAAC,UAAU,GAAG,CAAC,CAAC;YACd,OAAO,CAAC,iBAAiB,CAAC;IAE9B,IACE,WAAW,GAAG,uBAAuB;QACrC,WAAW,GAAG,wBAAwB,EACtC,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,iFAAiF,CAClF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GACZ,OAAO,CAAC,0BAA0B,CAAC;IACrC,MAAM,eAAe,GACnB,QAAQ,CAAC,qCAAqC,CAAC,CAAC,CAAC;IACnD,MAAM,eAAe,GACnB,QAAQ,CAAC,qCAAqC,CAAC,CAAC,CAAC;IACnD,MAAM,iBAAiB,GACrB,QAAQ,CAAC,gBAAgB,GAAG,CAAC,CAAC;IAChC,MAAM,kBAAkB,GACtB,QAAQ,CAAC,iBAAiB,GAAG,CAAC,CAAC;IAEjC,MAAM,iBAAiB,GACrB,OAAO,CAAC,gDAAgD,CAAC,CAAC;QAC1D,eAAe;QACf,iBAAiB,CAAC;IACpB,MAAM,gBAAgB,GACpB,OAAO,CAAC,gDAAgD,CAAC,CAAC;QAC1D,eAAe;QACf,kBAAkB,CAAC;IACrB,MAAM,iBAAiB,GACrB,WAAW;QACX,eAAe;QACf,iBAAiB,CAAC;IACpB,MAAM,kBAAkB,GACtB,WAAW;QACX,eAAe;QACf,kBAAkB,CAAC;IAErB,IACE,iBAAiB,GAAG,CAAC;QACrB,gBAAgB,GAAG,CAAC;QACpB,iBAAiB,GAAG,uBAAuB;QAC3C,kBAAkB,GAAG,wBAAwB,EAC7C,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,6HAA6H,CAC9H,CAAC;IACJ,CAAC;IAED,MAAM,sBAAsB,GAC1B,OAAO;SACJ,gDAAgD;SAChD,CAAC;QACJ,KAAK,GAAG,OAAO,CAAC,iBAAiB,CAAC;IACpC,MAAM,sBAAsB,GAC1B,OAAO;SACJ,gDAAgD;SAChD,CAAC;QACJ,KAAK,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAEpC,MAAM,0BAA0B,GAC9B,sBAAsB;QACtB,QAAQ;aACL,qCAAqC;aACrC,CAAC,CAAC;IACP,MAAM,0BAA0B,GAC9B,sBAAsB;QACtB,QAAQ;aACL,qCAAqC;aACrC,CAAC,CAAC;IACP,MAAM,gBAAgB,GACpB,0BAA0B;QAC1B,QAAQ,CAAC,gBAAgB,GAAG,CAAC,CAAC;IAChC,MAAM,oBAAoB,GACxB,0BAA0B;QAC1B,QAAQ,CAAC,gBAAgB,GAAG,CAAC,CAAC;IAChC,MAAM,gBAAgB,GACpB,0BAA0B;QAC1B,QAAQ,CAAC,iBAAiB,GAAG,CAAC,CAAC;IACjC,MAAM,oBAAoB,GACxB,0BAA0B;QAC1B,QAAQ,CAAC,iBAAiB,GAAG,CAAC,CAAC;IAEjC,IACE,gBAAgB,GAAG,CAAC;QACpB,gBAAgB,GAAG,CAAC;QACpB,oBAAoB;YAClB,uBAAuB;QACzB,oBAAoB;YAClB,wBAAwB,EAC1B,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,0FAA0F,CAC3F,CAAC;IACJ,CAAC;IAED,MAAM,2BAA2B,GAAG;QAClC,CAAC,EACC,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,GAAG,CAAC;YAC9B,sBAAsB,GAAG,IAAI;QAC/B,CAAC,EACC,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,GAAG,CAAC;YAC/B,sBAAsB,GAAG,IAAI;KAChC,CAAC;IACF,MAAM,+BAA+B,GAAG;QACtC,CAAC,EACC,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,GAAG,CAAC;YAC9B,0BAA0B,GAAG,IAAI;QACnC,CAAC,EACC,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,GAAG,CAAC;YAC/B,0BAA0B,GAAG,IAAI;KACpC,CAAC;IACF,MAAM,uBAAuB,GAAG;QAC9B,IAAI,EACF,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,GAAG,CAAC;YAC9B,gBAAgB,GAAG,IAAI;QACzB,KAAK,EACH,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,GAAG,CAAC;YAC9B,oBAAoB,GAAG,IAAI;QAC7B,GAAG,EACD,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,GAAG,CAAC;YAC/B,gBAAgB,GAAG,IAAI;QACzB,MAAM,EACJ,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,GAAG,CAAC;YAC/B,oBAAoB,GAAG,IAAI;KAC9B,CAAC;IAEF,MAAM,qBAAqB,GACzB,QAAQ,CAAC,gBAAgB;QACzB,QAAQ,CAAC,iBAAiB,CAAC;IAC7B,MAAM,gCAAgC,GACpC,OAAO,CAAC,iBAAiB;QACzB,OAAO,CAAC,iBAAiB,CAAC;IAC5B,MAAM,2CAA2C,GAC/C,qBAAqB;QACrB,gCAAgC,CAAC;IAEnC,IACE,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAC;QACvC,CAAC,MAAM,CAAC,QAAQ,CACd,gCAAgC,CACjC;QACD,CAAC,MAAM,CAAC,QAAQ,CACd,2CAA2C,CAC5C,EACD,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,wDAAwD,CACzD,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GACX,wBAAwB,CAAC;QACvB,OAAO,EAAE,KAAK,CAAC,oBAAoB;QACnC,IAAI,EAAE;YACJ,CAAC,EAAE,KAAK;YACR,CAAC,EAAE,KAAK;SACT;KACF,CAAC,CAAC;IAEL,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,sBAAsB,EACpB,OAAO,CAAC,sBAAsB;QAChC,sBAAsB,EACpB,OAAO,CAAC,sBAAsB;QAChC,gBAAgB,EACd,wBAAwB;QAC1B,IAAI,EAAE;YACJ,CAAC,EAAE,KAAK;YACR,CAAC,EAAE,KAAK;SACT;QACD,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS;QACpC,QAAQ,EAAE;YACR,UAAU,EAAE,SAAS;YACrB,WAAW,EAAE,UAAU;SACxB;QACD,OAAO,EAAE;YACP,iBAAiB,EACf,OAAO,CAAC,iBAAiB;YAC3B,iBAAiB,EACf,OAAO,CAAC,iBAAiB;YAC3B,gDAAgD,EAC9C;gBACE,GAAG,OAAO;qBACP,gDAAgD;aACpD;YACH,2CAA2C,EACzC;gBACE,CAAC,EAAE,sBAAsB;gBACzB,CAAC,EAAE,sBAAsB;aAC1B;YACH,2BAA2B;YAC3B,gCAAgC;SACjC;QACD,0BAA0B,EAAE;YAC1B,IAAI,EACF,gCAAgC;YAClC,gBAAgB,EACd,QAAQ,CAAC,gBAAgB;YAC3B,iBAAiB,EACf,QAAQ,CAAC,iBAAiB;YAC5B,qCAAqC,EACnC;gBACE,GAAG,QAAQ;qBACR,qCAAqC;aACzC;YACH,uBAAuB,EACrB,+BAA+B;YACjC,uBAAuB;YACvB,qBAAqB;YACrB,2CAA2C;YAC3C,gBAAgB,EACd,2BAA2B;YAC7B,mCAAmC,EACjC,eAAe;SAClB;QACD,qCAAqC,EACnC,KAAK;QACP,4BAA4B,EAAE,KAAK;QACnC,4BAA4B,EAAE,KAAK;QACnC,sCAAsC,EACpC,KAAK;QACP,uBAAuB,EAAE,KAAK;QAC9B,2BAA2B,EAAE,KAAK;QAClC,wBAAwB,EAAE,KAAK;QAC/B,yBAAyB,EAAE,KAAK;QAChC,yBAAyB,EAAE,KAAK;QAChC,oCAAoC,EAClC,KAAK;QACP,qCAAqC,EACnC,KAAK;QACP,UAAU,EAAE;YACV,OAAO,EAAE,OAAO,CAAC,QAAQ;YACzB,OAAO,EAAE,OAAO,CAAC,QAAQ;YACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;SAC5B;KACF,CAAC;AACJ,CAAC","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Sampling aperture: where the colour-sampling sites sit physically on the sensor, and the\n * light-sensitive area of each site as a simple geometric shape.\n *\n * Site pitch and origin are declared facts, never derived from NativeImageRaster. The sensitive\n * region, when known, is a plain geometric rectangle. It does not include microlens effects, charge\n * diffusion, electrical crosstalk, QE (quantum efficiency), throughput, spectral response or an\n * effective light-collection area.\n * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support\n * limits.\n */\n\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\nimport {\n  parseEvidenceList,\n  type EvidenceProvenance\n} from \"../core/evidence-provenance.js\";\nimport { InvalidScientificInputError } from \"../core/validation.js\";\nimport {\n  resolveNativeEffectiveRasterColorSamplingBinding,\n  type NativeEffectiveRasterColorSamplingBindingProfile\n} from \"./capture-color-sampling-binding.js\";\nimport {\n  resolveColorSamplingSite,\n  type NativeColorSamplingSiteIndex,\n  type SensorColorSamplingProfile\n} from \"./color-sampling.js\";\nimport type {\n  NativeImageRaster,\n  SensorImagingArea\n} from \"./sensor-geometry.js\";\nimport { requireInputObject, requireInputKeys, rejectUnknownFields } from \"../core/record-validation.js\";\n\ntype UnknownRecord = Record<string, unknown>;\n\nexport interface SensorSiteCenterLatticeRegistration {\n  kind: \"regular-rectangular-site-center-lattice\";\n  coordinateSystem: \"native-sensor-physical\";\n  /** Horizontal centre-to-centre site spacing (pitch) in micrometres. */\n  pitchXMicrometers: number;\n  /** Vertical centre-to-centre site spacing (pitch) in micrometres. */\n  pitchYMicrometers: number;\n  /**\n   * Centre of the first site, measured from the imaging area's physical\n   * top-left corner. +X right, +Y down. Units: micrometres.\n   */\n  firstSiteCenterFromImagingAreaTopLeftMicrometers: {\n    x: number;\n    y: number;\n  };\n  evidence: readonly EvidenceProvenance[];\n}\n\nexport type SensorGeometricSensitiveAperture =\n  | {\n      /**\n       * The light-sensitive area is known to matter, but its shape is not\n       * known well enough to use.\n       */\n      kind: \"unresolved\";\n      evidence: readonly EvidenceProvenance[];\n    }\n  | {\n      /**\n       * A simple approximation of the sensitive area as a rectangle.\n       *\n       * The rectangle must stay inside one grid cell, so neighbouring\n       * sensitive areas never overlap in schema 0.1.0.\n       */\n      kind: \"uniform-axis-aligned-rectangle\";\n      widthMicrometers: number;\n      heightMicrometers: number;\n      centerOffsetFromSiteCenterMicrometers: {\n        x: number;\n        y: number;\n      };\n      evidence: readonly EvidenceProvenance[];\n    };\n\nexport interface SensorSamplingApertureProfile {\n  schemaVersion: \"0.1.0\";\n  profileId: string;\n  colorSamplingProfileId: string;\n  colorSamplingBindingId: string;\n  evidence: readonly EvidenceProvenance[];\n  siteCenterLattice: SensorSiteCenterLatticeRegistration;\n  geometricSensitiveAperture: SensorGeometricSensitiveAperture;\n}\n\nexport interface ResolveSensorSamplingApertureInput {\n  imagingArea: SensorImagingArea;\n  nativeRaster: NativeImageRaster;\n  colorSamplingProfile: SensorColorSamplingProfile;\n  colorSamplingBindingProfile: NativeEffectiveRasterColorSamplingBindingProfile;\n  samplingApertureProfile: SensorSamplingApertureProfile;\n  site: NativeColorSamplingSiteIndex;\n}\n\nexport interface NativeSensorPhysicalPointMm {\n  x: number;\n  y: number;\n}\n\nexport interface NativeSensorPhysicalBoundsMm {\n  left: number;\n  right: number;\n  top: number;\n  bottom: number;\n}\n\nexport interface ResolvedSensorSamplingAperture {\n  profileId: string;\n  colorSamplingProfileId: string;\n  colorSamplingBindingId: string;\n  coordinateSystem: \"native-sensor-physical\";\n  site: NativeColorSamplingSiteIndex;\n  channelId: string;\n  siteGrid: {\n    widthSites: number;\n    heightSites: number;\n  };\n  lattice: {\n    pitchXMicrometers: number;\n    pitchYMicrometers: number;\n    firstSiteCenterFromImagingAreaTopLeftMicrometers: {\n      x: number;\n      y: number;\n    };\n    siteCenterFromImagingAreaTopLeftMicrometers: {\n      x: number;\n      y: number;\n    };\n    siteCenterFromOpticalAxisMm: NativeSensorPhysicalPointMm;\n    nominalCellAreaSquareMicrometers: number;\n  };\n  geometricSensitiveAperture: {\n    kind: \"uniform-axis-aligned-rectangle\";\n    widthMicrometers: number;\n    heightMicrometers: number;\n    centerOffsetFromSiteCenterMicrometers: {\n      x: number;\n      y: number;\n    };\n    centerFromOpticalAxisMm: NativeSensorPhysicalPointMm;\n    boundsFromOpticalAxisMm: NativeSensorPhysicalBoundsMm;\n    areaSquareMicrometers: number;\n    geometricSensitiveAreaFractionOfLatticeCell: number;\n    spatialWeighting:\n      \"uniform-unit-area-average\";\n    neighboringGeometricApertureOverlap:\n      \"none-by-model\";\n  };\n  /**\n   * Fixed statements of what this result does not establish.\n   */\n  sitePitchDerivedFromNativeImageRaster: false;\n  apertureDerivedFromSitePitch: false;\n  antiAliasingResponseIncluded: false;\n  microlensSpatialRedistributionIncluded: false;\n  chargeDiffusionIncluded: false;\n  electricalCrosstalkIncluded: false;\n  spectralResponseIncluded: false;\n  quantumEfficiencyIncluded: false;\n  opticalThroughputIncluded: false;\n  radiometricCollectionAreaEstablished: false;\n  physicalPhotodiodeGeometryEstablished: false;\n  provenance: {\n    profile: readonly EvidenceProvenance[];\n    lattice: readonly EvidenceProvenance[];\n    aperture: readonly EvidenceProvenance[];\n  };\n}\n\nfunction requireRecord(\n  value: unknown,\n  path: string,\n  allowedKeys: readonly string[] | null\n): UnknownRecord {\n  if (\n    typeof value !== \"object\" ||\n    value === null ||\n    Array.isArray(value)\n  ) {\n    throw new InvalidConfigurationError(\n      path + \" must be an object.\"\n    );\n  }\n  if (allowedKeys !== null) rejectUnknownFields(value, allowedKeys, path);\n  return value as UnknownRecord;\n}\n\nfunction requireNonEmptyString(\n  value: unknown,\n  path: string\n): string {\n  if (\n    typeof value !== \"string\" ||\n    value.trim().length === 0\n  ) {\n    throw new InvalidConfigurationError(\n      path + \" must be a non-empty string.\"\n    );\n  }\n  return value;\n}\n\nfunction requirePositiveFinite(\n  value: unknown,\n  path: string\n): number {\n  if (\n    typeof value !== \"number\" ||\n    !Number.isFinite(value) ||\n    value <= 0\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \" must be a finite number greater than zero.\"\n    );\n  }\n  return value;\n}\n\nfunction requireFinite(\n  value: unknown,\n  path: string\n): number {\n  if (\n    typeof value !== \"number\" ||\n    !Number.isFinite(value)\n  ) {\n    throw new InvalidConfigurationError(\n      path + \" must be a finite number.\"\n    );\n  }\n  return value;\n}\n\nfunction parseSiteCenterLattice(\n  value: unknown,\n  path: string\n): SensorSiteCenterLatticeRegistration {\n  const record = requireRecord(value, path, [\"kind\", \"coordinateSystem\", \"firstSiteCenterFromImagingAreaTopLeftMicrometers\", \"pitchXMicrometers\", \"pitchYMicrometers\", \"evidence\"]);\n\n  if (\n    record.kind !==\n    \"regular-rectangular-site-center-lattice\"\n  ) {\n    throw new InvalidConfigurationError(\n      path + \".kind is invalid.\"\n    );\n  }\n  if (\n    record.coordinateSystem !==\n    \"native-sensor-physical\"\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        '.coordinateSystem must be \"native-sensor-physical\".'\n    );\n  }\n\n  const firstCenter = requireRecord(\n    record.firstSiteCenterFromImagingAreaTopLeftMicrometers,\n    path +\n      \".firstSiteCenterFromImagingAreaTopLeftMicrometers\", [\"x\", \"y\"]\n  );\n\n  const firstX = requireFinite(\n    firstCenter.x,\n    path +\n      \".firstSiteCenterFromImagingAreaTopLeftMicrometers.x\"\n  );\n  const firstY = requireFinite(\n    firstCenter.y,\n    path +\n      \".firstSiteCenterFromImagingAreaTopLeftMicrometers.y\"\n  );\n\n  if (firstX < 0 || firstY < 0) {\n    throw new InvalidConfigurationError(\n      path +\n        \".firstSiteCenterFromImagingAreaTopLeftMicrometers must not be negative.\"\n    );\n  }\n\n  return {\n    kind:\n      \"regular-rectangular-site-center-lattice\",\n    coordinateSystem:\n      \"native-sensor-physical\",\n    pitchXMicrometers:\n      requirePositiveFinite(\n        record.pitchXMicrometers,\n        path + \".pitchXMicrometers\"\n      ),\n    pitchYMicrometers:\n      requirePositiveFinite(\n        record.pitchYMicrometers,\n        path + \".pitchYMicrometers\"\n      ),\n    firstSiteCenterFromImagingAreaTopLeftMicrometers:\n      {\n        x: firstX,\n        y: firstY\n      },\n    evidence: parseEvidenceList(\n      record.evidence,\n      path + \".evidence\"\n    )\n  };\n}\n\nfunction parseGeometricSensitiveAperture(\n  value: unknown,\n  path: string,\n  lattice: SensorSiteCenterLatticeRegistration\n): SensorGeometricSensitiveAperture {\n  const record = requireRecord(value, path, [\"kind\", \"widthMicrometers\", \"heightMicrometers\", \"centerOffsetFromSiteCenterMicrometers\", \"evidence\"]);\n\n  if (record.kind === \"unresolved\") {\n    if (\n      record.widthMicrometers !== undefined ||\n      record.heightMicrometers !== undefined ||\n      record.centerOffsetFromSiteCenterMicrometers !==\n        undefined\n    ) {\n      throw new InvalidConfigurationError(\n        path +\n          \" unresolved aperture must omit rectangle fields.\"\n      );\n    }\n    return {\n      kind: \"unresolved\",\n      evidence: parseEvidenceList(\n        record.evidence,\n        path + \".evidence\"\n      )\n    };\n  }\n\n  if (\n    record.kind !==\n    \"uniform-axis-aligned-rectangle\"\n  ) {\n    throw new InvalidConfigurationError(\n      path + \".kind is invalid.\"\n    );\n  }\n\n  const widthMicrometers =\n    requirePositiveFinite(\n      record.widthMicrometers,\n      path + \".widthMicrometers\"\n    );\n  const heightMicrometers =\n    requirePositiveFinite(\n      record.heightMicrometers,\n      path + \".heightMicrometers\"\n    );\n  const offset = requireRecord(\n    record.centerOffsetFromSiteCenterMicrometers,\n    path +\n      \".centerOffsetFromSiteCenterMicrometers\", [\"x\", \"y\"]\n  );\n  const offsetX = requireFinite(\n    offset.x,\n    path +\n      \".centerOffsetFromSiteCenterMicrometers.x\"\n  );\n  const offsetY = requireFinite(\n    offset.y,\n    path +\n      \".centerOffsetFromSiteCenterMicrometers.y\"\n  );\n\n  const halfCellX =\n    lattice.pitchXMicrometers / 2;\n  const halfCellY =\n    lattice.pitchYMicrometers / 2;\n\n  if (\n    Math.abs(offsetX) +\n      widthMicrometers / 2 >\n      halfCellX ||\n    Math.abs(offsetY) +\n      heightMicrometers / 2 >\n      halfCellY\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \" rectangle must remain within one regular site lattice cell.\"\n    );\n  }\n\n  return {\n    kind:\n      \"uniform-axis-aligned-rectangle\",\n    widthMicrometers,\n    heightMicrometers,\n    centerOffsetFromSiteCenterMicrometers:\n      {\n        x: offsetX,\n        y: offsetY\n      },\n    evidence: parseEvidenceList(\n      record.evidence,\n      path + \".evidence\"\n    )\n  };\n}\n\n/**\n * Parses where the colour-sampling sites sit physically, plus a simple geometric\n * model of each site's light-sensitive area.\n *\n * Site pitch and origin are declared facts, never derived from NativeImageRaster.\n * The rectangle, when given, is a geometric sensitive region only. It does not\n * include microlens effects, charge diffusion, electrical crosstalk, QE,\n * throughput, spectral response or an effective light-collection area.\n */\nexport function parseSensorSamplingApertureProfile(\n  value: unknown\n): SensorSamplingApertureProfile {\n  const profile = requireRecord(\n    value,\n    \"sensorSamplingAperture\", [\"schemaVersion\", \"siteCenterLattice\", \"profileId\", \"colorSamplingProfileId\", \"colorSamplingBindingId\", \"evidence\", \"geometricSensitiveAperture\"]\n  );\n\n  if (profile.schemaVersion !== \"0.1.0\") {\n    throw new InvalidConfigurationError(\n      'sensorSamplingAperture.schemaVersion must be \"0.1.0\".'\n    );\n  }\n\n  const siteCenterLattice =\n    parseSiteCenterLattice(\n      profile.siteCenterLattice,\n      \"sensorSamplingAperture.siteCenterLattice\"\n    );\n\n  return {\n    schemaVersion: \"0.1.0\",\n    profileId: requireNonEmptyString(\n      profile.profileId,\n      \"sensorSamplingAperture.profileId\"\n    ),\n    colorSamplingProfileId:\n      requireNonEmptyString(\n        profile.colorSamplingProfileId,\n        \"sensorSamplingAperture.colorSamplingProfileId\"\n      ),\n    colorSamplingBindingId:\n      requireNonEmptyString(\n        profile.colorSamplingBindingId,\n        \"sensorSamplingAperture.colorSamplingBindingId\"\n      ),\n    evidence: parseEvidenceList(\n      profile.evidence,\n      \"sensorSamplingAperture.evidence\"\n    ),\n    siteCenterLattice,\n    geometricSensitiveAperture:\n      parseGeometricSensitiveAperture(\n        profile.geometricSensitiveAperture,\n        \"sensorSamplingAperture.geometricSensitiveAperture\",\n        siteCenterLattice\n      )\n  };\n}\n\nfunction requireSiteIndex(\n  value: unknown,\n  path: string\n): number {\n  if (\n    typeof value !== \"number\" ||\n    !Number.isSafeInteger(value) ||\n    value < 0\n  ) {\n    throw new InvalidScientificInputError(\n      path +\n        \" must be a non-negative safe integer color-sampling-site index.\"\n    );\n  }\n  return value;\n}\n\nfunction requirePositiveImagingArea(\n  imagingArea: SensorImagingArea\n): void {\n  requireInputObject(imagingArea, \"imagingArea input\");\n  if (\n    !Number.isFinite(imagingArea.widthMm) ||\n    imagingArea.widthMm <= 0 ||\n    !Number.isFinite(imagingArea.heightMm) ||\n    imagingArea.heightMm <= 0\n  ) {\n    throw new InvalidScientificInputError(\n      \"imagingArea width/height must be finite and greater than zero.\"\n    );\n  }\n}\n\n/**\n * Resolves one site's geometric sampling aperture in native sensor physical space.\n *\n * The result is a normalized footprint that averages evenly over its area, for\n * image sampling, plus its physical area and fill fraction. That geometric area\n * is deliberately not treated as light-collection efficiency or as the true\n * photodiode shape.\n */\nexport function resolveSensorSamplingAperture(\n  input: ResolveSensorSamplingApertureInput\n): ResolvedSensorSamplingAperture {\n  requireInputKeys(input, \"resolveSensorSamplingAperture\", [\"imagingArea\", \"nativeRaster\", \"colorSamplingProfile\", \"colorSamplingBindingProfile\", \"samplingApertureProfile\", \"site\"]);\n  requirePositiveImagingArea(\n    input.imagingArea\n  );\n\n  const profile =\n    parseSensorSamplingApertureProfile(\n      input.samplingApertureProfile\n    );\n  const binding =\n    resolveNativeEffectiveRasterColorSamplingBinding(\n      {\n        nativeRaster: input.nativeRaster,\n        colorSamplingProfile:\n          input.colorSamplingProfile,\n        bindingProfile:\n          input.colorSamplingBindingProfile\n      }\n    );\n\n  if (\n    profile.colorSamplingProfileId !==\n    binding.colorSamplingProfileId\n  ) {\n    throw new InvalidScientificInputError(\n      \"Sampling-aperture colorSamplingProfileId must match the resolved color-sampling profile.\"\n    );\n  }\n  if (\n    profile.colorSamplingBindingId !==\n    binding.bindingId\n  ) {\n    throw new InvalidScientificInputError(\n      \"Sampling-aperture colorSamplingBindingId must match the resolved color-sampling binding.\"\n    );\n  }\n\n  if (\n    profile.geometricSensitiveAperture.kind ===\n    \"unresolved\"\n  ) {\n    throw new InvalidScientificInputError(\n      \"Geometric sensitive aperture is unresolved; a spatial sampling aperture cannot be produced.\"\n    );\n  }\n\n  const siteX = requireSiteIndex(\n    input.site.x,\n    \"site.x\"\n  );\n  const siteY = requireSiteIndex(\n    input.site.y,\n    \"site.y\"\n  );\n\n  if (\n    siteX >=\n      binding.colorSamplingSiteGrid.widthSites ||\n    siteY >=\n      binding.colorSamplingSiteGrid.heightSites\n  ) {\n    throw new InvalidScientificInputError(\n      \"site must lie within the bound color-sampling site grid.\"\n    );\n  }\n\n  const lattice =\n    profile.siteCenterLattice;\n  const gridWidth =\n    binding.colorSamplingSiteGrid.widthSites;\n  const gridHeight =\n    binding.colorSamplingSiteGrid.heightSites;\n  const imagingWidthMicrometers =\n    input.imagingArea.widthMm * 1000;\n  const imagingHeightMicrometers =\n    input.imagingArea.heightMm * 1000;\n\n  const lastCenterX =\n    lattice\n      .firstSiteCenterFromImagingAreaTopLeftMicrometers\n      .x +\n    (gridWidth - 1) *\n      lattice.pitchXMicrometers;\n  const lastCenterY =\n    lattice\n      .firstSiteCenterFromImagingAreaTopLeftMicrometers\n      .y +\n    (gridHeight - 1) *\n      lattice.pitchYMicrometers;\n\n  if (\n    lastCenterX > imagingWidthMicrometers ||\n    lastCenterY > imagingHeightMicrometers\n  ) {\n    throw new InvalidScientificInputError(\n      \"Declared site-center lattice extends beyond the supplied physical imaging area.\"\n    );\n  }\n\n  const aperture =\n    profile.geometricSensitiveAperture;\n  const apertureOffsetX =\n    aperture.centerOffsetFromSiteCenterMicrometers.x;\n  const apertureOffsetY =\n    aperture.centerOffsetFromSiteCenterMicrometers.y;\n  const apertureHalfWidth =\n    aperture.widthMicrometers / 2;\n  const apertureHalfHeight =\n    aperture.heightMicrometers / 2;\n\n  const firstApertureLeft =\n    lattice.firstSiteCenterFromImagingAreaTopLeftMicrometers.x +\n    apertureOffsetX -\n    apertureHalfWidth;\n  const firstApertureTop =\n    lattice.firstSiteCenterFromImagingAreaTopLeftMicrometers.y +\n    apertureOffsetY -\n    apertureHalfHeight;\n  const lastApertureRight =\n    lastCenterX +\n    apertureOffsetX +\n    apertureHalfWidth;\n  const lastApertureBottom =\n    lastCenterY +\n    apertureOffsetY +\n    apertureHalfHeight;\n\n  if (\n    firstApertureLeft < 0 ||\n    firstApertureTop < 0 ||\n    lastApertureRight > imagingWidthMicrometers ||\n    lastApertureBottom > imagingHeightMicrometers\n  ) {\n    throw new InvalidScientificInputError(\n      \"Declared geometric sensitive aperture does not fit within the supplied physical imaging area across the complete site grid.\"\n    );\n  }\n\n  const siteCenterFromTopLeftX =\n    lattice\n      .firstSiteCenterFromImagingAreaTopLeftMicrometers\n      .x +\n    siteX * lattice.pitchXMicrometers;\n  const siteCenterFromTopLeftY =\n    lattice\n      .firstSiteCenterFromImagingAreaTopLeftMicrometers\n      .y +\n    siteY * lattice.pitchYMicrometers;\n\n  const apertureCenterFromTopLeftX =\n    siteCenterFromTopLeftX +\n    aperture\n      .centerOffsetFromSiteCenterMicrometers\n      .x;\n  const apertureCenterFromTopLeftY =\n    siteCenterFromTopLeftY +\n    aperture\n      .centerOffsetFromSiteCenterMicrometers\n      .y;\n  const apertureLeftTopX =\n    apertureCenterFromTopLeftX -\n    aperture.widthMicrometers / 2;\n  const apertureRightBottomX =\n    apertureCenterFromTopLeftX +\n    aperture.widthMicrometers / 2;\n  const apertureLeftTopY =\n    apertureCenterFromTopLeftY -\n    aperture.heightMicrometers / 2;\n  const apertureRightBottomY =\n    apertureCenterFromTopLeftY +\n    aperture.heightMicrometers / 2;\n\n  if (\n    apertureLeftTopX < 0 ||\n    apertureLeftTopY < 0 ||\n    apertureRightBottomX >\n      imagingWidthMicrometers ||\n    apertureRightBottomY >\n      imagingHeightMicrometers\n  ) {\n    throw new InvalidScientificInputError(\n      \"Resolved geometric sensitive aperture extends beyond the supplied physical imaging area.\"\n    );\n  }\n\n  const siteCenterFromOpticalAxisMm = {\n    x:\n      -input.imagingArea.widthMm / 2 +\n      siteCenterFromTopLeftX / 1000,\n    y:\n      -input.imagingArea.heightMm / 2 +\n      siteCenterFromTopLeftY / 1000\n  };\n  const apertureCenterFromOpticalAxisMm = {\n    x:\n      -input.imagingArea.widthMm / 2 +\n      apertureCenterFromTopLeftX / 1000,\n    y:\n      -input.imagingArea.heightMm / 2 +\n      apertureCenterFromTopLeftY / 1000\n  };\n  const boundsFromOpticalAxisMm = {\n    left:\n      -input.imagingArea.widthMm / 2 +\n      apertureLeftTopX / 1000,\n    right:\n      -input.imagingArea.widthMm / 2 +\n      apertureRightBottomX / 1000,\n    top:\n      -input.imagingArea.heightMm / 2 +\n      apertureLeftTopY / 1000,\n    bottom:\n      -input.imagingArea.heightMm / 2 +\n      apertureRightBottomY / 1000\n  };\n\n  const areaSquareMicrometers =\n    aperture.widthMicrometers *\n    aperture.heightMicrometers;\n  const nominalCellAreaSquareMicrometers =\n    lattice.pitchXMicrometers *\n    lattice.pitchYMicrometers;\n  const geometricSensitiveAreaFractionOfLatticeCell =\n    areaSquareMicrometers /\n    nominalCellAreaSquareMicrometers;\n\n  if (\n    !Number.isFinite(areaSquareMicrometers) ||\n    !Number.isFinite(\n      nominalCellAreaSquareMicrometers\n    ) ||\n    !Number.isFinite(\n      geometricSensitiveAreaFractionOfLatticeCell\n    )\n  ) {\n    throw new InvalidScientificInputError(\n      \"Derived sampling-aperture geometry must remain finite.\"\n    );\n  }\n\n  const channel =\n    resolveColorSamplingSite({\n      profile: input.colorSamplingProfile,\n      site: {\n        x: siteX,\n        y: siteY\n      }\n    });\n\n  return {\n    profileId: profile.profileId,\n    colorSamplingProfileId:\n      profile.colorSamplingProfileId,\n    colorSamplingBindingId:\n      profile.colorSamplingBindingId,\n    coordinateSystem:\n      \"native-sensor-physical\",\n    site: {\n      x: siteX,\n      y: siteY\n    },\n    channelId: channel.mapping.channelId,\n    siteGrid: {\n      widthSites: gridWidth,\n      heightSites: gridHeight\n    },\n    lattice: {\n      pitchXMicrometers:\n        lattice.pitchXMicrometers,\n      pitchYMicrometers:\n        lattice.pitchYMicrometers,\n      firstSiteCenterFromImagingAreaTopLeftMicrometers:\n        {\n          ...lattice\n            .firstSiteCenterFromImagingAreaTopLeftMicrometers\n        },\n      siteCenterFromImagingAreaTopLeftMicrometers:\n        {\n          x: siteCenterFromTopLeftX,\n          y: siteCenterFromTopLeftY\n        },\n      siteCenterFromOpticalAxisMm,\n      nominalCellAreaSquareMicrometers\n    },\n    geometricSensitiveAperture: {\n      kind:\n        \"uniform-axis-aligned-rectangle\",\n      widthMicrometers:\n        aperture.widthMicrometers,\n      heightMicrometers:\n        aperture.heightMicrometers,\n      centerOffsetFromSiteCenterMicrometers:\n        {\n          ...aperture\n            .centerOffsetFromSiteCenterMicrometers\n        },\n      centerFromOpticalAxisMm:\n        apertureCenterFromOpticalAxisMm,\n      boundsFromOpticalAxisMm,\n      areaSquareMicrometers,\n      geometricSensitiveAreaFractionOfLatticeCell,\n      spatialWeighting:\n        \"uniform-unit-area-average\",\n      neighboringGeometricApertureOverlap:\n        \"none-by-model\"\n    },\n    sitePitchDerivedFromNativeImageRaster:\n      false,\n    apertureDerivedFromSitePitch: false,\n    antiAliasingResponseIncluded: false,\n    microlensSpatialRedistributionIncluded:\n      false,\n    chargeDiffusionIncluded: false,\n    electricalCrosstalkIncluded: false,\n    spectralResponseIncluded: false,\n    quantumEfficiencyIncluded: false,\n    opticalThroughputIncluded: false,\n    radiometricCollectionAreaEstablished:\n      false,\n    physicalPhotodiodeGeometryEstablished:\n      false,\n    provenance: {\n      profile: profile.evidence,\n      lattice: lattice.evidence,\n      aperture: aperture.evidence\n    }\n  };\n}\n"]}

package/dist/sensor/scene-eqe-temporal-exposure.d.ts

@@ -1,21 +1,23 @@
 /**
- * Module boundary and integration notes.
- * Compose declared scene radiance through paraxial optics and instantaneous EQE at every exact local
- * shutter midpoint. Light is never averaged before response validity. No projection, renderer, PSF,
- * charge/noise or production stage executes.
+ * Photo signal for one site over one exposure, starting from declared scene radiance: paraxial
+ * (small-angle) optics, then the EQE (external quantum efficiency) response, at every exact local
+ * shutter midpoint time.
+ *
+ * Light is never averaged before the response checks. No projection, renderer, PSF (point-spread
+ * function), charge, noise or production stage runs.
  * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
  * limits.
  */
 import { type CalculationResult } from "../core/calculation-result.js";
 import { calculateSceneToSensorIrradianceQuadrature, type CalculateSceneToSensorIrradianceQuadratureInput } from "../optics/scene-to-sensor-quadrature.js";
 import { calculateSensorEqeTemporalExposure, type CalculateSensorEqeTemporalExposureInput } from "./eqe-temporal-exposure.js";
-/** Declared physical scene radiance at every spatial/wavelength/local-shutter midpoint. */
+/** Input: declared physical scene radiance at every spatial position, wavelength and local shutter midpoint time. */
 export interface CalculateSceneSensorEqeTemporalExposureInput {
-    /** One destination site, response and local shutter event; no stationarity declaration. */
+    /** One destination site, its response and one local shutter event. No constant-rate declaration is needed. */
     sensor: Omit<CalculateSensorEqeTemporalExposureInput, "samples">;
     sceneBindings: CalculateSceneToSensorIrradianceQuadratureInput["sceneBindings"];
     optics: CalculateSceneToSensorIrradianceQuadratureInput["optics"];
-    /** Explicitly binds scene query seconds to the shutter's first-opening boundary. */
+    /** States that scene query times are seconds from the shutter's first opening boundary. */
     timeReference: "first-opening-boundary-phase";
     samples: readonly {
         temporalSampleIndex: number;
@@ -23,7 +25,7 @@ export interface CalculateSceneSensorEqeTemporalExposureInput {
         sceneSamples: CalculateSceneToSensorIrradianceQuadratureInput["samples"];
     }[];
 }
-/** Child optical and sensor envelopes retain approximation/evidence independently. */
+/** Result. The optical and sensor results each keep their own approximation labels and evidence. */
 export interface SceneSensorEqeTemporalExposure {
     sourcePlane: "sensor-package-incident";
     sourceTargetProjectionVerified: false;
@@ -37,9 +39,9 @@ export interface SceneSensorEqeTemporalExposure {
     exposure: ReturnType<typeof calculateSensorEqeTemporalExposure>;
 }
 /**
- * Compose declared scene radiance through paraxial optics and instantaneous EQE
- * at every exact local shutter midpoint. Light is never averaged before response
- * validity. No projection, renderer, PSF, charge/noise or production stage executes.
+ * Runs declared scene radiance through paraxial optics and the instantaneous EQE
+ * response at every exact local shutter midpoint time. Light is never averaged
+ * before the response checks. No projection, renderer, PSF, charge, noise or
+ * production stage runs.
  */
 export declare function calculateSceneSensorEqeTemporalExposure(input: CalculateSceneSensorEqeTemporalExposureInput): CalculationResult<SceneSensorEqeTemporalExposure>;
-//# sourceMappingURL=scene-eqe-temporal-exposure.d.ts.map

package/dist/sensor/scene-eqe-temporal-exposure.js

@@ -1,9 +1,11 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Module boundary and integration notes.
- * Compose declared scene radiance through paraxial optics and instantaneous EQE at every exact local
- * shutter midpoint. Light is never averaged before response validity. No projection, renderer, PSF,
- * charge/noise or production stage executes.
+ * Photo signal for one site over one exposure, starting from declared scene radiance: paraxial
+ * (small-angle) optics, then the EQE (external quantum efficiency) response, at every exact local
+ * shutter midpoint time.
+ *
+ * Light is never averaged before the response checks. No projection, renderer, PSF (point-spread
+ * function), charge, noise or production stage runs.
  * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
  * limits.
  */
@@ -14,19 +16,22 @@ import { calculateSensorEqeTemporalExposure } from "./eqe-temporal-exposure.js";
 import { calculateSensorSpatialSamplingQuadrature } from "./spatial-sampling-quadrature.js";
 import { calculateSensorSpectralQuadrature } from "./spectral-quadrature.js";
 import { bindSensorTemporalSamples } from "./temporal-sample-binding.js";
+import { requireInputKeys } from "../core/record-validation.js";
 /**
- * Compose declared scene radiance through paraxial optics and instantaneous EQE
- * at every exact local shutter midpoint. Light is never averaged before response
- * validity. No projection, renderer, PSF, charge/noise or production stage executes.
+ * Runs declared scene radiance through paraxial optics and the instantaneous EQE
+ * response at every exact local shutter midpoint time. Light is never averaged
+ * before the response checks. No projection, renderer, PSF, charge, noise or
+ * production stage runs.
  */
 export function calculateSceneSensorEqeTemporalExposure(input) {
+    requireInputKeys(input, "calculateSceneSensorEqeTemporalExposure", ["sensor", "sceneBindings", "optics", "timeReference", "samples"]);
     if (input.timeReference !== "first-opening-boundary-phase") {
         throw new InvalidScientificInputError("Scene samples must use the explicit first-opening-boundary-phase time reference.");
     }
     if (input.sensor.responseApplication.sourcePlane.value !== "sensor-package-incident") {
         throw new InvalidScientificInputError("Scene optical output requires a sensor-package-incident response application.");
     }
-    // Bound total declared work before any per-instant optical calculation.
+    // Check the total declared work against its limit before any per-instant optical calculation.
     const ordered = bindSensorTemporalSamples(input.samples, sample => sample.sceneSamples);
     const spatialQuadrature = calculateSensorSpatialSamplingQuadrature({ ...input.sensor.spatialSampling,
         colorSamplingProfile: input.sensor.colorSamplingProfile,

package/dist/sensor/scene-eqe-temporal-exposure.js.map

@@ -1 +1 @@
-{"version":3,"file":"scene-eqe-temporal-exposure.js","sourceRoot":"","sources":["../../src/sensor/scene-eqe-temporal-exposure.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scene-eqe-temporal-exposure.js","sourceRoot":"","sources":["../../src/sensor/scene-eqe-temporal-exposure.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;;;;;;;GASG;AAEH,OAAO,EAAE,mBAAmB,EAA0B,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,0CAA0C,EACK,MAAM,yCAAyC,CAAC;AACxG,OAAO,EAAE,kCAAkC,EAAgD,MAAM,4BAA4B,CAAC;AAC9H,OAAO,EAAE,wCAAwC,EAAE,MAAM,kCAAkC,CAAC;AAC5F,OAAO,EAAE,iCAAiC,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AA+BhE;;;;;GAKG;AACH,MAAM,UAAU,uCAAuC,CACrD,KAAmD;IAEnD,gBAAgB,CAAC,KAAK,EAAE,yCAAyC,EAAE,CAAC,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,CAAC,CAAC,CAAC;IACtI,IAAI,KAAK,CAAC,aAAa,KAAK,8BAA8B,EAAE,CAAC;QAC3D,MAAM,IAAI,2BAA2B,CAAC,kFAAkF,CAAC,CAAC;IAC5H,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,CAAC,mBAAmB,CAAC,WAAW,CAAC,KAAK,KAAK,yBAAyB,EAAE,CAAC;QACrF,MAAM,IAAI,2BAA2B,CAAC,+EAA+E,CAAC,CAAC;IACzH,CAAC;IACD,8FAA8F;IAC9F,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACxF,MAAM,iBAAiB,GAAG,wCAAwC,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,eAAe;QAClG,oBAAoB,EAAE,KAAK,CAAC,MAAM,CAAC,oBAAoB;QACvD,2BAA2B,EAAE,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,cAAc;QACtE,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,mBAAmB,CAAC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC;IACrF,MAAM,kBAAkB,GAAG,iCAAiC,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,gBAAgB;QAC7F,oBAAoB,EAAE,KAAK,CAAC,MAAM,CAAC,oBAAoB;QACvD,uBAAuB,EAAE,KAAK,CAAC,MAAM,CAAC,uBAAuB,EAAE,CAAC,CAAC,KAAK,CAAC;IACzE,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;QAC1C,MAAM,MAAM,GAAG,0CAA0C,CAAC,EAAE,iBAAiB,EAAE,kBAAkB;YAC/F,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM;YACxD,4BAA4B,EAAE,MAAM,CAAC,+BAA+B,EAAE,OAAO,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;QACxG,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACxC,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACzC,MAAM,IAAI,2BAA2B,CAAC,wEAAwE,CAAC,CAAC;YAClH,CAAC;YACD,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,EAAE,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;YACtD,+BAA+B,EAAE,MAAM,CAAC,+BAA+B,EAAE,MAAM,EAAE,CAAC;IACtF,CAAC,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,kCAAkC,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM;QACnE,OAAO,EAAE,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;YACtF,+BAA+B,EAAE,MAAM,CAAC,+BAA+B;YACvE,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACpE,OAAO,mBAAmB,CAAC,EAAE,WAAW,EAAE,yBAAyB,EAAE,8BAA8B,EAAE,KAAK;QACxG,8BAA8B,EAAE,KAAK,EAAE,wBAAwB,EAAE,KAAK,EAAE,cAAc,EAAE,QAAQ;KACjG,EAAE,oCAAoC,EAAE,OAAO,EAAE;QAChD,kHAAkH;QAClH,0GAA0G;QAC1G,6GAA6G;KAC9G,CAAC,CAAC;AACL,CAAC","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Photo signal for one site over one exposure, starting from declared scene radiance: paraxial\n * (small-angle) optics, then the EQE (external quantum efficiency) response, at every exact local\n * shutter midpoint time.\n *\n * Light is never averaged before the response checks. No projection, renderer, PSF (point-spread\n * function), charge, noise or production stage runs.\n * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support\n * limits.\n */\n\nimport { approximationResult, type CalculationResult } from \"../core/calculation-result.js\";\nimport { InvalidScientificInputError } from \"../core/validation.js\";\nimport { calculateSceneToSensorIrradianceQuadrature,\n  type CalculateSceneToSensorIrradianceQuadratureInput } from \"../optics/scene-to-sensor-quadrature.js\";\nimport { calculateSensorEqeTemporalExposure, type CalculateSensorEqeTemporalExposureInput } from \"./eqe-temporal-exposure.js\";\nimport { calculateSensorSpatialSamplingQuadrature } from \"./spatial-sampling-quadrature.js\";\nimport { calculateSensorSpectralQuadrature } from \"./spectral-quadrature.js\";\nimport { bindSensorTemporalSamples } from \"./temporal-sample-binding.js\";\nimport { requireInputKeys } from \"../core/record-validation.js\";\n\n/** Input: declared physical scene radiance at every spatial position, wavelength and local shutter midpoint time. */\nexport interface CalculateSceneSensorEqeTemporalExposureInput {\n  /** One destination site, its response and one local shutter event. No constant-rate declaration is needed. */\n  sensor: Omit<CalculateSensorEqeTemporalExposureInput, \"samples\">;\n  sceneBindings: CalculateSceneToSensorIrradianceQuadratureInput[\"sceneBindings\"];\n  optics: CalculateSceneToSensorIrradianceQuadratureInput[\"optics\"];\n  /** States that scene query times are seconds from the shutter's first opening boundary. */\n  timeReference: \"first-opening-boundary-phase\";\n  samples: readonly {\n    temporalSampleIndex: number;\n    timeSecondsFromOpeningReference: number;\n    sceneSamples: CalculateSceneToSensorIrradianceQuadratureInput[\"samples\"];\n  }[];\n}\n\n/** Result. The optical and sensor results each keep their own approximation labels and evidence. */\nexport interface SceneSensorEqeTemporalExposure {\n  sourcePlane: \"sensor-package-incident\";\n  sourceTargetProjectionVerified: false;\n  sceneProviderExecutionVerified: false;\n  psfRedistributionApplied: false;\n  opticalSamples: readonly {\n    temporalSampleIndex: number;\n    timeSecondsFromOpeningReference: number;\n    optics: ReturnType<typeof calculateSceneToSensorIrradianceQuadrature>;\n  }[];\n  exposure: ReturnType<typeof calculateSensorEqeTemporalExposure>;\n}\n\n/**\n * Runs declared scene radiance through paraxial optics and the instantaneous EQE\n * response at every exact local shutter midpoint time. Light is never averaged\n * before the response checks. No projection, renderer, PSF, charge, noise or\n * production stage runs.\n */\nexport function calculateSceneSensorEqeTemporalExposure(\n  input: CalculateSceneSensorEqeTemporalExposureInput\n): CalculationResult<SceneSensorEqeTemporalExposure> {\n  requireInputKeys(input, \"calculateSceneSensorEqeTemporalExposure\", [\"sensor\", \"sceneBindings\", \"optics\", \"timeReference\", \"samples\"]);\n  if (input.timeReference !== \"first-opening-boundary-phase\") {\n    throw new InvalidScientificInputError(\"Scene samples must use the explicit first-opening-boundary-phase time reference.\");\n  }\n  if (input.sensor.responseApplication.sourcePlane.value !== \"sensor-package-incident\") {\n    throw new InvalidScientificInputError(\"Scene optical output requires a sensor-package-incident response application.\");\n  }\n  // Check the total declared work against its limit before any per-instant optical calculation.\n  const ordered = bindSensorTemporalSamples(input.samples, sample => sample.sceneSamples);\n  const spatialQuadrature = calculateSensorSpatialSamplingQuadrature({ ...input.sensor.spatialSampling,\n    colorSamplingProfile: input.sensor.colorSamplingProfile,\n    colorSamplingBindingProfile: input.sensor.localExposure.bindingProfile,\n    nativeRaster: input.sensor.localExposure.exposureWindowInput.nativeRaster }).value;\n  const spectralQuadrature = calculateSensorSpectralQuadrature({ ...input.sensor.spectralSampling,\n    colorSamplingProfile: input.sensor.colorSamplingProfile,\n    spectralResponseProfile: input.sensor.spectralResponseProfile }).value;\n  const sampleIds = new Set<string>();\n  const opticalSamples = ordered.map(sample => {\n    const optics = calculateSceneToSensorIrradianceQuadrature({ spatialQuadrature, spectralQuadrature,\n      sceneBindings: input.sceneBindings, optics: input.optics,\n      timeSecondsFromExposureStart: sample.timeSecondsFromOpeningReference, samples: sample.sceneSamples });\n    for (const node of optics.value.samples) {\n      if (sampleIds.has(node.request.sampleId)) {\n        throw new InvalidScientificInputError(\"Scene sampleId must be unique across the complete temporal quadrature.\");\n      }\n      sampleIds.add(node.request.sampleId);\n    }\n    return { temporalSampleIndex: sample.temporalSampleIndex,\n      timeSecondsFromOpeningReference: sample.timeSecondsFromOpeningReference, optics };\n  });\n  const exposure = calculateSensorEqeTemporalExposure({ ...input.sensor,\n    samples: opticalSamples.map(sample => ({ temporalSampleIndex: sample.temporalSampleIndex,\n      timeSecondsFromOpeningReference: sample.timeSecondsFromOpeningReference,\n      irradianceSamples: sample.optics.value.irradianceSamples })) });\n  return approximationResult({ sourcePlane: \"sensor-package-incident\", sourceTargetProjectionVerified: false,\n    sceneProviderExecutionVerified: false, psfRedistributionApplied: false, opticalSamples, exposure\n  }, \"scene-sensor-eqe-temporal-exposure\", \"0.1.0\", [\n    \"Scene targets, visibility and provider transport remain declared; projection and PSF execution are not verified.\",\n    \"Paraxial optical irradiance and EQE validity are evaluated independently at each local shutter midpoint.\",\n    \"Child uncertainties are not combined; no quadrature convergence bound or production activation is asserted.\"\n  ]);\n}\n"]}

package/dist/sensor/sensor-geometry.d.ts

@@ -1,20 +1,18 @@
 /**
- * Module boundary and integration notes.
- * Calculates physical imaging-area metrics independently from native raster density. Crop factor uses
- * the diagonal ratio to a 36 × 24 mm reference frame. Digital/output crops are not part of this
- * physical imaging-area quantity.
- * Calculates physical imaging-area, native-raster, and geometric sampling metrics without coupling
- * sensor size to resolution. The supplied raster is assumed to span the supplied imaging area. Derived
- * sampling pitch is geometric sample spacing only and must not be interpreted as photosite fill factor
- * or photon-collection area.
+ * Sensor geometry: physical size of the imaging area (diagonal, aspect ratio, 35 mm crop factor) and
+ * the native pixel grid (megapixels, pixel pitch).
+ *
+ * Sensor size and resolution are kept independent. Crop factor is the ratio of diagonals to a
+ * 36 × 24 mm frame, and does not include any digital or output crop. Pixel pitch here is only the
+ * spacing between samples; it is not the photosite's fill factor or light-collecting area.
  * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
  * limits.
  */
 import { type CalculationResult } from "../core/calculation-result.js";
 /**
- * Physical photosensitive imaging area used for image formation.
+ * The physical light-sensitive imaging area used for image formation.
  *
- * This is deliberately not a sensor package/die dimension.
+ * It is deliberately not the size of the sensor package or die.
  */
 export interface SensorImagingArea {
     /** Physical active imaging width in millimetres. */
@@ -23,10 +21,10 @@ export interface SensorImagingArea {
     heightMm: number;
 }
 /**
- * Native effective image-sampling raster associated with an imaging area.
+ * Width and height of an image grid in pixels.
  *
- * The raster describes effective image samples. It does not imply that each
- * sample corresponds one-to-one with a physical photodiode/photosite.
+ * Pixels here are image samples. That does not mean each sample matches one
+ * physical photodiode (photosite).
  */
 export interface RasterDimensions {
     /** Horizontal image-sample/pixel count. */
@@ -35,10 +33,10 @@ export interface RasterDimensions {
     pixelHeight: number;
 }
 /**
- * Native effective image-sampling raster associated with an imaging area.
+ * The native pixel grid of an imaging area.
  *
- * This alias identifies semantic role; generic active/output rasters should
- * use RasterDimensions instead.
+ * This alias names the role. For other grids, such as active or output
+ * images, use RasterDimensions.
  */
 export type NativeImageRaster = RasterDimensions;
 export interface ImagingAreaMetrics {
@@ -49,8 +47,8 @@ export interface ImagingAreaMetrics {
     /**
      * Diagonal crop factor relative to a 36 × 24 mm reference frame.
      *
-     * This is a physical imaging-area quantity and does not include later
-     * digital/output cropping.
+     * It describes the physical imaging area only, and does not include any
+     * later digital or output crop.
      */
     cropFactor35Mm: number;
 }
@@ -70,15 +68,15 @@ export interface SensorGeometryMetrics {
     };
     sampling: {
         /**
-         * Horizontal geometric sampling pitch in micrometres.
+         * Horizontal sample spacing (pitch) in micrometres.
          *
-         * This is image-sample spacing, not physical photodiode active area.
+         * This is the spacing between image samples, not the photodiode's active area.
          */
         pitchXMicrometers: number;
         /**
-         * Vertical geometric sampling pitch in micrometres.
+         * Vertical sample spacing (pitch) in micrometres.
          *
-         * This is image-sample spacing, not physical photodiode active area.
+         * This is the spacing between image samples, not the photodiode's active area.
          */
         pitchYMicrometers: number;
         /** Horizontal sampling pitch divided by vertical sampling pitch. */
@@ -86,26 +84,24 @@ export interface SensorGeometryMetrics {
     };
 }
 /**
- * Calculates physical imaging-area metrics independently from native raster
- * density.
+ * Calculates metrics of the physical imaging area, independent of pixel count.
  *
- * Crop factor uses the diagonal ratio to a 36 × 24 mm reference frame.
- * Digital/output crops are not part of this physical imaging-area quantity.
+ * Crop factor is the ratio of diagonals to a 36 × 24 mm reference frame. It
+ * does not include any digital or output crop.
  *
  * @param imagingArea Physical photosensitive imaging area.
  * @returns Physical diagonal, aspect ratio, and diagonal 35 mm crop factor.
  */
 export declare function calculateImagingAreaMetrics(imagingArea: SensorImagingArea): CalculationResult<ImagingAreaMetrics>;
 /**
- * Calculates physical imaging-area, native-raster, and geometric sampling
- * metrics without coupling sensor size to resolution.
+ * Calculates metrics of the physical imaging area, the native pixel grid and
+ * the sample spacing, keeping sensor size and resolution independent.
  *
- * The supplied raster is assumed to span the supplied imaging area. Derived
- * sampling pitch is geometric sample spacing only and must not be interpreted
- * as photosite fill factor or photon-collection area.
+ * The grid is assumed to cover the whole imaging area. The derived pitch is
+ * only the spacing between samples. Do not read it as the photosite's fill
+ * factor or light-collecting area.
  *
  * @param input Physical imaging area and native effective image raster.
  * @returns Derived imaging-area, raster, and sampling metrics.
  */
 export declare function calculateSensorGeometryMetrics(input: CalculateSensorGeometryMetricsInput): CalculationResult<SensorGeometryMetrics>;
-//# sourceMappingURL=sensor-geometry.d.ts.map

package/dist/sensor/sensor-geometry.js

@@ -1,58 +1,73 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Module boundary and integration notes.
- * Calculates physical imaging-area metrics independently from native raster density. Crop factor uses
- * the diagonal ratio to a 36 × 24 mm reference frame. Digital/output crops are not part of this
- * physical imaging-area quantity.
- * Calculates physical imaging-area, native-raster, and geometric sampling metrics without coupling
- * sensor size to resolution. The supplied raster is assumed to span the supplied imaging area. Derived
- * sampling pitch is geometric sample spacing only and must not be interpreted as photosite fill factor
- * or photon-collection area.
+ * Sensor geometry: physical size of the imaging area (diagonal, aspect ratio, 35 mm crop factor) and
+ * the native pixel grid (megapixels, pixel pitch).
+ *
+ * Sensor size and resolution are kept independent. Crop factor is the ratio of diagonals to a
+ * 36 × 24 mm frame, and does not include any digital or output crop. Pixel pitch here is only the
+ * spacing between samples; it is not the photosite's fill factor or light-collecting area.
  * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
  * limits.
  */
 import { calculatedResult } from "../core/calculation-result.js";
 import { InvalidScientificInputError, requirePositiveFinite, requirePositiveInteger } from "../core/validation.js";
+import { portableHypot } from "../core/portable-math.js";
+import { requireInputObject, requireInputKeys } from "../core/record-validation.js";
 const REFERENCE_35MM_WIDTH_MM = 36;
 const REFERENCE_35MM_HEIGHT_MM = 24;
-const REFERENCE_35MM_DIAGONAL_MM = Math.hypot(REFERENCE_35MM_WIDTH_MM, REFERENCE_35MM_HEIGHT_MM);
+/** 36² + 24² mm²: the squared diagonal of the 35 mm reference frame (exact as a double). */
+const REFERENCE_35MM_DIAGONAL_SQUARED_MM2 = REFERENCE_35MM_WIDTH_MM * REFERENCE_35MM_WIDTH_MM +
+    REFERENCE_35MM_HEIGHT_MM * REFERENCE_35MM_HEIGHT_MM;
+/**
+ * Diagonal 35 mm crop factor, √(1872 / (w² + h²)). It uses only correctly rounded operations, so the
+ * stored value is bit-identical in every JavaScript engine (see core/portable-math.ts).
+ */
+function diagonalCropFactor35Mm(widthMm, heightMm, diagonalMm) {
+    const diagonalSquaredMm2 = widthMm * widthMm + heightMm * heightMm;
+    return Number.isFinite(diagonalSquaredMm2) && diagonalSquaredMm2 > 0
+        ? Math.sqrt(REFERENCE_35MM_DIAGONAL_SQUARED_MM2 / diagonalSquaredMm2)
+        : Math.sqrt(REFERENCE_35MM_DIAGONAL_SQUARED_MM2) / diagonalMm;
+}
 /**
- * Calculates physical imaging-area metrics independently from native raster
- * density.
+ * Calculates metrics of the physical imaging area, independent of pixel count.
  *
- * Crop factor uses the diagonal ratio to a 36 × 24 mm reference frame.
- * Digital/output crops are not part of this physical imaging-area quantity.
+ * Crop factor is the ratio of diagonals to a 36 × 24 mm reference frame. It
+ * does not include any digital or output crop.
  *
  * @param imagingArea Physical photosensitive imaging area.
  * @returns Physical diagonal, aspect ratio, and diagonal 35 mm crop factor.
  */
 export function calculateImagingAreaMetrics(imagingArea) {
+    requireInputKeys(imagingArea, "calculateImagingAreaMetrics", ["widthMm", "heightMm"]);
     requirePositiveFinite("imagingArea.widthMm", imagingArea.widthMm);
     requirePositiveFinite("imagingArea.heightMm", imagingArea.heightMm);
-    const diagonalMm = Math.hypot(imagingArea.widthMm, imagingArea.heightMm);
+    const diagonalMm = portableHypot(imagingArea.widthMm, imagingArea.heightMm);
     return calculatedResult({
         diagonalMm,
         aspectRatio: imagingArea.widthMm / imagingArea.heightMm,
-        cropFactor35Mm: REFERENCE_35MM_DIAGONAL_MM / diagonalMm
+        cropFactor35Mm: diagonalCropFactor35Mm(imagingArea.widthMm, imagingArea.heightMm, diagonalMm)
     }, "sensor-imaging-area", "1.0.0", [
         "35 mm reference frame is 36 × 24 mm and crop factor is diagonal-based.",
         "Digital/output cropping is excluded from physical imaging-area crop factor."
     ]);
 }
 /**
- * Calculates physical imaging-area, native-raster, and geometric sampling
- * metrics without coupling sensor size to resolution.
+ * Calculates metrics of the physical imaging area, the native pixel grid and
+ * the sample spacing, keeping sensor size and resolution independent.
  *
- * The supplied raster is assumed to span the supplied imaging area. Derived
- * sampling pitch is geometric sample spacing only and must not be interpreted
- * as photosite fill factor or photon-collection area.
+ * The grid is assumed to cover the whole imaging area. The derived pitch is
+ * only the spacing between samples. Do not read it as the photosite's fill
+ * factor or light-collecting area.
  *
  * @param input Physical imaging area and native effective image raster.
  * @returns Derived imaging-area, raster, and sampling metrics.
  */
 export function calculateSensorGeometryMetrics(input) {
+    requireInputKeys(input, "calculateSensorGeometryMetrics", ["imagingArea", "nativeRaster"]);
+    requireInputObject(input.imagingArea, "imagingArea");
     requirePositiveFinite("imagingArea.widthMm", input.imagingArea.widthMm);
     requirePositiveFinite("imagingArea.heightMm", input.imagingArea.heightMm);
+    requireInputObject(input.nativeRaster, "nativeRaster");
     requirePositiveInteger("nativeRaster.pixelWidth", input.nativeRaster.pixelWidth);
     requirePositiveInteger("nativeRaster.pixelHeight", input.nativeRaster.pixelHeight);
     const totalImageSamples = input.nativeRaster.pixelWidth * input.nativeRaster.pixelHeight;