fy59/lardon3d
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: freeze calibration science v2

Browse source
This commit is contained in:
fy59 2026-09-03 12:25:57 +02:00
parent cc903981ad
commit 72375078df
5 changed files with 28 additions and 16 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

12
docs/architecture/calibration_science_v2.md
View file

@ -1,6 +1,6 @@
# Calibration Science v2 — heterogeneous optics and adaptive acquisition # Calibration Science v2 — heterogeneous optics and adaptive acquisition
**Status: PLANNED — current additive design authority.** **Status: PASS/FROZEN — generic additive scientific contract.**
Calibration Science v1 remains `PASS/FROZEN`. Science v2 does not weaken, Calibration Science v1 remains `PASS/FROZEN`. Science v2 does not weaken,
reinterpret or retroactively replace v1 evidence. It defines the next reinterpret or retroactively replace v1 evidence. It defines the next
@ -11,6 +11,16 @@ configurations and normal autofocus operation.
No device-specific autofocus envelope is validated by this document. Numeric No device-specific autofocus envelope is validated by this document. Numeric
focus-domain limits require dedicated physical evidence. focus-domain limits require dedicated physical evidence.
```text
CALIBRATION_SCIENCE_V2=PASS/FROZEN
```
This freezes the generic heterogeneous-optics, adaptive-exposure and
applicability contract only. It does not validate a device-specific optical
state, focus envelope or calibration. In particular,
`A6000_E_PZ_16_50_AF_APPLICABILITY=BLOCKED_BY_PHYSICAL_VALIDATION` remains
unchanged until retained physical evidence satisfies the applicable rules.
## 1. Product/science problem ## 1. Product/science problem
A photogrammetry product must not require the operator to remember a rigid A photogrammetry product must not require the operator to remember a rigid

18
docs/roadmap/roadmap.md
View file

@ -24,7 +24,7 @@ SOURCE_COMMENT_AUDIT PASS
PRODUCT_DEFINITION PASS/FROZEN PRODUCT_DEFINITION PASS/FROZEN
PROMPT_TREE CURRENT PROMPT_TREE CURRENT
USER_FACING_UI_LANGUAGE_NORMALIZATION PASS USER_FACING_UI_LANGUAGE_NORMALIZATION PASS
CURRENT_NEXT CALIBRATION_SCIENCE_V2_DESIGN CURRENT_NEXT CALIBRATION_V2_HETEROGENEOUS_OPTICS_FOUNDATION
``` ```
The current Project DB head is additive: The current Project DB head is additive:
@ -510,10 +510,11 @@ S21 Engine Bay is permanently non-retro-calibrable under Calibration Science v1.
Calibration Science v1 defines the frozen physical protocol for its compatibility path. Calibration Science v1 defines the frozen physical protocol for its compatibility path.
Before the next physical campaign, the current dependency is Calibration Science v2. Real A6000 `CALIBRATION_SCIENCE_V2=PASS/FROZEN`: the generic additive contract now establishes
engine-bay acquisition evidence established that normal operation must support autofocus and heterogeneous optical states, adaptive photometric controls and evidence-bound autofocus
heterogeneous optical states without forcing the operator to maintain one locked focus or one optical applicability without changing Science v1. Real A6000 engine-bay acquisition evidence established
configuration for the whole project. that normal operation must support autofocus and heterogeneous optical states without forcing the
operator to maintain one locked focus or one optical configuration for the whole project.
Science v2 is additive and must preserve these product invariants: Science v2 is additive and must preserve these product invariants:
@ -527,9 +528,10 @@ autofocus is a normal supported mode when its applicability is physically valida
silent calibration substitution remains forbidden silent calibration substitution remains forbidden
``` ```
The current Sparse calibration scope already models membership as `image_id -> calibration_id`; v2 The current Sparse calibration scope already models membership as `image_id -> calibration_id`; the
should reuse that capability rather than require one global calibration. Device-specific autofocus next dependency is the additive durable heterogeneous-optics/applicability foundation, which must
envelopes remain blocked until physical evidence validates them. reuse that capability where it proves sufficient. Device-specific autofocus envelopes remain blocked
until physical evidence validates them.
Calibration Tooling v1 consumes an already acquired Science v1 evidence bundle, validates the bounded Calibration Tooling v1 consumes an already acquired Science v1 evidence bundle, validates the bounded
contract and produces deterministic `L3DCALB1` v1. contract and produces deterministic `L3DCALB1` v1.

4
prompt/02_CURRENT_FROZEN_STATE.md
View file

@ -6,7 +6,7 @@
CURRENT_PROJECT_DB_SCHEMA=v25 CURRENT_PROJECT_DB_SCHEMA=v25
PRODUCTION_TASK_KINDS=16 PRODUCTION_TASK_KINDS=16
USER_FACING_UI_LANGUAGE_NORMALIZATION=PASS USER_FACING_UI_LANGUAGE_NORMALIZATION=PASS
CURRENT_IMPLEMENTATION_CURSOR=CALIBRATION_SCIENCE_V2_DESIGN CURRENT_IMPLEMENTATION_CURSOR=CALIBRATION_V2_HETEROGENEOUS_OPTICS_FOUNDATION
``` ```
## Authority ## Authority
@ -35,7 +35,7 @@ Calibration workflow input boundary PASS/FROZEN
Calibration workflow evidence materialization PASS/FROZEN Calibration workflow evidence materialization PASS/FROZEN
Calibration workflow selected-execution binding PASS/FROZEN Calibration workflow selected-execution binding PASS/FROZEN
Calibration workflow Tooling/Bootstrap READY PASS/FROZEN Calibration workflow Tooling/Bootstrap READY PASS/FROZEN
Calibration Science v2 heterogeneous optics PLANNED Calibration Science v2 heterogeneous optics PASS/FROZEN
Adaptive capture settings semantics PLANNED Adaptive capture settings semantics PLANNED
Autofocus v2 foundation PLANNED Autofocus v2 foundation PLANNED
Calibration Tooling planarity alignment PASS/FROZEN Calibration Tooling planarity alignment PASS/FROZEN

4
prompt/12_CALIBRATION.md
View file

@ -17,11 +17,11 @@ CALIBRATION_WORKFLOW_INPUT_BOUNDARY_V1=PASS/FROZEN
CALIBRATION_WORKFLOW_EVIDENCE_MATERIALIZATION_V1=PASS/FROZEN CALIBRATION_WORKFLOW_EVIDENCE_MATERIALIZATION_V1=PASS/FROZEN
CALIBRATION_WORKFLOW_SELECTED_EXECUTION_BINDING_V1=PASS/FROZEN CALIBRATION_WORKFLOW_SELECTED_EXECUTION_BINDING_V1=PASS/FROZEN
CALIBRATION_WORKFLOW_TOOLING_BOOTSTRAP_READY_V1=PASS/FROZEN CALIBRATION_WORKFLOW_TOOLING_BOOTSTRAP_READY_V1=PASS/FROZEN
CALIBRATION_SCIENCE_V2=PLANNED CALIBRATION_SCIENCE_V2=PASS/FROZEN
CALIBRATION_V2_HETEROGENEOUS_OPTICS=PLANNED CALIBRATION_V2_HETEROGENEOUS_OPTICS=PLANNED
ADAPTIVE_CAPTURE_SETTINGS_CONTRACT=PLANNED ADAPTIVE_CAPTURE_SETTINGS_CONTRACT=PLANNED
AUTOFOCUS_V2_FOUNDATION=PLANNED AUTOFOCUS_V2_FOUNDATION=PLANNED
CURRENT_CALIBRATION_NEXT=CALIBRATION_SCIENCE_V2_DESIGN CURRENT_CALIBRATION_NEXT=CALIBRATION_V2_HETEROGENEOUS_OPTICS_FOUNDATION
``` ```
## Authority ## Authority

6
prompt/31_IMPLEMENTATION_ORDER.md
View file

@ -6,7 +6,7 @@
IMPLEMENTATION_ORDER=DEPENDENCY_DRIVEN IMPLEMENTATION_ORDER=DEPENDENCY_DRIVEN
IMPLEMENTATION_AUTHORIZATION=NO IMPLEMENTATION_AUTHORIZATION=NO
STEP_0_USER_FACING_LANGUAGE_NORMALIZATION=PASS STEP_0_USER_FACING_LANGUAGE_NORMALIZATION=PASS
CURRENT_NEXT=CALIBRATION_SCIENCE_V2_DESIGN CURRENT_NEXT=CALIBRATION_V2_HETEROGENEOUS_OPTICS_FOUNDATION
``` ```
## Authority ## Authority
@ -21,8 +21,8 @@ Default dependency order:
0. user-facing repository/UI language normalization where appropriate — PASS; 0. user-facing repository/UI language normalization where appropriate — PASS;
1. final usable Calibration Science/Tooling/Bootstrap/Workflow v1 compatibility path — PASS/FROZEN; 1. final usable Calibration Science/Tooling/Bootstrap/Workflow v1 compatibility path — PASS/FROZEN;
2. Calibration Science v2 design for heterogeneous cameras/lenses/focals, adaptive capture settings and autofocus — CURRENT; 2. Calibration Science v2 design for heterogeneous cameras/lenses/focals, adaptive capture settings and autofocus — PASS/FROZEN;
3. Calibration v2 heterogeneous-optics persistence / Tooling / Bootstrap / workflow foundation; 3. Calibration v2 heterogeneous-optics persistence / Tooling / Bootstrap / workflow foundation — CURRENT;
4. physical autofocus/optical applicability validation and dedicated calibrated real campaign; 4. physical autofocus/optical applicability validation and dedicated calibrated real campaign;
5. real Sparse SfM proof; 5. real Sparse SfM proof;
6. durable Dense/OpenMVS orchestration; 6. durable Dense/OpenMVS orchestration;