Files
aimsight-labeling/docs/archive/knowledge/measurement-chain.md
T

6.5 KiB

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).