@photivra/engine 0.5.1 → 1.0.0

package/dist/sensor/color-sampling.js

@@ -0,0 +1,245 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Module boundary and integration notes.
+ * Parses an exact color-sampling topology declaration without binding it to NativeImageRaster,
+ * physical photodiodes, spectral response, or a manufacturer-specific family enum. Periodic mosaics
+ * use an abstract native sensor color-sampling-site lattice with zero-based integer indices, top-left
+ * origin, +X right and +Y down. The repeat phase is anchored to the sensor lattice, so later active
+ * crops or orientation transforms must preserve the original native site indices. Layered layouts are
+ * structural-only in this first contract because real layered sensors may use unequal spatial sampling
+ * density/registration across layers. No per-site layered resolver is exposed until that relationship
+ * is modeled explicitly.
+ * Resolves the semantic measurement-channel assignment at one abstract native sensor
+ * color-sampling-site index for monochrome or periodic-mosaic layouts. This API intentionally has no
+ * NativeImageRaster input. A later explicit binding must establish how a selected capture mode's
+ * effective raster maps to this color-sampling-site lattice before RAW/CFA sampling can be simulated.
+ * Layered layouts fail closed because their per-layer spatial relationship is not resolved by the
+ * first structural contract.
+ * @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 { InvalidScientificInputError } from "../core/validation.js";
+function requireRecord(value, path) {
+    if (typeof value !== "object" ||
+        value === null ||
+        Array.isArray(value)) {
+        throw new InvalidConfigurationError(path + " must be an object.");
+    }
+    return value;
+}
+function requireNonEmptyString(value, path) {
+    if (typeof value !== "string" ||
+        value.trim().length === 0) {
+        throw new InvalidConfigurationError(path + " must be a non-empty string.");
+    }
+    return value;
+}
+function requirePositiveSafeInteger(value, path) {
+    if (typeof value !== "number" ||
+        !Number.isSafeInteger(value) ||
+        value <= 0) {
+        throw new InvalidConfigurationError(path + " must be a positive safe integer.");
+    }
+    return value;
+}
+function parseChannelIds(value, path, options) {
+    if (!Array.isArray(value) || value.length === 0) {
+        throw new InvalidConfigurationError(path + " must be a non-empty array.");
+    }
+    if (options.exactLength !== undefined &&
+        value.length !== options.exactLength) {
+        throw new InvalidConfigurationError(path +
+            " length must equal the declared repeating-tile site count.");
+    }
+    const ids = value.map((entry, index) => requireNonEmptyString(entry, path + "[" + index + "]"));
+    if (!options.allowDuplicates &&
+        new Set(ids).size !== ids.length) {
+        throw new InvalidConfigurationError(path + " must not contain duplicate channel IDs.");
+    }
+    return ids;
+}
+function parseLayout(value, path) {
+    const record = requireRecord(value, path);
+    if (record.kind === "monochrome") {
+        if (record.repeatWidthSites !== undefined ||
+            record.repeatHeightSites !== undefined ||
+            record.siteChannelIds !== undefined ||
+            record.anchor !== undefined ||
+            record.layerChannelIds !== undefined ||
+            record.spatialSamplingRelationship !== undefined) {
+            throw new InvalidConfigurationError(path +
+                " monochrome layout must omit mosaic/layered fields.");
+        }
+        return {
+            kind: "monochrome",
+            channelId: requireNonEmptyString(record.channelId, path + ".channelId")
+        };
+    }
+    if (record.kind === "periodic-mosaic") {
+        if (record.channelId !== undefined ||
+            record.layerChannelIds !== undefined ||
+            record.spatialSamplingRelationship !== undefined) {
+            throw new InvalidConfigurationError(path +
+                " periodic-mosaic layout must omit monochrome/layered fields.");
+        }
+        const repeatWidthSites = requirePositiveSafeInteger(record.repeatWidthSites, path + ".repeatWidthSites");
+        const repeatHeightSites = requirePositiveSafeInteger(record.repeatHeightSites, path + ".repeatHeightSites");
+        const repeatSiteCount = repeatWidthSites * repeatHeightSites;
+        if (!Number.isSafeInteger(repeatSiteCount)) {
+            throw new InvalidConfigurationError(path +
+                " repeating-tile site count must be a safe integer.");
+        }
+        if (record.anchor !== "native-sensor-top-left-site") {
+            throw new InvalidConfigurationError(path +
+                '.anchor must be "native-sensor-top-left-site".');
+        }
+        return {
+            kind: "periodic-mosaic",
+            repeatWidthSites,
+            repeatHeightSites,
+            siteChannelIds: parseChannelIds(record.siteChannelIds, path + ".siteChannelIds", {
+                allowDuplicates: true,
+                exactLength: repeatSiteCount
+            }),
+            anchor: "native-sensor-top-left-site"
+        };
+    }
+    if (record.kind === "layered") {
+        if (record.channelId !== undefined ||
+            record.repeatWidthSites !== undefined ||
+            record.repeatHeightSites !== undefined ||
+            record.siteChannelIds !== undefined ||
+            record.anchor !== undefined) {
+            throw new InvalidConfigurationError(path +
+                " layered layout must omit monochrome/mosaic fields.");
+        }
+        if (record.spatialSamplingRelationship !==
+            "not-resolved") {
+            throw new InvalidConfigurationError(path +
+                '.spatialSamplingRelationship must be "not-resolved" for the first layered contract.');
+        }
+        return {
+            kind: "layered",
+            layerChannelIds: parseChannelIds(record.layerChannelIds, path + ".layerChannelIds", {
+                allowDuplicates: false
+            }),
+            spatialSamplingRelationship: "not-resolved"
+        };
+    }
+    throw new InvalidConfigurationError(path + ".kind is invalid.");
+}
+/**
+ * Parses an exact color-sampling topology declaration without binding it to
+ * NativeImageRaster, physical photodiodes, spectral response, or a
+ * manufacturer-specific family enum.
+ *
+ * Periodic mosaics use an abstract native sensor color-sampling-site lattice
+ * with zero-based integer indices, top-left origin, +X right and +Y down.
+ * The repeat phase is anchored to the sensor lattice, so later active crops or
+ * orientation transforms must preserve the original native site indices.
+ *
+ * Layered layouts are structural-only in this first contract because real
+ * layered sensors may use unequal spatial sampling density/registration across
+ * layers. No per-site layered resolver is exposed until that relationship is
+ * modeled explicitly.
+ */
+export function parseSensorColorSamplingProfile(value) {
+    const profile = requireRecord(value, "sensorColorSampling");
+    if (profile.schemaVersion !== "0.1.0") {
+        throw new InvalidConfigurationError('sensorColorSampling.schemaVersion must be "0.1.0".');
+    }
+    const layout = parseLayout(profile.layout, "sensorColorSampling.layout");
+    const expectedCoordinateSystem = layout.kind === "layered"
+        ? "native-sensor-layered-spatial-relationship-not-resolved"
+        : "native-sensor-color-sampling-site-index";
+    if (profile.coordinateSystem !==
+        expectedCoordinateSystem) {
+        throw new InvalidConfigurationError("sensorColorSampling.coordinateSystem does not match the declared layout kind.");
+    }
+    return {
+        schemaVersion: "0.1.0",
+        profileId: requireNonEmptyString(profile.profileId, "sensorColorSampling.profileId"),
+        evidence: parseEvidenceList(profile.evidence, "sensorColorSampling.evidence"),
+        coordinateSystem: expectedCoordinateSystem,
+        layout
+    };
+}
+function requireNativeSiteIndex(value, path) {
+    if (typeof value !== "number" ||
+        !Number.isSafeInteger(value) ||
+        value < 0) {
+        throw new InvalidScientificInputError(path +
+            " must be a non-negative safe integer native color-sampling-site index.");
+    }
+    return value;
+}
+/**
+ * Resolves the semantic measurement-channel assignment at one abstract native
+ * sensor color-sampling-site index for monochrome or periodic-mosaic layouts.
+ *
+ * This API intentionally has no NativeImageRaster input. A later explicit
+ * binding must establish how a selected capture mode's effective raster maps
+ * to this color-sampling-site lattice before RAW/CFA sampling can be simulated.
+ *
+ * Layered layouts fail closed because their per-layer spatial relationship is
+ * not resolved by the first structural contract.
+ */
+export function resolveColorSamplingSite(input) {
+    const profile = parseSensorColorSamplingProfile(input.profile);
+    if (typeof input.site !== "object" ||
+        input.site === null) {
+        throw new InvalidScientificInputError("site must be an object.");
+    }
+    const x = requireNativeSiteIndex(input.site.x, "site.x");
+    const y = requireNativeSiteIndex(input.site.y, "site.y");
+    if (profile.layout.kind === "layered") {
+        throw new InvalidScientificInputError("Layered color sampling is structural-only in schema 0.1.0; per-site resolution requires an explicit per-layer spatial sampling relationship.");
+    }
+    if (profile.coordinateSystem !==
+        "native-sensor-color-sampling-site-index") {
+        throw new InvalidScientificInputError("Resolvable color sampling requires the native sensor color-sampling-site coordinate system.");
+    }
+    if (profile.layout.kind === "monochrome") {
+        return {
+            profileId: profile.profileId,
+            coordinateSystem: profile.coordinateSystem,
+            site: { x, y },
+            mapping: {
+                kind: "monochrome",
+                channelId: profile.layout.channelId
+            },
+            spectralResponseEstablished: false,
+            nativeImageRasterBindingEstablished: false,
+            physicalPhotodiodeBindingEstablished: false
+        };
+    }
+    const repeatX = x % profile.layout.repeatWidthSites;
+    const repeatY = y % profile.layout.repeatHeightSites;
+    const index = repeatY * profile.layout.repeatWidthSites +
+        repeatX;
+    const channelId = profile.layout.siteChannelIds[index];
+    if (channelId === undefined) {
+        throw new InvalidScientificInputError("Periodic color-sampling tile resolution failed.");
+    }
+    return {
+        profileId: profile.profileId,
+        coordinateSystem: profile.coordinateSystem,
+        site: { x, y },
+        mapping: {
+            kind: "periodic-mosaic",
+            channelId,
+            repeatCoordinate: {
+                x: repeatX,
+                y: repeatY
+            },
+            repeatWidthSites: profile.layout.repeatWidthSites,
+            repeatHeightSites: profile.layout.repeatHeightSites
+        },
+        spectralResponseEstablished: false,
+        nativeImageRasterBindingEstablished: false,
+        physicalPhotodiodeBindingEstablished: false
+    };
+}
+//# sourceMappingURL=color-sampling.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"color-sampling.js","sourceRoot":"","sources":["../../src/sensor/color-sampling.ts"],"names":[],"mappings":"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"}

package/dist/sensor/constant-rate-temporal-integration.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Module boundary and integration notes.
+ * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
+ * missing required fields and incompatible scientific data fail at this boundary. Rate times duration
+ * is allowed only by explicit stationarity bound to the exact site and local shutter interval. EQE
+ * integrates to expected photons/electrons; A/W integrates current magnitude to coulombs without an
+ * implicit carrier mapping. Counts remain fractional expectations before stochastic sampling.
+ * Integrates one explicitly stationary response-rate result over its exact bound local exposure
+ * window. This function is intentionally limited to the constant-rate approximation. It does not
+ * sample or integrate a time-varying signal.
+ * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
+ * limits.
+ */
+import { type CalculationResult } from "../core/calculation-result.js";
+import { type EvidenceProvenance } from "../core/evidence-provenance.js";
+import type { SensorInstantaneousRateResult, SensorRateLocalExposureBinding } from "./local-exposure-binding.js";
+export type SensorRateStationarityStatus = "established" | "approximation";
+export interface SensorRateTemporalStationarityProfile {
+    schemaVersion: "0.1.0";
+    profileId: string;
+    rateDomain: SensorRateLocalExposureBinding["rateDomain"];
+    colorSamplingProfileId: string;
+    channelId: string;
+    site: {
+        x: number;
+        y: number;
+    };
+    bindingId: string;
+    localExposureWindow: {
+        timeReference: "first-opening-boundary-phase";
+        startOffsetSecondsFromOpeningReference: number;
+        endOffsetSecondsFromOpeningReference: number;
+    };
+    stationarityMeaning: "reported-rate-constant-through-bound-local-exposure";
+    status: SensorRateStationarityStatus;
+    evidence: readonly EvidenceProvenance[];
+    limitation?: string;
+}
+export interface IntegrateStationarySensorRateInput {
+    rate: SensorInstantaneousRateResult;
+    exposureBinding: SensorRateLocalExposureBinding;
+    stationarityProfile: SensorRateTemporalStationarityProfile;
+}
+interface SensorTemporalIntegrationCommon {
+    colorSamplingProfileId: string;
+    channelId: string;
+    site: {
+        x: number;
+        y: number;
+    };
+    bindingId: string;
+    stationarityProfileId: string;
+    stationarityStatus: SensorRateStationarityStatus;
+    timeReference: "first-opening-boundary-phase";
+    startOffsetSecondsFromOpeningReference: number;
+    endOffsetSecondsFromOpeningReference: number;
+    localExposureDurationSeconds: number;
+    integrationMethod: "constant-rate-times-local-exposure-duration";
+    timeStationarityEstablished: true;
+    temporalIntegrationApplied: true;
+    exposureDurationApplied: true;
+    timeVaryingSignalIntegrated: false;
+    multiFrameSequenceIntegrated: false;
+    darkChargeIncluded: false;
+    otherChargeIncluded: false;
+    accumulatedSignalCompleteness: "photo-signal-only";
+    physicalFullWellAssessmentAuthorized: false;
+    cameraSaturationAssessmentAuthorized: false;
+    saturationAssessed: false;
+    shotNoiseApplied: false;
+    readNoiseApplied: false;
+    adcQuantizationApplied: false;
+    rawCodeValueProduced: false;
+    componentEvidence: {
+        stationarity: readonly EvidenceProvenance[];
+        exposureBinding: SensorRateLocalExposureBinding["componentEvidence"];
+    };
+}
+export interface SensorEqeExposureIntegration extends SensorTemporalIntegrationCommon {
+    kind: "eqe-expected-counts";
+    incidentPhotonRatePerSecond: number;
+    expectedGeneratedElectronRatePerSecond: number;
+    expectedIncidentPhotonCount: number;
+    expectedGeneratedElectronCount: number;
+    countsAreExpectationValues: true;
+    integerPhotonCountSampled: false;
+    integerElectronCountSampled: false;
+    chargeCalculated: false;
+    currentCalculated: false;
+}
+export interface SensorResponsivityExposureIntegration extends SensorTemporalIntegrationCommon {
+    kind: "responsivity-photocurrent-charge";
+    photocurrentMagnitudeAmperes: number;
+    photochargeMagnitudeCoulombs: number;
+    currentSignConvention: "magnitude-only-no-circuit-polarity";
+    chargeSignConvention: "magnitude-only-no-carrier-or-circuit-polarity";
+    carrierCountInferred: false;
+    electronCountCalculated: false;
+    photonCountCalculated: false;
+    detectorBandwidthModeled: false;
+}
+export type SensorStationaryRateExposureIntegration = SensorEqeExposureIntegration | SensorResponsivityExposureIntegration;
+/**
+ * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
+ * missing required fields and incompatible scientific data fail at this boundary.
+ *
+ * Rate times duration is allowed only by explicit stationarity bound to the exact site and local
+ * shutter interval. EQE integrates to expected photons/electrons; A/W integrates current magnitude to
+ * coulombs without an implicit carrier mapping. Counts remain fractional expectations before
+ * stochastic sampling.
+ * @param value - unknown. Treated as untrusted data; static typing alone is not validation.
+ * @returns SensorRateTemporalStationarityProfile. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ *
+ * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ */
+export declare function parseSensorRateTemporalStationarityProfile(value: unknown): SensorRateTemporalStationarityProfile;
+/**
+ * Integrates one explicitly stationary response-rate result over its exact
+ * bound local exposure window.
+ *
+ * This function is intentionally limited to the constant-rate approximation.
+ * It does not sample or integrate a time-varying signal.
+ */
+export declare function integrateStationarySensorRateOverLocalExposure(input: IntegrateStationarySensorRateInput): CalculationResult<SensorStationaryRateExposureIntegration>;
+export {};
+//# sourceMappingURL=constant-rate-temporal-integration.d.ts.map

package/dist/sensor/constant-rate-temporal-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant-rate-temporal-integration.d.ts","sourceRoot":"","sources":["../../src/sensor/constant-rate-temporal-integration.ts"],"names":[],"mappings":"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"}