37 lines
7.4 KiB
Markdown
37 lines
7.4 KiB
Markdown
# 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 »** (`<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`.
|
||
- `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 : `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/<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. 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** (`<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`.
|