@photivra/engine 0.1.0 → 0.4.0

package/dist/sensor/architecture.js

@@ -0,0 +1,98 @@
+// SPDX-License-Identifier: Apache-2.0
+import { parseEvidenceList } from "../core/evidence-provenance.js";
+import { InvalidConfigurationError } from "../core/configuration-error.js";
+const ILLUMINATION_VALUES = new Set([
+    "fsi",
+    "bsi"
+]);
+const INTEGRATION_VALUES = new Set([
+    "monolithic",
+    "partially-stacked",
+    "stacked"
+]);
+const READOUT_VALUES = new Set([
+    "rolling",
+    "global"
+]);
+const COLOR_SAMPLING_VALUES = new Set([
+    "bayer",
+    "quad-bayer",
+    "monochrome",
+    "custom-rgb-mosaic",
+    "layered-color"
+]);
+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(record, key, path) {
+    const value = record[key];
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new InvalidConfigurationError(`${path}.${key} must be a non-empty string.`);
+    }
+    return value;
+}
+function parseScalarFact(value, path, allowed) {
+    const record = requireRecord(value, path);
+    const factValue = requireNonEmptyString(record, "value", path);
+    if (!allowed.has(factValue)) {
+        throw new InvalidConfigurationError(`${path}.value is invalid.`);
+    }
+    return {
+        value: factValue,
+        evidence: parseEvidenceList(record.evidence, `${path}.evidence`)
+    };
+}
+function parseReadoutCapabilities(value, path) {
+    if (!Array.isArray(value) || value.length === 0) {
+        throw new InvalidConfigurationError(`${path} must be a non-empty array.`);
+    }
+    const parsed = value.map((entry, index) => parseScalarFact(entry, `${path}[${index}]`, READOUT_VALUES));
+    const values = parsed.map((fact) => fact.value);
+    if (new Set(values).size !== values.length) {
+        throw new InvalidConfigurationError(`${path} must not contain duplicate capability values.`);
+    }
+    return parsed;
+}
+/**
+ * Parses untrusted descriptive sensor-architecture metadata.
+ *
+ * Unknown facts should be omitted instead of inferred. The parser validates
+ * structure, supported vocabulary, and field-level evidence only; it does not
+ * verify that a cited real-world claim is factually true.
+ *
+ * @param value Unknown external data.
+ * @returns Validated sensor architecture profile.
+ */
+export function parseSensorArchitectureProfile(value) {
+    const profile = requireRecord(value, "sensorArchitecture");
+    if (profile.schemaVersion !== "0.2.0") {
+        throw new InvalidConfigurationError('sensorArchitecture.schemaVersion must be "0.2.0".');
+    }
+    return {
+        schemaVersion: "0.2.0",
+        ...(profile.illumination === undefined
+            ? {}
+            : {
+                illumination: parseScalarFact(profile.illumination, "sensorArchitecture.illumination", ILLUMINATION_VALUES)
+            }),
+        ...(profile.integration === undefined
+            ? {}
+            : {
+                integration: parseScalarFact(profile.integration, "sensorArchitecture.integration", INTEGRATION_VALUES)
+            }),
+        ...(profile.readoutCapabilities === undefined
+            ? {}
+            : {
+                readoutCapabilities: parseReadoutCapabilities(profile.readoutCapabilities, "sensorArchitecture.readoutCapabilities")
+            }),
+        ...(profile.colorSamplingFamily === undefined
+            ? {}
+            : {
+                colorSamplingFamily: parseScalarFact(profile.colorSamplingFamily, "sensorArchitecture.colorSamplingFamily", COLOR_SAMPLING_VALUES)
+            })
+    };
+}
+//# sourceMappingURL=architecture.js.map

package/dist/sensor/architecture.js.map

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

package/dist/sensor/radiometry-readiness.d.ts

@@ -0,0 +1,111 @@
+import { type EvidenceProvenance } from "../core/evidence-provenance.js";
+export type RadiometryRequirementId = "scene-spectral-radiance" | "optical-transmission" | "pupil-vignetting" | "photosite-collection-area" | "exposure-integration" | "sensor-response";
+export type RadiometryScientificStatus = "calibrated" | "approximation";
+export type RadiometryUncertaintyDeclaration = {
+    kind: "relative";
+    fraction: number;
+    basis: string;
+} | {
+    kind: "absolute";
+    plusMinus: number;
+    unit: string;
+    basis: string;
+} | {
+    kind: "not-quantified";
+    limitation: string;
+};
+export interface CalibrationArtifactReference {
+    id: string;
+    checksumSha256: string;
+}
+interface RadiometryRequirementBase {
+    requirement: RadiometryRequirementId;
+    scientificStatus: RadiometryScientificStatus;
+    modelId: string;
+    modelVersion: string;
+    evidence: readonly EvidenceProvenance[];
+    uncertainty: RadiometryUncertaintyDeclaration;
+}
+export interface SceneSpectralRadianceRequirement extends RadiometryRequirementBase {
+    requirement: "scene-spectral-radiance";
+    representation: "spectral-data" | "documented-spectral-approximation";
+    dataArtifact: CalibrationArtifactReference;
+}
+export type OpticalTransmissionRequirement = (RadiometryRequirementBase & {
+    requirement: "optical-transmission";
+    representation: "spectral-data";
+    dataArtifact: CalibrationArtifactReference;
+}) | (RadiometryRequirementBase & {
+    requirement: "optical-transmission";
+    representation: "t-stop-approximation";
+    tStop: number;
+});
+export type PupilVignettingRequirement = (RadiometryRequirementBase & {
+    requirement: "pupil-vignetting";
+    representation: "spatial-data";
+    dataArtifact: CalibrationArtifactReference;
+}) | (RadiometryRequirementBase & {
+    requirement: "pupil-vignetting";
+    representation: "documented-approximation";
+});
+export type PhotositeCollectionAreaRequirement = (RadiometryRequirementBase & {
+    requirement: "photosite-collection-area";
+    areaModel: "effective-collection-area";
+    effectiveCollectionAreaSquareMicrometers: number;
+}) | (RadiometryRequirementBase & {
+    requirement: "photosite-collection-area";
+    areaModel: "geometric-area-times-fill-factor";
+    geometricCellAreaSquareMicrometers: number;
+    fillFactor: number;
+});
+export type ExposureIntegrationRequirement = (RadiometryRequirementBase & {
+    requirement: "exposure-integration";
+    integrationModel: "uniform-boxcar";
+}) | (RadiometryRequirementBase & {
+    requirement: "exposure-integration";
+    integrationModel: "documented-shutter-function";
+    dataArtifact: CalibrationArtifactReference;
+});
+export type SensorResponseRequirement = (RadiometryRequirementBase & {
+    requirement: "sensor-response";
+    responseRepresentation: "spectral-quantum-efficiency";
+    dataArtifact: CalibrationArtifactReference;
+}) | (RadiometryRequirementBase & {
+    requirement: "sensor-response";
+    responseRepresentation: "effective-qe-approximation";
+    effectiveQuantumEfficiency: number;
+});
+export type RadiometryRequirement = SceneSpectralRadianceRequirement | OpticalTransmissionRequirement | PupilVignettingRequirement | PhotositeCollectionAreaRequirement | ExposureIntegrationRequirement | SensorResponseRequirement;
+export interface RadiometryReadinessProfile {
+    schemaVersion: "0.1.0";
+    components: readonly RadiometryRequirement[];
+}
+export interface RadiometryReadinessAssessment {
+    status: "not-ready" | "approximate-only" | "calibrated-ready";
+    nominalPhotonEstimateReady: boolean;
+    calibratedPhotonClaimReady: boolean;
+    missingRequirements: readonly RadiometryRequirementId[];
+    approximateRequirements: readonly RadiometryRequirementId[];
+    unquantifiedUncertaintyRequirements: readonly RadiometryRequirementId[];
+    /**
+     * This assessment never enables composed photon/noise output by itself.
+     * Integration remains an explicit later product/engine decision.
+     */
+    composedPhotonOutputEnabled: false;
+}
+/**
+ * Parses untrusted radiometry-prerequisite metadata.
+ *
+ * This validates structure and provenance; it cannot prove that a cited
+ * calibration/evidence claim is scientifically true.
+ */
+export declare function parseRadiometryReadinessProfile(value: unknown): RadiometryReadinessProfile;
+/**
+ * Assesses whether the declared prerequisites are sufficient for a nominal
+ * photon estimate and, separately, for a calibrated photon claim.
+ *
+ * This assessment does not enable composed photon/noise output.
+ */
+export declare function assessRadiometryReadiness(profile: RadiometryReadinessProfile): RadiometryReadinessAssessment;
+export {};
+//# sourceMappingURL=radiometry-readiness.d.ts.map

package/dist/sensor/radiometry-readiness.d.ts.map

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

package/dist/sensor/radiometry-readiness.js

@@ -0,0 +1,294 @@
+// SPDX-License-Identifier: Apache-2.0
+import { parseEvidenceList } from "../core/evidence-provenance.js";
+import { InvalidConfigurationError } from "../core/configuration-error.js";
+const REQUIRED_REQUIREMENTS = [
+    "scene-spectral-radiance",
+    "optical-transmission",
+    "pupil-vignetting",
+    "photosite-collection-area",
+    "exposure-integration",
+    "sensor-response"
+];
+const REQUIREMENT_IDS = new Set(REQUIRED_REQUIREMENTS);
+const SCIENTIFIC_STATUSES = new Set([
+    "calibrated",
+    "approximation"
+]);
+function requireRecord(value, path) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new InvalidConfigurationError(`${path} must be an object.`);
+    }
+    return value;
+}
+function requireString(record, key, path) {
+    const value = record[key];
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new InvalidConfigurationError(`${path}.${key} must be a non-empty string.`);
+    }
+    return value;
+}
+function requirePositiveNumber(record, key, path) {
+    const value = record[key];
+    if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+        throw new InvalidConfigurationError(`${path}.${key} must be a finite number greater than zero.`);
+    }
+    return value;
+}
+function requireFraction(record, key, path, allowZero) {
+    const value = record[key];
+    if (typeof value !== "number" ||
+        !Number.isFinite(value) ||
+        (allowZero ? value < 0 : value <= 0) ||
+        value > 1) {
+        throw new InvalidConfigurationError(`${path}.${key} must be a finite fraction ${allowZero ? "from 0 through 1" : "greater than 0 and at most 1"}.`);
+    }
+    return value;
+}
+function parseArtifact(value, path) {
+    const record = requireRecord(value, path);
+    const id = requireString(record, "id", path);
+    const checksumSha256 = requireString(record, "checksumSha256", path);
+    if (!/^[a-f0-9]{64}$/iu.test(checksumSha256)) {
+        throw new InvalidConfigurationError(`${path}.checksumSha256 must be a 64-character SHA-256 hex digest.`);
+    }
+    return { id, checksumSha256: checksumSha256.toLowerCase() };
+}
+function parseUncertainty(value, path) {
+    const record = requireRecord(value, path);
+    const kind = requireString(record, "kind", path);
+    if (kind === "relative") {
+        const fraction = record.fraction;
+        if (typeof fraction !== "number" ||
+            !Number.isFinite(fraction) ||
+            fraction < 0) {
+            throw new InvalidConfigurationError(`${path}.fraction must be finite and greater than or equal to zero.`);
+        }
+        return {
+            kind,
+            fraction,
+            basis: requireString(record, "basis", path)
+        };
+    }
+    if (kind === "absolute") {
+        const plusMinus = record.plusMinus;
+        if (typeof plusMinus !== "number" ||
+            !Number.isFinite(plusMinus) ||
+            plusMinus < 0) {
+            throw new InvalidConfigurationError(`${path}.plusMinus must be finite and greater than or equal to zero.`);
+        }
+        return {
+            kind,
+            plusMinus,
+            unit: requireString(record, "unit", path),
+            basis: requireString(record, "basis", path)
+        };
+    }
+    if (kind === "not-quantified") {
+        return {
+            kind,
+            limitation: requireString(record, "limitation", path)
+        };
+    }
+    throw new InvalidConfigurationError(`${path}.kind is invalid.`);
+}
+function parseBase(record, path) {
+    const scientificStatus = requireString(record, "scientificStatus", path);
+    if (!SCIENTIFIC_STATUSES.has(scientificStatus)) {
+        throw new InvalidConfigurationError(`${path}.scientificStatus is invalid.`);
+    }
+    return {
+        scientificStatus: scientificStatus,
+        modelId: requireString(record, "modelId", path),
+        modelVersion: requireString(record, "modelVersion", path),
+        evidence: parseEvidenceList(record.evidence, `${path}.evidence`),
+        uncertainty: parseUncertainty(record.uncertainty, `${path}.uncertainty`)
+    };
+}
+function requireApproximationStatus(base, path, representation) {
+    if (base.scientificStatus !== "approximation") {
+        throw new InvalidConfigurationError(`${path} uses inherently approximate representation "${representation}" and must declare scientificStatus "approximation".`);
+    }
+}
+function parseRequirement(value, path) {
+    const record = requireRecord(value, path);
+    const requirement = requireString(record, "requirement", path);
+    if (!REQUIREMENT_IDS.has(requirement)) {
+        throw new InvalidConfigurationError(`${path}.requirement is invalid.`);
+    }
+    const base = parseBase(record, path);
+    if (requirement === "scene-spectral-radiance") {
+        const representation = requireString(record, "representation", path);
+        if (representation !== "spectral-data" &&
+            representation !== "documented-spectral-approximation") {
+            throw new InvalidConfigurationError(`${path}.representation is invalid.`);
+        }
+        if (representation === "documented-spectral-approximation") {
+            requireApproximationStatus(base, path, representation);
+        }
+        return {
+            requirement,
+            ...base,
+            representation,
+            dataArtifact: parseArtifact(record.dataArtifact, `${path}.dataArtifact`)
+        };
+    }
+    if (requirement === "optical-transmission") {
+        const representation = requireString(record, "representation", path);
+        if (representation === "spectral-data") {
+            return {
+                requirement,
+                ...base,
+                representation,
+                dataArtifact: parseArtifact(record.dataArtifact, `${path}.dataArtifact`)
+            };
+        }
+        if (representation === "t-stop-approximation") {
+            requireApproximationStatus(base, path, representation);
+            return {
+                requirement,
+                ...base,
+                representation,
+                tStop: requirePositiveNumber(record, "tStop", path)
+            };
+        }
+        throw new InvalidConfigurationError(`${path}.representation is invalid.`);
+    }
+    if (requirement === "pupil-vignetting") {
+        const representation = requireString(record, "representation", path);
+        if (representation === "spatial-data") {
+            return {
+                requirement,
+                ...base,
+                representation,
+                dataArtifact: parseArtifact(record.dataArtifact, `${path}.dataArtifact`)
+            };
+        }
+        if (representation === "documented-approximation") {
+            requireApproximationStatus(base, path, representation);
+            return { requirement, ...base, representation };
+        }
+        throw new InvalidConfigurationError(`${path}.representation is invalid.`);
+    }
+    if (requirement === "photosite-collection-area") {
+        if (record.areaModel === undefined &&
+            (record.geometricPitchXMicrometers !== undefined ||
+                record.geometricPitchYMicrometers !== undefined)) {
+            throw new InvalidConfigurationError(`${path}.areaModel is required. Geometric sample pitch alone is not a photosite collection-area model.`);
+        }
+        const areaModel = requireString(record, "areaModel", path);
+        if (areaModel === "effective-collection-area") {
+            return {
+                requirement,
+                ...base,
+                areaModel,
+                effectiveCollectionAreaSquareMicrometers: requirePositiveNumber(record, "effectiveCollectionAreaSquareMicrometers", path)
+            };
+        }
+        if (areaModel === "geometric-area-times-fill-factor") {
+            return {
+                requirement,
+                ...base,
+                areaModel,
+                geometricCellAreaSquareMicrometers: requirePositiveNumber(record, "geometricCellAreaSquareMicrometers", path),
+                fillFactor: requireFraction(record, "fillFactor", path, false)
+            };
+        }
+        throw new InvalidConfigurationError(`${path}.areaModel is invalid. Geometric sample pitch alone is not a photosite collection-area model.`);
+    }
+    if (requirement === "exposure-integration") {
+        const integrationModel = requireString(record, "integrationModel", path);
+        if (integrationModel === "uniform-boxcar") {
+            return { requirement, ...base, integrationModel };
+        }
+        if (integrationModel === "documented-shutter-function") {
+            return {
+                requirement,
+                ...base,
+                integrationModel,
+                dataArtifact: parseArtifact(record.dataArtifact, `${path}.dataArtifact`)
+            };
+        }
+        throw new InvalidConfigurationError(`${path}.integrationModel is invalid.`);
+    }
+    const responseRepresentation = requireString(record, "responseRepresentation", path);
+    if (responseRepresentation === "spectral-quantum-efficiency") {
+        return {
+            requirement: "sensor-response",
+            ...base,
+            responseRepresentation,
+            dataArtifact: parseArtifact(record.dataArtifact, `${path}.dataArtifact`)
+        };
+    }
+    if (responseRepresentation === "effective-qe-approximation") {
+        requireApproximationStatus(base, path, responseRepresentation);
+        return {
+            requirement: "sensor-response",
+            ...base,
+            responseRepresentation,
+            effectiveQuantumEfficiency: requireFraction(record, "effectiveQuantumEfficiency", path, true)
+        };
+    }
+    throw new InvalidConfigurationError(`${path}.responseRepresentation is invalid.`);
+}
+/**
+ * Parses untrusted radiometry-prerequisite metadata.
+ *
+ * This validates structure and provenance; it cannot prove that a cited
+ * calibration/evidence claim is scientifically true.
+ */
+export function parseRadiometryReadinessProfile(value) {
+    const profile = requireRecord(value, "radiometryReadiness");
+    if (profile.schemaVersion !== "0.1.0") {
+        throw new InvalidConfigurationError('radiometryReadiness.schemaVersion must be "0.1.0".');
+    }
+    if (!Array.isArray(profile.components)) {
+        throw new InvalidConfigurationError("radiometryReadiness.components must be an array.");
+    }
+    const components = profile.components.map((component, index) => parseRequirement(component, `radiometryReadiness.components[${index}]`));
+    const ids = components.map((component) => component.requirement);
+    if (new Set(ids).size !== ids.length) {
+        throw new InvalidConfigurationError("radiometryReadiness.components must not contain duplicate requirement IDs.");
+    }
+    return {
+        schemaVersion: "0.1.0",
+        components
+    };
+}
+/**
+ * Assesses whether the declared prerequisites are sufficient for a nominal
+ * photon estimate and, separately, for a calibrated photon claim.
+ *
+ * This assessment does not enable composed photon/noise output.
+ */
+export function assessRadiometryReadiness(profile) {
+    const validatedProfile = parseRadiometryReadinessProfile(profile);
+    const byId = new Map(validatedProfile.components.map((component) => [
+        component.requirement,
+        component
+    ]));
+    const missingRequirements = REQUIRED_REQUIREMENTS.filter((requirement) => !byId.has(requirement));
+    const approximateRequirements = validatedProfile.components
+        .filter((component) => component.scientificStatus === "approximation")
+        .map((component) => component.requirement);
+    const unquantifiedUncertaintyRequirements = validatedProfile.components
+        .filter((component) => component.uncertainty.kind === "not-quantified")
+        .map((component) => component.requirement);
+    const nominalPhotonEstimateReady = missingRequirements.length === 0;
+    const calibratedPhotonClaimReady = nominalPhotonEstimateReady &&
+        approximateRequirements.length === 0 &&
+        unquantifiedUncertaintyRequirements.length === 0;
+    return {
+        status: !nominalPhotonEstimateReady
+            ? "not-ready"
+            : calibratedPhotonClaimReady
+                ? "calibrated-ready"
+                : "approximate-only",
+        nominalPhotonEstimateReady,
+        calibratedPhotonClaimReady,
+        missingRequirements,
+        approximateRequirements,
+        unquantifiedUncertaintyRequirements,
+        composedPhotonOutputEnabled: false
+    };
+}
+//# sourceMappingURL=radiometry-readiness.js.map

package/dist/sensor/radiometry-readiness.js.map

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

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

@@ -0,0 +1,99 @@
+import { type CalculationResult } from "../core/calculation-result.js";
+/**
+ * Physical photosensitive imaging area used for image formation.
+ *
+ * This is deliberately not a sensor package/die dimension.
+ */
+export interface SensorImagingArea {
+    /** Physical active imaging width in millimetres. */
+    widthMm: number;
+    /** Physical active imaging height in millimetres. */
+    heightMm: number;
+}
+/**
+ * Native effective image-sampling raster associated with an imaging area.
+ *
+ * The raster describes effective image samples. It does not imply that each
+ * sample corresponds one-to-one with a physical photodiode/photosite.
+ */
+export interface RasterDimensions {
+    /** Horizontal image-sample/pixel count. */
+    pixelWidth: number;
+    /** Vertical image-sample/pixel count. */
+    pixelHeight: number;
+}
+/**
+ * Native effective image-sampling raster associated with an imaging area.
+ *
+ * This alias identifies semantic role; generic active/output rasters should
+ * use RasterDimensions instead.
+ */
+export type NativeImageRaster = RasterDimensions;
+export interface ImagingAreaMetrics {
+    /** Physical imaging-area diagonal in millimetres. */
+    diagonalMm: number;
+    /** Physical width divided by physical height. */
+    aspectRatio: number;
+    /**
+     * 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.
+     */
+    cropFactor35Mm: number;
+}
+export interface CalculateSensorGeometryMetricsInput {
+    imagingArea: SensorImagingArea;
+    nativeRaster: NativeImageRaster;
+}
+export interface SensorGeometryMetrics {
+    imagingArea: ImagingAreaMetrics;
+    nativeRaster: {
+        /** Exact product of native raster width and height. */
+        totalImageSamples: number;
+        /** Derived megapixels from the exact native raster. */
+        megapixels: number;
+        /** Native raster width divided by native raster height. */
+        aspectRatio: number;
+    };
+    sampling: {
+        /**
+         * Horizontal geometric sampling pitch in micrometres.
+         *
+         * This is image-sample spacing, not physical photodiode active area.
+         */
+        pitchXMicrometers: number;
+        /**
+         * Vertical geometric sampling pitch in micrometres.
+         *
+         * This is image-sample spacing, not physical photodiode active area.
+         */
+        pitchYMicrometers: number;
+        /** Horizontal sampling pitch divided by vertical sampling pitch. */
+        pitchAspectRatio: number;
+    };
+}
+/**
+ * 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.
+ *
+ * @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.
+ *
+ * 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.
+ *
+ * @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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sensor-geometry.d.ts","sourceRoot":"","sources":["../../src/sensor/sensor-geometry.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAcvC;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mCAAmC;IAClD,WAAW,EAAE,iBAAiB,CAAC;IAC/B,YAAY,EAAE,iBAAiB,CAAC;CACjC;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,kBAAkB,CAAC;IAChC,YAAY,EAAE;QACZ,uDAAuD;QACvD,iBAAiB,EAAE,MAAM,CAAC;QAC1B,uDAAuD;QACvD,UAAU,EAAE,MAAM,CAAC;QACnB,2DAA2D;QAC3D,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,QAAQ,EAAE;QACR;;;;WAIG;QACH,iBAAiB,EAAE,MAAM,CAAC;QAC1B;;;;WAIG;QACH,iBAAiB,EAAE,MAAM,CAAC;QAC1B,oEAAoE;QACpE,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,iBAAiB,GAC7B,iBAAiB,CAAC,kBAAkB,CAAC,CAmBvC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,mCAAmC,GACzC,iBAAiB,CAAC,qBAAqB,CAAC,CAmD1C"}