Files
Support-Agent/docs/domaine/colonnes-des-deplacements.md
T

35 lines
5.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 : **uniquement dans l'export HDF5** (colonnes vides dans l'export « advanced »).
## Exports reçus (PS des Coudres, D-045)
Deux autres formats, observés sur les données (pas documentés dans la FAQ) :
- **« advanced »** (`<Station>_advanced_<début>_<fin>.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`.
- 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).
- **Mouvements de la caméra** (`camera/<Station>_camera_<AAAAMMJJ>.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. Lus par `ensemble.py` et `inventaire.py` (D-073).
- **Horaire** (`<Station>_<début>_to_<fin>_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 `docs/aimsight/AIMsight_reference_quality_event_explainer_roadmap.md`. Les règles non négociables qui s'y rapportent (`inlier` binaire, `sigma0`, mode commun) sont dans `CLAUDE.md`.