@photivra/engine 1.5.0 → 2.1.0

package/dist/sensor/spatio-spectral-reduction.js.map

@@ -1 +1 @@
-{"version":3,"file":"spatio-spectral-reduction.js","sourceRoot":"","sources":["../../src/sensor/spatio-spectral-reduction.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"spatio-spectral-reduction.js","sourceRoot":"","sources":["../../src/sensor/spatio-spectral-reduction.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Spatio-spectral reduction: integrates spectral irradiance on the sensor over one site's area and\n * over wavelength, giving the incident light power on the site's geometric aperture.\n *\n * It stops before the sensor response: QE (quantum efficiency), A/W responsivity and colour-filter\n * transmission are applied in later steps.\n * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support\n * limits.\n */\n\nimport {\n  approximationResult,\n  type CalculationResult\n} from \"../core/calculation-result.js\";\nimport { InvalidScientificInputError } from \"../core/validation.js\";\nimport {\n  sensorSpatialQuadratureNodeIdentityKey,\n  validateSensorSpatialSamplingQuadrature,\n  type SensorSpatialQuadratureNodeIdentity\n} from \"./spatial-sample-reduction.js\";\nimport type {\n  SensorSpatialSamplingQuadrature\n} from \"./spatial-sampling-quadrature.js\";\nimport {\n  validateSensorSpectralQuadrature,\n  type SensorSpectralQuadrature,\n  type SensorSpectralQuadratureNode\n} from \"./spectral-quadrature.js\";\nimport { requireInputKeys } from \"../core/record-validation.js\";\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\n\nconst SQUARE_MICROMETERS_TO_SQUARE_METERS = 1e-12;\nconst MAX_SPATIO_SPECTRAL_SAMPLE_VALUES = 100_000;\n\nexport interface SensorSpatioSpectralNodeIdentity {\n  spatialNode: SensorSpatialQuadratureNodeIdentity;\n  spectralSampleIndex: number;\n  wavelengthNanometers: number;\n}\n\nexport interface SensorSpatioSpectralIrradianceSample {\n  node: SensorSpatioSpectralNodeIdentity;\n  /**\n   * Spectral irradiance at the spatial node's preAntiAliasingSourcePointMm\n   * and this spectral node's wavelength.\n   *\n   * Units: W/m^2/nm.\n   */\n  spectralIrradianceWattsPerSquareMeterPerNanometer: number;\n}\n\nexport interface ReduceSensorSpatioSpectralIrradianceInput {\n  spatialQuadrature: SensorSpatialSamplingQuadrature;\n  spectralQuadrature: SensorSpectralQuadrature;\n  /**\n   * Exactly one E_lambda(x,y) value, with its node identity, for every\n   * combination of spatial node and spectral node.\n   *\n   * Order does not matter; the node identity does.\n   */\n  sampleValues: readonly SensorSpatioSpectralIrradianceSample[];\n}\n\nexport interface SensorSpatioSpectralWavelengthReduction {\n  spectralSampleIndex: number;\n  wavelengthNanometers: number;\n  wavelengthMeasureNanometers: number;\n  normalizedWavelengthWeight: number;\n  /**\n   * Spatially reduced spectral irradiance at this wavelength.\n   * Units: W/m^2/nm.\n   */\n  normalizedSpatialAverageSpectralIrradianceWattsPerSquareMeterPerNanometer:\n    number;\n  /**\n   * Spectral radiant flux reaching the geometric sensitive aperture, after the\n   * declared normalized AA spreading. Units: W/nm.\n   *\n   * This uses geometric area, not an established light-collection area.\n   */\n  geometricApertureIncidentSpectralFluxWattsPerNanometer: number;\n  /**\n   * Contribution to the wavelength-integrated spatial average.\n   * Units: W/m^2.\n   */\n  wavelengthIntegratedSpatialAverageContributionWattsPerSquareMeter: number;\n  /**\n   * Contribution to wavelength-integrated geometric-aperture incident flux.\n   * Units: W.\n   */\n  wavelengthIntegratedGeometricApertureIncidentFluxContributionWatts: number;\n}\n\nexport interface SensorSpatioSpectralIrradianceReduction {\n  colorSamplingProfileId: string;\n  samplingApertureProfileId?: string;\n  opticalStackProfileId?: string;\n  site: {\n    x: number;\n    y: number;\n  };\n  channelId: string;\n  responseProfileId: string;\n  sourceResponseKind:\n    SensorSpectralQuadrature[\"sourceResponseKind\"];\n  responseScope:\n    SensorSpectralQuadrature[\"responseScope\"];\n  responseScientificStatus:\n    SensorSpectralQuadrature[\"responseScientificStatus\"];\n  responseUncertainty:\n    SensorSpectralQuadrature[\"responseUncertainty\"];\n  responseChannelBinding?:\n    SensorSpectralQuadrature[\"responseChannelBinding\"];\n  responseReferenceConditions?:\n    SensorSpectralQuadrature[\"responseReferenceConditions\"];\n  wavelengthBasis:\n    SensorSpectralQuadrature[\"wavelengthBasis\"];\n  wavelengthBasisResolved: boolean;\n  wavelengthRangeNanometers:\n    SensorSpectralQuadrature[\"wavelengthRangeNanometers\"];\n  responseDeclaredWavelengthRangeNanometers:\n    SensorSpectralQuadrature[\"responseDeclaredWavelengthRangeNanometers\"];\n  outputMeaning:\n    \"pre-response-spatio-spectral-radiometric-reduction\";\n  inputValueDomain: {\n    kind: \"radiometric-spectral-irradiance\";\n    unit: \"W/m^2/nm\";\n    semantic:\n      \"pre-aa-pre-response-sensor-plane-spectral-irradiance\";\n  };\n  spatialNodeCount: number;\n  spectralNodeCount: number;\n  combinedSampleCount: number;\n  sourceValuesMatchedBy:\n    \"spatial-node-identity-plus-spectral-sample-index-and-wavelength\";\n  sourceValuesSuppliedForAllCombinedNodes: true;\n  outsideImagingAreaSourceValuesRequired: boolean;\n  geometricApertureAreaSquareMicrometers?: number;\n  nominalSiteCellAreaSquareMicrometers?: number;\n  geometricSensitiveAreaFractionOfLatticeCell?: number;\n  perWavelength:\n    readonly SensorSpatioSpectralWavelengthReduction[];\n  /**\n   * Integral over the requested wavelength interval of the spatially averaged\n   * spectral irradiance. Units: W/m^2.\n   */\n  wavelengthIntegratedSpatialAverageIrradianceWattsPerSquareMeter:\n    number;\n  /**\n   * Integral over the requested wavelength interval and the geometric\n   * aperture area. Units: W.\n   *\n   * This is the incident radiant flux before the sensor response, over the\n   * declared wavelength interval. It is not collected power or generated charge.\n   */\n  wavelengthIntegratedGeometricApertureIncidentFluxWatts:\n    number;\n  spatialIntegrationApplied: true;\n  wavelengthIntegrationApplied: true;\n  spectralResponsePlanUsedForWavelengthSupport: true;\n  spectralResponseApplicationPerformed: false;\n  responseScopeMatchedToSourcePlane: false;\n  quantumEfficiencyApplied: false;\n  spectralResponsivityApplied: false;\n  channelFilterTransmissionApplied: false;\n  opticalTransmissionAppliedByReducer: false;\n  radiometricCollectionAreaEstablished: false;\n  temporalIntegrationApplied: false;\n  exposureDurationApplied: false;\n  photonsCalculated: false;\n  electronsCalculated: false;\n  currentCalculated: false;\n  shotNoiseApplied: false;\n  readNoiseApplied: false;\n  adcQuantizationApplied: false;\n  rawCodeValueProduced: false;\n  demosaicOrReconstructionApplied: false;\n  convergenceErrorEstimated: false;\n  componentEvidence: {\n    spatial:\n      SensorSpatialSamplingQuadrature[\"componentEvidence\"];\n    spectral:\n      SensorSpectralQuadrature[\"componentEvidence\"];\n  };\n}\n\nfunction requireSafeNonNegativeInteger(\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 + \" must be a non-negative safe integer.\"\n    );\n  }\n  return value;\n}\n\nfunction requireNonNegativeFinite(\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 InvalidScientificInputError(\n      path +\n        \" must be finite and greater than or equal to zero.\"\n    );\n  }\n  return value;\n}\n\nfunction sampleKey(\n  spatialNode:\n    SensorSpatialQuadratureNodeIdentity,\n  spectralSampleIndex: number\n): string {\n  return (\n    sensorSpatialQuadratureNodeIdentityKey(\n      spatialNode\n    ) +\n    \"|\" +\n    spectralSampleIndex\n  );\n}\n\nfunction parseSamples<T extends { node: SensorSpatioSpectralNodeIdentity }, V>(\n  sampleValues:\n    readonly T[],\n  spatialNodesByKey: ReadonlyMap<\n    string,\n    SensorSpatialSamplingQuadrature[\"nodes\"][number]\n  >,\n  spectralNodesByIndex: ReadonlyMap<\n    number,\n    SensorSpectralQuadratureNode\n  >,\n  combinedSampleCount: number,\n  valueForSample: (sample: T, sampleIndex: number) => V\n): Map<string, V> {\n  if (!Array.isArray(sampleValues)) {\n    throw new InvalidConfigurationError(\n      \"sampleValues must be an array.\"\n    );\n  }\n  if (\n    sampleValues.length !==\n    combinedSampleCount\n  ) {\n    throw new InvalidScientificInputError(\n      \"sampleValues must contain exactly one value for every spatial × spectral quadrature node.\"\n    );\n  }\n\n  const valuesByKey =\n    new Map<string, V>();\n\n  sampleValues.forEach(\n    (sample, sampleIndex) => {\n      if (\n        typeof sample !== \"object\" ||\n        sample === null ||\n        typeof sample.node !== \"object\" ||\n        sample.node === null ||\n        typeof sample.node.spatialNode !==\n          \"object\" ||\n        sample.node.spatialNode === null\n      ) {\n        throw new InvalidScientificInputError(\n          \"sampleValues[\" +\n            sampleIndex +\n            \"] must contain a complete spatio-spectral node identity.\"\n        );\n      }\n\n      const spatialNode = {\n        antiAliasingComponentIndex:\n          requireSafeNonNegativeInteger(\n            sample.node.spatialNode\n              .antiAliasingComponentIndex,\n            \"sampleValues[\" +\n              sampleIndex +\n              \"].node.spatialNode.antiAliasingComponentIndex\"\n          ),\n        apertureSampleXIndex:\n          requireSafeNonNegativeInteger(\n            sample.node.spatialNode\n              .apertureSampleXIndex,\n            \"sampleValues[\" +\n              sampleIndex +\n              \"].node.spatialNode.apertureSampleXIndex\"\n          ),\n        apertureSampleYIndex:\n          requireSafeNonNegativeInteger(\n            sample.node.spatialNode\n              .apertureSampleYIndex,\n            \"sampleValues[\" +\n              sampleIndex +\n              \"].node.spatialNode.apertureSampleYIndex\"\n          )\n      };\n      const spatialKey =\n        sensorSpatialQuadratureNodeIdentityKey(\n          spatialNode\n        );\n      if (\n        !spatialNodesByKey.has(\n          spatialKey\n        )\n      ) {\n        throw new InvalidScientificInputError(\n          \"sampleValues identifies a spatial node that is not present in spatialQuadrature.\"\n        );\n      }\n\n      const spectralSampleIndex =\n        requireSafeNonNegativeInteger(\n          sample.node.spectralSampleIndex,\n          \"sampleValues[\" +\n            sampleIndex +\n            \"].node.spectralSampleIndex\"\n        );\n      const spectralNode =\n        spectralNodesByIndex.get(\n          spectralSampleIndex\n        );\n      if (spectralNode === undefined) {\n        throw new InvalidScientificInputError(\n          \"sampleValues identifies a spectral node that is not present in spectralQuadrature.\"\n        );\n      }\n\n      const wavelengthNanometers =\n        requireNonNegativeFinite(\n          sample.node.wavelengthNanometers,\n          \"sampleValues[\" +\n            sampleIndex +\n            \"].node.wavelengthNanometers\"\n        );\n      if (\n        wavelengthNanometers !==\n        spectralNode.wavelengthNanometers\n      ) {\n        throw new InvalidScientificInputError(\n          \"sampleValues wavelengthNanometers must exactly match the identified spectral quadrature node.\"\n        );\n      }\n\n      const key = sampleKey(\n        spatialNode,\n        spectralSampleIndex\n      );\n      if (valuesByKey.has(key)) {\n        throw new InvalidScientificInputError(\n          \"sampleValues contains duplicate spatio-spectral node identities.\"\n        );\n      }\n\n      valuesByKey.set(\n        key,\n        valueForSample(sample, sampleIndex)\n      );\n    }\n  );\n\n  if (valuesByKey.size !== combinedSampleCount) {\n    throw new InvalidScientificInputError(\"sampleValues must not contain sparse or missing node entries.\");\n  }\n  return valuesByKey;\n}\n\n/** Internal: matches samples to their spatial × spectral nodes. Each caller still validates values and applies its own equations. */\nexport function bindSensorSpatioSpectralSamples<T extends { node: SensorSpatioSpectralNodeIdentity }, V>(\n  input: { spatialQuadrature: SensorSpatialSamplingQuadrature; spectralQuadrature: SensorSpectralQuadrature; sampleValues: readonly T[] },\n  valueForSample: (sample: T, sampleIndex: number) => V\n): { spatialNodesByKey: Map<string, SensorSpatialSamplingQuadrature[\"nodes\"][number]>;\n  spectralNodesByIndex: Map<number, SensorSpectralQuadratureNode>; colorSamplingProfileId: string;\n  combinedSampleCount: number; valuesByKey: Map<string, V> } {\n  const spatialNodesByKey =\n    validateSensorSpatialSamplingQuadrature(\n      input.spatialQuadrature\n    );\n  const spectralNodesByIndex =\n    validateSensorSpectralQuadrature(\n      input.spectralQuadrature\n    );\n\n  const colorSamplingProfileId =\n    input.spatialQuadrature\n      .colorSamplingProfileId;\n  if (\n    typeof colorSamplingProfileId !==\n      \"string\" ||\n    colorSamplingProfileId.trim().length ===\n      0\n  ) {\n    throw new InvalidScientificInputError(\n      \"spatialQuadrature.colorSamplingProfileId is required for spatio-spectral composition.\"\n    );\n  }\n  if (\n    colorSamplingProfileId !==\n    input.spectralQuadrature\n      .colorSamplingProfileId\n  ) {\n    throw new InvalidScientificInputError(\n      \"Spatial and spectral quadratures must reference the same colorSamplingProfileId.\"\n    );\n  }\n  if (\n    input.spatialQuadrature.channelId !==\n    input.spectralQuadrature.channelId\n  ) {\n    throw new InvalidScientificInputError(\n      \"Spatial and spectral quadratures must reference the same exact channelId.\"\n    );\n  }\n\n  if (\n    input.spatialQuadrature.outputMeaning !==\n      \"pre-aa-optical-field-spatial-quadrature-nodes\" ||\n    input.spatialQuadrature\n      .spectralResponseIncluded !== false ||\n    input.spatialQuadrature\n      .temporalIntegrationIncluded !== false\n  ) {\n    throw new InvalidScientificInputError(\n      \"spatialQuadrature semantics are incompatible with pre-response spatio-spectral reduction.\"\n    );\n  }\n\n  const combinedSampleCount =\n    spatialNodesByKey.size *\n    spectralNodesByIndex.size;\n  if (\n    !Number.isSafeInteger(\n      combinedSampleCount\n    ) ||\n    combinedSampleCount <= 0\n  ) {\n    throw new InvalidScientificInputError(\n      \"Spatial × spectral quadrature sample count must be a positive safe integer.\"\n    );\n  }\n  if (\n    combinedSampleCount >\n    MAX_SPATIO_SPECTRAL_SAMPLE_VALUES\n  ) {\n    throw new InvalidScientificInputError(\n      \"Spatial × spectral quadrature sample count exceeds the safety limit of \" +\n        MAX_SPATIO_SPECTRAL_SAMPLE_VALUES +\n        \". Tile/batch the evaluation instead of materializing one oversized Cartesian product.\"\n    );\n  }\n\n  const valuesByKey =\n    parseSamples(\n      input.sampleValues,\n      spatialNodesByKey,\n      spectralNodesByIndex,\n      combinedSampleCount,\n      valueForSample\n    );\n\n  return { spatialNodesByKey, spectralNodesByIndex, colorSamplingProfileId, combinedSampleCount, valuesByKey };\n}\n\n/**\n * Integrates supplied spectral irradiance on the sensor plane, E_lambda(x,y),\n * over every combination of an existing spatial quadrature and spectral\n * quadrature.\n *\n * Units: the density is in W/m^2/nm and wavelengthMeasureNanometers is dλ in\n * nm, so their product is in W/m^2. Do not convert dλ to metres unless the\n * density's per-nanometre unit is converted to match.\n *\n * Area integration uses the spatial quadrature's geometric area measures,\n * converted from square micrometres to square metres. The result is the\n * incident radiant flux on the geometric aperture only; geometric area is not\n * treated as an effective light-collection area.\n *\n * It deliberately stops before the sensor response. The spectral plan comes\n * from a specific response channel, so its wavelength range and breakpoints\n * fit that channel, but QE, A/W responsivity and colour-filter transmission are\n * not applied here. Matching the response's scope and source plane is a\n * separate later step.\n */\nexport function reduceSensorSpatioSpectralIrradiance(\n  input:\n    ReduceSensorSpatioSpectralIrradianceInput\n): CalculationResult<SensorSpatioSpectralIrradianceReduction> {\n  requireInputKeys(input, \"reduceSensorSpatioSpectralIrradiance\", [\"spatialQuadrature\", \"spectralQuadrature\", \"sampleValues\"]);\n  const { spatialNodesByKey, spectralNodesByIndex, colorSamplingProfileId, combinedSampleCount, valuesByKey } =\n    bindSensorSpatioSpectralSamples(input, (sample, sampleIndex) => requireNonNegativeFinite(\n      sample.spectralIrradianceWattsPerSquareMeterPerNanometer,\n      \"sampleValues[\" + sampleIndex + \"].spectralIrradianceWattsPerSquareMeterPerNanometer\"\n    ));\n\n  const perWavelength:\n    SensorSpatioSpectralWavelengthReduction[] =\n      [];\n  let wavelengthIntegratedSpatialAverage = 0;\n  let wavelengthIntegratedGeometricFlux = 0;\n\n  for (\n    let spectralSampleIndex = 0;\n    spectralSampleIndex <\n    input.spectralQuadrature.totalNodeCount;\n    spectralSampleIndex += 1\n  ) {\n    const spectralNode =\n      spectralNodesByIndex.get(\n        spectralSampleIndex\n      );\n    if (spectralNode === undefined) {\n      throw new InvalidScientificInputError(\n        \"spectralQuadrature is missing a validated contiguous spectral sample.\"\n      );\n    }\n\n    let spatialAverageSpectralIrradiance = 0;\n    let geometricSpectralFluxWattsPerNanometer =\n      0;\n\n    spatialNodesByKey.forEach(\n      (spatialNode, spatialKey) => {\n        const value =\n          valuesByKey.get(\n            spatialKey +\n              \"|\" +\n              spectralSampleIndex\n          );\n        if (value === undefined) {\n          throw new InvalidScientificInputError(\n            \"A spatio-spectral quadrature node is missing its explicit source value.\"\n          );\n        }\n\n        spatialAverageSpectralIrradiance +=\n          value *\n          spatialNode\n            .combinedNormalizedSpatialWeight;\n        geometricSpectralFluxWattsPerNanometer +=\n          value *\n          (\n            spatialNode\n              .combinedAreaMeasureSquareMicrometers *\n            SQUARE_MICROMETERS_TO_SQUARE_METERS\n          );\n\n        if (\n          !Number.isFinite(\n            spatialAverageSpectralIrradiance\n          ) ||\n          !Number.isFinite(\n            geometricSpectralFluxWattsPerNanometer\n          )\n        ) {\n          throw new InvalidScientificInputError(\n            \"Reduced spatio-spectral values must remain finite.\"\n          );\n        }\n      }\n    );\n\n    const spatialAverageContribution =\n      spatialAverageSpectralIrradiance *\n      spectralNode\n        .wavelengthMeasureNanometers;\n    const geometricFluxContribution =\n      geometricSpectralFluxWattsPerNanometer *\n      spectralNode\n        .wavelengthMeasureNanometers;\n\n    wavelengthIntegratedSpatialAverage +=\n      spatialAverageContribution;\n    wavelengthIntegratedGeometricFlux +=\n      geometricFluxContribution;\n\n    if (\n      !Number.isFinite(\n        wavelengthIntegratedSpatialAverage\n      ) ||\n      !Number.isFinite(\n        wavelengthIntegratedGeometricFlux\n      )\n    ) {\n      throw new InvalidScientificInputError(\n        \"Wavelength-integrated spatio-spectral values must remain finite.\"\n      );\n    }\n\n    perWavelength.push({\n      spectralSampleIndex,\n      wavelengthNanometers:\n        spectralNode.wavelengthNanometers,\n      wavelengthMeasureNanometers:\n        spectralNode\n          .wavelengthMeasureNanometers,\n      normalizedWavelengthWeight:\n        spectralNode\n          .normalizedWavelengthWeight,\n      normalizedSpatialAverageSpectralIrradianceWattsPerSquareMeterPerNanometer:\n        spatialAverageSpectralIrradiance,\n      geometricApertureIncidentSpectralFluxWattsPerNanometer:\n        geometricSpectralFluxWattsPerNanometer,\n      wavelengthIntegratedSpatialAverageContributionWattsPerSquareMeter:\n        spatialAverageContribution,\n      wavelengthIntegratedGeometricApertureIncidentFluxContributionWatts:\n        geometricFluxContribution\n    });\n  }\n\n  return approximationResult(\n    {\n      colorSamplingProfileId,\n      ...(input.spatialQuadrature\n        .samplingApertureProfileId ===\n      undefined\n        ? {}\n        : {\n            samplingApertureProfileId:\n              input.spatialQuadrature\n                .samplingApertureProfileId\n          }),\n      ...(input.spatialQuadrature\n        .opticalStackProfileId ===\n      undefined\n        ? {}\n        : {\n            opticalStackProfileId:\n              input.spatialQuadrature\n                .opticalStackProfileId\n          }),\n      site: {\n        ...input.spatialQuadrature.site\n      },\n      channelId:\n        input.spatialQuadrature.channelId,\n      responseProfileId:\n        input.spectralQuadrature.profileId,\n      sourceResponseKind:\n        input.spectralQuadrature\n          .sourceResponseKind,\n      responseScope:\n        input.spectralQuadrature\n          .responseScope,\n      responseScientificStatus:\n        input.spectralQuadrature\n          .responseScientificStatus,\n      responseUncertainty:\n        input.spectralQuadrature\n          .responseUncertainty,\n      ...(input.spectralQuadrature\n        .responseChannelBinding ===\n      undefined\n        ? {}\n        : {\n            responseChannelBinding:\n              input.spectralQuadrature\n                .responseChannelBinding\n          }),\n      ...(input.spectralQuadrature\n        .responseReferenceConditions ===\n      undefined\n        ? {}\n        : {\n            responseReferenceConditions:\n              input.spectralQuadrature\n                .responseReferenceConditions\n          }),\n      wavelengthBasis:\n        input.spectralQuadrature\n          .wavelengthBasis,\n      wavelengthBasisResolved:\n        input.spectralQuadrature\n          .wavelengthBasisResolved,\n      wavelengthRangeNanometers: {\n        ...input.spectralQuadrature\n          .wavelengthRangeNanometers\n      },\n      responseDeclaredWavelengthRangeNanometers:\n        {\n          ...input.spectralQuadrature\n            .responseDeclaredWavelengthRangeNanometers\n        },\n      outputMeaning:\n        \"pre-response-spatio-spectral-radiometric-reduction\",\n      inputValueDomain: {\n        kind:\n          \"radiometric-spectral-irradiance\",\n        unit: \"W/m^2/nm\",\n        semantic:\n          \"pre-aa-pre-response-sensor-plane-spectral-irradiance\"\n      },\n      spatialNodeCount:\n        input.spatialQuadrature\n          .totalNodeCount,\n      spectralNodeCount:\n        input.spectralQuadrature\n          .totalNodeCount,\n      combinedSampleCount,\n      sourceValuesMatchedBy:\n        \"spatial-node-identity-plus-spectral-sample-index-and-wavelength\",\n      sourceValuesSuppliedForAllCombinedNodes:\n        true,\n      outsideImagingAreaSourceValuesRequired:\n        input.spatialQuadrature\n          .preAntiAliasingSourceOutsideImagingAreaNodeCount >\n        0,\n      geometricApertureAreaSquareMicrometers:\n        input.spatialQuadrature\n          .geometricApertureAreaSquareMicrometers,\n      ...(input.spatialQuadrature\n        .nominalSiteCellAreaSquareMicrometers ===\n      undefined\n        ? {}\n        : {\n            nominalSiteCellAreaSquareMicrometers:\n              input.spatialQuadrature\n                .nominalSiteCellAreaSquareMicrometers\n          }),\n      ...(input.spatialQuadrature\n        .geometricSensitiveAreaFractionOfLatticeCell ===\n      undefined\n        ? {}\n        : {\n            geometricSensitiveAreaFractionOfLatticeCell:\n              input.spatialQuadrature\n                .geometricSensitiveAreaFractionOfLatticeCell\n          }),\n      perWavelength,\n      wavelengthIntegratedSpatialAverageIrradianceWattsPerSquareMeter:\n        wavelengthIntegratedSpatialAverage,\n      wavelengthIntegratedGeometricApertureIncidentFluxWatts:\n        wavelengthIntegratedGeometricFlux,\n      spatialIntegrationApplied: true,\n      wavelengthIntegrationApplied: true,\n      spectralResponsePlanUsedForWavelengthSupport:\n        true,\n      spectralResponseApplicationPerformed:\n        false,\n      responseScopeMatchedToSourcePlane:\n        false,\n      quantumEfficiencyApplied: false,\n      spectralResponsivityApplied: false,\n      channelFilterTransmissionApplied:\n        false,\n      opticalTransmissionAppliedByReducer:\n        false,\n      radiometricCollectionAreaEstablished:\n        false,\n      temporalIntegrationApplied: false,\n      exposureDurationApplied: false,\n      photonsCalculated: false,\n      electronsCalculated: false,\n      currentCalculated: false,\n      shotNoiseApplied: false,\n      readNoiseApplied: false,\n      adcQuantizationApplied: false,\n      rawCodeValueProduced: false,\n      demosaicOrReconstructionApplied:\n        false,\n      convergenceErrorEstimated: false,\n      componentEvidence: {\n        spatial:\n          input.spatialQuadrature\n            .componentEvidence,\n        spectral:\n          input.spectralQuadrature\n            .componentEvidence\n      }\n    },\n    \"sensor-spatio-spectral-irradiance-reduction\",\n    \"1.0.0\",\n    [\n      \"Input values are nonnegative sensor-plane spectral irradiance E_lambda(x,y) in W/m^2/nm, evaluated at every spatial pre-AA source coordinate and spectral quadrature wavelength.\",\n      \"Spatial and spectral plans must share the exact colorSamplingProfileId and channelId; a matching channel label alone is insufficient linkage.\",\n      \"The full Cartesian product is explicit and capped at 100,000 supplied sample values to avoid multiplicative memory blowups.\",\n      \"Spatial normalized weights form the per-wavelength average; geometric square-micrometre area measures are converted to square metres for incident spectral flux density.\",\n      \"Physical wavelength integration multiplies W/m^2/nm or W/nm by d-lambda in nm. No extra 1e-9 factor is applied because the spectral density is already per nanometre.\",\n      \"The spatial AA kernel is the existing normalized throughput-free spatial redistribution; this reducer adds no omitted optical-stack or microlens throughput.\",\n      \"The spectral quadrature's response-derived support and breakpoints are consumed, but QE, A/W responsivity and channel-filter transmission are not applied.\",\n      \"Response scope is preserved for downstream work but is not matched to a declared source plane in this version.\",\n      \"Geometric aperture area is not promoted to effective radiometric collection area.\",\n      \"Temporal exposure integration, photon/electron conversion, electrical current, noise, saturation, ADC/RAW conversion and reconstruction remain separate future work.\",\n      \"No source-independent spatio-spectral convergence/error estimate is reported; downstream integrand structure controls numerical error.\"\n    ]\n  );\n}\n"]}

package/dist/sensor/spectral-coverage.d.ts

@@ -1,8 +1,6 @@
 /**
- * Module boundary and integration notes.
- * Adapts one parsed sensor response channel into the shared continuous spectral-coverage contract.
- * This exposes support and interpolation knots only. It does not apply QE or A/W responsivity and does
- * not establish scene/optics coverage.
+ * Describes a sensor response channel's wavelength coverage in the shared spectral-coverage format
+ * (core/spectral-composition), so it can be intersected with the light source and optics.
  * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
  * limits.
  */
@@ -14,11 +12,10 @@ export interface CreateSensorSpectralCoverageParticipantInput {
     participantId?: string;
 }
 /**
- * Adapts one parsed sensor response channel into the shared continuous
- * spectral-coverage contract.
+ * Converts one parsed sensor response channel into the shared continuous
+ * spectral-coverage format.
  *
- * This exposes support and interpolation knots only. It does not apply QE or
- * A/W responsivity and does not establish scene/optics coverage.
+ * It gives only the wavelength range and interpolation breakpoints. It does not
+ * apply QE or A/W responsivity, and says nothing about scene or optics coverage.
  */
 export declare function createSensorSpectralCoverageParticipant(input: CreateSensorSpectralCoverageParticipantInput): SpectralCoverageParticipant;
-//# sourceMappingURL=spectral-coverage.d.ts.map

package/dist/sensor/spectral-coverage.js

@@ -1,6 +1,8 @@
 // SPDX-License-Identifier: Apache-2.0
 import { InvalidScientificInputError } from "../core/validation.js";
 import { parseSensorSpectralResponseProfile } from "./spectral-response.js";
+import { requireInputKeys } from "../core/record-validation.js";
+import { InvalidConfigurationError } from "../core/configuration-error.js";
 function responseCurves(response) {
     if (response.kind ===
         "effective-external-quantum-efficiency") {
@@ -20,18 +22,19 @@ function responseCurves(response) {
     ];
 }
 /**
- * Adapts one parsed sensor response channel into the shared continuous
- * spectral-coverage contract.
+ * Converts one parsed sensor response channel into the shared continuous
+ * spectral-coverage format.
  *
- * This exposes support and interpolation knots only. It does not apply QE or
- * A/W responsivity and does not establish scene/optics coverage.
+ * It gives only the wavelength range and interpolation breakpoints. It does not
+ * apply QE or A/W responsivity, and says nothing about scene or optics coverage.
  */
 export function createSensorSpectralCoverageParticipant(input) {
+    requireInputKeys(input, "createSensorSpectralCoverageParticipant", ["spectralResponseProfile", "channelId", "participantId"]);
     const profile = parseSensorSpectralResponseProfile(input.spectralResponseProfile);
     if (typeof input.channelId !==
         "string" ||
         input.channelId.trim().length === 0) {
-        throw new InvalidScientificInputError("channelId must be a non-empty string.");
+        throw new InvalidConfigurationError("channelId must be a non-empty string.");
     }
     const response = profile.channels.find((entry) => entry.channelId ===
         input.channelId);
@@ -70,7 +73,7 @@ export function createSensorSpectralCoverageParticipant(input) {
             ":" +
             input.channelId;
     if (participantId.trim().length === 0) {
-        throw new InvalidScientificInputError("participantId must be a non-empty string when supplied.");
+        throw new InvalidConfigurationError("participantId must be a non-empty string when supplied.");
     }
     return {
         participantId,

package/dist/sensor/spectral-coverage.js.map

@@ -1 +1 @@
-{"version":3,"file":"spectral-coverage.js","sourceRoot":"","sources":["../../src/sensor/spectral-coverage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"spectral-coverage.js","sourceRoot":"","sources":["../../src/sensor/spectral-coverage.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Describes a sensor response channel's wavelength coverage in the shared spectral-coverage format\n * (core/spectral-composition), so it can be intersected with the light source and optics.\n * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support\n * limits.\n */\n\nimport type {\n  SpectralCoverageParticipant\n} from \"../core/spectral-composition.js\";\nimport { InvalidScientificInputError } from \"../core/validation.js\";\nimport {\n  parseSensorSpectralResponseProfile,\n  type SensorSpectralChannelResponse,\n  type SensorSpectralResponseProfile\n} from \"./spectral-response.js\";\nimport { requireInputKeys } from \"../core/record-validation.js\";\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\n\nexport interface CreateSensorSpectralCoverageParticipantInput {\n  spectralResponseProfile:\n    SensorSpectralResponseProfile;\n  channelId: string;\n  participantId?: string;\n}\n\ntype ResponseCurve =\n  | Extract<\n      SensorSpectralChannelResponse,\n      {\n        kind:\n          \"effective-external-quantum-efficiency\";\n      }\n    >[\"externalQuantumEfficiency\"]\n  | Extract<\n      SensorSpectralChannelResponse,\n      {\n        kind:\n          \"effective-spectral-responsivity\";\n      }\n    >[\"spectralResponsivity\"]\n  | Extract<\n      SensorSpectralChannelResponse,\n      {\n        kind:\n          \"separable-channel-filter-and-detector-eqe\";\n      }\n    >[\"channelFilterTransmittance\"];\n\nfunction responseCurves(\n  response:\n    SensorSpectralChannelResponse\n): readonly ResponseCurve[] {\n  if (\n    response.kind ===\n    \"effective-external-quantum-efficiency\"\n  ) {\n    return [\n      response.externalQuantumEfficiency\n    ];\n  }\n  if (\n    response.kind ===\n    \"effective-spectral-responsivity\"\n  ) {\n    return [\n      response.spectralResponsivity\n    ];\n  }\n  return [\n    response.channelFilterTransmittance,\n    response.detectorExternalQuantumEfficiency\n  ];\n}\n\n/**\n * Converts one parsed sensor response channel into the shared continuous\n * spectral-coverage format.\n *\n * It gives only the wavelength range and interpolation breakpoints. It does not\n * apply QE or A/W responsivity, and says nothing about scene or optics coverage.\n */\nexport function createSensorSpectralCoverageParticipant(\n  input:\n    CreateSensorSpectralCoverageParticipantInput\n): SpectralCoverageParticipant {\n  requireInputKeys(input, \"createSensorSpectralCoverageParticipant\", [\"spectralResponseProfile\", \"channelId\", \"participantId\"]);\n  const profile =\n    parseSensorSpectralResponseProfile(\n      input.spectralResponseProfile\n    );\n\n  if (\n    typeof input.channelId !==\n      \"string\" ||\n    input.channelId.trim().length === 0\n  ) {\n    throw new InvalidConfigurationError(\n      \"channelId must be a non-empty string.\"\n    );\n  }\n\n  const response =\n    profile.channels.find(\n      (entry) =>\n        entry.channelId ===\n        input.channelId\n    );\n  if (response === undefined) {\n    throw new InvalidScientificInputError(\n      \"No spectral response is declared for the requested channelId.\"\n    );\n  }\n\n  const curves =\n    responseCurves(response);\n  const wavelengthBasis =\n    curves[0]!.wavelengthBasis;\n  if (wavelengthBasis === \"unspecified\") {\n    throw new InvalidScientificInputError(\n      \"Sensor spectral coverage requires a resolved air or vacuum wavelength basis.\"\n    );\n  }\n  if (\n    curves.some(\n      (curve) =>\n        curve.wavelengthBasis !==\n        wavelengthBasis\n    )\n  ) {\n    throw new InvalidScientificInputError(\n      \"Sensor response component curves must share one wavelengthBasis before coverage composition.\"\n    );\n  }\n\n  const minimum = Math.max(\n    ...curves.map(\n      (curve) =>\n        curve.samples[0]!\n          .wavelengthNanometers\n    )\n  );\n  const maximum = Math.min(\n    ...curves.map(\n      (curve) =>\n        curve.samples[\n          curve.samples.length - 1\n        ]!.wavelengthNanometers\n    )\n  );\n  if (!(minimum < maximum)) {\n    throw new InvalidScientificInputError(\n      \"Sensor response component curves do not share a non-empty wavelength interval.\"\n    );\n  }\n\n  const breakpoints =\n    new Set<number>();\n  for (const curve of curves) {\n    for (const sample of curve.samples) {\n      if (\n        sample.wavelengthNanometers >\n          minimum &&\n        sample.wavelengthNanometers <\n          maximum\n      ) {\n        breakpoints.add(\n          sample.wavelengthNanometers\n        );\n      }\n    }\n  }\n\n  const participantId =\n    input.participantId ??\n    \"sensor-response:\" +\n      profile.profileId +\n      \":\" +\n      input.channelId;\n\n  if (\n    participantId.trim().length === 0\n  ) {\n    throw new InvalidConfigurationError(\n      \"participantId must be a non-empty string when supplied.\"\n    );\n  }\n\n  return {\n    participantId,\n    role: \"sensor-response\",\n    wavelengthBasis,\n    wavelengthRangeNanometers: {\n      minimum,\n      maximum\n    },\n    breakpointsNanometers:\n      [...breakpoints].sort(\n        (a, b) => a - b\n      )\n  };\n}\n"]}

package/dist/sensor/spectral-quadrature.d.ts

@@ -1,21 +1,11 @@
 /**
- * Module boundary and integration notes.
- * Revalidate continuous spectral node identity, support and nanometre measures before reducing a
- * supplied wavelength plan. Continuous spectral midpoint planning uses explicit nanometre measures and
- * response-supported intervals. Knot/breakpoint alignment does not prove convergence. Discrete/delta
- * lines require their own integrated measure and cannot be silently widened into continuous bins.
- * Builds deterministic wavelength quadrature nodes for one exact sensor response channel without
- * applying the response to a source spectrum. The requested wavelength range must lie fully inside the
- * response channel's declared usable range. Response-curve knots and optional caller-provided
- * continuous-spectrum/optics breakpoints partition that range. Each segment is then subdivided so no
- * midpoint subinterval exceeds maximumSubintervalWidthNanometers. wavelengthMeasureNanometers is
- * d-lambda in nanometres. It is not a dimensionless response weight. Future integration must use a
- * source spectral density expressed per nanometre or explicitly convert units before multiplying by
- * this measure. This function deliberately does not apply QE or A/W responsivity. Those
- * representations have different compatible downstream signal domains: QE is photon-to-electron
- * efficiency, while A/W responsivity relates incident radiant power to electrical current. A later
- * versioned composition must also match responseScope to the source plane and collection-area
- * semantics before integrating any signal.
+ * Spectral quadrature: the wavelength sample points (nodes) and step widths used to integrate light
+ * over wavelength for one sensor response channel.
+ *
+ * Each node is the midpoint of a wavelength interval, with its width dλ in nanometres. The intervals
+ * stay inside the range the response supports. Lining nodes up with curve breakpoints does not prove
+ * the integral has converged. Discrete (delta-like) emission lines need their own integration and are
+ * never silently widened into continuous bins.
  * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
  * limits.
  */
@@ -31,26 +21,26 @@ export interface CalculateSensorSpectralQuadratureInput {
     channelId: string;
     wavelengthBasis: SpectralWavelengthBasis;
     /**
-     * Explicit wavelength interval to sample. This API validates the interval
-     * against sensor-response support only; it does not establish scene-spectrum
-     * or optical-transmission coverage.
+     * Wavelength interval to sample. It is checked only against the range the
+     * sensor response supports, not against scene-spectrum or optical-transmission
+     * coverage.
      */
     wavelengthRangeNanometers: SensorSpectralWavelengthRangeNanometers;
     /**
-     * Hard upper bound on each midpoint subinterval width.
+     * Strict upper limit on the width of each midpoint subinterval.
      *
-     * Response knots and optional additional breakpoints split the requested
-     * range first; each resulting segment is then subdivided until every
-     * subinterval is no wider than this value.
+     * Response breakpoints and any additional breakpoints split the requested
+     * range first. Each segment is then subdivided until every subinterval is
+     * no wider than this value.
      */
     maximumSubintervalWidthNanometers: number;
     /**
      * Optional strictly increasing wavelength breakpoints from other continuous
-     * spectral factors, such as scene spectral-density or optical-transmission
-     * interpolation knots. Values must lie strictly inside the requested range.
+     * spectral inputs, such as the interpolation points of a scene spectrum or of
+     * optical transmission. Values must be strictly inside the requested range.
      *
-     * These coordinates do not assert that those external factors are actually
-     * available or valid over the requested range.
+     * Passing them does not claim those other inputs are available or valid over
+     * the requested range.
      */
     additionalBreakpointsNanometers?: readonly number[];
 }
@@ -64,16 +54,16 @@ export interface SensorSpectralQuadratureNode {
      */
     wavelengthNanometers: number;
     /**
-     * d-lambda represented by this node. Units: nm.
+     * dλ (wavelength width) this node stands for. Units: nm.
      *
-     * This is wavelength measure only. It is not response-weighted throughput,
-     * photon count, radiant energy, current, or a dimensionless probability.
+     * It is only a wavelength width. It is not response-weighted throughput,
+     * a photon count, radiant energy, current or a dimensionless probability.
      */
     wavelengthMeasureNanometers: number;
     /**
-     * Dimensionless wavelength measure normalized by the requested range width.
+     * The wavelength width divided by the requested range width (dimensionless).
      *
-     * This may be useful for averages, but it is not a sensor-response weight.
+     * Useful for averages, but it is not a sensor-response weight.
      */
     normalizedWavelengthWeight: number;
 }
@@ -94,7 +84,7 @@ export interface SensorSpectralQuadrature {
     quadratureScheme: "response-breakpoint-aware-bounded-midpoint";
     segmentBoundarySource: "requested-range-plus-response-knots-plus-optional-additional-breakpoints";
     /**
-     * Ordered unique segment boundaries, including requested range endpoints.
+     * Sorted, unique segment boundaries, including the ends of the requested range.
      */
     segmentBoundariesNanometers: readonly number[];
     maximumSubintervalWidthNanometers: number;
@@ -111,7 +101,7 @@ export interface SensorSpectralQuadrature {
         curves: readonly (readonly EvidenceProvenance[])[];
     };
     /**
-     * Hard scientific boundaries.
+     * Fixed statements of what this result does not include.
      */
     responseValuesIncluded: false;
     responseApplicationPerformed: false;
@@ -131,39 +121,35 @@ export interface SensorSpectralQuadrature {
     convergenceErrorEstimated: false;
 }
 /**
- * Revalidate continuous spectral node identity, support and nanometre measures before reducing a
- * supplied wavelength plan.
+ * Rechecks a supplied wavelength plan (node identities, coverage and widths in nanometres) before it
+ * is used.
  *
- * Continuous spectral midpoint planning uses explicit nanometre measures and response-supported
- * intervals. Knot/breakpoint alignment does not prove convergence. Discrete/delta lines require their
- * own integrated measure and cannot be silently widened into continuous bins.
- * @param quadrature - SensorSpectralQuadrature. See the linked contract for coordinate, unit and profile binding semantics.
- * @returns Map<number, SensorSpectralQuadratureNode>. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ * Lining nodes up with breakpoints does not prove convergence. Discrete (delta-like) lines need their
+ * own integration and are never silently widened into continuous bins.
+ * @param quadrature - The input; see `SensorSpectralQuadrature` for its fields, units and coordinates.
+ * @returns The result. Success does not imply calibration.
  *
- * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ * @see docs/API_REFERENCE.md for the package export and its full type definitions.
  */
 export declare function validateSensorSpectralQuadrature(quadrature: SensorSpectralQuadrature): Map<number, SensorSpectralQuadratureNode>;
 /**
- * Builds deterministic wavelength quadrature nodes for one exact sensor
- * response channel without applying the response to a source spectrum.
+ * Builds deterministic wavelength sample points for one exact sensor response
+ * channel. It does not apply the response to any spectrum.
  *
- * The requested wavelength range must lie fully inside the response channel's
- * declared usable range. Response-curve knots and optional caller-provided
- * continuous-spectrum/optics breakpoints partition that range. Each segment is
- * then subdivided so no midpoint subinterval exceeds
+ * The requested range must lie fully inside the channel's declared usable
+ * range. The response curve's breakpoints, plus any caller-supplied breakpoints
+ * from the source spectrum or optics, split that range into segments. Each
+ * segment is then subdivided so no midpoint subinterval is wider than
  * maximumSubintervalWidthNanometers.
  *
- * wavelengthMeasureNanometers is d-lambda in nanometres. It is not a
- * dimensionless response weight. Future integration must use a source spectral
- * density expressed per nanometre or explicitly convert units before
- * multiplying by this measure.
+ * wavelengthMeasureNanometers is dλ in nanometres, not a dimensionless response
+ * weight. Multiply it only by a spectral density per nanometre, or convert
+ * units explicitly first.
  *
- * This function deliberately does not apply QE or A/W responsivity. Those
- * representations have different compatible downstream signal domains: QE is
- * photon-to-electron efficiency, while A/W responsivity relates incident
- * radiant power to electrical current. A later versioned composition must also
- * match responseScope to the source plane and collection-area semantics before
- * integrating any signal.
+ * QE and A/W responsivity are deliberately not applied. They lead to different
+ * signals: QE is photon-to-electron efficiency, while A/W responsivity relates
+ * incident radiant power to electrical current. A later step must also match
+ * responseScope to the source plane and collection area before integrating any
+ * signal.
  */
 export declare function calculateSensorSpectralQuadrature(input: CalculateSensorSpectralQuadratureInput): CalculationResult<SensorSpectralQuadrature>;
-//# sourceMappingURL=spectral-quadrature.d.ts.map

package/dist/sensor/spectral-quadrature.js

@@ -1,22 +1,12 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Module boundary and integration notes.
- * Revalidate continuous spectral node identity, support and nanometre measures before reducing a
- * supplied wavelength plan. Continuous spectral midpoint planning uses explicit nanometre measures and
- * response-supported intervals. Knot/breakpoint alignment does not prove convergence. Discrete/delta
- * lines require their own integrated measure and cannot be silently widened into continuous bins.
- * Builds deterministic wavelength quadrature nodes for one exact sensor response channel without
- * applying the response to a source spectrum. The requested wavelength range must lie fully inside the
- * response channel's declared usable range. Response-curve knots and optional caller-provided
- * continuous-spectrum/optics breakpoints partition that range. Each segment is then subdivided so no
- * midpoint subinterval exceeds maximumSubintervalWidthNanometers. wavelengthMeasureNanometers is
- * d-lambda in nanometres. It is not a dimensionless response weight. Future integration must use a
- * source spectral density expressed per nanometre or explicitly convert units before multiplying by
- * this measure. This function deliberately does not apply QE or A/W responsivity. Those
- * representations have different compatible downstream signal domains: QE is photon-to-electron
- * efficiency, while A/W responsivity relates incident radiant power to electrical current. A later
- * versioned composition must also match responseScope to the source plane and collection-area
- * semantics before integrating any signal.
+ * Spectral quadrature: the wavelength sample points (nodes) and step widths used to integrate light
+ * over wavelength for one sensor response channel.
+ *
+ * Each node is the midpoint of a wavelength interval, with its width dλ in nanometres. The intervals
+ * stay inside the range the response supports. Lining nodes up with curve breakpoints does not prove
+ * the integral has converged. Discrete (delta-like) emission lines need their own integration and are
+ * never silently widened into continuous bins.
  * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
  * limits.
  */
@@ -24,6 +14,8 @@ import { approximationResult } from "../core/calculation-result.js";
 import { InvalidScientificInputError } from "../core/validation.js";
 import { parseSensorColorSamplingProfile } from "./color-sampling.js";
 import { createSensorSpectralResponseChannelBinding, parseSensorSpectralResponseProfile, resolveSensorSpectralResponseAtWavelength } from "./spectral-response.js";
+import { requireInputKeys } from "../core/record-validation.js";
+import { InvalidConfigurationError } from "../core/configuration-error.js";
 const MAX_SPECTRAL_QUADRATURE_NODES = 100_000;
 function requirePositiveFinite(value, path) {
     if (typeof value !== "number" ||
@@ -36,7 +28,7 @@ function requirePositiveFinite(value, path) {
 function channelResponse(profile, channelId) {
     if (typeof channelId !== "string" ||
         channelId.trim().length === 0) {
-        throw new InvalidScientificInputError("channelId must be a non-empty string.");
+        throw new InvalidConfigurationError("channelId must be a non-empty string.");
     }
     const response = profile.channels.find((entry) => entry.channelId === channelId);
     if (response === undefined) {
@@ -74,7 +66,7 @@ function usableResponseRange(curves) {
 function parseRequestedRange(input, usable) {
     if (typeof input !== "object" ||
         input === null) {
-        throw new InvalidScientificInputError("wavelengthRangeNanometers must be an object.");
+        throw new InvalidConfigurationError("wavelengthRangeNanometers must be an object.");
     }
     const minimum = requirePositiveFinite(input.minimum, "wavelengthRangeNanometers.minimum");
     const maximum = requirePositiveFinite(input.maximum, "wavelengthRangeNanometers.maximum");
@@ -92,7 +84,7 @@ function additionalBreakpoints(value, range) {
         return [];
     }
     if (!Array.isArray(value)) {
-        throw new InvalidScientificInputError("additionalBreakpointsNanometers must be an array when supplied.");
+        throw new InvalidConfigurationError("additionalBreakpointsNanometers must be an array when supplied.");
     }
     if (value.length >=
         MAX_SPECTRAL_QUADRATURE_NODES) {
@@ -190,22 +182,21 @@ function approximatelyEqual(actual, expected, tolerance = SPECTRAL_VALIDATION_TO
         tolerance * scale);
 }
 /**
- * Revalidate continuous spectral node identity, support and nanometre measures before reducing a
- * supplied wavelength plan.
+ * Rechecks a supplied wavelength plan (node identities, coverage and widths in nanometres) before it
+ * is used.
  *
- * Continuous spectral midpoint planning uses explicit nanometre measures and response-supported
- * intervals. Knot/breakpoint alignment does not prove convergence. Discrete/delta lines require their
- * own integrated measure and cannot be silently widened into continuous bins.
- * @param quadrature - SensorSpectralQuadrature. See the linked contract for coordinate, unit and profile binding semantics.
- * @returns Map<number, SensorSpectralQuadratureNode>. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ * Lining nodes up with breakpoints does not prove convergence. Discrete (delta-like) lines need their
+ * own integration and are never silently widened into continuous bins.
+ * @param quadrature - The input; see `SensorSpectralQuadrature` for its fields, units and coordinates.
+ * @returns The result. Success does not imply calibration.
  *
- * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ * @see docs/API_REFERENCE.md for the package export and its full type definitions.
  */
 export function validateSensorSpectralQuadrature(quadrature) {
     if (typeof quadrature !== "object" ||
         quadrature === null ||
         !Array.isArray(quadrature.nodes)) {
-        throw new InvalidScientificInputError("spectralQuadrature must contain a nodes array.");
+        throw new InvalidConfigurationError("spectralQuadrature must contain a nodes array.");
     }
     for (const [field, value] of [
         ["profileId", quadrature.profileId],
@@ -217,7 +208,7 @@ export function validateSensorSpectralQuadrature(quadrature) {
     ]) {
         if (typeof value !== "string" ||
             value.trim().length === 0) {
-            throw new InvalidScientificInputError("spectralQuadrature." +
+            throw new InvalidConfigurationError("spectralQuadrature." +
                 field +
                 " must be a non-empty string.");
         }
@@ -225,7 +216,7 @@ export function validateSensorSpectralQuadrature(quadrature) {
     if (quadrature.wavelengthBasis !== "air" &&
         quadrature.wavelengthBasis !== "vacuum" &&
         quadrature.wavelengthBasis !== "unspecified") {
-        throw new InvalidScientificInputError("spectralQuadrature.wavelengthBasis is invalid.");
+        throw new InvalidConfigurationError("spectralQuadrature.wavelengthBasis is invalid.");
     }
     const rangeMinimum = requirePositiveFinite(quadrature.wavelengthRangeNanometers.minimum, "spectralQuadrature.wavelengthRangeNanometers.minimum");
     const rangeMaximum = requirePositiveFinite(quadrature.wavelengthRangeNanometers.maximum, "spectralQuadrature.wavelengthRangeNanometers.maximum");
@@ -386,33 +377,32 @@ export function validateSensorSpectralQuadrature(quadrature) {
     return nodesByIndex;
 }
 /**
- * Builds deterministic wavelength quadrature nodes for one exact sensor
- * response channel without applying the response to a source spectrum.
+ * Builds deterministic wavelength sample points for one exact sensor response
+ * channel. It does not apply the response to any spectrum.
  *
- * The requested wavelength range must lie fully inside the response channel's
- * declared usable range. Response-curve knots and optional caller-provided
- * continuous-spectrum/optics breakpoints partition that range. Each segment is
- * then subdivided so no midpoint subinterval exceeds
+ * The requested range must lie fully inside the channel's declared usable
+ * range. The response curve's breakpoints, plus any caller-supplied breakpoints
+ * from the source spectrum or optics, split that range into segments. Each
+ * segment is then subdivided so no midpoint subinterval is wider than
  * maximumSubintervalWidthNanometers.
  *
- * wavelengthMeasureNanometers is d-lambda in nanometres. It is not a
- * dimensionless response weight. Future integration must use a source spectral
- * density expressed per nanometre or explicitly convert units before
- * multiplying by this measure.
+ * wavelengthMeasureNanometers is dλ in nanometres, not a dimensionless response
+ * weight. Multiply it only by a spectral density per nanometre, or convert
+ * units explicitly first.
  *
- * This function deliberately does not apply QE or A/W responsivity. Those
- * representations have different compatible downstream signal domains: QE is
- * photon-to-electron efficiency, while A/W responsivity relates incident
- * radiant power to electrical current. A later versioned composition must also
- * match responseScope to the source plane and collection-area semantics before
- * integrating any signal.
+ * QE and A/W responsivity are deliberately not applied. They lead to different
+ * signals: QE is photon-to-electron efficiency, while A/W responsivity relates
+ * incident radiant power to electrical current. A later step must also match
+ * responseScope to the source plane and collection area before integrating any
+ * signal.
  */
 export function calculateSensorSpectralQuadrature(input) {
+    requireInputKeys(input, "calculateSensorSpectralQuadrature", ["colorSamplingProfile", "spectralResponseProfile", "channelId", "wavelengthBasis", "wavelengthRangeNanometers", "maximumSubintervalWidthNanometers", "additionalBreakpointsNanometers"]);
     const maximumSubintervalWidthNanometers = requirePositiveFinite(input.maximumSubintervalWidthNanometers, "maximumSubintervalWidthNanometers");
     if (input.wavelengthBasis !== "air" &&
         input.wavelengthBasis !== "vacuum" &&
         input.wavelengthBasis !== "unspecified") {
-        throw new InvalidScientificInputError("wavelengthBasis is invalid.");
+        throw new InvalidConfigurationError("wavelengthBasis is invalid.");
     }
     const colorProfile = parseSensorColorSamplingProfile(input.colorSamplingProfile);
     const responseProfile = parseSensorSpectralResponseProfile(input.spectralResponseProfile);