@photivra/engine 2.18.0 → 2.20.0

package/docs/USAGE.md

@@ -374,7 +374,7 @@ The actual focal length stays the physical optical quantity used by projection a
 - Focus distance is not part of conventional 35 mm-equivalent focal length. A later digital/output crop and the output resolution are also excluded.
 - If a product wants to describe the final digital framing, it should label it as output framing. It should not silently replace the optical focal length or the capture-equivalent focal length.
 
-To render a lens by its physical focal length on any sensor, give `simulateCapture()` or the display view `lens.ideal: { focalLengthMm }` with any `lens.fNumber` within `IDEAL_LENS_LIMITS` (f/0.5–f/128, 1–4000 mm; optional `widestFNumber` and `narrowestFNumber` narrow the f-number range for the automatic exposure modes): an aberration-free thin lens that is not scaled by the crop factor, unlike `lens.prime` (see docs/QUICK_START.md, "Ideal lens at any focal length and f-number").
+To render a lens by its physical focal length on any sensor, give `simulateCapture()` or the display view `lens.ideal: { focalLengthMm }` with any `lens.fNumber` within `IDEAL_LENS_LIMITS` (f/0.5–f/128, 1–4000 mm; optional `widestFNumber` and `narrowestFNumber` narrow the f-number range for the automatic exposure modes; in program the engine's program line is limited to that range, #583): an aberration-free thin lens that is not scaled by the crop factor, unlike `lens.prime` (see docs/QUICK_START.md, "Ideal lens at any focal length and f-number").
 
 `calculateImagingAreaMetrics()` provides the same canonical diagonal crop-factor calculation, independent of raster density, so other engine modules do not need to repeat that formula.
 
@@ -1058,6 +1058,30 @@ T_stack = T_1 * T_2 * ... * T_n
 
 The stack keeps each filter's identity and evidence. The combined numeric uncertainty is deliberately reported as **not propagated**, unless it is established whether the filters' errors are correlated or independent. Each filter's own uncertainty stays attached to that filter.
 
+### Exposure time with an ND filter
+
+`calculateFilteredExposureTime({ shutterSeconds, filter, shutterDialSeconds? })` (model `filtered-exposure-time` 1.0.0, #578) gives the shutter time that keeps the same exposure at the same f-number and ISO after adding one filter or a stack (`filter` takes one profile or an array in light-path order): `filteredShutterSeconds = shutterSeconds / T`, with `T` the stack's combined transmittance from `composeFrontOfLensFilterTransmission()`. It also returns `attenuationStops`, `exposureFactor` (`1/T`) and the full `filterTransmission`. With a `shutterDialSeconds` list (for example `GENERIC_THIRD_STOP_SHUTTER_SECONDS`) it adds `dial`: the nearest dial value in stops (the shorter on a tie), its exposure error in stops, and `clamped: "maximum"` when the exact time is longer than the longest dial value (use bulb).
+
+- Exact under the linear sensor model (exposure `H = E·t`); film reciprocity failure is not modelled.
+- Nominal filters vary: a "10-stop" filter (`T = 2^-10`) gives 1/125 s → 8.19 s, an ND1000 (OD 3.0, 9.97 stops) gives exactly 8 s. The result is only as good as the profile, and is an approximation whenever a profile is.
+- Generic presets: `GENERIC_ND_FILTER_PROFILES[3]`, `[6]` and `[10]` (keys in `GENERIC_ND_FILTER_STOPS`) are frozen, unbranded, spectrally flat profiles over 380–780 nm with a transmittance of exactly 2^-N (1/8, 1/64, 1/1024). They are idealized (`scientificStatus: "approximation"`, uncertainty not quantified), and any function that takes a front-of-lens filter profile accepts them. For other filters, build a profile with `parseFrontOfLensFilterProfile()`.
+- Filters are resolved at 550 nm unless `wavelengthNanometers` is given; neutral filters do not depend on it. `incidentPolarization` matters only with a polarizer in the stack.
+
+```ts
+import {
+  GENERIC_ND_FILTER_PROFILES,
+  GENERIC_THIRD_STOP_SHUTTER_SECONDS,
+  calculateFilteredExposureTime
+} from "@photivra/engine";
+
+const { value } = calculateFilteredExposureTime({
+  shutterSeconds: 1 / 125,
+  filter: GENERIC_ND_FILTER_PROFILES[10],
+  shutterDialSeconds: GENERIC_THIRD_STOP_SHUTTER_SECONDS
+});
+console.log(value.filteredShutterSeconds.toFixed(2), value.dial?.shutterSeconds); // 8.19 8
+```
+
 ### Spectral boundary
 
 Spectral filter data stays wavelength-resolved all the way through the [scene-radiance-to-sensor bridge](#scene-radiance-to-sensor-irradiance). Photivra does not turn a spectral filter into an undocumented RGB tint.
@@ -5527,6 +5551,20 @@ All modes:
 
 Flash-aware behaviour, safety shift and the program behaviour of named cameras are separate work.
 
+### The capture facade's program line and the lens's f-number range (#583)
+
+`simulateCapture()` and the display view in `exposure.mode: "program"` use an engine-authored generic line (f/16 1/2000 s … f/8
+1/125 s … f/4 1.024 s, assumption `exposure.programLine`). `resolveProgramAutoExposureMode()` refuses a line whose apertures leave
+the capability range, so with a lens range that does not hold f/4–f/16 (`lens.ideal` `widestFNumber`/`narrowestFNumber`,
+`lens.prime`, `lens.catalogue`) the facade limits the line to the range first: the line's f/4 and f/16 are clamped to the range, giving the same shape with
+the aperture held at the range's end and the shutter keeping each point's exposure (t/N², camera equation H = 0.65·L·t/N²),
+still from 1/2000 s to 1.024 s. Where both lines run, the limited line's aperture is the old one clamped in log2 to the range.
+Beyond the line's ends the resolver holds them as before. A range that holds f/4–f/16, or no range, keeps the line and its
+bytes. The limited line is recorded as its profile (id `"facade-generic-program-line-lens-range"`), with node stops measured from the
+capture's exposure anchor (f/8, 1/125 s; the same N²/t at the range's aperture nearest f/8; or, #585, that aperture at the
+body's shortest shutter when the same N²/t would need a shorter one). An approximation of a generic
+program, not a manufacturer's.
+
 ## Program Auto and Full Auto exposure
 
 Program Auto and Full Auto exposure both need a declared, versioned **program line**: a curve that says which aperture and shutter to use at each brightness level. The engine does not invent one "correct" aperture/shutter pair.
@@ -7109,6 +7147,7 @@ See [Print planning](https://github.com/Photivra/photivra/blob/main/docs/PRINT_P
 
 - `calculatePrintPlan()` says whether the native sampling is enough, and gives a compatible minimum file raster.
 - `calculatePrintSizeLimit()` distinguishes finite, unbounded and unavailable sampling limits.
+- `calculatePrintSizeLimitWithBlurAndNoise()` (2.20.0) gives the largest print at a viewing distance that still looks sharp and clean, counting blur and noise as well as pixels, and names the limiting factor ([Print size limit with blur and noise](https://github.com/Photivra/photivra/blob/main/docs/PRINT_PLANNING.md#print-size-limit-with-blur-and-noise)). An approximation.
 - Print quality and delivery are not assessed.
 
 The [regional Print detail diagnostic](https://github.com/Photivra/photivra/blob/main/docs/PRINT_DETAIL_ASSESSMENT.md) measures one declared, coherent sinusoidal fundamental in a selected linear-luminance ROI, and records the exact pipeline stage it measured. Its [validation protocol](https://github.com/Photivra/photivra/blob/main/docs/PRINT_DETAIL_VALIDATION.md) and [capability ledger](https://github.com/Photivra/photivra/blob/main/docs/validation/print-detail-capabilities.json) separate mathematical conformance from the still-blocked qualification of acquired images, renderers and perceived quality.
@@ -7478,9 +7517,12 @@ console.log(calculateGeometricFocusBreathing({
 `GENERIC_LENS_CATALOGUE` lists the engine's 30 generic primes (17 professional, 13 consumer, "PV 50 1.2 Pro", "PV 50 1.8"; Photivra's
 own designs, not real products). `resolveGenericLens` resolves one for a sensor, an f-number and a focus distance: its focal length
 (scaled by the crop factor), aperture range, close focus, projection and its character, Seidel aberrations, axial and lateral
-colour, distortion and vignetting profiles, flare, breathing and focus scatter, each a labelled approximation.
+colour, distortion and vignetting profiles, flare, breathing, focus scatter and its bokeh (`character.bokeh`, #567: the options of
+`lens.defocus` and `calculateDefocusBokehKernel`), each a labelled approximation.
 `simulateGenericLensFocusError` draws a seeded autofocus error; `createGenericLensCorrectionProfile` builds the lens's generic
-correction profile for `resolveLensCorrectionPlan`. `simulateCapture` renders a catalogue lens with `lens.catalogue`
+correction profile for `resolveLensCorrectionPlan`, which `simulateCapture` applies to its developed image with
+`output.lensCorrections` (#570; never to the RAW or the DNG), and which a DNG can carry for RAW editors as optional DNG opcodes with
+`output.dng.lensCorrectionOpcodes` (#587; the RAW codes unchanged). `simulateCapture` renders a catalogue lens with `lens.catalogue`
 ([quick start](QUICK_START.md#generic-lens-catalogue-549)); `fast: true` (or `lens: { catalogue: { kind, fast: true } }`) takes its
 fast method (#568), a labeled approximation that blends the PSF over a field grid, for interactive captures. Equations, tables and the
 chart measurements: [LENS_CATALOGUE.md](https://github.com/Photivra/photivra/blob/main/docs/LENS_CATALOGUE.md).
@@ -7742,6 +7784,12 @@ console.log(star.assumptions.filter((a) => a.kind === "default").map((a) => a.id
 console.log(star.request.siteInput(0).environment.optics.nominalFNumber);
 ```
 
+A capture can render its RAW in parallel parts (`output.region`, one call per part). `serializeSimulatedCaptureDngFromParts()`
+writes the whole frame's DNG from the parts, and `simulateCaptureFromParts()` (#571) develops the whole frame from them,
+including the whole-image stages `output.diffractionCorrection` and `output.sharpening` that a region refuses, with the same
+bytes as a whole-frame `simulateCapture()` and per-row progress (`diffraction-correction`, `sharpening`). See
+[Quick start, Developing a capture rendered in parts](QUICK_START.md#developing-a-capture-rendered-in-parts-571).
+
 ### Color charts (2.14)
 
 The engine's own [color patches](https://github.com/Photivra/photivra/blob/main/docs/COLOR_PATCHES.md) are reflectance spectra lit by the capture's illuminant. Draw the
@@ -8040,3 +8088,63 @@ console.log(share.print?.blurOnPrintMm); // 0.25 mm on the print
 - Equal shares of the frame diagonal look the same when images are shown at the same size. `calculateBlurShareOfFrame()` does not judge whether a blur is visible.
 
 See [Physics Foundation](https://github.com/Photivra/photivra/blob/main/docs/PHYSICS_FOUNDATION.md#sensor-equivalence-f-number-area-and-blur-share).
+
+## Aperture diameter and cropping to match a longer lens
+
+`calculateApertureDiameter()` gives the entrance-pupil diameter in millimetres, focal length ÷ f-number (exact by the definition of the f-number, ideal lens focused at infinity). `calculateCropToMatchFocalLength()` gives the centred crop that makes an image from a shorter lens match a longer lens's framing from the same position, and the pixels it leaves:
+
+```ts
+import { calculateApertureDiameter, calculateCropToMatchFocalLength } from "@photivra/engine";
+
+console.log(calculateApertureDiameter({ focalLengthMm: 50, fNumber: 2 }).value.entrancePupilDiameterMm); // 25
+console.log(calculateApertureDiameter({ focalLengthMm: 50, fNumber: 4 }).value.entrancePupilDiameterMm); // 12.5
+
+const crop = calculateCropToMatchFocalLength({
+  focalLengthMm: 50,
+  targetFocalLengthMm: 100,
+  pixelWidth: 6000,
+  pixelHeight: 4000
+}).value;
+
+console.log(crop.cropFactor); // 2
+console.log(crop.pixelWidth, crop.pixelHeight); // 3000 2000
+console.log(crop.megapixels, crop.sourceMegapixels); // 6 24
+```
+
+- The aperture diameter is the entrance pupil (the aperture stop seen from the front of the lens), not the diaphragm's opening. Close focus (working f-number `N·(1 + m/P)`, pupil magnification `P`) is not modelled.
+- The crop factor `target ÷ focal length` is exact for ideal rectilinear lenses focused at infinity; at close focus the matching factor is larger, `F·(d − f)/(f·(d − F))` at object distance `d` (thin lens), which is not applied. The crop is `calculateCenteredCrop()`'s (aspect ratio kept to whole pixels), and `targetFocalLengthMm` must be at least `focalLengthMm`.
+
+See [Physics Foundation](https://github.com/Photivra/photivra/blob/main/docs/PHYSICS_FOUNDATION.md#aperture-entrance-pupil-diameter).
+
+## Which limits detail: the lens or the sensor
+
+`calculateDetailLimit()` (model `detail-limit` 1.0.0, #575) answers "would a sharper lens or a denser sensor help?" for given settings. It returns the optics' resolution (MTF50 in cycles/mm, from diffraction, the lens's aberrations and any defocus), the sampling's (the Nyquist frequency 1/(2p) and, with a Bayer filter, the red and blue sites' 1/(4p)), the system MTF50, and which one limits:
+
+```ts
+import { calculateDetailLimit } from "@photivra/engine";
+
+const sensor = { widthMm: 36, heightMm: 24, pixelWidth: 6000 }; // 6 µm pixels
+
+const stoppedDown = calculateDetailLimit({ sensor, lens: { kind: "ideal", focalLengthMm: 50 }, fNumber: 22 }).value;
+console.log(stoppedDown.limitedBy, stoppedDown.limitingFactor); // "lens" "diffraction"
+console.log(stoppedDown.optics.mtf50CyclesPerMm); // ≈ 33.4, against a Nyquist frequency of ≈ 83.3
+console.log(stoppedDown.diffractionLimitedFNumber); // ≈ 8.8: from here on diffraction limits on this sensor
+
+const wideOpen = calculateDetailLimit({ sensor, lens: { kind: "catalogue", lensId: "pv-50-1.2-pro" }, fNumber: 4 }).value;
+console.log(wideOpen.limitedBy, wideOpen.limitingFactor); // "sensor" "pixel-pitch"
+
+const outOfFocus = calculateDetailLimit({
+  sensor,
+  lens: { kind: "ideal", focalLengthMm: 50 },
+  fNumber: 2,
+  focus: { focusDistanceM: 3, subjectDistanceM: 2.5 }
+}).value;
+console.log(outOfFocus.limitingFactor); // "defocus"
+```
+
+- The sensor limits when the optics still pass 50 % contrast at the Nyquist frequency (`opticsToNyquistRatio ≥ 1`): a denser sensor would record finer detail. Otherwise the lens limits, through `"diffraction"` when its RMS wavefront error is within λ/14 (the Maréchal criterion), else `"aberrations"` or `"defocus"`, whichever is larger. This rule is an approximation; the MTF values are the exact scalar OTF of the stated wavefront at one wavelength (550 nm unless `wavelengthNm` is given).
+- `lens.catalogue` lenses use their generic Seidel aberrations at `fieldPosition` (0 the center, 1 the corner), so corners are softer; `lens.ideal` has none.
+- Tangential and sagittal MTF50 are both reported; the decision uses the lower one.
+- Demosaicing, sharpening, noise and motion are not included.
+
+See [Physics Foundation](https://github.com/Photivra/photivra/blob/main/docs/PHYSICS_FOUNDATION.md#which-limits-detail-the-lens-or-the-sensor).

package/docs/api/capture-native-raw-dng.md

@@ -82,5 +82,11 @@ export interface SerializeNativeRawDngInput {
   capturedAtUtc?: string;
   /** Optional (2.4) caller text: description, software, copyright, comment (see the module notes). If omitted, no text is added. */
   textMetadata?: OutputTextMetadata;
+  /**
+   * Optional (#587) OpcodeList3 (tag 51022) bytes, for example `createDngLensCorrectionOpcodes(...).opcodeList3`: a big-endian DNG
+   * opcode list (DNG 1.3.0.0+, "Opcode List Processing") that readers apply to the demosaiced stage-3 image. Only its framing is
+   * checked (count, per-opcode headers and parameter sizes filling the bytes exactly). The RAW codes are unchanged. If omitted, no tag.
+   */
+  opcodeList3?: Uint8Array;
 }
 ```

package/docs/api/core-version.md

@@ -11,5 +11,5 @@ version they were made with. Proof-of-concept (POC), schema and model contracts
 own versions. Release checks confirm it matches package.json and the packed package.
 
 ```ts
-ENGINE_API_VERSION = "2.18.0" as const
+ENGINE_API_VERSION = "2.20.0" as const
 ```

package/docs/api/equipment-generic-lens-catalogue.md

@@ -69,7 +69,7 @@ export interface GenericLensCatalogueEntry {
   note: string;
   /**
    * A short plain-English summary of the lens's character (at most 40 characters, US spelling), written from its adjustments and
-   * `note`, for lists and pickers. It describes only what the catalogue models (bokeh shape is not modeled: the defocus is a disc).
+   * `note`, for lists and pickers. It describes the lens's sharpness, color, distortion and falloff, not its bokeh (the same rule for every lens of a set).
    */
   summary: string;
 }
@@ -102,6 +102,11 @@ export interface GenericLensCharacter {
   breathing: { fieldOfViewChange: number; atMinimumFocus: number };
   /** Standard deviation of the autofocus error as a fraction of the depth of focus 2·N·c. */
   focusScatterDepthOfFocusFraction: number;
+  /**
+   * Bokeh character (#567) at this f-number, focus and sensor, as the options of `lens.defocus` and `calculateDefocusBokehKernel`
+   * (#553): blades, the resolved W040 as `sphericalAberration` (µm at this f-number) and, for fast wides and normals, `catsEye`.
+   */
+  bokeh: DefocusBokehOptions;
 }
 ```
 
@@ -127,7 +132,7 @@ export interface GenericLensCharacterValues {
   distortionMagnitude: number;
   /** Corner fall-off in stops that stays when stopped down (natural vignetting). */
   naturalVignettingStops: number;
-  /** Extra corner fall-off in stops at the widest aperture (optical vignetting); gone two stops down. */
+  /** Extra corner fall-off in stops at the widest aperture (optical vignetting); gone four stops down (N = 4·N0). */
   opticalVignettingStops: number;
   /** Veiling glare: the fraction of the image's mean irradiance spread as a uniform veil. */
   veilingGlareFraction: number;

package/docs/api/exports.json

@@ -1,6 +1,6 @@
 {
-  "packageVersion": "2.18.0",
-  "engineApiVersion": "2.18.0",
+  "packageVersion": "2.20.0",
+  "engineApiVersion": "2.20.0",
   "exports": [
     {
       "name": "AbsoluteUncertaintyEstimate",
@@ -77,6 +77,11 @@
       "source": "src/sensor/optical-stack.ts",
       "kind": "type"
     },
+    {
+      "name": "ApertureDiameter",
+      "source": "src/optics/aperture-diameter.ts",
+      "kind": "type"
+    },
     {
       "name": "AperturePriorityAutoIsoExposureModeResolution",
       "source": "src/exposure/exposure-mode-resolver.ts",
@@ -362,6 +367,16 @@
       "source": "src/optics/diffraction.ts",
       "kind": "type"
     },
+    {
+      "name": "calculateApertureDiameter",
+      "source": "src/optics/aperture-diameter.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "CalculateApertureDiameterInput",
+      "source": "src/optics/aperture-diameter.ts",
+      "kind": "type"
+    },
     {
       "name": "calculateAtmosphericHaze",
       "source": "src/optics/atmospheric-haze.ts",
@@ -582,6 +597,16 @@
       "source": "src/color/illuminants.ts",
       "kind": "runtime"
     },
+    {
+      "name": "calculateCropToMatchFocalLength",
+      "source": "src/output/crop-to-match-focal-length.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "CalculateCropToMatchFocalLengthInput",
+      "source": "src/output/crop-to-match-focal-length.ts",
+      "kind": "type"
+    },
     {
       "name": "calculateDefocusBokehKernel",
       "source": "src/optics/defocus-bokeh-kernel.ts",
@@ -632,6 +657,16 @@
       "source": "src/optics/depth-of-field.ts",
       "kind": "type"
     },
+    {
+      "name": "calculateDetailLimit",
+      "source": "src/optics/detail-limit.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "CalculateDetailLimitInput",
+      "source": "src/optics/detail-limit.ts",
+      "kind": "type"
+    },
     {
       "name": "calculatedResult",
       "source": "src/core/calculation-result.ts",
@@ -732,6 +767,16 @@
       "source": "src/camera/field-of-view.ts",
       "kind": "type"
     },
+    {
+      "name": "calculateFilteredExposureTime",
+      "source": "src/exposure/filtered-exposure-time.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "CalculateFilteredExposureTimeInput",
+      "source": "src/exposure/filtered-exposure-time.ts",
+      "kind": "type"
+    },
     {
       "name": "calculateFlashGuideNumber",
       "source": "src/exposure/flash-ttl.ts",
@@ -1142,6 +1187,11 @@
       "source": "src/output/print-plan.ts",
       "kind": "runtime"
     },
+    {
+      "name": "calculatePrintSizeLimitWithBlurAndNoise",
+      "source": "src/output/print-size-blur-noise.ts",
+      "kind": "runtime"
+    },
     {
       "name": "calculateProcessedSensorRaw",
       "source": "src/capture/photographic-export.ts",
@@ -2742,6 +2792,11 @@
       "source": "src/optics/zernike-wavefront.ts",
       "kind": "type"
     },
+    {
+      "name": "CropToMatchFocalLength",
+      "source": "src/output/crop-to-match-focal-length.ts",
+      "kind": "type"
+    },
     {
       "name": "DeadLeavesChartScene",
       "source": "src/facade/chart-scenes.ts",
@@ -2812,6 +2867,56 @@
       "source": "src/optics/depth-of-field.ts",
       "kind": "type"
     },
+    {
+      "name": "DETAIL_LIMIT_LIMITS",
+      "source": "src/optics/detail-limit.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "DetailLimit",
+      "source": "src/optics/detail-limit.ts",
+      "kind": "type"
+    },
+    {
+      "name": "DetailLimitBasis",
+      "source": "src/optics/detail-limit.ts",
+      "kind": "type"
+    },
+    {
+      "name": "DetailLimitCatalogueLens",
+      "source": "src/optics/detail-limit.ts",
+      "kind": "type"
+    },
+    {
+      "name": "DetailLimitedBy",
+      "source": "src/optics/detail-limit.ts",
+      "kind": "type"
+    },
+    {
+      "name": "DetailLimitIdealLens",
+      "source": "src/optics/detail-limit.ts",
+      "kind": "type"
+    },
+    {
+      "name": "DetailLimitingFactor",
+      "source": "src/optics/detail-limit.ts",
+      "kind": "type"
+    },
+    {
+      "name": "DetailLimitOptics",
+      "source": "src/optics/detail-limit.ts",
+      "kind": "type"
+    },
+    {
+      "name": "DetailLimitSampling",
+      "source": "src/optics/detail-limit.ts",
+      "kind": "type"
+    },
+    {
+      "name": "DetailLimitSystem",
+      "source": "src/optics/detail-limit.ts",
+      "kind": "type"
+    },
     {
       "name": "DIFFRACTION_LIMITED_PSF_PROFILE_LIMITS",
       "source": "src/optics/diffraction-psf-profile.ts",
@@ -3317,6 +3422,21 @@
       "source": "src/camera/field-of-view.ts",
       "kind": "type"
     },
+    {
+      "name": "FILTERED_EXPOSURE_DEFAULT_WAVELENGTH_NANOMETERS",
+      "source": "src/exposure/filtered-exposure-time.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "FilteredExposureDialSetting",
+      "source": "src/exposure/filtered-exposure-time.ts",
+      "kind": "type"
+    },
+    {
+      "name": "FilteredExposureTime",
+      "source": "src/exposure/filtered-exposure-time.ts",
+      "kind": "type"
+    },
     {
       "name": "FixedMultiFrameCaptureAcquisition",
       "source": "src/sensor/capture-mode.ts",
@@ -3584,7 +3704,7 @@
     },
     {
       "name": "GENERIC_LENS_CORRECTION_CHANNEL_WAVELENGTHS_NM",
-      "source": "src/output/generic-lens-corrections.ts",
+      "source": "src/output/developed-lens-corrections.ts",
       "kind": "runtime"
     },
     {
@@ -3597,6 +3717,16 @@
       "source": "src/equipment/generic-lens-catalogue.ts",
       "kind": "runtime"
     },
+    {
+      "name": "GENERIC_ND_FILTER_PROFILES",
+      "source": "src/optics/generic-nd-filter-presets.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "GENERIC_ND_FILTER_STOPS",
+      "source": "src/optics/generic-nd-filter-presets.ts",
+      "kind": "runtime"
+    },
     {
       "name": "GENERIC_PRIME_EQUIVALENT_FOCAL_LENGTHS_MM",
       "source": "src/equipment/generic-prime-lenses.ts",
@@ -3747,6 +3877,11 @@
       "source": "src/equipment/generic-lens-catalogue.ts",
       "kind": "type"
     },
+    {
+      "name": "GenericNdFilterStops",
+      "source": "src/optics/generic-nd-filter-presets.ts",
+      "kind": "type"
+    },
     {
       "name": "GenericOpticalEvidence",
       "source": "src/optics/profile-contract.ts",
@@ -5927,6 +6062,11 @@
       "source": "src/output/print-region-statistics.ts",
       "kind": "runtime"
     },
+    {
+      "name": "PrintBlurInput",
+      "source": "src/output/print-size-blur-noise.ts",
+      "kind": "type"
+    },
     {
       "name": "PrintContrastReference",
       "source": "src/output/print-contrast-reference.ts",
@@ -5952,6 +6092,11 @@
       "source": "src/output/print-plan.ts",
       "kind": "type"
     },
+    {
+      "name": "PrintImageMm",
+      "source": "src/output/print-size-blur-noise.ts",
+      "kind": "type"
+    },
     {
       "name": "PrintJpegInput",
       "source": "src/output/print-jpeg.ts",
@@ -6007,6 +6152,11 @@
       "source": "src/output/print-plan.ts",
       "kind": "type"
     },
+    {
+      "name": "PrintNoiseInput",
+      "source": "src/output/print-size-blur-noise.ts",
+      "kind": "type"
+    },
     {
       "name": "PrintPlan",
       "source": "src/output/print-plan.ts",
@@ -6072,6 +6222,11 @@
       "source": "src/output/print-plan.ts",
       "kind": "type"
     },
+    {
+      "name": "PrintSharpCleanCriterion",
+      "source": "src/output/print-size-blur-noise.ts",
+      "kind": "type"
+    },
     {
       "name": "PrintSinusoidalMeasurement",
       "source": "src/output/print-detail.ts",
@@ -6092,6 +6247,16 @@
       "source": "src/output/print-plan.ts",
       "kind": "type"
     },
+    {
+      "name": "PrintSizeLimitWithBlurAndNoise",
+      "source": "src/output/print-size-blur-noise.ts",
+      "kind": "type"
+    },
+    {
+      "name": "PrintSizeLimitWithBlurAndNoiseInput",
+      "source": "src/output/print-size-blur-noise.ts",
+      "kind": "type"
+    },
     {
       "name": "PROCESSED_SENSOR_RAW_MODEL_VERSION",
       "source": "src/capture/photographic-export.ts",
@@ -8472,6 +8637,11 @@
       "source": "src/facade/simulate-capture.ts",
       "kind": "runtime"
     },
+    {
+      "name": "SIMULATE_CAPTURE_FAST_METHODS",
+      "source": "src/facade/fast-methods.ts",
+      "kind": "runtime"
+    },
     {
       "name": "SIMULATE_CAPTURE_FAST_OPTIONS",
       "source": "src/facade/simulate-capture.ts",
@@ -8562,6 +8732,11 @@
       "source": "src/facade/simulate-capture.ts",
       "kind": "type"
     },
+    {
+      "name": "SimulateCaptureFastMethod",
+      "source": "src/facade/fast-methods.ts",
+      "kind": "type"
+    },
     {
       "name": "SimulateCaptureFastOption",
       "source": "src/facade/simulate-capture.ts",
@@ -8572,11 +8747,21 @@
       "source": "src/facade/simulate-capture.ts",
       "kind": "type"
     },
+    {
+      "name": "simulateCaptureFromParts",
+      "source": "src/facade/develop-joined-parts.ts",
+      "kind": "runtime"
+    },
     {
       "name": "SimulateCaptureLensCatalogueRecord",
       "source": "src/facade/simulate-capture.ts",
       "kind": "type"
     },
+    {
+      "name": "SimulateCaptureLensCorrections",
+      "source": "src/facade/simulate-capture.ts",
+      "kind": "type"
+    },
     {
       "name": "SimulateCaptureLensDistortion",
       "source": "src/facade/simulate-capture.ts",
@@ -8592,6 +8777,11 @@
       "source": "src/facade/simulate-capture.ts",
       "kind": "type"
     },
+    {
+      "name": "SimulateCaptureNoiseComponents",
+      "source": "src/sensor/sensor-characteristics.ts",
+      "kind": "type"
+    },
     {
       "name": "SimulateCaptureOptions",
       "source": "src/facade/simulate-capture.ts",
@@ -8622,6 +8812,16 @@
       "source": "src/facade/simulate-capture.ts",
       "kind": "type"
     },
+    {
+      "name": "SimulateCaptureSensorCharacteristics",
+      "source": "src/sensor/sensor-characteristics.ts",
+      "kind": "type"
+    },
+    {
+      "name": "SimulateCaptureSensorReport",
+      "source": "src/sensor/sensor-characteristics.ts",
+      "kind": "type"
+    },
     {
       "name": "SimulateCaptureSharpening",
       "source": "src/facade/simulate-capture.ts",