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>
This commit is contained in:
1 parent
2edd297726
commit
a2b1f2ed14
16 files changed
+2039
-84
No files matched your search
@@ -7,7 +7,7 @@ D'après la FAQ, les colonnes de l'export CSV sont préfixées par la cible (ex.
|
||||
- `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 »).
|
||||
- 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)
|
||||
|
||||
@@ -17,7 +17,7 @@ Deux autres formats, observés sur les données (pas documentés dans la FAQ) :
|
||||
- `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`. 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).
|
||||
- `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`.
|
||||
|
||||
@@ -0,0 +1,18 @@
|
||||
# Les métriques de qualité d'image d'une cible
|
||||
|
||||
Six colonnes de l'export « advanced », par capteur et par mesure : `peak`, `flux`, `sharpness`, `fwhm`, `dominance`, `snr`. Calculées par le GPU des caméras récentes (`aimsight_optical` 6.7.11) sur la fenêtre du capteur dans l'image DIFF, en unités de cette image. Remplies sur LENZSPITZE et NADELHORN (pompage d'octobre 2026), vides ailleurs ; pour une ancienne caméra, `~/optical_emulator` les recalcule dans `quality/` (`run.md`).
|
||||
|
||||
Source : `~/optical_emulator/docs/cuda_phase_correlation.md`, §14 (définitions du code de référence). « Disque » : le voisinage du pic, de rayon `min(H, W)/6` (au moins 3 px) ; « fond » : tout le reste de la fenêtre (`bg_mean`, `bg_sigma`).
|
||||
|
||||
| Métrique | Définition | Ce qu'elle mesure | Lecture |
|
||||
|---|---|---|---|
|
||||
| `peak` | `max(I)` | la luminosité du retour | en haut, saturation ; en bas, sous-exposition ou flash manqué. Toutes les cibles qui baissent : l'éclairage (LED, flash) ; une seule : cette cible (salissure, désalignement) |
|
||||
| `flux` | flux du disque moins le fond | la lumière de la cible, fond retiré | réflectivité de la cible (salissure, vieillissement, flash), pas la lumière ambiante ; baisse bien avant que `error_value` ne dépasse son seuil |
|
||||
| `sharpness` | `Σ(I²) / (ΣI)²` | concentration de l'énergie (plus haut = plus net) | baisse : mise au point qui dérive, turbulence thermique, cible qui se dégrade, soit plus de bruit de mesure. Indépendante du gain, mais pas du fond (non retiré) : à suivre dans le temps sur une cible, pas à comparer entre caméras |
|
||||
| `fwhm` | largeur à mi-hauteur autour du pic, fond retiré [px] | largeur de la tache | monte : défocalisation, turbulence, flou de bougé. Tronquée au disque : sous une forte défocalisation, elle se tasse au lieu de monter |
|
||||
| `dominance` | `(second pic − fond) / (pic − fond)`, de 0 (propre) vers 1 (ambigu) | une seule cible domine-t-elle la fenêtre ? | haute : un second reflet comparable, un point brillant parasite, ou la cible a disparu et autre chose est le plus brillant : la corrélation peut s'accrocher au mauvais motif, ce qu'`error_value` seule ne voit pas. Un seul pixel chaud hors du disque suffit à la faire monter |
|
||||
| `snr` | `(peak − fond) / bg_sigma` | le signal au-dessus du bruit du fond | bas : retour marginal, même quand `peak` paraît normal. Indépendant de l'exposition et du gain. L'émulateur marque `vide` sous 8 |
|
||||
|
||||
En bref : `peak` et `flux` disent la luminosité, `sharpness` et `fwhm` la netteté, `dominance` et `snr` la validité. Ensemble, ils disent **pourquoi** une mesure se dégrade, là où `error_value` ne dit que qu'elle se dégrade.
|
||||
|
||||
Ce sont des qualités de l'image d'**une cible** : elles ne disent rien de la santé du réseau de références (CLAUDE.md, « Pour les déplacements » ; `AIMsight_agentic_support_project_context.md`, §5.5 et §5.6). Les lectures du tableau sont celles de la source ; ce qu'elles valent sur nos phénomènes (pluie, buée, obstruction, soleil) se confirme dans les données (`docs/displacement/domaine/chaine-de-mesure.md`).
|
||||
Reference in new issue
Block a user