# Colonnes des déplacements (cas d'usage suivant) D'après la FAQ, les colonnes de l'export CSV sont préfixées par la cible (ex. `target_06_rch`) : - `rch` / `rcv` : déplacement corrigé du mouvement de la caméra [mm]. C'est le signal principal. - `x` / `y` : position brute dans l'image [px]. - `rx` / `ry` : déplacement relatif avant correction caméra. **Ce n'est pas** `x - x0`. - `error` : erreur de reconnaissance de la cible, **pas** une incertitude. Seuil par défaut : 0,7. - `camera_pan|tilt|rotation` [deg], `camera_scale`, `camera_sigma0` (résidu du fit du réseau de références). - `inlier_{ch}`, `reproj_err_{ch}` : contribution et résidu de chaque référence. - Sharpness, FWHM, Dominance, Peak Intensity, Flux, SNR : dans l'export « advanced » des caméras récentes seulement (voir plus bas) ; définitions : `metriques-de-qualite.md`. ## Exports reçus (PS des Coudres, D-045) Deux autres formats, observés sur les données (pas documentés dans la FAQ) : - **« advanced »** (`_advanced__.csv`), la source des analyses : une ligne par capteur et par mesure, à la cadence native (15 min, 10 min selon la station), `time_utc` en UTC explicite. - `sensor_name`, `pattern_type` (`global_ref` pour une référence de la compensation ; `ref` pour une *local reference*, traitée comme une cible, hors compensation, d'après le manuel de la station et sans `reproj_err`, vu sur NORDEND), `x` / `y` [px], `error_value`, `error_threshold` (propre à chaque capteur : 0,3 à 0,7) ; - `x` / `y` ne sont pas le centroïde de la tache dans l'image (NORDEND, 2026-10-16) : de jour (12:30 UTC, sept jours), centroïde − (`x`, `y`) est constant par capteur et diffère d'un capteur à l'autre (PR17 −2,5 / −0,5 px, PR18 −3,1 / +1,6, PR16 −5,8 / −0,1, CTR02 −1,4 / −2,4, CTR04 −1,0 / −1,4). Centroïde pondéré au-dessus de la médiane d'un cadre de ±20 px, sur une fenêtre de ±8 px. De nuit, la tache est saturée et l'écart change (PR17 −0,7 à −1,3 px en x). Hypothèse : `x`, `y` désignent la position du motif de référence (manuel de la station), pas la tache elle-même. - `relative_x` / `relative_y` (vraisemblablement `rx` / `ry`), `corr_x` / `corr_y` (vraisemblablement `rch` / `rcv`, mais pas en mm, voir plus bas) ; - `reproj_err` et `inlier` : références seulement ; `sigma0` : une valeur par mesure, répétée sur chaque ligne ; pas de `camera_pan|tilt|rotation|scale`. - `peak`, `flux`, `sharpness`, `fwhm`, `dominance`, `snr` : la qualité d'image de chaque cible, calculée par le GPU des caméras récentes (`run.md`) ; « Empty for most devices today » (handoff G, `docs/aimsight/AIMsight_handoff_G_site_health.md`). Remplies sur LENZSPITZE et NADELHORN, vides ailleurs (pompage d'octobre 2026) ; `inventaire.py` dit, sur un lot, quelles colonnes portent des valeurs. Pour les anciennes caméras, `~/optical_emulator` les recalcule à partir des images DIFF dans `quality/` (`run.md`), avec `stacking`, `exposition`, `gain`, `rotation` et `flag` de l'image, à joindre sur `time_utc` et `sensor_name`. Définitions et lecture : `metriques-de-qualite.md`. Flux, SNR et netteté relèvent de l'observabilité d'une cible dans l'image, à séparer de la santé du réseau de références (`AIMsight_agentic_support_project_context.md`, §5.5 et §5.6). - Une mesure rejetée (`error_value` > `error_threshold`) garde sa ligne et son `error_value` ; `corr_x` / `corr_y` sont vides, pas interpolés. « Rejetée » est un jugement d'AIMsight, pas un tri de la caméra : la caméra livre toutes ses mesures, et la plateforme d'un client qui intègre les données les reçoit et peut les afficher (l'utilisateur, 2026-10-28). - **LENZSPITZE, `x` / `y` relatifs** (2026-11-04) : `x` / `y` y sont l'écart à la position de référence du motif (médianes ~0 px), `relative_x` / `relative_y` sont égaux à `corr_x` / `corr_y`, `pattern_type` est vide. Conversion provisoire, pour cette station seulement : `~/aimsight-data/extraction/lenzspitze_absolu.py` réécrit `data/LENZSPITZE/displacement/` en px de l'image (centre du motif de `lentzpitze_patterns.json` + décalage mesuré +330,5 / +15,8 px entre le repère du JSON et les images IRON + `x` / `y`) et remplit `pattern_type`. À relancer après un repompage. Limites : 1023 et 8019 n'ont pas de motif dans le JSON, leurs `x` / `y` sont vidés (8019 classé `global_ref`, par ses `reproj_err`) ; `relative_x` en px n'est pas reconstruit. À corriger le moment venu : le repère des positions côté pompage, et `visibility.py`, `thermal_displacement.py`, `categories.py`, qui testent `pattern_type` directement au lieu de `donnees.est_reference` (vide, ils ne voient aucune référence). - **Mouvements de la caméra** (`camera/_camera_.csv`, pompage seulement, absent des exports reçus) : la pose de la caméra à chaque recalage, `time_utc` en UTC, `median_|min_|max_` de `pan`, `tilt`, `rotation` [deg], `scale`, `sigma0` à la minute ; une ligne par mesure (min = max), aux instants des déplacements. Un instant de mesure sans ligne : la caméra n'a pas été recalée (NORDEND : 101 instants sur 6 071, dont 49 les 29 et 30/07). Ordres de grandeur : `pan`, `tilt` de quelques centièmes de degré, `scale` à 10⁻³ près de 1 ; des écarts de plusieurs degrés sur NORDEND (`pan` jusqu'à 3,1°, `tilt` −2,8 à 4,0°), non expliqués. Signe : un `tilt` positif veut dire que la caméra pique du nez (l'expert, 2026-11-03, BREITHORN : le `tilt` monte tout octobre pendant que la caméra s'incline). Lus par `ensemble.py` et `inventaire.py` (D-073). - **Horaire** (`__to__1hour.csv`) : une ligne par heure, cibles seulement. Par cible : `horizontal_displacement`, `vertical_displacement`, leurs `_min` / `_max`, `_error`, `_count_val`. - `timestamp` **sans fuseau** : heure suisse (UTC+2 en octobre), au début de l'heure. Vérifié : `_error` = moyenne des `error_value` de l'heure, à 0,0006 près (médiane). - `count_val` compte les mesures de l'heure, rejetées comprises. - **Unité de `corr_x` / `corr_y`** : `horizontal_displacement` = facteur × moyenne horaire de `corr_x` + décalage constant (de même `vertical` et `corr_y`, corrélation ≥ 0,99). Le facteur dépend du motif : `target05` 0,61, `target` 1,6, `target02` 4,3, `target03` 6,85, `target04` 7,9. Si l'horaire est en mm (FAQ), `corr_x` / `corr_y` ne le sont pas. Selon l'utilisateur (2026-10-16), ils sont sûrement en **px**, le facteur étant alors des mm par px. C'est compatible avec NORDEND : au saut de PR17 (08/10 02:30), `corr_y` baisse d'environ 0,15, et `relative_y` (en px) de 0,26 px contre 0,08 px pour les autres capteurs ; sur la fenêtre, `corr` de PR17 ≈ 0,8 × (`relative` − moyenne des `relative` des références globales), mais une moyenne ignore la rotation et l'échelle de la compensation. À confirmer. Le facteur dépend de la station : sur NORDEND, `vertical_displacement` de PR17 = 55,5 × moyenne horaire de `corr_y` (r = 0,994, 244 heures), soit environ 9 mm pour son saut de 0,15. Causes à départager pour une anomalie de déplacement : - mouvement réel de l'ouvrage ; - mouvement de la caméra ; - instabilité de la compensation (cas Barcelone) ; - dégradation locale d'une cible ; - parallaxe ou modèle inadapté. La référence qui fait autorité est `AIMsight_reference_quality_event_explainer_roadmap.md` (documentation AIMsight, rangée dans Support-Agent, `docs/aimsight/`). Les règles non négociables qui s'y rapportent : - ne rien construire sur `inlier` binaire : RANSAC sera remplacé par un estimateur pondéré ; utiliser poids continus, `N_eff`, résidus, influence ; - `sigma0` seul et le nombre de références ne sont jamais des critères suffisants ; - ne pas confondre qualité image d'une cible et qualité du réseau de références, ni petit résidu et transformation bien contrainte ; - ne pas confondre mouvement en mode commun et mouvement structurel, ni références cohérentes et références physiquement fixes.