Files

56 lines
6.5 KiB
Markdown

# The measurement chain: where each cause enters
- **Status**: draft of 2026-10-29 (point 67 of the morning-journal plan), to be reread by the user; not yet among what the analyst reads.
- **Purpose**: the why, to reason about a case that the event map does not list. The meaning of the columns is in `labeling/knowledge/displacement-columns.md`, the signatures and categories in `events/carte-des-evenements.md`; this note does not repeat them.
- **Sources**, noted in brackets: [U] the user (voice messages of 2026-10-29); [A] the AIMsight documentation (`AIMsight_agentic_support_project_context.md`, `AIMsight_reference_quality_event_explainer_roadmap.md`); [D] seen in the data (note cited); [H] Claude's hypothesis, to validate.
## 1. How a measurement is made
1. **The scene**: targets on the structure, references around it, supposed fixed.
2. **The view**: the air between the camera and the targets, and what can pass or settle in front.
3. **The image**: the lens, then the capture (IRON, or DIFF which combines several captures: `camera-images.md`).
4. **The pattern measurement**: each sensor is found in the image: `x`, `y` [px], `error_value` (recognition error, not an uncertainty); on recent cameras, the quality (`peak`, `flux`, `sharpness`, `fwhm`, `dominance`, `snr`). Above `error_threshold`, the measurement is rejected: its row stays, `corr` is empty.
5. **The compensation**: a 2D similarity (translation, rotation, scale) fitted on the references (`global_ref`) gives the camera pose (`camera/`: `pan`, `tilt`, `rotation`, `scale`, `sigma0`) and, per reference, `reproj_err` and `inlier` [A, reference §2.5].
6. **The corrected curve**: `corr_x`, `corr_y`, the position of the target once the estimated camera movement is removed (in px, probably: `displacement-columns.md`).
A displayed value is the end of this chain: find the stage that gave way [A, context §4].
## 2. Where each cause enters, and what it touches
| Stage | Cause | What it touches | Time | Witnesses |
|---|---|---|---|---|
| View (air) | fog, rain, condensation: **reduced visibility** | a drop in flux, homogeneous [U] (stronger on distant targets? [H]); `error_value` rises, rejections; raw positions without a step | hours | quality (`flux`), images |
| View (air) | **heat haze** (turbulence) | a fast noise; only when the structure really heats up; not under a bridge [U] | the hot hours | temperature, `error_value` by day versus night |
| View (obstacle) | object, leaves, snow on a target: **occultation**; passage | one or a few targets: something in front [U]; flux cut at once, neighbors intact [H]; a passage: one measurement | from one measurement to weeks | quality, images |
| Target | problem target (badly oriented, dirty, glued) | one target, lastingly | days and more | `error_value` of the target alone |
| Lens | **thermal deformation of the optics** (sun on the station) [U] | the whole image deforms [U]; a similarity does not represent a deformation: residuals organized by position in the image, `reproj_err` of the references, `corr` that depends on the target's position [H, from A, reference §2.5] | short: follows the sun on the station [U] | station temperature |
| Camera and mount | **expansion of the mount** [U]; wind, jolt, shock | raw positions of all sensors, references included, together; the compensation absorbs it (`corr` flat) or badly: `corr` follows the inflections of the camera movement (JUNGFRAU: mount or lens, the user hesitates [U]) [A, context §12.4] | specific to the mount [U] | `camera/`, station temperature |
| References | **reference hidden or less well seen** [U] | the transformation is redone without it: points shifted at once, often grouped in one part of the image; back to the recalibration, when it returns [U]; reversible [A, context §12.2]; shift that grows with the distance to the references (Barcelona [D]) | the time of the nuisance | `error_value`, `reproj_err` of the references, `sigma0`, camera pose |
| References | a reference moved | the `corr` of the targets shifted lastingly | lasting | `reproj_err` of the reference |
| Structure | **thermal expansion of the structure** [U] | `corr`, amplitude specific to each target, references stable | the longest: slow heating, late cooling [U] | air temperature (absent, see 3) |
| Structure | real movement | `corr` of one or several targets, which lasts; references and pose stable, good quality [A, context §5.8] | lasting | all the previous, at calm |
**A jump that returns** to normal is not serious: it is this return that makes it benign. Saying "jump" is not enough; the question is its cause, quite often a reference hidden or less well seen (row "References") [U].
## 3. The thermal effects
- **Three movement effects** [U]: the lens, the mount, the structure. They are told apart by their heating and cooling time, each its own; the structure is the slowest. Heat haze is apart: a noise, not a movement.
- **The cases cross** [U]: a camera placed on a bridge has two structures, the one that carries it (the mount) and the one it monitors.
- **In waves** [U]: expansion, then contraction; often stronger in Y than in X, but it depends on the orientation.
- **The temperatures available** [D, `docs/temperature/domaine/point-de-depart.md`]: those of the compute board (`sensor_*_deg_c`), inside the housing, heated by the sun and by the computing, as hourly means: a witness for the lens and the mount, not for the structure nor the air. `temperature_deg_c`, on a few stations: unknown sensor.
## 4. The reading rules
Copied from `CLAUDE.md` ("Non-negotiable rules"):
- build nothing on a binary `inlier`: RANSAC will be replaced by a weighted estimator; use continuous weights, `N_eff`, residuals, influence;
- `sigma0` alone and the number of references are never sufficient criteria;
- the image quality of a target is not the quality of the reference network; a small residual is not a well-constrained transformation [A, reference §2.1 to §2.3];
- a common-mode movement is not a structural movement; coherent references are not physically fixed references: the camera cannot prove that a network that moves as a block is fixed [A, reference §2.4] (Barcelona: `barcelona-incident.md`).
## Leads to revisit
- The order of the lens and mount times, and what separates them on the curves (point 58, question 2).
- The lens signature: deformation organized by position in the image [H].
- Reduced visibility, stronger on distant targets; occultation, flux cut at once [H]: to confirm on the stations that have the quality (point 63).
- The sensor of `temperature_deg_c` (point 59).