Files
aimsight-labeling/connaissances/metriques-de-qualite.md
T

19 lines
3.1 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.
# 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 (les règles non négociables, à la fin de `labeling/connaissances/colonnes-des-deplacements.md` ; `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 (`labeling/connaissances/chaine-de-mesure.md`).