Files
Support-Agent/docs/domaine/colonnes-des-deplacements.md
T
maximeandClaude Opus 5.5 1e80ee0acb Add PS des Coudres optical exports as the displacement working set (D-045)
Exports go to data/<STATION>/displacement/, out of reach of the system
metrics loader. The 15-min "advanced" export (UTC) is the analysis source;
the hourly export is kept for the corr_x/corr_y conversion factors.
Document both formats and record the open questions in the framing doc.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-14 12:15:34 +02:00

3.0 KiB
Raw Blame History

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), time_utc en UTC explicite.
    • sensor_name, pattern_type (global_ref pour une référence), x / y [px], error_value, error_threshold (propre à chaque capteur : 0,3 à 0,7) ;
    • 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.
  • 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 : à confirmer.

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.