@photivra/engine 2.17.0 → 2.19.0

package/dist/sensor/raw-readout.js.map

@@ -1 +1 @@
-{"version":3,"file":"raw-readout.js","sourceRoot":"","sources":["../../src/sensor/raw-readout.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * RAW readout: turns the expected charge in a sensor site into a RAW code, with shot noise, read\n * noise and the ADC (analogue-to-digital converter).\n *\n * The steps, in order:\n * 1. expected charge;\n * 2. separately seeded random photo and dark draws (Poisson shot noise);\n * 3. signed electronic read noise;\n * 4. the upper pre-ADC clipping threshold;\n * 5. the black pedestal (offset);\n * 6. ADC quantization, rounding to nearest with ties up;\n * 7. limits on the unsigned code.\n *\n * Values below black stay signed until the final code clamp. Physical storage saturation, pre-ADC\n * clipping and digital clipping are reported separately. The ISO setting never invents a conversion\n * regime; regimes are declared.\n * @see docs/SENSOR_RAW_PRODUCER.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 { InvalidConfigurationError } from \"../core/configuration-error.js\";\nimport {\n  parseEvidenceList,\n  type EvidenceBackedFact,\n  type EvidenceProvenance\n} from \"../core/evidence-provenance.js\";\nimport { InvalidScientificInputError } from \"../core/validation.js\";\nimport {\n  createDeterministicUniformStream,\n  sampleDeterministicStandardNormal,\n  samplePortableStandardNormal,\n  type DeterministicUniformStream\n} from \"./stochastic-seed.js\";\nimport { portableExp, portableLog } from \"../core/portable-math.js\";\nimport type {\n  SensorPhotoAccumulatedChargeComposition as SensorAccumulatedChargeComposition\n} from \"./accumulated-charge.js\";\nimport type {\n  SensorPhysicalChargeCapacityAssessment\n} from \"./physical-charge-capacity.js\";\nimport type {\n  SensorSpectralResponseScientificStatus\n} from \"./spectral-response.js\";\nimport { requireInputKeys, rejectUnknownFields } from \"../core/record-validation.js\";\nimport {\n  evaluateParsedFixedPatternSite,\n  parseSensorFixedPatternNoiseProfile,\n  type SensorFixedPatternNoiseProfile,\n  type SensorFixedPatternSiteValues\n} from \"./fixed-pattern-noise.js\";\n\ntype UnknownRecord = Record<string, unknown>;\n\nexport const SENSOR_CHARGE_SAMPLING_PROFILE_SCHEMA_VERSION =\n  \"0.1.0\" as const;\nexport const SENSOR_READOUT_CONVERSION_PROFILE_SCHEMA_VERSION =\n  \"0.1.0\" as const;\n\nexport type SensorAdditionalChargeSamplingModel =\n  | \"poisson\"\n  | \"deterministic-expected-electron-equivalent\";\n\nexport interface SensorAdditionalChargeSamplingPolicy {\n  componentId: string;\n  model:\n    SensorAdditionalChargeSamplingModel;\n}\n\nexport interface SensorChargeSamplingProfile {\n  schemaVersion:\n    typeof SENSOR_CHARGE_SAMPLING_PROFILE_SCHEMA_VERSION;\n  profileId: string;\n  completenessProfileId: string;\n  scientificStatus: \"approximation\";\n  photoShotNoiseModel: \"poisson\";\n  darkShotNoiseModel: \"poisson\";\n  additionalComponentPolicies:\n    readonly SensorAdditionalChargeSamplingPolicy[];\n  evidence:\n    readonly EvidenceProvenance[];\n  limitations: readonly string[];\n}\n\nexport interface SimulateSensorChargeRealizationInput {\n  accumulatedCharge:\n    SensorAccumulatedChargeComposition;\n  samplingProfile:\n    SensorChargeSamplingProfile;\n  seedUint32: number;\n  /**\n   * Optional fixed-pattern noise for this sensor. PRNU (photo-response non-uniformity) scales the\n   * photo Poisson mean; DSNU (dark-signal non-uniformity) and hot pixels scale the dark Poisson mean.\n   * If omitted, the result is exactly the uniform population model.\n   */\n  fixedPatternNoise?:\n    SensorFixedPatternNoiseProfile;\n}\n\nexport interface SensorChargeRealization {\n  samplingProfileId: string;\n  completenessProfileId: string;\n  colorSamplingProfileId: string;\n  channelId: string;\n  site: {\n    x: number;\n    y: number;\n  };\n  bindingId: string;\n  seedUint32: number;\n  photoExpectedElectronCount: number;\n  photoRealizedElectronCount: number;\n  darkExpectedElectronCount: number;\n  darkRealizedElectronCount: number;\n  /** Fixed-pattern profile applied to this realization, or null for the uniform population model. */\n  fixedPatternNoiseProfileId:\n    string | null;\n  /** PRNU gain applied to the photo expectation (exactly 1 without a fixed pattern). */\n  photoResponseGainFactor: number;\n  /** DSNU/hot-pixel factor applied to the dark expectation (exactly 1 without a fixed pattern). */\n  darkCurrentFactor: number;\n  hotPixel: boolean;\n  /** Poisson means actually sampled: expectation × the site's fixed-pattern factor. */\n  photoSampledMeanElectronCount: number;\n  darkSampledMeanElectronCount: number;\n  additionalComponents:\n    readonly {\n      componentId: string;\n      expectedElectronCount: number;\n      realizedElectronEquivalentCount:\n        number;\n      model:\n        SensorAdditionalChargeSamplingModel;\n    }[];\n  totalExpectedStoredElectronCount:\n    number;\n  totalRealizedStoredElectronEquivalentCount:\n    number;\n  photoShotNoiseApplied: true;\n  darkShotNoiseApplied: true;\n  electronicReadNoiseApplied: false;\n  physicalSaturationApplied: false;\n  bloomingModeled: false;\n  conversionGainApplied: false;\n  adcQuantizationApplied: false;\n  rawCodeValueProduced: false;\n  stochasticModel:\n    \"independent-poisson-photo-dark-explicit-additional-policy\";\n  deterministicSeededRealization:\n    true;\n}\n\n/**\n * Optional ADC integral non-linearity (INL): an offset in code units (LSB, least significant bit),\n * piecewise linear in the ideal continuous ADC input code, added before quantization. The points must\n * start at code 0 and end at the ADC maximum code. If omitted, the ADC is ideal and uniform.\n */\nexport interface SensorAdcIntegralNonLinearity {\n  kind: \"piecewise-linear-code-offset\";\n  knots: readonly { code: number; offsetCodes: number }[];\n  evidence: readonly EvidenceProvenance[];\n}\n\n/**\n * Optional record of how one regime's ISO gain was derived (the exposure index of CIPA DC-004,\n * relative to the base exposure index). The readout equations still use\n * systemConversionGainElectronsPerCode (analog, before the ADC) and adc.digitalGain (after the ADC).\n * This record must agree with them and never replaces them.\n */\nexport interface SensorReadoutExposureIndexGain {\n  exposureIndex: number;\n  baseExposureIndex: number;\n  /** Analog (pre-ADC) gain relative to the base-exposure-index regime. */\n  analogGain: number;\n  /** Post-ADC digital gain; equals adc.digitalGain (1 when omitted). */\n  digitalGain: number;\n  conversionGainMode:\n    | \"single-conversion-gain\"\n    | \"low-conversion-gain\"\n    | \"high-conversion-gain\";\n  evidence: readonly EvidenceProvenance[];\n}\n\nexport interface SensorElectronicReadNoiseComponent {\n  componentId: string;\n  rmsElectrons:\n    EvidenceBackedFact<number>;\n  evidence:\n    readonly EvidenceProvenance[];\n}\n\n/**\n * One explicitly selected electronic conversion regime. It has a sourced number of\n * electrons per code, an upper pre-ADC threshold in electron equivalents, separate\n * read-noise components (RMS electrons) and an unsigned ADC coding policy. The black\n * pedestal and digital saturation are in code units. The regime does not guess its\n * hardware mechanism, is not chosen from ISO automatically, and does not replace\n * physical storage capacity.\n */\nexport interface SensorReadoutConversionRegime {\n  regimeId: string;\n  scientificStatus:\n    SensorSpectralResponseScientificStatus;\n  systemConversionGainElectronsPerCode:\n    EvidenceBackedFact<number>;\n  preAdcSaturationElectronEquivalent:\n    EvidenceBackedFact<number>;\n  readNoiseComponents:\n    readonly SensorElectronicReadNoiseComponent[];\n  adc: {\n    bitDepth: number;\n    blackLevelCode: number;\n    digitalSaturationCode: number;\n    transfer:\n      \"uniform-round-half-up\";\n    /**\n     * Optional post-ADC digital gain (>= 1) applied about the black level:\n     * code = roundHalfUp((adcCode - black) * digitalGain + black). Omission means 1.\n     */\n    digitalGain?: number;\n    integralNonLinearity?:\n      SensorAdcIntegralNonLinearity;\n  };\n  exposureIndexGain?:\n    SensorReadoutExposureIndexGain;\n  evidence:\n    readonly EvidenceProvenance[];\n  limitations: readonly string[];\n}\n\nexport interface SensorReadoutConversionProfile {\n  schemaVersion:\n    typeof SENSOR_READOUT_CONVERSION_PROFILE_SCHEMA_VERSION;\n  profileId: string;\n  colorSamplingProfileId: string;\n  channelId: string;\n  regimes:\n    readonly SensorReadoutConversionRegime[];\n  regimeSelectionOwnedBy:\n    \"explicit-upstream-camera-state-not-inferred-from-iso\";\n  evidence:\n    readonly EvidenceProvenance[];\n}\n\nexport interface ResolveSensorReadoutRegimeInput {\n  profile:\n    SensorReadoutConversionProfile;\n  regimeId: string;\n}\n\nexport interface ResolvedSensorReadoutRegime {\n  profileId: string;\n  colorSamplingProfileId: string;\n  channelId: string;\n  regime:\n    SensorReadoutConversionRegime;\n  regimeSelectionOwnedBy:\n    \"explicit-upstream-camera-state-not-inferred-from-iso\";\n  adcMaximumCode: number;\n  combinedReadNoiseRmsElectrons:\n    number;\n}\n\nexport interface CalculateExpectedSensorReadoutInput {\n  accumulatedCharge:\n    SensorAccumulatedChargeComposition;\n  physicalCapacityAssessment:\n    SensorPhysicalChargeCapacityAssessment;\n  readoutProfile:\n    SensorReadoutConversionProfile;\n  regimeId: string;\n}\n\nexport interface SensorExpectedReadoutSignal {\n  readoutProfileId: string;\n  regimeId: string;\n  completenessProfileId: string;\n  capacityProfileId: string;\n  colorSamplingProfileId: string;\n  channelId: string;\n  site: {\n    x: number;\n    y: number;\n  };\n  bindingId: string;\n  expectedStoredElectronCount:\n    number;\n  expectedStoredChargeBelowOrAtPhysicalCapacity:\n    true;\n  expectedElectronEquivalentAfterPreAdcSaturation:\n    number;\n  preAdcSaturationAppliedToExpectation:\n    boolean;\n  systemConversionGainElectronsPerCode:\n    number;\n  expectedCodeBeforeBlackOffset:\n    number;\n  blackLevelCode: number;\n  /** Continuous ADC input code including any declared INL offset. */\n  expectedCodeBeforeQuantization:\n    number;\n  adcIntegralNonLinearityOffsetCodes:\n    number;\n  digitalGain: number;\n  /** Continuous code after post-ADC digital gain about black (equals the ADC input without one). */\n  expectedCodeAfterDigitalGain:\n    number;\n  adcBitDepth: number;\n  adcMaximumCode: number;\n  digitalSaturationCode: number;\n  expectedDigitalSaturation:\n    boolean;\n  electronicReadNoiseMeanElectrons:\n    0;\n  electronicReadNoiseRmsElectrons:\n    number;\n  electronicReadNoiseSampled: false;\n  adcQuantizationApplied: false;\n  rawCodeValueProduced: false;\n  isoUsedToInferRegime: false;\n}\n\nexport interface SimulateSensorRawCodeInput {\n  chargeRealization:\n    SensorChargeRealization;\n  physicalCapacityAssessment:\n    SensorPhysicalChargeCapacityAssessment;\n  readoutProfile:\n    SensorReadoutConversionProfile;\n  regimeId: string;\n  readNoiseSeedUint32: number;\n  /**\n   * Optional fixed pattern; must be the same profile used for the charge realization. Its static\n   * row/column offsets are added with read noise before the pre-ADC threshold.\n   */\n  fixedPatternNoise?:\n    SensorFixedPatternNoiseProfile;\n}\n\nexport interface SensorRawCodeSample {\n  readoutProfileId: string;\n  regimeId: string;\n  samplingProfileId: string;\n  completenessProfileId: string;\n  capacityProfileId: string;\n  colorSamplingProfileId: string;\n  channelId: string;\n  site: {\n    x: number;\n    y: number;\n  };\n  bindingId: string;\n  chargeSeedUint32: number;\n  readNoiseSeedUint32: number;\n  realizedStoredElectronEquivalentCountBeforePhysicalCapacity:\n    number;\n  physicalChargeCapacityElectrons:\n    number;\n  electronEquivalentAfterPhysicalScalarSaturation:\n    number;\n  physicalScalarSaturationApplied:\n    boolean;\n  overflowElectronEquivalentDiagnostic:\n    number;\n  bloomingModeled: false;\n  electronicReadNoiseComponents:\n    readonly {\n      componentId: string;\n      rmsElectrons: number;\n      sampledElectrons: number;\n    }[];\n  totalElectronicReadNoiseElectrons:\n    number;\n  /** Fixed-pattern profile applied at readout, or null. */\n  fixedPatternNoiseProfileId:\n    string | null;\n  /** Static fixed-pattern row + column offset in input-referred electrons (0 without a pattern). */\n  fixedPatternReadoutOffsetElectrons:\n    number;\n  electronEquivalentAfterReadNoise:\n    number;\n  preAdcSaturationElectronEquivalent:\n    number;\n  /** Signed electronic signal after the upper (pre-ADC) clip, before conversion and the black pedestal. */\n  electronEquivalentAfterPreAdcSaturation:\n    number;\n  preAdcSaturationApplied:\n    boolean;\n  systemConversionGainElectronsPerCode:\n    number;\n  blackLevelCode: number;\n  /** Continuous ADC input code including any declared integral non-linearity offset. */\n  codeBeforeQuantization:\n    number;\n  /** INL offset added before quantization (0 for an ideal ADC). */\n  adcIntegralNonLinearityOffsetCodes:\n    number;\n  /** ADC output after quantization and the ADC code-range limit, before digital gain. */\n  adcCodeBeforeDigitalGain:\n    number;\n  /** Post-ADC digital gain (1 when the regime declares none). */\n  digitalGain: number;\n  quantizedCodeBeforeDigitalClamp:\n    number;\n  adcBitDepth: number;\n  adcMaximumCode: number;\n  digitalSaturationCode: number;\n  rawCode: number;\n  digitalSaturationApplied:\n    boolean;\n  lowerCodeClampApplied:\n    boolean;\n  adcTransfer:\n    \"uniform-round-half-up\";\n  physicalSaturationApplied: boolean;\n  electronicReadNoiseApplied:\n    boolean;\n  conversionGainApplied: true;\n  adcQuantizationApplied: true;\n  rawCodeValueProduced: true;\n  isoUsedToInferRegime: false;\n  deterministicSeededRealization:\n    true;\n}\n\nfunction requireRecord(\n  value: unknown,\n  path: string,\n  allowedKeys: readonly string[] | null\n): UnknownRecord {\n  if (\n    typeof value !== \"object\" ||\n    value === null ||\n    Array.isArray(value)\n  ) {\n    throw new InvalidConfigurationError(\n      path + \" must be an object.\"\n    );\n  }\n  if (allowedKeys !== null) rejectUnknownFields(value, allowedKeys, path);\n  return value as UnknownRecord;\n}\n\nfunction requireNonEmptyString(\n  value: unknown,\n  path: string\n): string {\n  if (\n    typeof value !== \"string\" ||\n    value.trim().length === 0\n  ) {\n    throw new InvalidConfigurationError(\n      path + \" must be a non-empty string.\"\n    );\n  }\n  return value.trim();\n}\n\nfunction requireFinite(\n  value: unknown,\n  path: string\n): number {\n  if (\n    typeof value !== \"number\" ||\n    !Number.isFinite(value)\n  ) {\n    throw new InvalidConfigurationError(\n      path + \" must be finite.\"\n    );\n  }\n  return value;\n}\n\nfunction requireNonNegativeFinite(\n  value: unknown,\n  path: string\n): number {\n  const parsed =\n    requireFinite(value, path);\n  if (parsed < 0) {\n    throw new InvalidConfigurationError(\n      path +\n        \" must be greater than or equal to zero.\"\n    );\n  }\n  return parsed;\n}\n\nfunction requirePositiveFinite(\n  value: unknown,\n  path: string\n): number {\n  const parsed =\n    requireFinite(value, path);\n  if (parsed <= 0) {\n    throw new InvalidConfigurationError(\n      path +\n        \" must be greater than zero.\"\n    );\n  }\n  return parsed;\n}\n\nfunction requireUint32(\n  value: unknown,\n  path: string\n): number {\n  if (\n    typeof value !== \"number\" ||\n    !Number.isSafeInteger(value) ||\n    value < 0 ||\n    value > 0xffff_ffff\n  ) {\n    throw new InvalidScientificInputError(\n      path +\n        \" must be an unsigned 32-bit integer.\"\n    );\n  }\n  return value;\n}\n\nfunction requireSafeInteger(\n  value: unknown,\n  path: string\n): number {\n  if (\n    typeof value !== \"number\" ||\n    !Number.isSafeInteger(value)\n  ) {\n    throw new InvalidConfigurationError(\n      path + \" must be a safe integer.\"\n    );\n  }\n  return value;\n}\n\nfunction parseLimitations(\n  value: unknown,\n  path: string\n): readonly string[] {\n  if (!Array.isArray(value)) {\n    throw new InvalidConfigurationError(\n      path + \" must be an array.\"\n    );\n  }\n  const parsed =\n    value.map((entry, index) =>\n      requireNonEmptyString(\n        entry,\n        path +\n          \"[\" +\n          index +\n          \"]\"\n      )\n    );\n  if (\n    new Set(parsed).size !==\n    parsed.length\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \" must not contain duplicates.\"\n    );\n  }\n  return parsed;\n}\n\nfunction parsePositiveFact(\n  value: unknown,\n  path: string\n): EvidenceBackedFact<number> {\n  const record =\n    requireRecord(value, path, [\"value\", \"evidence\"]);\n  return {\n    value:\n      requirePositiveFinite(\n        record.value,\n        path + \".value\"\n      ),\n    evidence:\n      parseEvidenceList(\n        record.evidence,\n        path + \".evidence\"\n      )\n  };\n}\n\nfunction parseNonNegativeFact(\n  value: unknown,\n  path: string\n): EvidenceBackedFact<number> {\n  const record =\n    requireRecord(value, path, [\"value\", \"evidence\"]);\n  return {\n    value:\n      requireNonNegativeFinite(\n        record.value,\n        path + \".value\"\n      ),\n    evidence:\n      parseEvidenceList(\n        record.evidence,\n        path + \".evidence\"\n      )\n  };\n}\n\n/**\n * Validates untrusted input and returns it as a normalized, typed value. Unknown enum values,\n * missing required fields and inconsistent scientific data are rejected.\n *\n * The profile sets how expected charge is sampled into random photo and dark counts.\n * @param value - Untrusted data. TypeScript types alone are not validation.\n * @returns The result. Success does not imply calibration.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function parseSensorChargeSamplingProfile(\n  value: unknown\n): SensorChargeSamplingProfile {\n  const record =\n    requireRecord(\n      value,\n      \"sensorChargeSamplingProfile\", [\"schemaVersion\", \"scientificStatus\", \"photoShotNoiseModel\", \"darkShotNoiseModel\", \"additionalComponentPolicies\", \"profileId\", \"completenessProfileId\", \"evidence\", \"limitations\"]\n    );\n\n  if (\n    record.schemaVersion !==\n    SENSOR_CHARGE_SAMPLING_PROFILE_SCHEMA_VERSION\n  ) {\n    throw new InvalidConfigurationError(\n      'sensorChargeSamplingProfile.schemaVersion must be \"' +\n        SENSOR_CHARGE_SAMPLING_PROFILE_SCHEMA_VERSION +\n        '\".'\n    );\n  }\n  if (\n    record.scientificStatus !==\n    \"approximation\"\n  ) {\n    throw new InvalidConfigurationError(\n      'sensorChargeSamplingProfile.scientificStatus must be \"approximation\".'\n    );\n  }\n  if (\n    record.photoShotNoiseModel !==\n      \"poisson\" ||\n    record.darkShotNoiseModel !==\n      \"poisson\"\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorChargeSamplingProfile photo/dark shot-noise models must be Poisson.\"\n    );\n  }\n  if (\n    !Array.isArray(\n      record.additionalComponentPolicies\n    )\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorChargeSamplingProfile.additionalComponentPolicies must be an array.\"\n    );\n  }\n\n  const additionalComponentPolicies =\n    record.additionalComponentPolicies.map(\n      (entry, index) => {\n        const path =\n          \"sensorChargeSamplingProfile.additionalComponentPolicies[\" +\n          index +\n          \"]\";\n        const policy =\n          requireRecord(\n            entry,\n            path, [\"model\", \"componentId\"]\n          );\n        if (\n          policy.model !==\n            \"poisson\" &&\n          policy.model !==\n            \"deterministic-expected-electron-equivalent\"\n        ) {\n          throw new InvalidConfigurationError(\n            path +\n              \".model is invalid.\"\n          );\n        }\n        return {\n          componentId:\n            requireNonEmptyString(\n              policy.componentId,\n              path +\n                \".componentId\"\n            ),\n          model:\n            policy.model\n        } as SensorAdditionalChargeSamplingPolicy;\n      }\n    );\n\n  const ids =\n    additionalComponentPolicies.map(\n      (policy) =>\n        policy.componentId\n    );\n  if (\n    new Set(ids).size !==\n    ids.length\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorChargeSamplingProfile.additionalComponentPolicies must not contain duplicate componentId values.\"\n    );\n  }\n\n  return {\n    schemaVersion:\n      SENSOR_CHARGE_SAMPLING_PROFILE_SCHEMA_VERSION,\n    profileId:\n      requireNonEmptyString(\n        record.profileId,\n        \"sensorChargeSamplingProfile.profileId\"\n      ),\n    completenessProfileId:\n      requireNonEmptyString(\n        record.completenessProfileId,\n        \"sensorChargeSamplingProfile.completenessProfileId\"\n      ),\n    scientificStatus:\n      \"approximation\",\n    photoShotNoiseModel:\n      \"poisson\",\n    darkShotNoiseModel:\n      \"poisson\",\n    additionalComponentPolicies,\n    evidence:\n      parseEvidenceList(\n        record.evidence,\n        \"sensorChargeSamplingProfile.evidence\"\n      ),\n    limitations:\n      parseLimitations(\n        record.limitations,\n        \"sensorChargeSamplingProfile.limitations\"\n      )\n  };\n}\n\nfunction parseStatus(\n  value: unknown,\n  path: string\n): SensorSpectralResponseScientificStatus {\n  if (\n    value !== \"calibrated\" &&\n    value !== \"approximation\"\n  ) {\n    throw new InvalidConfigurationError(\n      path + \" is invalid.\"\n    );\n  }\n  return value;\n}\n\nfunction parseReadNoiseComponent(\n  value: unknown,\n  path: string\n): SensorElectronicReadNoiseComponent {\n  const record =\n    requireRecord(value, path, [\"componentId\", \"rmsElectrons\", \"evidence\"]);\n  return {\n    componentId:\n      requireNonEmptyString(\n        record.componentId,\n        path + \".componentId\"\n      ),\n    rmsElectrons:\n      parseNonNegativeFact(\n        record.rmsElectrons,\n        path + \".rmsElectrons\"\n      ),\n    evidence:\n      parseEvidenceList(\n        record.evidence,\n        path + \".evidence\"\n      )\n  };\n}\n\nfunction parseIntegralNonLinearity(\n  value: unknown,\n  path: string,\n  adcMaximumCode: number\n): SensorAdcIntegralNonLinearity {\n  const record =\n    requireRecord(value, path, [\"kind\", \"knots\", \"evidence\"]);\n  if (\n    record.kind !==\n    \"piecewise-linear-code-offset\"\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        '.kind must be \"piecewise-linear-code-offset\".'\n    );\n  }\n  if (\n    !Array.isArray(record.knots) ||\n    record.knots.length < 2 ||\n    record.knots.length > 4096\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \".knots must contain 2 through 4096 knots.\"\n    );\n  }\n  const knots =\n    record.knots.map(\n      (entry: unknown, index: number) => {\n        const knot =\n          requireRecord(\n            entry,\n            path + \".knots[\" + index + \"]\", [\"code\", \"offsetCodes\"]\n          );\n        return {\n          code: requireFinite(\n            knot.code,\n            path + \".knots[\" + index + \"].code\"\n          ),\n          offsetCodes: requireFinite(\n            knot.offsetCodes,\n            path + \".knots[\" + index + \"].offsetCodes\"\n          )\n        };\n      }\n    );\n  if (\n    knots[0]!.code !== 0 ||\n    knots[knots.length - 1]!.code !==\n      adcMaximumCode ||\n    knots.some(\n      (knot, index) =>\n        index > 0 &&\n        knot.code <=\n          knots[index - 1]!.code\n    ) ||\n    knots.some(\n      (knot) =>\n        Math.abs(knot.offsetCodes) >\n        adcMaximumCode\n    )\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \".knots must strictly increase from code 0 to the ADC maximum code with bounded offsets.\"\n    );\n  }\n  return {\n    kind:\n      \"piecewise-linear-code-offset\",\n    knots,\n    evidence:\n      parseEvidenceList(\n        record.evidence,\n        path + \".evidence\"\n      )\n  };\n}\n\nfunction parseExposureIndexGain(\n  value: unknown,\n  path: string,\n  adcDigitalGain: number\n): SensorReadoutExposureIndexGain {\n  const record =\n    requireRecord(value, path, [\"exposureIndex\", \"baseExposureIndex\", \"analogGain\", \"digitalGain\", \"conversionGainMode\", \"evidence\"]);\n  const exposureIndex =\n    requirePositiveFinite(\n      record.exposureIndex,\n      path + \".exposureIndex\"\n    );\n  const baseExposureIndex =\n    requirePositiveFinite(\n      record.baseExposureIndex,\n      path + \".baseExposureIndex\"\n    );\n  const analogGain =\n    requirePositiveFinite(\n      record.analogGain,\n      path + \".analogGain\"\n    );\n  const digitalGain =\n    requirePositiveFinite(\n      record.digitalGain,\n      path + \".digitalGain\"\n    );\n  const mode =\n    record.conversionGainMode;\n  if (\n    mode !== \"single-conversion-gain\" &&\n    mode !== \"low-conversion-gain\" &&\n    mode !== \"high-conversion-gain\"\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \".conversionGainMode is invalid.\"\n    );\n  }\n  const ratio =\n    exposureIndex /\n    baseExposureIndex;\n  if (\n    digitalGain !==\n      adcDigitalGain ||\n    Math.abs(\n      analogGain * digitalGain -\n        ratio\n    ) >\n      1e-12 * ratio\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \" must satisfy analogGain x digitalGain = exposureIndex / baseExposureIndex and digitalGain = adc.digitalGain.\"\n    );\n  }\n  return {\n    exposureIndex,\n    baseExposureIndex,\n    analogGain,\n    digitalGain,\n    conversionGainMode: mode,\n    evidence:\n      parseEvidenceList(\n        record.evidence,\n        path + \".evidence\"\n      )\n  };\n}\n\nfunction parseRegime(\n  value: unknown,\n  path: string\n): SensorReadoutConversionRegime {\n  const record =\n    requireRecord(value, path, [\"adc\", \"readNoiseComponents\", \"systemConversionGainElectronsPerCode\", \"exposureIndexGain\", \"regimeId\", \"scientificStatus\", \"preAdcSaturationElectronEquivalent\", \"evidence\", \"limitations\"]);\n  const adc =\n    requireRecord(\n      record.adc,\n      path + \".adc\", [\"bitDepth\", \"blackLevelCode\", \"digitalSaturationCode\", \"transfer\", \"digitalGain\", \"integralNonLinearity\"]\n    );\n  const bitDepth =\n    requireSafeInteger(\n      adc.bitDepth,\n      path + \".adc.bitDepth\"\n    );\n  if (\n    bitDepth < 1 ||\n    bitDepth > 30\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \".adc.bitDepth must be from 1 through 30.\"\n    );\n  }\n  const adcMaximumCode =\n    2 ** bitDepth - 1;\n  const blackLevelCode =\n    requireSafeInteger(\n      adc.blackLevelCode,\n      path + \".adc.blackLevelCode\"\n    );\n  const digitalSaturationCode =\n    requireSafeInteger(\n      adc.digitalSaturationCode,\n      path +\n        \".adc.digitalSaturationCode\"\n    );\n\n  if (\n    blackLevelCode < 0 ||\n    blackLevelCode >\n      adcMaximumCode\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \".adc.blackLevelCode must lie inside the unsigned ADC code range.\"\n    );\n  }\n  if (\n    digitalSaturationCode <=\n      blackLevelCode ||\n    digitalSaturationCode >\n      adcMaximumCode\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \".adc.digitalSaturationCode must be greater than blackLevelCode and at most the ADC maximum code.\"\n    );\n  }\n  if (\n    adc.transfer !==\n    \"uniform-round-half-up\"\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        '.adc.transfer must be \"uniform-round-half-up\".'\n    );\n  }\n  if (\n    !Array.isArray(\n      record.readNoiseComponents\n    )\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \".readNoiseComponents must be an array.\"\n    );\n  }\n  const readNoiseComponents =\n    record.readNoiseComponents.map(\n      (entry, index) =>\n        parseReadNoiseComponent(\n          entry,\n          path +\n            \".readNoiseComponents[\" +\n            index +\n            \"]\"\n        )\n    );\n  const componentIds =\n    readNoiseComponents.map(\n      (entry) =>\n        entry.componentId\n    );\n  if (\n    new Set(componentIds).size !==\n    componentIds.length\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \".readNoiseComponents must not contain duplicate componentId values.\"\n    );\n  }\n\n  const digitalGain =\n    adc.digitalGain === undefined\n      ? undefined\n      : requireFinite(\n          adc.digitalGain,\n          path + \".adc.digitalGain\"\n        );\n  if (\n    digitalGain !== undefined &&\n    (digitalGain < 1 ||\n      digitalGain > 65536)\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \".adc.digitalGain must be from 1 through 65536.\"\n    );\n  }\n  const integralNonLinearity =\n    adc.integralNonLinearity === undefined\n      ? undefined\n      : parseIntegralNonLinearity(\n          adc.integralNonLinearity,\n          path + \".adc.integralNonLinearity\",\n          adcMaximumCode\n        );\n  const systemConversionGainElectronsPerCode =\n    parsePositiveFact(\n      record\n        .systemConversionGainElectronsPerCode,\n      path +\n        \".systemConversionGainElectronsPerCode\"\n    );\n  const exposureIndexGain =\n    record.exposureIndexGain === undefined\n      ? undefined\n      : parseExposureIndexGain(\n          record.exposureIndexGain,\n          path + \".exposureIndexGain\",\n          digitalGain ?? 1\n        );\n\n  return {\n    regimeId:\n      requireNonEmptyString(\n        record.regimeId,\n        path + \".regimeId\"\n      ),\n    scientificStatus:\n      parseStatus(\n        record.scientificStatus,\n        path +\n          \".scientificStatus\"\n      ),\n    systemConversionGainElectronsPerCode,\n    preAdcSaturationElectronEquivalent:\n      parsePositiveFact(\n        record\n          .preAdcSaturationElectronEquivalent,\n        path +\n          \".preAdcSaturationElectronEquivalent\"\n      ),\n    readNoiseComponents,\n    adc: {\n      bitDepth,\n      blackLevelCode,\n      digitalSaturationCode,\n      transfer:\n        \"uniform-round-half-up\",\n      ...(digitalGain === undefined\n        ? {}\n        : { digitalGain }),\n      ...(integralNonLinearity === undefined\n        ? {}\n        : { integralNonLinearity })\n    },\n    ...(exposureIndexGain === undefined\n      ? {}\n      : { exposureIndexGain }),\n    evidence:\n      parseEvidenceList(\n        record.evidence,\n        path + \".evidence\"\n      ),\n    limitations:\n      parseLimitations(\n        record.limitations,\n        path + \".limitations\"\n      )\n  };\n}\n\n/**\n * Validates untrusted input and returns it as a normalized, typed value. Unknown enum values,\n * missing required fields and inconsistent scientific data are rejected.\n *\n * The profile lists the declared conversion regimes. ISO never invents a regime.\n * @param value - Untrusted data. TypeScript types alone are not validation.\n * @returns The result. Success does not imply calibration.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function parseSensorReadoutConversionProfile(\n  value: unknown\n): SensorReadoutConversionProfile {\n  const record =\n    requireRecord(\n      value,\n      \"sensorReadoutConversionProfile\", [\"schemaVersion\", \"regimeSelectionOwnedBy\", \"regimes\", \"profileId\", \"colorSamplingProfileId\", \"channelId\", \"evidence\"]\n    );\n  if (\n    record.schemaVersion !==\n    SENSOR_READOUT_CONVERSION_PROFILE_SCHEMA_VERSION\n  ) {\n    throw new InvalidConfigurationError(\n      'sensorReadoutConversionProfile.schemaVersion must be \"' +\n        SENSOR_READOUT_CONVERSION_PROFILE_SCHEMA_VERSION +\n        '\".'\n    );\n  }\n  if (\n    record.regimeSelectionOwnedBy !==\n    \"explicit-upstream-camera-state-not-inferred-from-iso\"\n  ) {\n    throw new InvalidConfigurationError(\n      'sensorReadoutConversionProfile.regimeSelectionOwnedBy must be \"explicit-upstream-camera-state-not-inferred-from-iso\".'\n    );\n  }\n  if (\n    !Array.isArray(\n      record.regimes\n    ) ||\n    record.regimes.length === 0\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorReadoutConversionProfile.regimes must be a non-empty array.\"\n    );\n  }\n  const regimes =\n    record.regimes.map(\n      (entry, index) =>\n        parseRegime(\n          entry,\n          \"sensorReadoutConversionProfile.regimes[\" +\n            index +\n            \"]\"\n        )\n    );\n  const ids =\n    regimes.map(\n      (regime) =>\n        regime.regimeId\n    );\n  if (\n    new Set(ids).size !==\n    ids.length\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorReadoutConversionProfile.regimes must not contain duplicate regimeId values.\"\n    );\n  }\n\n  return {\n    schemaVersion:\n      SENSOR_READOUT_CONVERSION_PROFILE_SCHEMA_VERSION,\n    profileId:\n      requireNonEmptyString(\n        record.profileId,\n        \"sensorReadoutConversionProfile.profileId\"\n      ),\n    colorSamplingProfileId:\n      requireNonEmptyString(\n        record.colorSamplingProfileId,\n        \"sensorReadoutConversionProfile.colorSamplingProfileId\"\n      ),\n    channelId:\n      requireNonEmptyString(\n        record.channelId,\n        \"sensorReadoutConversionProfile.channelId\"\n      ),\n    regimes,\n    regimeSelectionOwnedBy:\n      \"explicit-upstream-camera-state-not-inferred-from-iso\",\n    evidence:\n      parseEvidenceList(\n        record.evidence,\n        \"sensorReadoutConversionProfile.evidence\"\n      )\n  };\n}\n\n/**\n * Selects a declared readout regime and checks it against the exact channel and profile identity.\n * The regime is never inferred from ISO.\n * @param input - The input; see `ResolveSensorReadoutRegimeInput` for its fields, units and coordinates.\n * @returns The result. Success does not imply calibration.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function resolveSensorReadoutRegime(\n  input:\n    ResolveSensorReadoutRegimeInput\n): ResolvedSensorReadoutRegime {\n  requireInputKeys(input, \"resolveSensorReadoutRegime\", [\"profile\", \"regimeId\"]);\n  const profile =\n    parseSensorReadoutConversionProfile(\n      input.profile\n    );\n  if (\n    typeof input.regimeId !==\n      \"string\" ||\n    input.regimeId.trim().length ===\n      0\n  ) {\n    throw new InvalidConfigurationError(\n      \"regimeId must be a non-empty string.\"\n    );\n  }\n  const regimeId =\n    input.regimeId.trim();\n  const regime =\n    profile.regimes.find(\n      (entry) =>\n        entry.regimeId === regimeId\n    );\n  if (regime === undefined) {\n    throw new InvalidScientificInputError(\n      \"regimeId is not declared by the sensor readout conversion profile.\"\n    );\n  }\n  const combinedReadNoiseRmsElectrons =\n    Math.sqrt(\n      regime.readNoiseComponents.reduce(\n        (sum, component) =>\n          sum +\n          component\n            .rmsElectrons.value *\n            component\n              .rmsElectrons.value,\n        0\n      )\n    );\n\n  return {\n    profileId:\n      profile.profileId,\n    colorSamplingProfileId:\n      profile.colorSamplingProfileId,\n    channelId:\n      profile.channelId,\n    regime,\n    regimeSelectionOwnedBy:\n      profile\n        .regimeSelectionOwnedBy,\n    adcMaximumCode:\n      2 **\n        regime.adc.bitDepth -\n      1,\n    combinedReadNoiseRmsElectrons\n  };\n}\n\nfunction validateChargeIdentity(\n  charge:\n    SensorAccumulatedChargeComposition,\n  capacity:\n    SensorPhysicalChargeCapacityAssessment,\n  readout:\n    ResolvedSensorReadoutRegime\n): true {\n  if (\n    charge.completenessProfileId !==\n      capacity\n        .completenessProfileId ||\n    charge.colorSamplingProfileId !==\n      capacity\n        .colorSamplingProfileId ||\n    charge.channelId !==\n      capacity.channelId ||\n    charge.site.x !==\n      capacity.site.x ||\n    charge.site.y !==\n      capacity.site.y ||\n    charge.bindingId !==\n      capacity.bindingId\n  ) {\n    throw new InvalidScientificInputError(\n      \"Physical capacity assessment identity must match the accumulated charge.\"\n    );\n  }\n  // The assessment copies the complete expected stored-electron total exactly from the charge it\n  // assessed. So the match must be exact: an assessment made for any other charge is out of date.\n  if (\n    charge\n      .totalExpectedStoredElectronCount !==\n    capacity\n      .totalExpectedStoredElectronCount\n  ) {\n    throw new InvalidScientificInputError(\n      \"Physical capacity assessment must be computed for the supplied accumulated charge; its total expected stored electrons differ.\"\n    );\n  }\n  if (\n    readout\n      .colorSamplingProfileId !==\n      charge.colorSamplingProfileId ||\n    readout.channelId !==\n      charge.channelId\n  ) {\n    throw new InvalidScientificInputError(\n      \"Sensor readout profile color/channel identity must match the accumulated charge.\"\n    );\n  }\n  const belowOrAtCapacity =\n    capacity\n      .totalExpectedStoredElectronCount <=\n    capacity\n      .physicalChargeCapacityElectrons;\n  if (\n    capacity\n      .expectedChargeCapacityStatus ===\n      \"above-capacity\" ||\n    !belowOrAtCapacity\n  ) {\n    throw new InvalidScientificInputError(\n      \"Expected stored charge above physical capacity cannot enter linear expected readout; the actual post-saturation stored charge is not defined by the upstream assessment.\"\n    );\n  }\n  if (\n    charge.saturationAssessed !==\n      false ||\n    charge.adcQuantizationApplied !==\n      false ||\n    charge.rawCodeValueProduced !==\n      false\n  ) {\n    throw new InvalidScientificInputError(\n      \"Sensor readout requires the unmodified accumulated-charge result.\"\n    );\n  }\n  return belowOrAtCapacity;\n}\n\nfunction additionalPolicyMap(\n  profile:\n    SensorChargeSamplingProfile,\n  charge:\n    SensorAccumulatedChargeComposition\n): ReadonlyMap<\n  string,\n  SensorAdditionalChargeSamplingPolicy\n> {\n  if (\n    profile.completenessProfileId !==\n    charge.completenessProfileId\n  ) {\n    throw new InvalidScientificInputError(\n      \"Charge sampling profile completenessProfileId must match the accumulated charge.\"\n    );\n  }\n\n  const chargeIds =\n    charge.additionalComponents.map(\n      (component) =>\n        component.componentId\n    ).sort();\n  const policyIds =\n    profile\n      .additionalComponentPolicies\n      .map(\n        (policy) =>\n          policy.componentId\n      )\n      .sort();\n\n  if (\n    chargeIds.length !==\n      policyIds.length ||\n    chargeIds.some(\n      (id, index) =>\n        id !== policyIds[index]\n    )\n  ) {\n    throw new InvalidScientificInputError(\n      \"Charge sampling profile must declare exactly one policy for every accumulated additional-charge component.\"\n    );\n  }\n\n  return new Map(\n    profile.additionalComponentPolicies.map(\n      (policy) => [\n        policy.componentId,\n        policy\n      ] as const\n    )\n  );\n}\n\ntype DeterministicRandom = DeterministicUniformStream;\n\nfunction createRandom(\n  seedUint32: number\n): DeterministicRandom {\n  return createDeterministicUniformStream(seedUint32);\n}\n\n/**\n * log(n!) for n < 256: entry n is ln 2 + ln 3 + … + ln n, summed in that order, so each entry\n * is bit-identical to summing the logarithms on demand (the partial sums of one loop).\n */\nconst SMALL_LOG_FACTORIALS = ((): Float64Array => {\n  const table = new Float64Array(256);\n  let sum = 0;\n  for (let value = 2; value < 256; value += 1) {\n    sum += Math.log(value);\n    table[value] = sum;\n  }\n  return table;\n})();\n\n/**\n * Computes log(n!) without forming the factorial, which would overflow. Small counts\n * sum the logarithms directly (read from a table of the same partial sums). Larger counts\n * use Stirling's formula with the correction terms 1/(12n) - 1/(360n³). This is internal\n * to the Poisson rejection sampler; it is not a claim about physical accuracy or uncertainty.\n */\nfunction logFactorial(\n  n: number\n): number {\n  if (n < 2) {\n    return 0;\n  }\n  if (n < 256) {\n    return SMALL_LOG_FACTORIALS[n]!;\n  }\n\n  const inverse = 1 / n;\n  const inverseCubed =\n    inverse * inverse * inverse;\n  return (\n    (n + 0.5) * Math.log(n) -\n    n +\n    0.5 *\n      Math.log(\n        2 * Math.PI\n      ) +\n    inverse / 12 -\n    inverseCubed / 360\n  );\n}\n\n/** Means at or above this use the continuity-corrected normal approximation. */\nconst POISSON_NORMAL_APPROXIMATION_MINIMUM_MEAN =\n  1e9;\n\n/**\n * Draws a nonnegative integer from a Poisson distribution with the given mean.\n *\n * - Mean 0 returns exactly 0.\n * - Mean below 30: multiply uniform random numbers until the product drops below e^(−mean).\n * - Mean from 30 to below 1e9: Hörmann's (1993) PTRS transformed rejection, comparing log\n *   probabilities to avoid overflow.\n * - Mean of 1e9 and above: a continuity-corrected normal approximation, because the log terms lose\n *   precision there.\n *\n * The same mean and random stream reproduce the same draw. Increasing the mean does not guarantee\n * that each individual draw increases. Exported internally for the lean native executor, which must\n * draw exactly as simulateSensorChargeRealization does; not exported from the package.\n */\nexport function samplePoisson(\n  mean: number,\n  random:\n    DeterministicRandom\n): number {\n  if (\n    !Number.isFinite(mean) ||\n    mean < 0\n  ) {\n    throw new InvalidScientificInputError(\n      \"Poisson mean must be finite and nonnegative.\"\n    );\n  }\n  if (mean === 0) {\n    return 0;\n  }\n\n  if (\n    mean >=\n    POISSON_NORMAL_APPROXIMATION_MINIMUM_MEAN\n  ) {\n    // Above 1e9 the log-probability terms of the rejection test reach about 1e10 and cancel badly\n    // (variance/mean is 1.012 at 1e14). Here the continuity-corrected normal approximation has a\n    // relative skewness error of 1/sqrt(mean) <= 3.2e-5 (Poisson skewness 1/sqrt(mean): NIST/SEMATECH\n    // e-Handbook of Statistical Methods, sec. 1.3.6.6.19, free; normal approximation with continuity\n    // correction: SOCR, University of Michigan, free. Also see: Johnson, Kemp & Kotz, Univariate\n    // Discrete Distributions, 3rd ed., section 4.4).\n    return Math.max(\n      0,\n      Math.floor(\n        mean +\n          Math.sqrt(mean) *\n            sampleStandardNormal(\n              random\n            ) +\n          0.5\n      )\n    );\n  }\n\n  if (mean < 30) {\n    const threshold =\n      Math.exp(-mean);\n    let product = 1;\n    let count = 0;\n    do {\n      count += 1;\n      product *=\n        random.next();\n    } while (\n      product > threshold\n    );\n    return count - 1;\n  }\n\n  const sqrtMean =\n    Math.sqrt(mean);\n  const b =\n    0.931 +\n    2.53 * sqrtMean;\n  const a =\n    -0.059 +\n    0.02483 * b;\n  const inverseAlpha =\n    1.1239 +\n    1.1328 /\n      (b - 3.4);\n  const vR =\n    0.9277 -\n    3.6224 /\n      (b - 2);\n\n  for (;;) {\n    const u =\n      random.next() - 0.5;\n    const v =\n      random.next();\n    const uS =\n      0.5 - Math.abs(u);\n    if (uS <= 0) {\n      continue;\n    }\n    const k =\n      Math.floor(\n        (2 * a / uS + b) *\n          u +\n          mean +\n          0.43\n      );\n\n    if (\n      uS >= 0.07 &&\n      v <= vR &&\n      k >= 0\n    ) {\n      return k;\n    }\n    if (\n      k < 0 ||\n      (\n        uS < 0.013 &&\n        v > uS\n      )\n    ) {\n      continue;\n    }\n\n    const lhs =\n      Math.log(\n        v *\n          inverseAlpha /\n          (a /\n            (uS * uS) +\n            b)\n      );\n    const rhs =\n      -mean +\n      k * Math.log(mean) -\n      logFactorial(k);\n\n    if (lhs <= rhs) {\n      return k;\n    }\n  }\n}\n\n/** log(n!) as `logFactorial` computes it, with the portable logarithm (`portableLog`) in place of Math.log. */\nlet portableSmallLogFactorials: Float64Array | undefined;\nfunction portableLogFactorial(n: number): number {\n  if (n < 2) return 0;\n  if (n < 256) {\n    if (!portableSmallLogFactorials) {\n      const table = new Float64Array(256);\n      let sum = 0;\n      for (let value = 2; value < 256; value += 1) { sum += portableLog(value); table[value] = sum; }\n      portableSmallLogFactorials = table;\n    }\n    return portableSmallLogFactorials[n]!;\n  }\n  const inverse = 1 / n, inverseCubed = inverse * inverse * inverse;\n  // 0.5·ln(2π), as logFactorial forms it; computed on first use, so a bundle without the portable sampler need not evaluate it.\n  portableHalfLogTwoPi ??= 0.5 * portableLog(2 * Math.PI);\n  return (n + 0.5) * portableLog(n) - n + portableHalfLogTwoPi + inverse / 12 - inverseCubed / 360;\n}\nlet portableHalfLogTwoPi: number | undefined;\n\n/**\n * Internal (not exported from the package): `samplePoisson` for one fixed mean, with the per-mean constants (e^(−mean),\n * the PTRS constants and ln mean) computed once. Each draw takes the same branch, reads the same random values and\n * forms every value with the same expressions as `samplePoisson(mean, random)`, so the draws are identical; it is for\n * callers that draw many times with one mean (the display view's AHD correction).\n *\n * With `portable` true, every exponential, logarithm and normal draw uses the engine's portable functions\n * (`portableExp`, `portableLog`, `samplePortableStandardNormal`) instead of Math.exp, Math.log and the Box–Muller of\n * Math.log/Math.cos, so the draws are the same in every JavaScript engine; they then equal `samplePoisson`'s except\n * where a comparison falls within the last-bit difference of those functions. The display view uses this form.\n */\nexport function createPoissonSampler(\n  mean: number,\n  portable = false\n): (random: DeterministicRandom) => number {\n  if (\n    !Number.isFinite(mean) ||\n    mean < 0\n  ) {\n    throw new InvalidScientificInputError(\n      \"Poisson mean must be finite and nonnegative.\"\n    );\n  }\n  if (mean === 0) {\n    return () => 0;\n  }\n  const exp = portable ? portableExp : Math.exp, log = portable ? portableLog : Math.log;\n  const logFactorialOf = portable ? portableLogFactorial : logFactorial;\n  if (\n    mean >=\n    POISSON_NORMAL_APPROXIMATION_MINIMUM_MEAN\n  ) {\n    if (!portable) return (random) => samplePoisson(mean, random);\n    const sqrtMean = Math.sqrt(mean);\n    return (random) => Math.max(0, Math.floor(mean + sqrtMean * samplePortableStandardNormal(random) + 0.5));\n  }\n  if (mean < 30) {\n    const threshold =\n      exp(-mean);\n    return (random) => {\n      let product = 1;\n      let count = 0;\n      do {\n        count += 1;\n        product *=\n          random.next();\n      } while (\n        product > threshold\n      );\n      return count - 1;\n    };\n  }\n  const sqrtMean =\n    Math.sqrt(mean);\n  const b =\n    0.931 +\n    2.53 * sqrtMean;\n  const a =\n    -0.059 +\n    0.02483 * b;\n  const inverseAlpha =\n    1.1239 +\n    1.1328 /\n      (b - 3.4);\n  const vR =\n    0.9277 -\n    3.6224 /\n      (b - 2);\n  const logMean =\n    log(mean);\n  return (random) => {\n    for (;;) {\n      const u =\n        random.next() - 0.5;\n      const v =\n        random.next();\n      const uS =\n        0.5 - Math.abs(u);\n      if (uS <= 0) {\n        continue;\n      }\n      const k =\n        Math.floor(\n          (2 * a / uS + b) *\n            u +\n            mean +\n            0.43\n        );\n      if (\n        uS >= 0.07 &&\n        v <= vR &&\n        k >= 0\n      ) {\n        return k;\n      }\n      if (\n        k < 0 ||\n        (\n          uS < 0.013 &&\n          v > uS\n        )\n      ) {\n        continue;\n      }\n      const lhs =\n        log(\n          v *\n            inverseAlpha /\n            (a /\n              (uS * uS) +\n              b)\n        );\n      const rhs =\n        -mean +\n        k * logMean -\n        logFactorialOf(k);\n      if (lhs <= rhs) {\n        return k;\n      }\n    }\n  };\n}\n\n/**\n * Internal (not exported from the package): draws `count` Poisson samples of one mean from one seeded\n * stream, exactly as the charge realization does. Used by the sampler's distribution tests.\n */\nexport function samplePoissonStreamForValidation(\n  mean: number,\n  seedUint32: number,\n  count: number\n): number[] {\n  const random =\n    createRandom(seedUint32);\n  return Array.from(\n    { length: count },\n    () =>\n      samplePoisson(\n        mean,\n        random\n      )\n  );\n}\n\n/**\n * Internal (not exported from the package): draws `count` standard normal values from one seeded\n * stream, exactly as the read-noise path does. Used by the sampler's distribution tests.\n */\nexport function sampleStandardNormalStreamForValidation(\n  seedUint32: number,\n  count: number\n): number[] {\n  const random =\n    createRandom(seedUint32);\n  return Array.from(\n    { length: count },\n    () =>\n      sampleStandardNormal(\n        random\n      )\n  );\n}\n\nfunction sampleStandardNormal(\n  random:\n    DeterministicRandom\n): number {\n  return sampleDeterministicStandardNormal(random);\n}\n\n/**\n * Draws deterministic, separately seeded Poisson counts for photo and dark charge, and applies the\n * declared policies for additional components, starting from the expected accumulated charge.\n *\n * This is steps 1–2 of the readout order (see the module notes). Physical storage saturation is\n * reported separately from later clipping.\n * @param input - The input; see `SimulateSensorChargeRealizationInput` for its fields, units and coordinates.\n * @returns The result. Success does not imply calibration.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function simulateSensorChargeRealization(\n  input:\n    SimulateSensorChargeRealizationInput\n): CalculationResult<SensorChargeRealization> {\n  requireInputKeys(input, \"simulateSensorChargeRealization\", [\"accumulatedCharge\", \"samplingProfile\", \"seedUint32\", \"fixedPatternNoise\"]);\n  const profile =\n    parseSensorChargeSamplingProfile(\n      input.samplingProfile\n    );\n  const seed =\n    requireUint32(\n      input.seedUint32,\n      \"seedUint32\"\n    );\n  const charge =\n    input.accumulatedCharge;\n\n  if (\n    charge.accumulatedChargeCompleteness !==\n      \"complete-for-physical-storage-capacity-assessment\" ||\n    charge.saturationAssessed !==\n      false ||\n    charge.adcQuantizationApplied !==\n      false ||\n    charge.rawCodeValueProduced !==\n      false\n  ) {\n    throw new InvalidScientificInputError(\n      \"Charge realization requires a complete unsaturated pre-readout accumulated-charge result.\"\n    );\n  }\n\n  const policies =\n    additionalPolicyMap(\n      profile,\n      charge\n    );\n  const pattern =\n    input.fixedPatternNoise === undefined\n      ? null\n      : fixedPatternAtSite(\n          parseSensorFixedPatternNoiseProfile(\n            input.fixedPatternNoise\n          ),\n          charge\n            .colorSamplingProfileId,\n          charge.site\n        );\n  const photoGain =\n    pattern === null\n      ? 1\n      : pattern\n          .photoResponseGainFactor;\n  const darkFactor =\n    pattern === null\n      ? 1\n      : pattern.darkCurrentFactor;\n  const photoMean =\n    pattern === null\n      ? charge\n          .photoExpectedElectronCount\n      : charge\n          .photoExpectedElectronCount *\n        photoGain;\n  const darkMean =\n    pattern === null\n      ? charge\n          .darkExpectedElectronCount\n      : charge\n          .darkExpectedElectronCount *\n        darkFactor;\n  const random =\n    createRandom(seed);\n  const photoRealized =\n    samplePoisson(\n      photoMean,\n      random\n    );\n  const darkRealized =\n    samplePoisson(\n      darkMean,\n      random\n    );\n\n  const additionalComponents =\n    charge.additionalComponents.map(\n      (component) => {\n        const policy =\n          policies.get(\n            component.componentId\n          )!;\n        const realized =\n          policy.model ===\n          \"poisson\"\n            ? samplePoisson(\n                component\n                  .expectedElectronCount,\n                random\n              )\n            : component\n                .expectedElectronCount;\n        return {\n          componentId:\n            component.componentId,\n          expectedElectronCount:\n            component\n              .expectedElectronCount,\n          realizedElectronEquivalentCount:\n            realized,\n          model:\n            policy.model\n        };\n      }\n    );\n\n  const additionalRealized =\n    additionalComponents.reduce(\n      (sum, component) =>\n        sum +\n        component\n          .realizedElectronEquivalentCount,\n      0\n    );\n  const totalRealized =\n    photoRealized +\n    darkRealized +\n    additionalRealized;\n\n  if (\n    !Number.isFinite(\n      totalRealized\n    ) ||\n    totalRealized < 0\n  ) {\n    throw new InvalidScientificInputError(\n      \"Realized stored charge must remain finite and nonnegative.\"\n    );\n  }\n\n  return approximationResult(\n    {\n      samplingProfileId:\n        profile.profileId,\n      completenessProfileId:\n        charge\n          .completenessProfileId,\n      colorSamplingProfileId:\n        charge\n          .colorSamplingProfileId,\n      channelId:\n        charge.channelId,\n      site: {\n        ...charge.site\n      },\n      bindingId:\n        charge.bindingId,\n      seedUint32:\n        seed,\n      photoExpectedElectronCount:\n        charge\n          .photoExpectedElectronCount,\n      photoRealizedElectronCount:\n        photoRealized,\n      darkExpectedElectronCount:\n        charge\n          .darkExpectedElectronCount,\n      darkRealizedElectronCount:\n        darkRealized,\n      fixedPatternNoiseProfileId:\n        pattern === null\n          ? null\n          : pattern.profileId,\n      photoResponseGainFactor:\n        photoGain,\n      darkCurrentFactor:\n        darkFactor,\n      hotPixel:\n        pattern?.hotPixel ?? false,\n      photoSampledMeanElectronCount:\n        photoMean,\n      darkSampledMeanElectronCount:\n        darkMean,\n      additionalComponents,\n      totalExpectedStoredElectronCount:\n        charge\n          .totalExpectedStoredElectronCount,\n      totalRealizedStoredElectronEquivalentCount:\n        totalRealized,\n      photoShotNoiseApplied:\n        true,\n      darkShotNoiseApplied:\n        true,\n      electronicReadNoiseApplied:\n        false,\n      physicalSaturationApplied:\n        false,\n      bloomingModeled: false,\n      conversionGainApplied:\n        false,\n      adcQuantizationApplied:\n        false,\n      rawCodeValueProduced:\n        false,\n      stochasticModel:\n        \"independent-poisson-photo-dark-explicit-additional-policy\",\n      deterministicSeededRealization:\n        true\n    },\n    \"sensor-charge-stochastic-realization\",\n    \"3.0.0\",\n    [\n      \"An optional explicit fixed-pattern profile multiplies the photo Poisson mean by the site's PRNU gain and the dark Poisson mean by its DSNU/hot-pixel factor; without one the uniform population expectation is sampled. Fixed-pattern values are deterministic per sensor instance and colour-sampling site.\",\n      \"Poisson means of 1e9 electrons and above use a continuity-corrected normal approximation.\",\n      \"Photo-generated and dark-generated electron counts are sampled independently from Poisson distributions using an explicit deterministic seed.\",\n      \"Each additional stored-charge component uses its explicitly declared Poisson or deterministic electron-equivalent policy; Photivra does not infer defect/leakage statistics from the component name.\",\n      \"This is a pre-saturation, pre-electronic-read-noise charge realization and remains separate from expectation-value calculations.\",\n      \"The seeded PRNG is a deterministic simulation mechanism and is not cryptographically secure; its seed is scrambled by the MurmurHash3 fmix32 finalizer so nearby seeds give unrelated streams.\"\n    ]\n  );\n}\n\nfunction fixedPatternAtSite(\n  profile:\n    SensorFixedPatternNoiseProfile,\n  colorSamplingProfileId: string,\n  site: { x: number; y: number }\n): SensorFixedPatternSiteValues {\n  if (\n    profile.colorSamplingProfileId !==\n    colorSamplingProfileId\n  ) {\n    throw new InvalidScientificInputError(\n      \"Fixed-pattern noise profile colour-sampling identity must match the charge.\"\n    );\n  }\n  return evaluateParsedFixedPatternSite(\n    profile,\n    site\n  );\n}\n\nfunction fixedPatternForRealization(\n  value:\n    SensorFixedPatternNoiseProfile | undefined,\n  charge:\n    SensorChargeRealization\n): SensorFixedPatternSiteValues | null {\n  if (value === undefined) {\n    if (\n      charge.fixedPatternNoiseProfileId !==\n        null &&\n      charge.fixedPatternNoiseProfileId !==\n        undefined\n    ) {\n      throw new InvalidScientificInputError(\n        \"A charge realization with a fixed pattern requires the same fixed-pattern profile at readout.\"\n      );\n    }\n    return null;\n  }\n  const profile =\n    parseSensorFixedPatternNoiseProfile(\n      value\n    );\n  if (\n    charge.fixedPatternNoiseProfileId !==\n    profile.profileId\n  ) {\n    throw new InvalidScientificInputError(\n      \"Readout fixed-pattern profile must be the profile used for the charge realization.\"\n    );\n  }\n  return fixedPatternAtSite(\n    profile,\n    charge.colorSamplingProfileId,\n    charge.site\n  );\n}\n\nfunction validateCapacityAgainstRealization(\n  charge:\n    SensorChargeRealization,\n  capacity:\n    SensorPhysicalChargeCapacityAssessment,\n  readout:\n    ResolvedSensorReadoutRegime\n): void {\n  if (\n    charge.completenessProfileId !==\n      capacity\n        .completenessProfileId ||\n    charge.colorSamplingProfileId !==\n      capacity\n        .colorSamplingProfileId ||\n    charge.channelId !==\n      capacity.channelId ||\n    charge.site.x !==\n      capacity.site.x ||\n    charge.site.y !==\n      capacity.site.y ||\n    charge.bindingId !==\n      capacity.bindingId\n  ) {\n    throw new InvalidScientificInputError(\n      \"Physical capacity assessment identity must match the charge realization.\"\n    );\n  }\n  if (\n    charge\n      .totalExpectedStoredElectronCount !==\n    capacity\n      .totalExpectedStoredElectronCount\n  ) {\n    throw new InvalidScientificInputError(\n      \"Physical capacity assessment must be computed for the charge behind the realization; its total expected stored electrons differ.\"\n    );\n  }\n  if (\n    readout\n      .colorSamplingProfileId !==\n      charge.colorSamplingProfileId ||\n    readout.channelId !==\n      charge.channelId\n  ) {\n    throw new InvalidScientificInputError(\n      \"Sensor readout profile color/channel identity must match the charge realization.\"\n    );\n  }\n}\n\n/**\n * Maps the expected charge through the declared gain, offset and readout limits, with no random\n * sampling. Each kind of clipping (physical storage, pre-ADC, digital) is reported separately.\n * @param input - The input; see `CalculateExpectedSensorReadoutInput` for its fields, units and coordinates.\n * @returns The result. Success does not imply calibration.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function calculateExpectedSensorReadout(\n  input:\n    CalculateExpectedSensorReadoutInput\n): CalculationResult<SensorExpectedReadoutSignal> {\n  requireInputKeys(input, \"calculateExpectedSensorReadout\", [\"accumulatedCharge\", \"physicalCapacityAssessment\", \"readoutProfile\", \"regimeId\"]);\n  const readout =\n    resolveSensorReadoutRegime({\n      profile:\n        input.readoutProfile,\n      regimeId:\n        input.regimeId\n    });\n  const expectedStoredChargeBelowOrAtPhysicalCapacity =\n    validateChargeIdentity(\n      input.accumulatedCharge,\n      input\n        .physicalCapacityAssessment,\n      readout\n    );\n\n  const expected =\n    input.accumulatedCharge\n      .totalExpectedStoredElectronCount;\n  const threshold =\n    readout.regime\n      .preAdcSaturationElectronEquivalent\n      .value;\n  const afterPreAdc =\n    Math.min(\n      expected,\n      threshold\n    );\n  const codeSignal =\n    afterPreAdc /\n    readout.regime\n      .systemConversionGainElectronsPerCode\n      .value;\n  const inlOffset =\n    integralNonLinearityOffset(\n      readout.regime.adc\n        .integralNonLinearity,\n      codeSignal +\n        readout.regime\n          .adc.blackLevelCode\n    );\n  const codeBeforeQuantization =\n    codeSignal +\n    readout.regime\n      .adc.blackLevelCode +\n    inlOffset;\n  const digitalGain =\n    readout.regime.adc\n      .digitalGain ?? 1;\n  const codeAfterDigitalGain =\n    readout.regime.adc\n      .digitalGain === undefined\n      ? codeBeforeQuantization\n      : (Math.min(\n          codeBeforeQuantization,\n          readout.adcMaximumCode\n        ) -\n          readout.regime.adc\n            .blackLevelCode) *\n          digitalGain +\n        readout.regime.adc\n          .blackLevelCode;\n\n  return approximationResult(\n    {\n      readoutProfileId:\n        readout.profileId,\n      regimeId:\n        readout.regime\n          .regimeId,\n      completenessProfileId:\n        input.accumulatedCharge\n          .completenessProfileId,\n      capacityProfileId:\n        input\n          .physicalCapacityAssessment\n          .capacityProfileId,\n      colorSamplingProfileId:\n        input.accumulatedCharge\n          .colorSamplingProfileId,\n      channelId:\n        input.accumulatedCharge\n          .channelId,\n      site: {\n        ...input\n          .accumulatedCharge\n          .site\n      },\n      bindingId:\n        input.accumulatedCharge\n          .bindingId,\n      expectedStoredElectronCount:\n        expected,\n      expectedStoredChargeBelowOrAtPhysicalCapacity,\n      expectedElectronEquivalentAfterPreAdcSaturation:\n        afterPreAdc,\n      preAdcSaturationAppliedToExpectation:\n        afterPreAdc < expected,\n      systemConversionGainElectronsPerCode:\n        readout.regime\n          .systemConversionGainElectronsPerCode\n          .value,\n      expectedCodeBeforeBlackOffset:\n        codeSignal,\n      blackLevelCode:\n        readout.regime\n          .adc.blackLevelCode,\n      expectedCodeBeforeQuantization:\n        codeBeforeQuantization,\n      adcIntegralNonLinearityOffsetCodes:\n        inlOffset,\n      digitalGain,\n      expectedCodeAfterDigitalGain:\n        codeAfterDigitalGain,\n      adcBitDepth:\n        readout.regime\n          .adc.bitDepth,\n      adcMaximumCode:\n        readout.adcMaximumCode,\n      digitalSaturationCode:\n        readout.regime\n          .adc\n          .digitalSaturationCode,\n      expectedDigitalSaturation:\n        codeAfterDigitalGain >=\n        readout.regime\n          .adc\n          .digitalSaturationCode,\n      electronicReadNoiseMeanElectrons:\n        0,\n      electronicReadNoiseRmsElectrons:\n        readout\n          .combinedReadNoiseRmsElectrons,\n      electronicReadNoiseSampled:\n        false,\n      adcQuantizationApplied:\n        false,\n      rawCodeValueProduced:\n        false,\n      isoUsedToInferRegime:\n        false\n    },\n    \"sensor-expected-electronic-readout\",\n    \"2.0.0\",\n    [\n      \"Expected readout uses complete expected stored charge only after the upstream physical-capacity assessment confirms the expectation is not above physical capacity.\",\n      \"Electronic read-noise mean is zero and is not sampled in this expectation result.\",\n      \"The explicitly selected conversion regime is not inferred from ISO, sensor technology family or marketing mode names; an ISO signal chain may bind an exposure index to a declared regime.\",\n      \"Declared ADC integral non-linearity and post-ADC digital gain are applied to the continuous expectation without quantization.\",\n      \"Pre-ADC electron-equivalent saturation, black offset and ADC/digital saturation remain separate domains.\",\n      \"ADC quantization is not applied to the expectation value.\"\n    ]\n  );\n}\n\n/**\n * Nearest integer, with ties going towards +infinity. Math.round is exact for every double. (In\n * contrast, floor(x + 0.5) returns 1 for 0.49999999999999994, because the addition rounds up.)\n * Adding 0 turns -0 into +0.\n */\nfunction roundHalfUp(\n  value: number\n): number {\n  return Math.round(value) + 0;\n}\n\nfunction integralNonLinearityOffset(\n  inl:\n    SensorAdcIntegralNonLinearity | undefined,\n  code: number\n): number {\n  if (inl === undefined) {\n    return 0;\n  }\n  const knots = inl.knots;\n  const first = knots[0]!;\n  const last = knots[knots.length - 1]!;\n  if (code <= first.code) {\n    return first.offsetCodes;\n  }\n  if (code >= last.code) {\n    return last.offsetCodes;\n  }\n  let low = 0;\n  let high = knots.length - 1;\n  while (high - low > 1) {\n    const middle = (low + high) >> 1;\n    if (knots[middle]!.code <= code) {\n      low = middle;\n    } else {\n      high = middle;\n    }\n  }\n  const a = knots[low]!;\n  const b = knots[high]!;\n  return (\n    a.offsetCodes +\n    ((code - a.code) /\n      (b.code - a.code)) *\n      (b.offsetCodes - a.offsetCodes)\n  );\n}\n\n/**\n * Shared ADC transfer function: continuous input code (signal/gain + black + INL), rounded half up\n * and limited to the ADC code range, then optional post-ADC digital gain about black, rounded again.\n * The caller applies the final clamp to [0, digitalSaturationCode]. Exported internally for the lean\n * native executor; not exported from the package.\n */\nexport function adcTransfer(\n  regime:\n    SensorReadoutConversionRegime,\n  adcMaximumCode: number,\n  electronEquivalent: number\n): {\n  codeBeforeQuantization: number;\n  inlOffset: number;\n  adcCode: number;\n  digitalGain: number;\n  quantized: number;\n} {\n  const ideal =\n    electronEquivalent /\n      regime\n        .systemConversionGainElectronsPerCode\n        .value +\n    regime.adc.blackLevelCode;\n  const inlOffset =\n    integralNonLinearityOffset(\n      regime.adc.integralNonLinearity,\n      ideal\n    );\n  const codeBeforeQuantization =\n    ideal + inlOffset;\n  const quantizedAdc =\n    roundHalfUp(\n      codeBeforeQuantization\n    );\n  const digitalGain =\n    regime.adc.digitalGain ?? 1;\n  if (\n    regime.adc.digitalGain ===\n    undefined\n  ) {\n    return {\n      codeBeforeQuantization,\n      inlOffset,\n      adcCode:\n        quantizedAdc,\n      digitalGain,\n      quantized:\n        quantizedAdc\n    };\n  }\n  const adcCode =\n    Math.max(\n      0,\n      Math.min(\n        quantizedAdc,\n        adcMaximumCode\n      )\n    );\n  return {\n    codeBeforeQuantization,\n    inlOffset,\n    adcCode,\n    digitalGain,\n    quantized:\n      roundHalfUp(\n        (adcCode -\n          regime.adc\n            .blackLevelCode) *\n          digitalGain +\n          regime.adc\n            .blackLevelCode\n      )\n  };\n}\n\n/**\n * Simulates one RAW code from a charge realization with the declared seed and regime: steps 3–7 of\n * the readout order (see the module notes). Signed read noise is kept through the black pedestal and\n * quantization, and only the final code is clamped. Returns the bounded native ADC code and per-step\n * diagnostics.\n * @param input - The input; see `SimulateSensorRawCodeInput` for its fields, units and coordinates.\n * @returns The result. Success does not imply calibration.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function simulateSensorRawCode(\n  input:\n    SimulateSensorRawCodeInput\n): CalculationResult<SensorRawCodeSample> {\n  requireInputKeys(input, \"simulateSensorRawCode\", [\"chargeRealization\", \"physicalCapacityAssessment\", \"readoutProfile\", \"regimeId\", \"readNoiseSeedUint32\", \"fixedPatternNoise\"]);\n  const readout =\n    resolveSensorReadoutRegime({\n      profile:\n        input.readoutProfile,\n      regimeId:\n        input.regimeId\n    });\n  validateCapacityAgainstRealization(\n    input.chargeRealization,\n    input\n      .physicalCapacityAssessment,\n    readout\n  );\n  const readNoiseSeed =\n    requireUint32(\n      input.readNoiseSeedUint32,\n      \"readNoiseSeedUint32\"\n    );\n  const random =\n    createRandom(\n      readNoiseSeed\n    );\n\n  const realized =\n    input.chargeRealization\n      .totalRealizedStoredElectronEquivalentCount;\n  if (\n    !Number.isFinite(realized) ||\n    realized < 0\n  ) {\n    throw new InvalidScientificInputError(\n      \"Charge realization total must be finite and nonnegative.\"\n    );\n  }\n\n  const physicalCapacity =\n    input\n      .physicalCapacityAssessment\n      .physicalChargeCapacityElectrons;\n  const afterPhysical =\n    Math.min(\n      realized,\n      physicalCapacity\n    );\n  const physicalSaturation =\n    afterPhysical < realized;\n  const overflow =\n    Math.max(\n      0,\n      realized -\n        physicalCapacity\n    );\n\n  const readNoiseComponents =\n    readout.regime\n      .readNoiseComponents.map(\n        (component) => {\n          const sampled =\n            component\n              .rmsElectrons.value ===\n            0\n              ? 0\n              : sampleStandardNormal(\n                  random\n                ) *\n                component\n                  .rmsElectrons.value;\n          return {\n            componentId:\n              component\n                .componentId,\n            rmsElectrons:\n              component\n                .rmsElectrons\n                .value,\n            sampledElectrons:\n              sampled\n          };\n        }\n      );\n  const totalReadNoise =\n    readNoiseComponents.reduce(\n      (sum, component) =>\n        sum +\n        component\n          .sampledElectrons,\n      0\n    );\n  const pattern =\n    fixedPatternForRealization(\n      input.fixedPatternNoise,\n      input.chargeRealization\n    );\n  const fixedPatternOffset =\n    pattern === null\n      ? 0\n      : pattern\n          .readoutOffsetElectrons;\n\n  const afterReadNoise =\n    afterPhysical +\n    totalReadNoise +\n    fixedPatternOffset;\n  const preAdcThreshold =\n    readout.regime\n      .preAdcSaturationElectronEquivalent\n      .value;\n  // Stored charge is nonnegative, but the electronic signal after it is signed.\n  // Keep negative read noise until the black pedestal and the unsigned ADC limit.\n  const afterPreAdc =\n    Math.min(\n      afterReadNoise,\n      preAdcThreshold\n    );\n  const preAdcSaturation =\n    afterReadNoise >\n    preAdcThreshold;\n\n  const transfer =\n    adcTransfer(\n      readout.regime,\n      readout.adcMaximumCode,\n      afterPreAdc\n    );\n  const codeBeforeQuantization =\n    transfer.codeBeforeQuantization;\n  const quantized =\n    transfer.quantized;\n  const rawCode =\n    Math.max(\n      0,\n      Math.min(\n        quantized,\n        readout.regime\n          .adc\n          .digitalSaturationCode\n      )\n    );\n\n  return approximationResult(\n    {\n      readoutProfileId:\n        readout.profileId,\n      regimeId:\n        readout.regime\n          .regimeId,\n      samplingProfileId:\n        input.chargeRealization\n          .samplingProfileId,\n      completenessProfileId:\n        input.chargeRealization\n          .completenessProfileId,\n      capacityProfileId:\n        input\n          .physicalCapacityAssessment\n          .capacityProfileId,\n      colorSamplingProfileId:\n        input.chargeRealization\n          .colorSamplingProfileId,\n      channelId:\n        input.chargeRealization\n          .channelId,\n      site: {\n        ...input\n          .chargeRealization.site\n      },\n      bindingId:\n        input.chargeRealization\n          .bindingId,\n      chargeSeedUint32:\n        input.chargeRealization\n          .seedUint32,\n      readNoiseSeedUint32:\n        readNoiseSeed,\n      realizedStoredElectronEquivalentCountBeforePhysicalCapacity:\n        realized,\n      physicalChargeCapacityElectrons:\n        physicalCapacity,\n      electronEquivalentAfterPhysicalScalarSaturation:\n        afterPhysical,\n      physicalScalarSaturationApplied:\n        physicalSaturation,\n      overflowElectronEquivalentDiagnostic:\n        overflow,\n      bloomingModeled: false,\n      electronicReadNoiseComponents:\n        readNoiseComponents,\n      totalElectronicReadNoiseElectrons:\n        totalReadNoise,\n      fixedPatternNoiseProfileId:\n        pattern === null\n          ? null\n          : pattern.profileId,\n      fixedPatternReadoutOffsetElectrons:\n        fixedPatternOffset,\n      electronEquivalentAfterReadNoise:\n        afterReadNoise,\n      preAdcSaturationElectronEquivalent:\n        preAdcThreshold,\n      electronEquivalentAfterPreAdcSaturation:\n        afterPreAdc,\n      preAdcSaturationApplied:\n        preAdcSaturation,\n      systemConversionGainElectronsPerCode:\n        readout.regime\n          .systemConversionGainElectronsPerCode\n          .value,\n      blackLevelCode:\n        readout.regime\n          .adc.blackLevelCode,\n      codeBeforeQuantization,\n      adcIntegralNonLinearityOffsetCodes:\n        transfer.inlOffset,\n      adcCodeBeforeDigitalGain:\n        transfer.adcCode,\n      digitalGain:\n        transfer.digitalGain,\n      quantizedCodeBeforeDigitalClamp:\n        quantized,\n      adcBitDepth:\n        readout.regime\n          .adc.bitDepth,\n      adcMaximumCode:\n        readout.adcMaximumCode,\n      digitalSaturationCode:\n        readout.regime\n          .adc\n          .digitalSaturationCode,\n      rawCode,\n      digitalSaturationApplied:\n        quantized >=\n        readout.regime\n          .adc\n          .digitalSaturationCode,\n      lowerCodeClampApplied:\n        quantized < 0,\n      adcTransfer:\n        \"uniform-round-half-up\",\n      physicalSaturationApplied:\n        physicalSaturation,\n      electronicReadNoiseApplied:\n        readNoiseComponents\n          .some(\n            (component) =>\n              component\n                .rmsElectrons >\n              0\n          ),\n      conversionGainApplied:\n        true,\n      adcQuantizationApplied:\n        true,\n      rawCodeValueProduced:\n        true,\n      isoUsedToInferRegime:\n        false,\n      deterministicSeededRealization:\n        true\n    },\n    \"sensor-raw-code-stochastic-readout\",\n    \"4.0.0\",\n    [\n      \"A stochastic stored-charge realization is scalar-clamped at the explicit physical storage capacity; this is a bounded saturation approximation and does not model blooming, neighbor transport or anti-blooming behavior.\",\n      \"Independent input-referred Gaussian electronic read-noise components, plus any declared static fixed-pattern row/column offsets, are added after physical charge saturation and before the explicit pre-ADC electron-equivalent saturation threshold.\",\n      \"System conversion gain is expressed in electrons per digital-number code unit for the explicitly selected regime; an ISO-dependent gain exists only where an explicit ISO signal chain binds the setting to a declared regime.\",\n      \"Signed electronic read noise survives the upper-only pre-ADC saturation threshold. Black level and any declared ADC integral non-linearity are added before uniform round-half-up quantization (exact ties toward +infinity); an optional post-ADC digital gain about black is re-quantized; codes are then clamped to zero/digital saturation and valid below-black codes are retained.\",\n      \"Physical storage capacity, pre-ADC saturation and digital/ADC saturation remain separate thresholds.\",\n      \"The charge seed and read-noise seed are separate deterministic simulation identities; neither is cryptographically secure.\"\n    ]\n  );\n}\n"]}
+{"version":3,"file":"raw-readout.js","sourceRoot":"","sources":["../../src/sensor/raw-readout.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * RAW readout: turns the expected charge in a sensor site into a RAW code, with shot noise, read\n * noise and the ADC (analogue-to-digital converter).\n *\n * The steps, in order:\n * 1. expected charge;\n * 2. separately seeded random photo and dark draws (Poisson shot noise);\n * 3. signed electronic read noise;\n * 4. the upper pre-ADC clipping threshold;\n * 5. the black pedestal (offset);\n * 6. ADC quantization, rounding to nearest with ties up;\n * 7. limits on the unsigned code.\n *\n * Values below black stay signed until the final code clamp. Physical storage saturation, pre-ADC\n * clipping and digital clipping are reported separately. The ISO setting never invents a conversion\n * regime; regimes are declared.\n * @see docs/SENSOR_RAW_PRODUCER.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 { InvalidConfigurationError } from \"../core/configuration-error.js\";\nimport {\n  parseEvidenceList,\n  type EvidenceBackedFact,\n  type EvidenceProvenance\n} from \"../core/evidence-provenance.js\";\nimport { InvalidScientificInputError } from \"../core/validation.js\";\nimport {\n  createDeterministicUniformStream,\n  sampleDeterministicStandardNormal,\n  samplePortableStandardNormal,\n  type DeterministicUniformStream\n} from \"./stochastic-seed.js\";\nimport { portableExp, portableLog } from \"../core/portable-math.js\";\nimport type {\n  SensorPhotoAccumulatedChargeComposition as SensorAccumulatedChargeComposition\n} from \"./accumulated-charge.js\";\nimport type {\n  SensorPhysicalChargeCapacityAssessment\n} from \"./physical-charge-capacity.js\";\nimport type {\n  SensorSpectralResponseScientificStatus\n} from \"./spectral-response.js\";\nimport { requireInputKeys, requireConfigRecord as requireRecord, requireTrimmedConfigString as requireNonEmptyString, requireConfigFinite as requireFinite, parseConfigScientificStatus as parseStatus, parseConfigLimitations as parseLimitations, requireConfigFiniteAboveZero as requirePositiveFinite, requireConfigFiniteAtLeastZero as requireNonNegativeFinite } from \"../core/record-validation.js\";\nimport {\n  evaluateParsedFixedPatternSite,\n  parseSensorFixedPatternNoiseProfile,\n  type SensorFixedPatternNoiseProfile,\n  type SensorFixedPatternSiteValues\n} from \"./fixed-pattern-noise.js\";\n\nexport const SENSOR_CHARGE_SAMPLING_PROFILE_SCHEMA_VERSION =\n  \"0.1.0\" as const;\nexport const SENSOR_READOUT_CONVERSION_PROFILE_SCHEMA_VERSION =\n  \"0.1.0\" as const;\n\nexport type SensorAdditionalChargeSamplingModel =\n  | \"poisson\"\n  | \"deterministic-expected-electron-equivalent\";\n\nexport interface SensorAdditionalChargeSamplingPolicy {\n  componentId: string;\n  model:\n    SensorAdditionalChargeSamplingModel;\n}\n\nexport interface SensorChargeSamplingProfile {\n  schemaVersion:\n    typeof SENSOR_CHARGE_SAMPLING_PROFILE_SCHEMA_VERSION;\n  profileId: string;\n  completenessProfileId: string;\n  scientificStatus: \"approximation\";\n  photoShotNoiseModel: \"poisson\";\n  darkShotNoiseModel: \"poisson\";\n  additionalComponentPolicies:\n    readonly SensorAdditionalChargeSamplingPolicy[];\n  evidence:\n    readonly EvidenceProvenance[];\n  limitations: readonly string[];\n}\n\nexport interface SimulateSensorChargeRealizationInput {\n  accumulatedCharge:\n    SensorAccumulatedChargeComposition;\n  samplingProfile:\n    SensorChargeSamplingProfile;\n  seedUint32: number;\n  /**\n   * Optional fixed-pattern noise for this sensor. PRNU (photo-response non-uniformity) scales the\n   * photo Poisson mean; DSNU (dark-signal non-uniformity) and hot pixels scale the dark Poisson mean.\n   * If omitted, the result is exactly the uniform population model.\n   */\n  fixedPatternNoise?:\n    SensorFixedPatternNoiseProfile;\n}\n\nexport interface SensorChargeRealization {\n  samplingProfileId: string;\n  completenessProfileId: string;\n  colorSamplingProfileId: string;\n  channelId: string;\n  site: {\n    x: number;\n    y: number;\n  };\n  bindingId: string;\n  seedUint32: number;\n  photoExpectedElectronCount: number;\n  photoRealizedElectronCount: number;\n  darkExpectedElectronCount: number;\n  darkRealizedElectronCount: number;\n  /** Fixed-pattern profile applied to this realization, or null for the uniform population model. */\n  fixedPatternNoiseProfileId:\n    string | null;\n  /** PRNU gain applied to the photo expectation (exactly 1 without a fixed pattern). */\n  photoResponseGainFactor: number;\n  /** DSNU/hot-pixel factor applied to the dark expectation (exactly 1 without a fixed pattern). */\n  darkCurrentFactor: number;\n  hotPixel: boolean;\n  /** Poisson means actually sampled: expectation × the site's fixed-pattern factor. */\n  photoSampledMeanElectronCount: number;\n  darkSampledMeanElectronCount: number;\n  additionalComponents:\n    readonly {\n      componentId: string;\n      expectedElectronCount: number;\n      realizedElectronEquivalentCount:\n        number;\n      model:\n        SensorAdditionalChargeSamplingModel;\n    }[];\n  totalExpectedStoredElectronCount:\n    number;\n  totalRealizedStoredElectronEquivalentCount:\n    number;\n  photoShotNoiseApplied: true;\n  darkShotNoiseApplied: true;\n  electronicReadNoiseApplied: false;\n  physicalSaturationApplied: false;\n  bloomingModeled: false;\n  conversionGainApplied: false;\n  adcQuantizationApplied: false;\n  rawCodeValueProduced: false;\n  stochasticModel:\n    \"independent-poisson-photo-dark-explicit-additional-policy\";\n  deterministicSeededRealization:\n    true;\n}\n\n/**\n * Optional ADC integral non-linearity (INL): an offset in code units (LSB, least significant bit),\n * piecewise linear in the ideal continuous ADC input code, added before quantization. The points must\n * start at code 0 and end at the ADC maximum code. If omitted, the ADC is ideal and uniform.\n */\nexport interface SensorAdcIntegralNonLinearity {\n  kind: \"piecewise-linear-code-offset\";\n  knots: readonly { code: number; offsetCodes: number }[];\n  evidence: readonly EvidenceProvenance[];\n}\n\n/**\n * Optional record of how one regime's ISO gain was derived (the exposure index of CIPA DC-004,\n * relative to the base exposure index). The readout equations still use\n * systemConversionGainElectronsPerCode (analog, before the ADC) and adc.digitalGain (after the ADC).\n * This record must agree with them and never replaces them.\n */\nexport interface SensorReadoutExposureIndexGain {\n  exposureIndex: number;\n  baseExposureIndex: number;\n  /** Analog (pre-ADC) gain relative to the base-exposure-index regime. */\n  analogGain: number;\n  /** Post-ADC digital gain; equals adc.digitalGain (1 when omitted). */\n  digitalGain: number;\n  conversionGainMode:\n    | \"single-conversion-gain\"\n    | \"low-conversion-gain\"\n    | \"high-conversion-gain\";\n  evidence: readonly EvidenceProvenance[];\n}\n\nexport interface SensorElectronicReadNoiseComponent {\n  componentId: string;\n  rmsElectrons:\n    EvidenceBackedFact<number>;\n  evidence:\n    readonly EvidenceProvenance[];\n}\n\n/**\n * One explicitly selected electronic conversion regime. It has a sourced number of\n * electrons per code, an upper pre-ADC threshold in electron equivalents, separate\n * read-noise components (RMS electrons) and an unsigned ADC coding policy. The black\n * pedestal and digital saturation are in code units. The regime does not guess its\n * hardware mechanism, is not chosen from ISO automatically, and does not replace\n * physical storage capacity.\n */\nexport interface SensorReadoutConversionRegime {\n  regimeId: string;\n  scientificStatus:\n    SensorSpectralResponseScientificStatus;\n  systemConversionGainElectronsPerCode:\n    EvidenceBackedFact<number>;\n  preAdcSaturationElectronEquivalent:\n    EvidenceBackedFact<number>;\n  readNoiseComponents:\n    readonly SensorElectronicReadNoiseComponent[];\n  adc: {\n    bitDepth: number;\n    blackLevelCode: number;\n    digitalSaturationCode: number;\n    transfer:\n      \"uniform-round-half-up\";\n    /**\n     * Optional post-ADC digital gain (>= 1) applied about the black level:\n     * code = roundHalfUp((adcCode - black) * digitalGain + black). Omission means 1.\n     */\n    digitalGain?: number;\n    integralNonLinearity?:\n      SensorAdcIntegralNonLinearity;\n  };\n  exposureIndexGain?:\n    SensorReadoutExposureIndexGain;\n  evidence:\n    readonly EvidenceProvenance[];\n  limitations: readonly string[];\n}\n\nexport interface SensorReadoutConversionProfile {\n  schemaVersion:\n    typeof SENSOR_READOUT_CONVERSION_PROFILE_SCHEMA_VERSION;\n  profileId: string;\n  colorSamplingProfileId: string;\n  channelId: string;\n  regimes:\n    readonly SensorReadoutConversionRegime[];\n  regimeSelectionOwnedBy:\n    \"explicit-upstream-camera-state-not-inferred-from-iso\";\n  evidence:\n    readonly EvidenceProvenance[];\n}\n\nexport interface ResolveSensorReadoutRegimeInput {\n  profile:\n    SensorReadoutConversionProfile;\n  regimeId: string;\n}\n\nexport interface ResolvedSensorReadoutRegime {\n  profileId: string;\n  colorSamplingProfileId: string;\n  channelId: string;\n  regime:\n    SensorReadoutConversionRegime;\n  regimeSelectionOwnedBy:\n    \"explicit-upstream-camera-state-not-inferred-from-iso\";\n  adcMaximumCode: number;\n  combinedReadNoiseRmsElectrons:\n    number;\n}\n\nexport interface CalculateExpectedSensorReadoutInput {\n  accumulatedCharge:\n    SensorAccumulatedChargeComposition;\n  physicalCapacityAssessment:\n    SensorPhysicalChargeCapacityAssessment;\n  readoutProfile:\n    SensorReadoutConversionProfile;\n  regimeId: string;\n}\n\nexport interface SensorExpectedReadoutSignal {\n  readoutProfileId: string;\n  regimeId: string;\n  completenessProfileId: string;\n  capacityProfileId: string;\n  colorSamplingProfileId: string;\n  channelId: string;\n  site: {\n    x: number;\n    y: number;\n  };\n  bindingId: string;\n  expectedStoredElectronCount:\n    number;\n  expectedStoredChargeBelowOrAtPhysicalCapacity:\n    true;\n  expectedElectronEquivalentAfterPreAdcSaturation:\n    number;\n  preAdcSaturationAppliedToExpectation:\n    boolean;\n  systemConversionGainElectronsPerCode:\n    number;\n  expectedCodeBeforeBlackOffset:\n    number;\n  blackLevelCode: number;\n  /** Continuous ADC input code including any declared INL offset. */\n  expectedCodeBeforeQuantization:\n    number;\n  adcIntegralNonLinearityOffsetCodes:\n    number;\n  digitalGain: number;\n  /** Continuous code after post-ADC digital gain about black (equals the ADC input without one). */\n  expectedCodeAfterDigitalGain:\n    number;\n  adcBitDepth: number;\n  adcMaximumCode: number;\n  digitalSaturationCode: number;\n  expectedDigitalSaturation:\n    boolean;\n  electronicReadNoiseMeanElectrons:\n    0;\n  electronicReadNoiseRmsElectrons:\n    number;\n  electronicReadNoiseSampled: false;\n  adcQuantizationApplied: false;\n  rawCodeValueProduced: false;\n  isoUsedToInferRegime: false;\n}\n\nexport interface SimulateSensorRawCodeInput {\n  chargeRealization:\n    SensorChargeRealization;\n  physicalCapacityAssessment:\n    SensorPhysicalChargeCapacityAssessment;\n  readoutProfile:\n    SensorReadoutConversionProfile;\n  regimeId: string;\n  readNoiseSeedUint32: number;\n  /**\n   * Optional fixed pattern; must be the same profile used for the charge realization. Its static\n   * row/column offsets are added with read noise before the pre-ADC threshold.\n   */\n  fixedPatternNoise?:\n    SensorFixedPatternNoiseProfile;\n}\n\nexport interface SensorRawCodeSample {\n  readoutProfileId: string;\n  regimeId: string;\n  samplingProfileId: string;\n  completenessProfileId: string;\n  capacityProfileId: string;\n  colorSamplingProfileId: string;\n  channelId: string;\n  site: {\n    x: number;\n    y: number;\n  };\n  bindingId: string;\n  chargeSeedUint32: number;\n  readNoiseSeedUint32: number;\n  realizedStoredElectronEquivalentCountBeforePhysicalCapacity:\n    number;\n  physicalChargeCapacityElectrons:\n    number;\n  electronEquivalentAfterPhysicalScalarSaturation:\n    number;\n  physicalScalarSaturationApplied:\n    boolean;\n  overflowElectronEquivalentDiagnostic:\n    number;\n  bloomingModeled: false;\n  electronicReadNoiseComponents:\n    readonly {\n      componentId: string;\n      rmsElectrons: number;\n      sampledElectrons: number;\n    }[];\n  totalElectronicReadNoiseElectrons:\n    number;\n  /** Fixed-pattern profile applied at readout, or null. */\n  fixedPatternNoiseProfileId:\n    string | null;\n  /** Static fixed-pattern row + column offset in input-referred electrons (0 without a pattern). */\n  fixedPatternReadoutOffsetElectrons:\n    number;\n  electronEquivalentAfterReadNoise:\n    number;\n  preAdcSaturationElectronEquivalent:\n    number;\n  /** Signed electronic signal after the upper (pre-ADC) clip, before conversion and the black pedestal. */\n  electronEquivalentAfterPreAdcSaturation:\n    number;\n  preAdcSaturationApplied:\n    boolean;\n  systemConversionGainElectronsPerCode:\n    number;\n  blackLevelCode: number;\n  /** Continuous ADC input code including any declared integral non-linearity offset. */\n  codeBeforeQuantization:\n    number;\n  /** INL offset added before quantization (0 for an ideal ADC). */\n  adcIntegralNonLinearityOffsetCodes:\n    number;\n  /** ADC output after quantization and the ADC code-range limit, before digital gain. */\n  adcCodeBeforeDigitalGain:\n    number;\n  /** Post-ADC digital gain (1 when the regime declares none). */\n  digitalGain: number;\n  quantizedCodeBeforeDigitalClamp:\n    number;\n  adcBitDepth: number;\n  adcMaximumCode: number;\n  digitalSaturationCode: number;\n  rawCode: number;\n  digitalSaturationApplied:\n    boolean;\n  lowerCodeClampApplied:\n    boolean;\n  adcTransfer:\n    \"uniform-round-half-up\";\n  physicalSaturationApplied: boolean;\n  electronicReadNoiseApplied:\n    boolean;\n  conversionGainApplied: true;\n  adcQuantizationApplied: true;\n  rawCodeValueProduced: true;\n  isoUsedToInferRegime: false;\n  deterministicSeededRealization:\n    true;\n}\n\nfunction requireUint32(\n  value: unknown,\n  path: string\n): number {\n  if (\n    typeof value !== \"number\" ||\n    !Number.isSafeInteger(value) ||\n    value < 0 ||\n    value > 0xffff_ffff\n  ) {\n    throw new InvalidScientificInputError(\n      path +\n        \" must be an unsigned 32-bit integer.\"\n    );\n  }\n  return value;\n}\n\nexport function requireSafeInteger(\n  value: unknown,\n  path: string\n): number {\n  if (\n    typeof value !== \"number\" ||\n    !Number.isSafeInteger(value)\n  ) {\n    throw new InvalidConfigurationError(\n      path + \" must be a safe integer.\"\n    );\n  }\n  return value;\n}\n\nexport function parsePositiveFact(\n  value: unknown,\n  path: string\n): EvidenceBackedFact<number> {\n  const record =\n    requireRecord(value, path, [\"value\", \"evidence\"]);\n  return {\n    value:\n      requirePositiveFinite(\n        record.value,\n        path + \".value\"\n      ),\n    evidence:\n      parseEvidenceList(\n        record.evidence,\n        path + \".evidence\"\n      )\n  };\n}\n\nexport function parseNonNegativeFact(\n  value: unknown,\n  path: string\n): EvidenceBackedFact<number> {\n  const record =\n    requireRecord(value, path, [\"value\", \"evidence\"]);\n  return {\n    value:\n      requireNonNegativeFinite(\n        record.value,\n        path + \".value\"\n      ),\n    evidence:\n      parseEvidenceList(\n        record.evidence,\n        path + \".evidence\"\n      )\n  };\n}\n\n/**\n * Validates untrusted input and returns it as a normalized, typed value. Unknown enum values,\n * missing required fields and inconsistent scientific data are rejected.\n *\n * The profile sets how expected charge is sampled into random photo and dark counts.\n * @param value - Untrusted data. TypeScript types alone are not validation.\n * @returns The result. Success does not imply calibration.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function parseSensorChargeSamplingProfile(\n  value: unknown\n): SensorChargeSamplingProfile {\n  const record =\n    requireRecord(\n      value,\n      \"sensorChargeSamplingProfile\", [\"schemaVersion\", \"scientificStatus\", \"photoShotNoiseModel\", \"darkShotNoiseModel\", \"additionalComponentPolicies\", \"profileId\", \"completenessProfileId\", \"evidence\", \"limitations\"]\n    );\n\n  if (\n    record.schemaVersion !==\n    SENSOR_CHARGE_SAMPLING_PROFILE_SCHEMA_VERSION\n  ) {\n    throw new InvalidConfigurationError(\n      'sensorChargeSamplingProfile.schemaVersion must be \"' +\n        SENSOR_CHARGE_SAMPLING_PROFILE_SCHEMA_VERSION +\n        '\".'\n    );\n  }\n  if (\n    record.scientificStatus !==\n    \"approximation\"\n  ) {\n    throw new InvalidConfigurationError(\n      'sensorChargeSamplingProfile.scientificStatus must be \"approximation\".'\n    );\n  }\n  if (\n    record.photoShotNoiseModel !==\n      \"poisson\" ||\n    record.darkShotNoiseModel !==\n      \"poisson\"\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorChargeSamplingProfile photo/dark shot-noise models must be Poisson.\"\n    );\n  }\n  if (\n    !Array.isArray(\n      record.additionalComponentPolicies\n    )\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorChargeSamplingProfile.additionalComponentPolicies must be an array.\"\n    );\n  }\n\n  const additionalComponentPolicies =\n    record.additionalComponentPolicies.map(\n      (entry, index) => {\n        const path =\n          \"sensorChargeSamplingProfile.additionalComponentPolicies[\" +\n          index +\n          \"]\";\n        const policy =\n          requireRecord(\n            entry,\n            path, [\"model\", \"componentId\"]\n          );\n        if (\n          policy.model !==\n            \"poisson\" &&\n          policy.model !==\n            \"deterministic-expected-electron-equivalent\"\n        ) {\n          throw new InvalidConfigurationError(\n            path +\n              \".model is invalid.\"\n          );\n        }\n        return {\n          componentId:\n            requireNonEmptyString(\n              policy.componentId,\n              path +\n                \".componentId\"\n            ),\n          model:\n            policy.model\n        } as SensorAdditionalChargeSamplingPolicy;\n      }\n    );\n\n  const ids =\n    additionalComponentPolicies.map(\n      (policy) =>\n        policy.componentId\n    );\n  if (\n    new Set(ids).size !==\n    ids.length\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorChargeSamplingProfile.additionalComponentPolicies must not contain duplicate componentId values.\"\n    );\n  }\n\n  return {\n    schemaVersion:\n      SENSOR_CHARGE_SAMPLING_PROFILE_SCHEMA_VERSION,\n    profileId:\n      requireNonEmptyString(\n        record.profileId,\n        \"sensorChargeSamplingProfile.profileId\"\n      ),\n    completenessProfileId:\n      requireNonEmptyString(\n        record.completenessProfileId,\n        \"sensorChargeSamplingProfile.completenessProfileId\"\n      ),\n    scientificStatus:\n      \"approximation\",\n    photoShotNoiseModel:\n      \"poisson\",\n    darkShotNoiseModel:\n      \"poisson\",\n    additionalComponentPolicies,\n    evidence:\n      parseEvidenceList(\n        record.evidence,\n        \"sensorChargeSamplingProfile.evidence\"\n      ),\n    limitations:\n      parseLimitations(\n        record.limitations,\n        \"sensorChargeSamplingProfile.limitations\"\n      )\n  };\n}\n\nfunction parseReadNoiseComponent(\n  value: unknown,\n  path: string\n): SensorElectronicReadNoiseComponent {\n  const record =\n    requireRecord(value, path, [\"componentId\", \"rmsElectrons\", \"evidence\"]);\n  return {\n    componentId:\n      requireNonEmptyString(\n        record.componentId,\n        path + \".componentId\"\n      ),\n    rmsElectrons:\n      parseNonNegativeFact(\n        record.rmsElectrons,\n        path + \".rmsElectrons\"\n      ),\n    evidence:\n      parseEvidenceList(\n        record.evidence,\n        path + \".evidence\"\n      )\n  };\n}\n\nfunction parseIntegralNonLinearity(\n  value: unknown,\n  path: string,\n  adcMaximumCode: number\n): SensorAdcIntegralNonLinearity {\n  const record =\n    requireRecord(value, path, [\"kind\", \"knots\", \"evidence\"]);\n  if (\n    record.kind !==\n    \"piecewise-linear-code-offset\"\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        '.kind must be \"piecewise-linear-code-offset\".'\n    );\n  }\n  if (\n    !Array.isArray(record.knots) ||\n    record.knots.length < 2 ||\n    record.knots.length > 4096\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \".knots must contain 2 through 4096 knots.\"\n    );\n  }\n  const knots =\n    record.knots.map(\n      (entry: unknown, index: number) => {\n        const knot =\n          requireRecord(\n            entry,\n            path + \".knots[\" + index + \"]\", [\"code\", \"offsetCodes\"]\n          );\n        return {\n          code: requireFinite(\n            knot.code,\n            path + \".knots[\" + index + \"].code\"\n          ),\n          offsetCodes: requireFinite(\n            knot.offsetCodes,\n            path + \".knots[\" + index + \"].offsetCodes\"\n          )\n        };\n      }\n    );\n  if (\n    knots[0]!.code !== 0 ||\n    knots[knots.length - 1]!.code !==\n      adcMaximumCode ||\n    knots.some(\n      (knot, index) =>\n        index > 0 &&\n        knot.code <=\n          knots[index - 1]!.code\n    ) ||\n    knots.some(\n      (knot) =>\n        Math.abs(knot.offsetCodes) >\n        adcMaximumCode\n    )\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \".knots must strictly increase from code 0 to the ADC maximum code with bounded offsets.\"\n    );\n  }\n  return {\n    kind:\n      \"piecewise-linear-code-offset\",\n    knots,\n    evidence:\n      parseEvidenceList(\n        record.evidence,\n        path + \".evidence\"\n      )\n  };\n}\n\nfunction parseExposureIndexGain(\n  value: unknown,\n  path: string,\n  adcDigitalGain: number\n): SensorReadoutExposureIndexGain {\n  const record =\n    requireRecord(value, path, [\"exposureIndex\", \"baseExposureIndex\", \"analogGain\", \"digitalGain\", \"conversionGainMode\", \"evidence\"]);\n  const exposureIndex =\n    requirePositiveFinite(\n      record.exposureIndex,\n      path + \".exposureIndex\"\n    );\n  const baseExposureIndex =\n    requirePositiveFinite(\n      record.baseExposureIndex,\n      path + \".baseExposureIndex\"\n    );\n  const analogGain =\n    requirePositiveFinite(\n      record.analogGain,\n      path + \".analogGain\"\n    );\n  const digitalGain =\n    requirePositiveFinite(\n      record.digitalGain,\n      path + \".digitalGain\"\n    );\n  const mode =\n    record.conversionGainMode;\n  if (\n    mode !== \"single-conversion-gain\" &&\n    mode !== \"low-conversion-gain\" &&\n    mode !== \"high-conversion-gain\"\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \".conversionGainMode is invalid.\"\n    );\n  }\n  const ratio =\n    exposureIndex /\n    baseExposureIndex;\n  if (\n    digitalGain !==\n      adcDigitalGain ||\n    Math.abs(\n      analogGain * digitalGain -\n        ratio\n    ) >\n      1e-12 * ratio\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \" must satisfy analogGain x digitalGain = exposureIndex / baseExposureIndex and digitalGain = adc.digitalGain.\"\n    );\n  }\n  return {\n    exposureIndex,\n    baseExposureIndex,\n    analogGain,\n    digitalGain,\n    conversionGainMode: mode,\n    evidence:\n      parseEvidenceList(\n        record.evidence,\n        path + \".evidence\"\n      )\n  };\n}\n\nfunction parseRegime(\n  value: unknown,\n  path: string\n): SensorReadoutConversionRegime {\n  const record =\n    requireRecord(value, path, [\"adc\", \"readNoiseComponents\", \"systemConversionGainElectronsPerCode\", \"exposureIndexGain\", \"regimeId\", \"scientificStatus\", \"preAdcSaturationElectronEquivalent\", \"evidence\", \"limitations\"]);\n  const adc =\n    requireRecord(\n      record.adc,\n      path + \".adc\", [\"bitDepth\", \"blackLevelCode\", \"digitalSaturationCode\", \"transfer\", \"digitalGain\", \"integralNonLinearity\"]\n    );\n  const bitDepth =\n    requireSafeInteger(\n      adc.bitDepth,\n      path + \".adc.bitDepth\"\n    );\n  if (\n    bitDepth < 1 ||\n    bitDepth > 30\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \".adc.bitDepth must be from 1 through 30.\"\n    );\n  }\n  const adcMaximumCode =\n    2 ** bitDepth - 1;\n  const blackLevelCode =\n    requireSafeInteger(\n      adc.blackLevelCode,\n      path + \".adc.blackLevelCode\"\n    );\n  const digitalSaturationCode =\n    requireSafeInteger(\n      adc.digitalSaturationCode,\n      path +\n        \".adc.digitalSaturationCode\"\n    );\n\n  if (\n    blackLevelCode < 0 ||\n    blackLevelCode >\n      adcMaximumCode\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \".adc.blackLevelCode must lie inside the unsigned ADC code range.\"\n    );\n  }\n  if (\n    digitalSaturationCode <=\n      blackLevelCode ||\n    digitalSaturationCode >\n      adcMaximumCode\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \".adc.digitalSaturationCode must be greater than blackLevelCode and at most the ADC maximum code.\"\n    );\n  }\n  if (\n    adc.transfer !==\n    \"uniform-round-half-up\"\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        '.adc.transfer must be \"uniform-round-half-up\".'\n    );\n  }\n  if (\n    !Array.isArray(\n      record.readNoiseComponents\n    )\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \".readNoiseComponents must be an array.\"\n    );\n  }\n  const readNoiseComponents =\n    record.readNoiseComponents.map(\n      (entry, index) =>\n        parseReadNoiseComponent(\n          entry,\n          path +\n            \".readNoiseComponents[\" +\n            index +\n            \"]\"\n        )\n    );\n  const componentIds =\n    readNoiseComponents.map(\n      (entry) =>\n        entry.componentId\n    );\n  if (\n    new Set(componentIds).size !==\n    componentIds.length\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \".readNoiseComponents must not contain duplicate componentId values.\"\n    );\n  }\n\n  const digitalGain =\n    adc.digitalGain === undefined\n      ? undefined\n      : requireFinite(\n          adc.digitalGain,\n          path + \".adc.digitalGain\"\n        );\n  if (\n    digitalGain !== undefined &&\n    (digitalGain < 1 ||\n      digitalGain > 65536)\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \".adc.digitalGain must be from 1 through 65536.\"\n    );\n  }\n  const integralNonLinearity =\n    adc.integralNonLinearity === undefined\n      ? undefined\n      : parseIntegralNonLinearity(\n          adc.integralNonLinearity,\n          path + \".adc.integralNonLinearity\",\n          adcMaximumCode\n        );\n  const systemConversionGainElectronsPerCode =\n    parsePositiveFact(\n      record\n        .systemConversionGainElectronsPerCode,\n      path +\n        \".systemConversionGainElectronsPerCode\"\n    );\n  const exposureIndexGain =\n    record.exposureIndexGain === undefined\n      ? undefined\n      : parseExposureIndexGain(\n          record.exposureIndexGain,\n          path + \".exposureIndexGain\",\n          digitalGain ?? 1\n        );\n\n  return {\n    regimeId:\n      requireNonEmptyString(\n        record.regimeId,\n        path + \".regimeId\"\n      ),\n    scientificStatus:\n      parseStatus(\n        record.scientificStatus,\n        path +\n          \".scientificStatus\"\n      ),\n    systemConversionGainElectronsPerCode,\n    preAdcSaturationElectronEquivalent:\n      parsePositiveFact(\n        record\n          .preAdcSaturationElectronEquivalent,\n        path +\n          \".preAdcSaturationElectronEquivalent\"\n      ),\n    readNoiseComponents,\n    adc: {\n      bitDepth,\n      blackLevelCode,\n      digitalSaturationCode,\n      transfer:\n        \"uniform-round-half-up\",\n      ...(digitalGain === undefined\n        ? {}\n        : { digitalGain }),\n      ...(integralNonLinearity === undefined\n        ? {}\n        : { integralNonLinearity })\n    },\n    ...(exposureIndexGain === undefined\n      ? {}\n      : { exposureIndexGain }),\n    evidence:\n      parseEvidenceList(\n        record.evidence,\n        path + \".evidence\"\n      ),\n    limitations:\n      parseLimitations(\n        record.limitations,\n        path + \".limitations\"\n      )\n  };\n}\n\n/**\n * Validates untrusted input and returns it as a normalized, typed value. Unknown enum values,\n * missing required fields and inconsistent scientific data are rejected.\n *\n * The profile lists the declared conversion regimes. ISO never invents a regime.\n * @param value - Untrusted data. TypeScript types alone are not validation.\n * @returns The result. Success does not imply calibration.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function parseSensorReadoutConversionProfile(\n  value: unknown\n): SensorReadoutConversionProfile {\n  const record =\n    requireRecord(\n      value,\n      \"sensorReadoutConversionProfile\", [\"schemaVersion\", \"regimeSelectionOwnedBy\", \"regimes\", \"profileId\", \"colorSamplingProfileId\", \"channelId\", \"evidence\"]\n    );\n  if (\n    record.schemaVersion !==\n    SENSOR_READOUT_CONVERSION_PROFILE_SCHEMA_VERSION\n  ) {\n    throw new InvalidConfigurationError(\n      'sensorReadoutConversionProfile.schemaVersion must be \"' +\n        SENSOR_READOUT_CONVERSION_PROFILE_SCHEMA_VERSION +\n        '\".'\n    );\n  }\n  if (\n    record.regimeSelectionOwnedBy !==\n    \"explicit-upstream-camera-state-not-inferred-from-iso\"\n  ) {\n    throw new InvalidConfigurationError(\n      'sensorReadoutConversionProfile.regimeSelectionOwnedBy must be \"explicit-upstream-camera-state-not-inferred-from-iso\".'\n    );\n  }\n  if (\n    !Array.isArray(\n      record.regimes\n    ) ||\n    record.regimes.length === 0\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorReadoutConversionProfile.regimes must be a non-empty array.\"\n    );\n  }\n  const regimes =\n    record.regimes.map(\n      (entry, index) =>\n        parseRegime(\n          entry,\n          \"sensorReadoutConversionProfile.regimes[\" +\n            index +\n            \"]\"\n        )\n    );\n  const ids =\n    regimes.map(\n      (regime) =>\n        regime.regimeId\n    );\n  if (\n    new Set(ids).size !==\n    ids.length\n  ) {\n    throw new InvalidConfigurationError(\n      \"sensorReadoutConversionProfile.regimes must not contain duplicate regimeId values.\"\n    );\n  }\n\n  return {\n    schemaVersion:\n      SENSOR_READOUT_CONVERSION_PROFILE_SCHEMA_VERSION,\n    profileId:\n      requireNonEmptyString(\n        record.profileId,\n        \"sensorReadoutConversionProfile.profileId\"\n      ),\n    colorSamplingProfileId:\n      requireNonEmptyString(\n        record.colorSamplingProfileId,\n        \"sensorReadoutConversionProfile.colorSamplingProfileId\"\n      ),\n    channelId:\n      requireNonEmptyString(\n        record.channelId,\n        \"sensorReadoutConversionProfile.channelId\"\n      ),\n    regimes,\n    regimeSelectionOwnedBy:\n      \"explicit-upstream-camera-state-not-inferred-from-iso\",\n    evidence:\n      parseEvidenceList(\n        record.evidence,\n        \"sensorReadoutConversionProfile.evidence\"\n      )\n  };\n}\n\n/**\n * Selects a declared readout regime and checks it against the exact channel and profile identity.\n * The regime is never inferred from ISO.\n * @param input - The input; see `ResolveSensorReadoutRegimeInput` for its fields, units and coordinates.\n * @returns The result. Success does not imply calibration.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function resolveSensorReadoutRegime(\n  input:\n    ResolveSensorReadoutRegimeInput\n): ResolvedSensorReadoutRegime {\n  requireInputKeys(input, \"resolveSensorReadoutRegime\", [\"profile\", \"regimeId\"]);\n  const profile =\n    parseSensorReadoutConversionProfile(\n      input.profile\n    );\n  if (\n    typeof input.regimeId !==\n      \"string\" ||\n    input.regimeId.trim().length ===\n      0\n  ) {\n    throw new InvalidConfigurationError(\n      \"regimeId must be a non-empty string.\"\n    );\n  }\n  const regimeId =\n    input.regimeId.trim();\n  const regime =\n    profile.regimes.find(\n      (entry) =>\n        entry.regimeId === regimeId\n    );\n  if (regime === undefined) {\n    throw new InvalidScientificInputError(\n      \"regimeId is not declared by the sensor readout conversion profile.\"\n    );\n  }\n  const combinedReadNoiseRmsElectrons =\n    Math.sqrt(\n      regime.readNoiseComponents.reduce(\n        (sum, component) =>\n          sum +\n          component\n            .rmsElectrons.value *\n            component\n              .rmsElectrons.value,\n        0\n      )\n    );\n\n  return {\n    profileId:\n      profile.profileId,\n    colorSamplingProfileId:\n      profile.colorSamplingProfileId,\n    channelId:\n      profile.channelId,\n    regime,\n    regimeSelectionOwnedBy:\n      profile\n        .regimeSelectionOwnedBy,\n    adcMaximumCode:\n      2 **\n        regime.adc.bitDepth -\n      1,\n    combinedReadNoiseRmsElectrons\n  };\n}\n\nfunction validateChargeIdentity(\n  charge:\n    SensorAccumulatedChargeComposition,\n  capacity:\n    SensorPhysicalChargeCapacityAssessment,\n  readout:\n    ResolvedSensorReadoutRegime\n): true {\n  if (\n    charge.completenessProfileId !==\n      capacity\n        .completenessProfileId ||\n    charge.colorSamplingProfileId !==\n      capacity\n        .colorSamplingProfileId ||\n    charge.channelId !==\n      capacity.channelId ||\n    charge.site.x !==\n      capacity.site.x ||\n    charge.site.y !==\n      capacity.site.y ||\n    charge.bindingId !==\n      capacity.bindingId\n  ) {\n    throw new InvalidScientificInputError(\n      \"Physical capacity assessment identity must match the accumulated charge.\"\n    );\n  }\n  // The assessment copies the complete expected stored-electron total exactly from the charge it\n  // assessed. So the match must be exact: an assessment made for any other charge is out of date.\n  if (\n    charge\n      .totalExpectedStoredElectronCount !==\n    capacity\n      .totalExpectedStoredElectronCount\n  ) {\n    throw new InvalidScientificInputError(\n      \"Physical capacity assessment must be computed for the supplied accumulated charge; its total expected stored electrons differ.\"\n    );\n  }\n  if (\n    readout\n      .colorSamplingProfileId !==\n      charge.colorSamplingProfileId ||\n    readout.channelId !==\n      charge.channelId\n  ) {\n    throw new InvalidScientificInputError(\n      \"Sensor readout profile color/channel identity must match the accumulated charge.\"\n    );\n  }\n  const belowOrAtCapacity =\n    capacity\n      .totalExpectedStoredElectronCount <=\n    capacity\n      .physicalChargeCapacityElectrons;\n  if (\n    capacity\n      .expectedChargeCapacityStatus ===\n      \"above-capacity\" ||\n    !belowOrAtCapacity\n  ) {\n    throw new InvalidScientificInputError(\n      \"Expected stored charge above physical capacity cannot enter linear expected readout; the actual post-saturation stored charge is not defined by the upstream assessment.\"\n    );\n  }\n  if (\n    charge.saturationAssessed !==\n      false ||\n    charge.adcQuantizationApplied !==\n      false ||\n    charge.rawCodeValueProduced !==\n      false\n  ) {\n    throw new InvalidScientificInputError(\n      \"Sensor readout requires the unmodified accumulated-charge result.\"\n    );\n  }\n  return belowOrAtCapacity;\n}\n\nfunction additionalPolicyMap(\n  profile:\n    SensorChargeSamplingProfile,\n  charge:\n    SensorAccumulatedChargeComposition\n): ReadonlyMap<\n  string,\n  SensorAdditionalChargeSamplingPolicy\n> {\n  if (\n    profile.completenessProfileId !==\n    charge.completenessProfileId\n  ) {\n    throw new InvalidScientificInputError(\n      \"Charge sampling profile completenessProfileId must match the accumulated charge.\"\n    );\n  }\n\n  const chargeIds =\n    charge.additionalComponents.map(\n      (component) =>\n        component.componentId\n    ).sort();\n  const policyIds =\n    profile\n      .additionalComponentPolicies\n      .map(\n        (policy) =>\n          policy.componentId\n      )\n      .sort();\n\n  if (\n    chargeIds.length !==\n      policyIds.length ||\n    chargeIds.some(\n      (id, index) =>\n        id !== policyIds[index]\n    )\n  ) {\n    throw new InvalidScientificInputError(\n      \"Charge sampling profile must declare exactly one policy for every accumulated additional-charge component.\"\n    );\n  }\n\n  return new Map(\n    profile.additionalComponentPolicies.map(\n      (policy) => [\n        policy.componentId,\n        policy\n      ] as const\n    )\n  );\n}\n\ntype DeterministicRandom = DeterministicUniformStream;\n\nfunction createRandom(\n  seedUint32: number\n): DeterministicRandom {\n  return createDeterministicUniformStream(seedUint32);\n}\n\n/**\n * log(n!) for n < 256: entry n is ln 2 + ln 3 + … + ln n, summed in that order, so each entry\n * is bit-identical to summing the logarithms on demand (the partial sums of one loop).\n */\nconst SMALL_LOG_FACTORIALS = ((): Float64Array => {\n  const table = new Float64Array(256);\n  let sum = 0;\n  for (let value = 2; value < 256; value += 1) {\n    sum += Math.log(value);\n    table[value] = sum;\n  }\n  return table;\n})();\n\n/**\n * Computes log(n!) without forming the factorial, which would overflow. Small counts\n * sum the logarithms directly (read from a table of the same partial sums). Larger counts\n * use Stirling's formula with the correction terms 1/(12n) - 1/(360n³). This is internal\n * to the Poisson rejection sampler; it is not a claim about physical accuracy or uncertainty.\n */\nfunction logFactorial(\n  n: number\n): number {\n  if (n < 2) {\n    return 0;\n  }\n  if (n < 256) {\n    return SMALL_LOG_FACTORIALS[n]!;\n  }\n\n  const inverse = 1 / n;\n  const inverseCubed =\n    inverse * inverse * inverse;\n  return (\n    (n + 0.5) * Math.log(n) -\n    n +\n    0.5 *\n      Math.log(\n        2 * Math.PI\n      ) +\n    inverse / 12 -\n    inverseCubed / 360\n  );\n}\n\n/** Means at or above this use the continuity-corrected normal approximation. */\nconst POISSON_NORMAL_APPROXIMATION_MINIMUM_MEAN =\n  1e9;\n\n/**\n * Draws a nonnegative integer from a Poisson distribution with the given mean.\n *\n * - Mean 0 returns exactly 0.\n * - Mean below 30: multiply uniform random numbers until the product drops below e^(−mean).\n * - Mean from 30 to below 1e9: Hörmann's (1993) PTRS transformed rejection, comparing log\n *   probabilities to avoid overflow.\n * - Mean of 1e9 and above: a continuity-corrected normal approximation, because the log terms lose\n *   precision there.\n *\n * The same mean and random stream reproduce the same draw. Increasing the mean does not guarantee\n * that each individual draw increases. Exported internally for the lean native executor, which must\n * draw exactly as simulateSensorChargeRealization does; not exported from the package.\n */\nexport function samplePoisson(\n  mean: number,\n  random:\n    DeterministicRandom\n): number {\n  if (\n    !Number.isFinite(mean) ||\n    mean < 0\n  ) {\n    throw new InvalidScientificInputError(\n      \"Poisson mean must be finite and nonnegative.\"\n    );\n  }\n  if (mean === 0) {\n    return 0;\n  }\n\n  if (\n    mean >=\n    POISSON_NORMAL_APPROXIMATION_MINIMUM_MEAN\n  ) {\n    // Above 1e9 the log-probability terms of the rejection test reach about 1e10 and cancel badly\n    // (variance/mean is 1.012 at 1e14). Here the continuity-corrected normal approximation has a\n    // relative skewness error of 1/sqrt(mean) <= 3.2e-5 (Poisson skewness 1/sqrt(mean): NIST/SEMATECH\n    // e-Handbook of Statistical Methods, sec. 1.3.6.6.19, free; normal approximation with continuity\n    // correction: SOCR, University of Michigan, free. Also see: Johnson, Kemp & Kotz, Univariate\n    // Discrete Distributions, 3rd ed., section 4.4).\n    return Math.max(\n      0,\n      Math.floor(\n        mean +\n          Math.sqrt(mean) *\n            sampleStandardNormal(\n              random\n            ) +\n          0.5\n      )\n    );\n  }\n\n  if (mean < 30) {\n    const threshold =\n      Math.exp(-mean);\n    let product = 1;\n    let count = 0;\n    do {\n      count += 1;\n      product *=\n        random.next();\n    } while (\n      product > threshold\n    );\n    return count - 1;\n  }\n\n  const sqrtMean =\n    Math.sqrt(mean);\n  const b =\n    0.931 +\n    2.53 * sqrtMean;\n  const a =\n    -0.059 +\n    0.02483 * b;\n  const inverseAlpha =\n    1.1239 +\n    1.1328 /\n      (b - 3.4);\n  const vR =\n    0.9277 -\n    3.6224 /\n      (b - 2);\n\n  for (;;) {\n    const u =\n      random.next() - 0.5;\n    const v =\n      random.next();\n    const uS =\n      0.5 - Math.abs(u);\n    if (uS <= 0) {\n      continue;\n    }\n    const k =\n      Math.floor(\n        (2 * a / uS + b) *\n          u +\n          mean +\n          0.43\n      );\n\n    if (\n      uS >= 0.07 &&\n      v <= vR &&\n      k >= 0\n    ) {\n      return k;\n    }\n    if (\n      k < 0 ||\n      (\n        uS < 0.013 &&\n        v > uS\n      )\n    ) {\n      continue;\n    }\n\n    const lhs =\n      Math.log(\n        v *\n          inverseAlpha /\n          (a /\n            (uS * uS) +\n            b)\n      );\n    const rhs =\n      -mean +\n      k * Math.log(mean) -\n      logFactorial(k);\n\n    if (lhs <= rhs) {\n      return k;\n    }\n  }\n}\n\n/** log(n!) as `logFactorial` computes it, with the portable logarithm (`portableLog`) in place of Math.log. */\nlet portableSmallLogFactorials: Float64Array | undefined;\nfunction portableLogFactorial(n: number): number {\n  if (n < 2) return 0;\n  if (n < 256) {\n    if (!portableSmallLogFactorials) {\n      const table = new Float64Array(256);\n      let sum = 0;\n      for (let value = 2; value < 256; value += 1) { sum += portableLog(value); table[value] = sum; }\n      portableSmallLogFactorials = table;\n    }\n    return portableSmallLogFactorials[n]!;\n  }\n  const inverse = 1 / n, inverseCubed = inverse * inverse * inverse;\n  // 0.5·ln(2π), as logFactorial forms it; computed on first use, so a bundle without the portable sampler need not evaluate it.\n  portableHalfLogTwoPi ??= 0.5 * portableLog(2 * Math.PI);\n  return (n + 0.5) * portableLog(n) - n + portableHalfLogTwoPi + inverse / 12 - inverseCubed / 360;\n}\nlet portableHalfLogTwoPi: number | undefined;\n\n/**\n * Internal (not exported from the package): `samplePoisson` for one fixed mean, with the per-mean constants (e^(−mean),\n * the PTRS constants and ln mean) computed once. Each draw takes the same branch, reads the same random values and\n * forms every value with the same expressions as `samplePoisson(mean, random)`, so the draws are identical; it is for\n * callers that draw many times with one mean (the display view's AHD correction).\n *\n * With `portable` true, every exponential, logarithm and normal draw uses the engine's portable functions\n * (`portableExp`, `portableLog`, `samplePortableStandardNormal`) instead of Math.exp, Math.log and the Box–Muller of\n * Math.log/Math.cos, so the draws are the same in every JavaScript engine; they then equal `samplePoisson`'s except\n * where a comparison falls within the last-bit difference of those functions. The display view uses this form.\n */\nexport function createPoissonSampler(\n  mean: number,\n  portable = false\n): (random: DeterministicRandom) => number {\n  if (\n    !Number.isFinite(mean) ||\n    mean < 0\n  ) {\n    throw new InvalidScientificInputError(\n      \"Poisson mean must be finite and nonnegative.\"\n    );\n  }\n  if (mean === 0) {\n    return () => 0;\n  }\n  const exp = portable ? portableExp : Math.exp, log = portable ? portableLog : Math.log;\n  const logFactorialOf = portable ? portableLogFactorial : logFactorial;\n  if (\n    mean >=\n    POISSON_NORMAL_APPROXIMATION_MINIMUM_MEAN\n  ) {\n    if (!portable) return (random) => samplePoisson(mean, random);\n    const sqrtMean = Math.sqrt(mean);\n    return (random) => Math.max(0, Math.floor(mean + sqrtMean * samplePortableStandardNormal(random) + 0.5));\n  }\n  if (mean < 30) {\n    const threshold =\n      exp(-mean);\n    return (random) => {\n      let product = 1;\n      let count = 0;\n      do {\n        count += 1;\n        product *=\n          random.next();\n      } while (\n        product > threshold\n      );\n      return count - 1;\n    };\n  }\n  const sqrtMean =\n    Math.sqrt(mean);\n  const b =\n    0.931 +\n    2.53 * sqrtMean;\n  const a =\n    -0.059 +\n    0.02483 * b;\n  const inverseAlpha =\n    1.1239 +\n    1.1328 /\n      (b - 3.4);\n  const vR =\n    0.9277 -\n    3.6224 /\n      (b - 2);\n  const logMean =\n    log(mean);\n  return (random) => {\n    for (;;) {\n      const u =\n        random.next() - 0.5;\n      const v =\n        random.next();\n      const uS =\n        0.5 - Math.abs(u);\n      if (uS <= 0) {\n        continue;\n      }\n      const k =\n        Math.floor(\n          (2 * a / uS + b) *\n            u +\n            mean +\n            0.43\n        );\n      if (\n        uS >= 0.07 &&\n        v <= vR &&\n        k >= 0\n      ) {\n        return k;\n      }\n      if (\n        k < 0 ||\n        (\n          uS < 0.013 &&\n          v > uS\n        )\n      ) {\n        continue;\n      }\n      const lhs =\n        log(\n          v *\n            inverseAlpha /\n            (a /\n              (uS * uS) +\n              b)\n        );\n      const rhs =\n        -mean +\n        k * logMean -\n        logFactorialOf(k);\n      if (lhs <= rhs) {\n        return k;\n      }\n    }\n  };\n}\n\n/**\n * Internal (not exported from the package): draws `count` Poisson samples of one mean from one seeded\n * stream, exactly as the charge realization does. Used by the sampler's distribution tests.\n */\nexport function samplePoissonStreamForValidation(\n  mean: number,\n  seedUint32: number,\n  count: number\n): number[] {\n  const random =\n    createRandom(seedUint32);\n  return Array.from(\n    { length: count },\n    () =>\n      samplePoisson(\n        mean,\n        random\n      )\n  );\n}\n\n/**\n * Internal (not exported from the package): draws `count` standard normal values from one seeded\n * stream, exactly as the read-noise path does. Used by the sampler's distribution tests.\n */\nexport function sampleStandardNormalStreamForValidation(\n  seedUint32: number,\n  count: number\n): number[] {\n  const random =\n    createRandom(seedUint32);\n  return Array.from(\n    { length: count },\n    () =>\n      sampleStandardNormal(\n        random\n      )\n  );\n}\n\nfunction sampleStandardNormal(\n  random:\n    DeterministicRandom\n): number {\n  return sampleDeterministicStandardNormal(random);\n}\n\n/**\n * Draws deterministic, separately seeded Poisson counts for photo and dark charge, and applies the\n * declared policies for additional components, starting from the expected accumulated charge.\n *\n * This is steps 1–2 of the readout order (see the module notes). Physical storage saturation is\n * reported separately from later clipping.\n * @param input - The input; see `SimulateSensorChargeRealizationInput` for its fields, units and coordinates.\n * @returns The result. Success does not imply calibration.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function simulateSensorChargeRealization(\n  input:\n    SimulateSensorChargeRealizationInput\n): CalculationResult<SensorChargeRealization> {\n  requireInputKeys(input, \"simulateSensorChargeRealization\", [\"accumulatedCharge\", \"samplingProfile\", \"seedUint32\", \"fixedPatternNoise\"]);\n  const profile =\n    parseSensorChargeSamplingProfile(\n      input.samplingProfile\n    );\n  const seed =\n    requireUint32(\n      input.seedUint32,\n      \"seedUint32\"\n    );\n  const charge =\n    input.accumulatedCharge;\n\n  if (\n    charge.accumulatedChargeCompleteness !==\n      \"complete-for-physical-storage-capacity-assessment\" ||\n    charge.saturationAssessed !==\n      false ||\n    charge.adcQuantizationApplied !==\n      false ||\n    charge.rawCodeValueProduced !==\n      false\n  ) {\n    throw new InvalidScientificInputError(\n      \"Charge realization requires a complete unsaturated pre-readout accumulated-charge result.\"\n    );\n  }\n\n  const policies =\n    additionalPolicyMap(\n      profile,\n      charge\n    );\n  const pattern =\n    input.fixedPatternNoise === undefined\n      ? null\n      : fixedPatternAtSite(\n          parseSensorFixedPatternNoiseProfile(\n            input.fixedPatternNoise\n          ),\n          charge\n            .colorSamplingProfileId,\n          charge.site\n        );\n  const photoGain =\n    pattern === null\n      ? 1\n      : pattern\n          .photoResponseGainFactor;\n  const darkFactor =\n    pattern === null\n      ? 1\n      : pattern.darkCurrentFactor;\n  const photoMean =\n    pattern === null\n      ? charge\n          .photoExpectedElectronCount\n      : charge\n          .photoExpectedElectronCount *\n        photoGain;\n  const darkMean =\n    pattern === null\n      ? charge\n          .darkExpectedElectronCount\n      : charge\n          .darkExpectedElectronCount *\n        darkFactor;\n  const random =\n    createRandom(seed);\n  const photoRealized =\n    samplePoisson(\n      photoMean,\n      random\n    );\n  const darkRealized =\n    samplePoisson(\n      darkMean,\n      random\n    );\n\n  const additionalComponents =\n    charge.additionalComponents.map(\n      (component) => {\n        const policy =\n          policies.get(\n            component.componentId\n          )!;\n        const realized =\n          policy.model ===\n          \"poisson\"\n            ? samplePoisson(\n                component\n                  .expectedElectronCount,\n                random\n              )\n            : component\n                .expectedElectronCount;\n        return {\n          componentId:\n            component.componentId,\n          expectedElectronCount:\n            component\n              .expectedElectronCount,\n          realizedElectronEquivalentCount:\n            realized,\n          model:\n            policy.model\n        };\n      }\n    );\n\n  const additionalRealized =\n    additionalComponents.reduce(\n      (sum, component) =>\n        sum +\n        component\n          .realizedElectronEquivalentCount,\n      0\n    );\n  const totalRealized =\n    photoRealized +\n    darkRealized +\n    additionalRealized;\n\n  if (\n    !Number.isFinite(\n      totalRealized\n    ) ||\n    totalRealized < 0\n  ) {\n    throw new InvalidScientificInputError(\n      \"Realized stored charge must remain finite and nonnegative.\"\n    );\n  }\n\n  return approximationResult(\n    {\n      samplingProfileId:\n        profile.profileId,\n      completenessProfileId:\n        charge\n          .completenessProfileId,\n      colorSamplingProfileId:\n        charge\n          .colorSamplingProfileId,\n      channelId:\n        charge.channelId,\n      site: {\n        ...charge.site\n      },\n      bindingId:\n        charge.bindingId,\n      seedUint32:\n        seed,\n      photoExpectedElectronCount:\n        charge\n          .photoExpectedElectronCount,\n      photoRealizedElectronCount:\n        photoRealized,\n      darkExpectedElectronCount:\n        charge\n          .darkExpectedElectronCount,\n      darkRealizedElectronCount:\n        darkRealized,\n      fixedPatternNoiseProfileId:\n        pattern === null\n          ? null\n          : pattern.profileId,\n      photoResponseGainFactor:\n        photoGain,\n      darkCurrentFactor:\n        darkFactor,\n      hotPixel:\n        pattern?.hotPixel ?? false,\n      photoSampledMeanElectronCount:\n        photoMean,\n      darkSampledMeanElectronCount:\n        darkMean,\n      additionalComponents,\n      totalExpectedStoredElectronCount:\n        charge\n          .totalExpectedStoredElectronCount,\n      totalRealizedStoredElectronEquivalentCount:\n        totalRealized,\n      photoShotNoiseApplied:\n        true,\n      darkShotNoiseApplied:\n        true,\n      electronicReadNoiseApplied:\n        false,\n      physicalSaturationApplied:\n        false,\n      bloomingModeled: false,\n      conversionGainApplied:\n        false,\n      adcQuantizationApplied:\n        false,\n      rawCodeValueProduced:\n        false,\n      stochasticModel:\n        \"independent-poisson-photo-dark-explicit-additional-policy\",\n      deterministicSeededRealization:\n        true\n    },\n    \"sensor-charge-stochastic-realization\",\n    \"3.0.0\",\n    [\n      \"An optional explicit fixed-pattern profile multiplies the photo Poisson mean by the site's PRNU gain and the dark Poisson mean by its DSNU/hot-pixel factor; without one the uniform population expectation is sampled. Fixed-pattern values are deterministic per sensor instance and colour-sampling site.\",\n      \"Poisson means of 1e9 electrons and above use a continuity-corrected normal approximation.\",\n      \"Photo-generated and dark-generated electron counts are sampled independently from Poisson distributions using an explicit deterministic seed.\",\n      \"Each additional stored-charge component uses its explicitly declared Poisson or deterministic electron-equivalent policy; Photivra does not infer defect/leakage statistics from the component name.\",\n      \"This is a pre-saturation, pre-electronic-read-noise charge realization and remains separate from expectation-value calculations.\",\n      \"The seeded PRNG is a deterministic simulation mechanism and is not cryptographically secure; its seed is scrambled by the MurmurHash3 fmix32 finalizer so nearby seeds give unrelated streams.\"\n    ]\n  );\n}\n\nfunction fixedPatternAtSite(\n  profile:\n    SensorFixedPatternNoiseProfile,\n  colorSamplingProfileId: string,\n  site: { x: number; y: number }\n): SensorFixedPatternSiteValues {\n  if (\n    profile.colorSamplingProfileId !==\n    colorSamplingProfileId\n  ) {\n    throw new InvalidScientificInputError(\n      \"Fixed-pattern noise profile colour-sampling identity must match the charge.\"\n    );\n  }\n  return evaluateParsedFixedPatternSite(\n    profile,\n    site\n  );\n}\n\nfunction fixedPatternForRealization(\n  value:\n    SensorFixedPatternNoiseProfile | undefined,\n  charge:\n    SensorChargeRealization\n): SensorFixedPatternSiteValues | null {\n  if (value === undefined) {\n    if (\n      charge.fixedPatternNoiseProfileId !==\n        null &&\n      charge.fixedPatternNoiseProfileId !==\n        undefined\n    ) {\n      throw new InvalidScientificInputError(\n        \"A charge realization with a fixed pattern requires the same fixed-pattern profile at readout.\"\n      );\n    }\n    return null;\n  }\n  const profile =\n    parseSensorFixedPatternNoiseProfile(\n      value\n    );\n  if (\n    charge.fixedPatternNoiseProfileId !==\n    profile.profileId\n  ) {\n    throw new InvalidScientificInputError(\n      \"Readout fixed-pattern profile must be the profile used for the charge realization.\"\n    );\n  }\n  return fixedPatternAtSite(\n    profile,\n    charge.colorSamplingProfileId,\n    charge.site\n  );\n}\n\nfunction validateCapacityAgainstRealization(\n  charge:\n    SensorChargeRealization,\n  capacity:\n    SensorPhysicalChargeCapacityAssessment,\n  readout:\n    ResolvedSensorReadoutRegime\n): void {\n  if (\n    charge.completenessProfileId !==\n      capacity\n        .completenessProfileId ||\n    charge.colorSamplingProfileId !==\n      capacity\n        .colorSamplingProfileId ||\n    charge.channelId !==\n      capacity.channelId ||\n    charge.site.x !==\n      capacity.site.x ||\n    charge.site.y !==\n      capacity.site.y ||\n    charge.bindingId !==\n      capacity.bindingId\n  ) {\n    throw new InvalidScientificInputError(\n      \"Physical capacity assessment identity must match the charge realization.\"\n    );\n  }\n  if (\n    charge\n      .totalExpectedStoredElectronCount !==\n    capacity\n      .totalExpectedStoredElectronCount\n  ) {\n    throw new InvalidScientificInputError(\n      \"Physical capacity assessment must be computed for the charge behind the realization; its total expected stored electrons differ.\"\n    );\n  }\n  if (\n    readout\n      .colorSamplingProfileId !==\n      charge.colorSamplingProfileId ||\n    readout.channelId !==\n      charge.channelId\n  ) {\n    throw new InvalidScientificInputError(\n      \"Sensor readout profile color/channel identity must match the charge realization.\"\n    );\n  }\n}\n\n/**\n * Maps the expected charge through the declared gain, offset and readout limits, with no random\n * sampling. Each kind of clipping (physical storage, pre-ADC, digital) is reported separately.\n * @param input - The input; see `CalculateExpectedSensorReadoutInput` for its fields, units and coordinates.\n * @returns The result. Success does not imply calibration.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function calculateExpectedSensorReadout(\n  input:\n    CalculateExpectedSensorReadoutInput\n): CalculationResult<SensorExpectedReadoutSignal> {\n  requireInputKeys(input, \"calculateExpectedSensorReadout\", [\"accumulatedCharge\", \"physicalCapacityAssessment\", \"readoutProfile\", \"regimeId\"]);\n  const readout =\n    resolveSensorReadoutRegime({\n      profile:\n        input.readoutProfile,\n      regimeId:\n        input.regimeId\n    });\n  const expectedStoredChargeBelowOrAtPhysicalCapacity =\n    validateChargeIdentity(\n      input.accumulatedCharge,\n      input\n        .physicalCapacityAssessment,\n      readout\n    );\n\n  const expected =\n    input.accumulatedCharge\n      .totalExpectedStoredElectronCount;\n  const threshold =\n    readout.regime\n      .preAdcSaturationElectronEquivalent\n      .value;\n  const afterPreAdc =\n    Math.min(\n      expected,\n      threshold\n    );\n  const codeSignal =\n    afterPreAdc /\n    readout.regime\n      .systemConversionGainElectronsPerCode\n      .value;\n  const inlOffset =\n    integralNonLinearityOffset(\n      readout.regime.adc\n        .integralNonLinearity,\n      codeSignal +\n        readout.regime\n          .adc.blackLevelCode\n    );\n  const codeBeforeQuantization =\n    codeSignal +\n    readout.regime\n      .adc.blackLevelCode +\n    inlOffset;\n  const digitalGain =\n    readout.regime.adc\n      .digitalGain ?? 1;\n  const codeAfterDigitalGain =\n    readout.regime.adc\n      .digitalGain === undefined\n      ? codeBeforeQuantization\n      : (Math.min(\n          codeBeforeQuantization,\n          readout.adcMaximumCode\n        ) -\n          readout.regime.adc\n            .blackLevelCode) *\n          digitalGain +\n        readout.regime.adc\n          .blackLevelCode;\n\n  return approximationResult(\n    {\n      readoutProfileId:\n        readout.profileId,\n      regimeId:\n        readout.regime\n          .regimeId,\n      completenessProfileId:\n        input.accumulatedCharge\n          .completenessProfileId,\n      capacityProfileId:\n        input\n          .physicalCapacityAssessment\n          .capacityProfileId,\n      colorSamplingProfileId:\n        input.accumulatedCharge\n          .colorSamplingProfileId,\n      channelId:\n        input.accumulatedCharge\n          .channelId,\n      site: {\n        ...input\n          .accumulatedCharge\n          .site\n      },\n      bindingId:\n        input.accumulatedCharge\n          .bindingId,\n      expectedStoredElectronCount:\n        expected,\n      expectedStoredChargeBelowOrAtPhysicalCapacity,\n      expectedElectronEquivalentAfterPreAdcSaturation:\n        afterPreAdc,\n      preAdcSaturationAppliedToExpectation:\n        afterPreAdc < expected,\n      systemConversionGainElectronsPerCode:\n        readout.regime\n          .systemConversionGainElectronsPerCode\n          .value,\n      expectedCodeBeforeBlackOffset:\n        codeSignal,\n      blackLevelCode:\n        readout.regime\n          .adc.blackLevelCode,\n      expectedCodeBeforeQuantization:\n        codeBeforeQuantization,\n      adcIntegralNonLinearityOffsetCodes:\n        inlOffset,\n      digitalGain,\n      expectedCodeAfterDigitalGain:\n        codeAfterDigitalGain,\n      adcBitDepth:\n        readout.regime\n          .adc.bitDepth,\n      adcMaximumCode:\n        readout.adcMaximumCode,\n      digitalSaturationCode:\n        readout.regime\n          .adc\n          .digitalSaturationCode,\n      expectedDigitalSaturation:\n        codeAfterDigitalGain >=\n        readout.regime\n          .adc\n          .digitalSaturationCode,\n      electronicReadNoiseMeanElectrons:\n        0,\n      electronicReadNoiseRmsElectrons:\n        readout\n          .combinedReadNoiseRmsElectrons,\n      electronicReadNoiseSampled:\n        false,\n      adcQuantizationApplied:\n        false,\n      rawCodeValueProduced:\n        false,\n      isoUsedToInferRegime:\n        false\n    },\n    \"sensor-expected-electronic-readout\",\n    \"2.0.0\",\n    [\n      \"Expected readout uses complete expected stored charge only after the upstream physical-capacity assessment confirms the expectation is not above physical capacity.\",\n      \"Electronic read-noise mean is zero and is not sampled in this expectation result.\",\n      \"The explicitly selected conversion regime is not inferred from ISO, sensor technology family or marketing mode names; an ISO signal chain may bind an exposure index to a declared regime.\",\n      \"Declared ADC integral non-linearity and post-ADC digital gain are applied to the continuous expectation without quantization.\",\n      \"Pre-ADC electron-equivalent saturation, black offset and ADC/digital saturation remain separate domains.\",\n      \"ADC quantization is not applied to the expectation value.\"\n    ]\n  );\n}\n\n/**\n * Nearest integer, with ties going towards +infinity. Math.round is exact for every double. (In\n * contrast, floor(x + 0.5) returns 1 for 0.49999999999999994, because the addition rounds up.)\n * Adding 0 turns -0 into +0.\n */\nfunction roundHalfUp(\n  value: number\n): number {\n  return Math.round(value) + 0;\n}\n\nfunction integralNonLinearityOffset(\n  inl:\n    SensorAdcIntegralNonLinearity | undefined,\n  code: number\n): number {\n  if (inl === undefined) {\n    return 0;\n  }\n  const knots = inl.knots;\n  const first = knots[0]!;\n  const last = knots[knots.length - 1]!;\n  if (code <= first.code) {\n    return first.offsetCodes;\n  }\n  if (code >= last.code) {\n    return last.offsetCodes;\n  }\n  let low = 0;\n  let high = knots.length - 1;\n  while (high - low > 1) {\n    const middle = (low + high) >> 1;\n    if (knots[middle]!.code <= code) {\n      low = middle;\n    } else {\n      high = middle;\n    }\n  }\n  const a = knots[low]!;\n  const b = knots[high]!;\n  return (\n    a.offsetCodes +\n    ((code - a.code) /\n      (b.code - a.code)) *\n      (b.offsetCodes - a.offsetCodes)\n  );\n}\n\n/**\n * Shared ADC transfer function: continuous input code (signal/gain + black + INL), rounded half up\n * and limited to the ADC code range, then optional post-ADC digital gain about black, rounded again.\n * The caller applies the final clamp to [0, digitalSaturationCode]. Exported internally for the lean\n * native executor; not exported from the package.\n */\nexport function adcTransfer(\n  regime:\n    SensorReadoutConversionRegime,\n  adcMaximumCode: number,\n  electronEquivalent: number\n): {\n  codeBeforeQuantization: number;\n  inlOffset: number;\n  adcCode: number;\n  digitalGain: number;\n  quantized: number;\n} {\n  const ideal =\n    electronEquivalent /\n      regime\n        .systemConversionGainElectronsPerCode\n        .value +\n    regime.adc.blackLevelCode;\n  const inlOffset =\n    integralNonLinearityOffset(\n      regime.adc.integralNonLinearity,\n      ideal\n    );\n  const codeBeforeQuantization =\n    ideal + inlOffset;\n  const quantizedAdc =\n    roundHalfUp(\n      codeBeforeQuantization\n    );\n  const digitalGain =\n    regime.adc.digitalGain ?? 1;\n  if (\n    regime.adc.digitalGain ===\n    undefined\n  ) {\n    return {\n      codeBeforeQuantization,\n      inlOffset,\n      adcCode:\n        quantizedAdc,\n      digitalGain,\n      quantized:\n        quantizedAdc\n    };\n  }\n  const adcCode =\n    Math.max(\n      0,\n      Math.min(\n        quantizedAdc,\n        adcMaximumCode\n      )\n    );\n  return {\n    codeBeforeQuantization,\n    inlOffset,\n    adcCode,\n    digitalGain,\n    quantized:\n      roundHalfUp(\n        (adcCode -\n          regime.adc\n            .blackLevelCode) *\n          digitalGain +\n          regime.adc\n            .blackLevelCode\n      )\n  };\n}\n\n/**\n * Simulates one RAW code from a charge realization with the declared seed and regime: steps 3–7 of\n * the readout order (see the module notes). Signed read noise is kept through the black pedestal and\n * quantization, and only the final code is clamped. Returns the bounded native ADC code and per-step\n * diagnostics.\n * @param input - The input; see `SimulateSensorRawCodeInput` for its fields, units and coordinates.\n * @returns The result. Success does not imply calibration.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function simulateSensorRawCode(\n  input:\n    SimulateSensorRawCodeInput\n): CalculationResult<SensorRawCodeSample> {\n  requireInputKeys(input, \"simulateSensorRawCode\", [\"chargeRealization\", \"physicalCapacityAssessment\", \"readoutProfile\", \"regimeId\", \"readNoiseSeedUint32\", \"fixedPatternNoise\"]);\n  const readout =\n    resolveSensorReadoutRegime({\n      profile:\n        input.readoutProfile,\n      regimeId:\n        input.regimeId\n    });\n  validateCapacityAgainstRealization(\n    input.chargeRealization,\n    input\n      .physicalCapacityAssessment,\n    readout\n  );\n  const readNoiseSeed =\n    requireUint32(\n      input.readNoiseSeedUint32,\n      \"readNoiseSeedUint32\"\n    );\n  const random =\n    createRandom(\n      readNoiseSeed\n    );\n\n  const realized =\n    input.chargeRealization\n      .totalRealizedStoredElectronEquivalentCount;\n  if (\n    !Number.isFinite(realized) ||\n    realized < 0\n  ) {\n    throw new InvalidScientificInputError(\n      \"Charge realization total must be finite and nonnegative.\"\n    );\n  }\n\n  const physicalCapacity =\n    input\n      .physicalCapacityAssessment\n      .physicalChargeCapacityElectrons;\n  const afterPhysical =\n    Math.min(\n      realized,\n      physicalCapacity\n    );\n  const physicalSaturation =\n    afterPhysical < realized;\n  const overflow =\n    Math.max(\n      0,\n      realized -\n        physicalCapacity\n    );\n\n  const readNoiseComponents =\n    readout.regime\n      .readNoiseComponents.map(\n        (component) => {\n          const sampled =\n            component\n              .rmsElectrons.value ===\n            0\n              ? 0\n              : sampleStandardNormal(\n                  random\n                ) *\n                component\n                  .rmsElectrons.value;\n          return {\n            componentId:\n              component\n                .componentId,\n            rmsElectrons:\n              component\n                .rmsElectrons\n                .value,\n            sampledElectrons:\n              sampled\n          };\n        }\n      );\n  const totalReadNoise =\n    readNoiseComponents.reduce(\n      (sum, component) =>\n        sum +\n        component\n          .sampledElectrons,\n      0\n    );\n  const pattern =\n    fixedPatternForRealization(\n      input.fixedPatternNoise,\n      input.chargeRealization\n    );\n  const fixedPatternOffset =\n    pattern === null\n      ? 0\n      : pattern\n          .readoutOffsetElectrons;\n\n  const afterReadNoise =\n    afterPhysical +\n    totalReadNoise +\n    fixedPatternOffset;\n  const preAdcThreshold =\n    readout.regime\n      .preAdcSaturationElectronEquivalent\n      .value;\n  // Stored charge is nonnegative, but the electronic signal after it is signed.\n  // Keep negative read noise until the black pedestal and the unsigned ADC limit.\n  const afterPreAdc =\n    Math.min(\n      afterReadNoise,\n      preAdcThreshold\n    );\n  const preAdcSaturation =\n    afterReadNoise >\n    preAdcThreshold;\n\n  const transfer =\n    adcTransfer(\n      readout.regime,\n      readout.adcMaximumCode,\n      afterPreAdc\n    );\n  const codeBeforeQuantization =\n    transfer.codeBeforeQuantization;\n  const quantized =\n    transfer.quantized;\n  const rawCode =\n    Math.max(\n      0,\n      Math.min(\n        quantized,\n        readout.regime\n          .adc\n          .digitalSaturationCode\n      )\n    );\n\n  return approximationResult(\n    {\n      readoutProfileId:\n        readout.profileId,\n      regimeId:\n        readout.regime\n          .regimeId,\n      samplingProfileId:\n        input.chargeRealization\n          .samplingProfileId,\n      completenessProfileId:\n        input.chargeRealization\n          .completenessProfileId,\n      capacityProfileId:\n        input\n          .physicalCapacityAssessment\n          .capacityProfileId,\n      colorSamplingProfileId:\n        input.chargeRealization\n          .colorSamplingProfileId,\n      channelId:\n        input.chargeRealization\n          .channelId,\n      site: {\n        ...input\n          .chargeRealization.site\n      },\n      bindingId:\n        input.chargeRealization\n          .bindingId,\n      chargeSeedUint32:\n        input.chargeRealization\n          .seedUint32,\n      readNoiseSeedUint32:\n        readNoiseSeed,\n      realizedStoredElectronEquivalentCountBeforePhysicalCapacity:\n        realized,\n      physicalChargeCapacityElectrons:\n        physicalCapacity,\n      electronEquivalentAfterPhysicalScalarSaturation:\n        afterPhysical,\n      physicalScalarSaturationApplied:\n        physicalSaturation,\n      overflowElectronEquivalentDiagnostic:\n        overflow,\n      bloomingModeled: false,\n      electronicReadNoiseComponents:\n        readNoiseComponents,\n      totalElectronicReadNoiseElectrons:\n        totalReadNoise,\n      fixedPatternNoiseProfileId:\n        pattern === null\n          ? null\n          : pattern.profileId,\n      fixedPatternReadoutOffsetElectrons:\n        fixedPatternOffset,\n      electronEquivalentAfterReadNoise:\n        afterReadNoise,\n      preAdcSaturationElectronEquivalent:\n        preAdcThreshold,\n      electronEquivalentAfterPreAdcSaturation:\n        afterPreAdc,\n      preAdcSaturationApplied:\n        preAdcSaturation,\n      systemConversionGainElectronsPerCode:\n        readout.regime\n          .systemConversionGainElectronsPerCode\n          .value,\n      blackLevelCode:\n        readout.regime\n          .adc.blackLevelCode,\n      codeBeforeQuantization,\n      adcIntegralNonLinearityOffsetCodes:\n        transfer.inlOffset,\n      adcCodeBeforeDigitalGain:\n        transfer.adcCode,\n      digitalGain:\n        transfer.digitalGain,\n      quantizedCodeBeforeDigitalClamp:\n        quantized,\n      adcBitDepth:\n        readout.regime\n          .adc.bitDepth,\n      adcMaximumCode:\n        readout.adcMaximumCode,\n      digitalSaturationCode:\n        readout.regime\n          .adc\n          .digitalSaturationCode,\n      rawCode,\n      digitalSaturationApplied:\n        quantized >=\n        readout.regime\n          .adc\n          .digitalSaturationCode,\n      lowerCodeClampApplied:\n        quantized < 0,\n      adcTransfer:\n        \"uniform-round-half-up\",\n      physicalSaturationApplied:\n        physicalSaturation,\n      electronicReadNoiseApplied:\n        readNoiseComponents\n          .some(\n            (component) =>\n              component\n                .rmsElectrons >\n              0\n          ),\n      conversionGainApplied:\n        true,\n      adcQuantizationApplied:\n        true,\n      rawCodeValueProduced:\n        true,\n      isoUsedToInferRegime:\n        false,\n      deterministicSeededRealization:\n        true\n    },\n    \"sensor-raw-code-stochastic-readout\",\n    \"4.0.0\",\n    [\n      \"A stochastic stored-charge realization is scalar-clamped at the explicit physical storage capacity; this is a bounded saturation approximation and does not model blooming, neighbor transport or anti-blooming behavior.\",\n      \"Independent input-referred Gaussian electronic read-noise components, plus any declared static fixed-pattern row/column offsets, are added after physical charge saturation and before the explicit pre-ADC electron-equivalent saturation threshold.\",\n      \"System conversion gain is expressed in electrons per digital-number code unit for the explicitly selected regime; an ISO-dependent gain exists only where an explicit ISO signal chain binds the setting to a declared regime.\",\n      \"Signed electronic read noise survives the upper-only pre-ADC saturation threshold. Black level and any declared ADC integral non-linearity are added before uniform round-half-up quantization (exact ties toward +infinity); an optional post-ADC digital gain about black is re-quantized; codes are then clamped to zero/digital saturation and valid below-black codes are retained.\",\n      \"Physical storage capacity, pre-ADC saturation and digital/ADC saturation remain separate thresholds.\",\n      \"The charge seed and read-noise seed are separate deterministic simulation identities; neither is cryptographically secure.\"\n    ]\n  );\n}\n"]}

package/dist/sensor/raw-reconstruction.js

@@ -17,72 +17,10 @@ import { computeEffectiveSaturationCode } from "../capture/raw-white-level.js";
 import { parseEvidenceList } from "../core/evidence-provenance.js";
 import { InvalidScientificInputError } from "../core/validation.js";
 import { parseSensorColorSamplingProfile, resolveColorSamplingSite } from "./color-sampling.js";
-import { requireInputObject, requireInputKeys, rejectUnknownFields } from "../core/record-validation.js";
+import { requireInputObject, requireInputKeys, requireConfigRecord as requireRecord, requireTrimmedConfigString as requireNonEmptyString, requireConfigFinite as requireFinite, parseConfigScientificStatus as parseStatus, requireInputNonNegativeSafeInteger as requireNonNegativeSafeIntegerInput, parseConfigLimitations as parseLimitations } from "../core/record-validation.js";
+import { requireSafeInteger } from "./raw-readout.js";
 export const SENSOR_RAW_CAPTURE_SAMPLE_VERSION = "0.1.0";
 export const SENSOR_RAW_RECONSTRUCTION_PROFILE_SCHEMA_VERSION = "0.1.0";
-function requireRecord(value, path, allowedKeys) {
-    if (typeof value !== "object" ||
-        value === null ||
-        Array.isArray(value)) {
-        throw new InvalidConfigurationError(path + " must be an object.");
-    }
-    if (allowedKeys !== null)
-        rejectUnknownFields(value, allowedKeys, path);
-    return value;
-}
-function requireNonEmptyString(value, path) {
-    if (typeof value !== "string" ||
-        value.trim().length === 0) {
-        throw new InvalidConfigurationError(path +
-            " must be a non-empty string.");
-    }
-    return value.trim();
-}
-function requireFinite(value, path) {
-    if (typeof value !== "number" ||
-        !Number.isFinite(value)) {
-        throw new InvalidConfigurationError(path + " must be finite.");
-    }
-    return value;
-}
-function requireSafeInteger(value, path) {
-    if (typeof value !== "number" ||
-        !Number.isSafeInteger(value)) {
-        throw new InvalidConfigurationError(path + " must be a safe integer.");
-    }
-    return value;
-}
-function requireNonNegativeSafeIntegerInput(value, path) {
-    if (typeof value !== "number" ||
-        !Number.isSafeInteger(value) ||
-        value < 0) {
-        throw new InvalidScientificInputError(path +
-            " must be a non-negative safe integer.");
-    }
-    return value;
-}
-function parseLimitations(value, path) {
-    if (!Array.isArray(value)) {
-        throw new InvalidConfigurationError(path + " must be an array.");
-    }
-    const parsed = value.map((entry, index) => requireNonEmptyString(entry, path +
-        "[" +
-        index +
-        "]"));
-    if (new Set(parsed).size !==
-        parsed.length) {
-        throw new InvalidConfigurationError(path +
-            " must not contain duplicates.");
-    }
-    return parsed;
-}
-function parseStatus(value, path) {
-    if (value !== "calibrated" &&
-        value !== "approximation") {
-        throw new InvalidConfigurationError(path + " is invalid.");
-    }
-    return value;
-}
 function parseContribution(value, path) {
     const record = requireRecord(value, path, ["offsetX", "offsetY", "sourceChannelId", "weight"]);
     return {