fy59/lardon3d
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
lardon3d/prompt/12_CALIBRATION.md

6.9 KiB
Raw Blame History

12 — Calibration

Status

CALIBRATION_SCIENCE_V1=PASS/FROZEN
CALIBRATION_TOOLING_V1=PASS/FROZEN
CALIBRATION_TOOLING_PLANARITY_ALIGNMENT=PASS/FROZEN
CALIBRATION_BOOTSTRAP_V1=PASS/FROZEN
CALIBRATION_EVIDENCE_SOLVER_V1=IMPLEMENTED/VALIDATED
CALIBRATION_SOLVER_WHITE_BORDER_V1=PASS/FROZEN
CALIBRATION_SOLVER_PRODUCER_IDENTITY_V1=PASS/FROZEN
CALIBRATION_SOLVER_PER_VIEW_EVIDENCE_V1=PASS/FROZEN
CALIBRATION_SOLVER_BUNDLE_REPAIR_V1=PASS/FROZEN
CALIBRATION_WORKFLOW=PASS/FROZEN
CALIBRATION_WORKFLOW_INPUT_BOUNDARY_V1=PASS/FROZEN
CALIBRATION_WORKFLOW_EVIDENCE_MATERIALIZATION_V1=PASS/FROZEN
CALIBRATION_WORKFLOW_SELECTED_EXECUTION_BINDING_V1=PASS/FROZEN
CALIBRATION_WORKFLOW_TOOLING_BOOTSTRAP_READY_V1=PASS/FROZEN
CALIBRATION_SCIENCE_V2=PASS/FROZEN
CALIBRATION_V2_HETEROGENEOUS_OPTICS=PASS/FROZEN
CALIBRATION_V2_HETEROGENEOUS_CALIBRATION_PUBLICATION=PASS/FROZEN
CALIBRATION_V2_WORKFLOW_READY=PASS/FROZEN
ADAPTIVE_CAPTURE_SETTINGS_CONTRACT=PASS/FROZEN
AUTOFOCUS_V2_FOUNDATION=PASS/FROZEN
CALIBRATION_AF_STUDY_EVIDENCE_V1=PASS/FROZEN
CALIBRATION_AF_STUDY_WORKFLOW_BRIDGE_V1=PASS/FROZEN
CALIBRATION_AF_STUDY_ASSEMBLY_V1=PASS/FROZEN
CURRENT_CALIBRATION_NEXT=PHYSICAL_AUTOFOCUS_OPTICAL_APPLICABILITY_VALIDATION

Authority

docs/architecture/calibration_science_v1.md, docs/architecture/calibration_science_v2.md, docs/architecture/calibration_bootstrap.md and docs/architecture/calibration_solver_preflight_v1.md are the current specialized calibration documents. Science v1 remains FROZEN; the v2 document is the current additive design authority until its contract is validated and frozen.

docs/architecture/calibration_tooling.md is the specialized Tooling authority.

docs/architecture/calibration_workflow.md is the specialized workflow authority. Its public API is include/lardon3d/calibration_workflow.h; the FROZEN Tooling API remains include/lardon3d/calibration_tooling.h.

A bounded corrective review established that Calibration Science v1 defines target planarity as a categorical physical attestation, not a numeric flatness tolerance. Tooling preserves its public structure layout while requiring target_flatness_mm to be NaN, so callers cannot invent a millimetre measurement. The canonical session's planarity PASS <sha256> evidence is bound through immutable initialization evidence.

The external tools/calibration_evidence_solver/ implementation is present and validated by its deterministic synthetic CPU1 self-test. It remains external to the Lardon3D runtime and Project DB.

Its session v1 now requires an explicit measured white_border of at least 30 mm. No default border width may be invented by the solver or the future coordinator.

CURRENT

Historical S21 and A6000 Engine Bay campaigns:

CALIBRATION_UNAVAILABLE
BLOCKED_BY_KNOWN_CALIBRATION_DATA

Do not retro-calibrate them by invention.

Calibration Science v2 product requirements

Science v2 is additive. It does not weaken or rewrite Science v1.

The product requirement is:

ONE_PROJECT_MAY_MIX_CAMERAS=YES
ONE_PROJECT_MAY_MIX_LENSES=YES
ONE_PROJECT_MAY_MIX_FOCAL_CONFIGURATIONS=YES
PER_IMAGE_COMPATIBLE_CALIBRATION=REQUIRED

AUTOFOCUS_NORMAL_OPERATION=SUPPORTED_TARGET
MANUAL_FOCUS_LOCK_REQUIRED_FOR_NORMAL_CAPTURE=NO

SHUTTER_SPEED_FIXED=NO
ISO_FIXED=NO
WHITE_BALANCE_FIXED=NO
EXPOSURE_SETTINGS_ADAPTIVE=YES

PHOTO_REJECTION_BASED_SOLELY_ON_EXPOSURE_METADATA=FORBIDDEN
UNKNOWN_OPTICS_REJECT_CAPTURE=NO
UNKNOWN_OPTICS_STATE=CALIBRATION_REQUIRED

SILENT_CALIBRATION_SUBSTITUTION=FORBIDDEN

The core separation is:

CAPTURE / PHOTO QUALITY
!=
CALIBRATION READINESS

A Capture may be sharp, non-clipped and scientifically useful as image data while still being CALIBRATION_REQUIRED. It remains durable in the project.

Purely photometric settings such as shutter speed, ISO, white balance and exposure compensation may vary according to conditions. Their numeric values alone are not scientific rejection criteria. Actual decoded-image evidence remains authoritative for quality: sharpness/defocus/motion blur, clipping, usable tonal information, contrast/texture, noise or local SNR where available, and downstream feature usability.

Camera/lens/focal/focus/aperture/stabilization/crop/pipeline state is treated according to whether it can alter geometry. Lardon3D must observe and classify that state, automatically select an exactly compatible validated calibration when one exists, expose CALIBRATION_REQUIRED when none exists, and expose SELECTION_REQUIRED when compatibility remains ambiguous.

Autofocus is a normal v2 acquisition mode. A real autofocus applicability envelope must be supported only by physical calibration/hold-out evidence. Historical EXIF or MakerNote focus observations may guide experiment design but must never fabricate such evidence.

See docs/architecture/calibration_science_v2.md.

FROZEN v1 flow

dedicated physical calibration acquisition
-> external OpenCV 5.x Calibration Evidence Solver v1
-> immutable session manifest + complete solver bundle
-> workflow coordinator
-> Calibration Tooling v1
-> deterministic L3DCALB1 v1
-> Calibration Bootstrap v1
-> exact selected-execution calibration scope attachment
-> READY
-> real Sparse SfM

The workflow coordinator now has three PASS/FROZEN non-mutating checkpoints. Input Boundary v1 validates immutable files, hashes, formats and complete optical-state equality. Evidence Materialization v1 parses the retained session and solver bundle into bounded Science v1 target, per-view, coordinate, repeated-solve, fit, residual, hold-out and provenance evidence without opening Project DB. Selected Execution Binding v1 is read-only: it proves the exact selected execution and Capture mapping, explicit optical configuration, managed representation size/SHA-256, safe project-relative file containment, decoded geometry dimensions, and deterministic Lardon3DCalibrationToolingEntry construction. Missing or mismatched evidence is rejected; nothing is inferred. The final remaining boundary composes the validated binding with the FROZEN Tooling and Bootstrap import path to reach truthful READY.

REQUIRED_PRODUCT_TARGET

The TUI calibration assistant must expose:

READY
CALIBRATION_REQUIRED
SELECTION_REQUIRED

It must guide physical evidence acquisition, exact optical configuration, accepted/rejected evidence and remaining evidence requirements.

Solver exit success is never sufficient acceptance.

REJECTED

Pseudo-calibration, EXIF calibration, nearby focal substitution, lens substitution, silent interpolation, silent backfill, and silent identity inference.

Canonical-reference rule

When implementation enters this area, read the cited canonical document in full before editing. If this prompt summary and the canonical document appear to conflict, do not silently choose the shorter text: determine whether this file is stale or whether a real contract contradiction exists, then apply the STOP rules where necessary.