Files
Support-Agent/docs/domaine/colonnes-des-deplacements.md
T
maximeandClaude Opus 5.5 a2b1f2ed14 Image quality metrics in labeling: qualite.py, LENZSPITZE October labels reviewed with them (D-129)
Definitions of peak, flux, sharpness, fwhm, dominance and snr in docs/domaine;
agent-tools/qualite.py (ratio to a calm reference, per label, outside labels,
figures), inventaire/graphique/resume aware of the six columns, lire-les-donnees
and the labeler's instructions updated. LENZSPITZE 16.10-01.11 relabeled: 67
labels, 4 found by the metrics.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-04 13:34:04 +01:00

6.4 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 : 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).
  • 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.