2026-10-14 16:00:40 +02:00
"""Vignettes des images de la caméra autour de capteurs, à pleine résolution, pour l'agent de diagnostic.
2026-10-28 16:36:45 +01:00
Usage : .venv/bin/python agent-tools/vignettes.py data/PS_DES_COUDRES/
2026-10-26 14:47:00 +01:00
--capteurs REF_G,REF_D --heures 2026-10-13T22:00Z,2026-10-14T02:00Z [--rayon 100] [--contraste [MIN,MAX]] [--sortie DOSSIER]
2026-10-26 14:55:46 +01:00
Une ligne par capteur, une colonne par heure. Quand il n'y a pas d'image à l'heure demandée, la plus proche est
prise : l'écart est imprimé et l'heure réelle de l'image est dans le titre de la vignette. Chaque vignette est centrée sur la position brute (x, y) du capteur
2026-10-14 16:00:40 +02:00
dans l'export « advanced », lue à la mesure la plus proche de l'image ; les pixels ne sont pas retouchés, l'éclat
2026-10-26 14:47:00 +01:00
se compare donc d'une vignette à l'autre. Imprime les positions utilisées, le fond (médiane des pixels de la
vignette), le 99e centile et le pic (maximum) du niveau de gris de chaque vignette (0 à 255), puis le chemin du PNG.
--contraste : toutes les vignettes en niveaux de gris, avec le même étirement pour toute la planche, pour qu'une
tache faible se voie et se compare d'une vignette à l'autre. Sans valeur, l'étirement va du 1er centile au maximum
de la planche (un pixel saturé quelque part l'écrase : redonner alors --contraste MIN,MAX, en s'aidant du fond et du
pic imprimés pour chaque vignette). Un --rayon plus petit (30 à 50) grossit. Les bornes sont imprimées.
2026-10-26 19:07:50 +01:00
Le centre du cadre (px) est écrit sous chaque vignette : quand les x, y de l'export sautent, le cadre se déplace
d'autant. --fixe garde, sur chaque ligne, le cadre centré sur la position de la première heure demandée, et marque
d'une croix rouge les x, y de l'export à chaque heure : une tache qui entre dans le cadre ou en sort ne s'y confond
pas avec une tache qui apparaît.
2026-10-14 16:00:40 +02:00
"""
import argparse
import os
import sys
import matplotlib
matplotlib . use ( "Agg" )
import matplotlib.pyplot as plt # noqa: E402
from donnees import charger , heure_image , instant , iso , trouver # noqa: E402
2026-10-26 14:47:00 +01:00
def centile ( gris , p ):
"""Centile p (0 à 100) des pixels d'une vignette, sans interpolation."""
v = sorted ( gris . ravel () . tolist ())
return v [ min ( int ( p / 100 * len ( v )), len ( v ) - 1 )]
2026-10-28 16:36:45 +01:00
RACINE = os . path . normpath ( os . path . join ( os . path . dirname ( os . path . abspath ( __file__ )), ".." ))
2026-10-14 16:00:40 +02:00
def main ():
a = argparse . ArgumentParser ( description = __doc__ , formatter_class = argparse . RawDescriptionHelpFormatter )
a . add_argument ( "dossier" )
a . add_argument ( "--capteurs" , required = True , help = "liste séparée par des virgules" )
a . add_argument ( "--heures" , required = True , help = "heures des images, séparées par des virgules (UTC)" )
a . add_argument ( "--rayon" , type = int , default = 100 , help = "demi-côté de la vignette en pixels (défaut 100)" )
2026-10-26 14:47:00 +01:00
a . add_argument ( "--contraste" , nargs = "?" , const = "auto" , metavar = "MIN,MAX" , help = "niveaux de gris, même étirement pour toute la planche : MIN,MAX (0 à 255) ou, sans valeur, du 1er centile au maximum de la planche" )
2026-10-26 19:07:50 +01:00
a . add_argument ( "--fixe" , action = "store_true" , help = "un cadre fixe par capteur (position à la première heure), x, y de chaque heure marqués d'une croix" )
2026-10-14 16:00:40 +02:00
a . add_argument ( "--sortie" , default = os . path . join ( RACINE , "out" , "diagnostic" ), help = "dossier du PNG" )
o = a . parse_args ()
par = charger ( o . dossier )
images = { heure_image ( p ): p for p in trouver ( o . dossier )[ "images" ]}
noms , heures = o . capteurs . split ( "," ), [ instant ( h ) for h in o . heures . split ( "," )]
absents = [ s for s in noms if s not in par ]
if absents :
sys . exit ( f "Capteurs inconnus : { ', ' . join ( absents ) } . Connus : { ', ' . join ( sorted ( par )) } ." )
2026-10-26 14:55:46 +01:00
connues = sorted ( h for h in images if h )
if not connues :
sys . exit ( f "Aucune image dans { o . dossier } ." )
proche = { h : min ( connues , key = lambda i : abs ( i - h )) for h in heures } # image à l'heure demandée, sinon la plus proche
for h in heures :
if proche [ h ] != h :
print ( f "Pas d'image à { iso ( h ) } : la plus proche est celle de { iso ( proche [ h ]) } (écart { abs ( proche [ h ] - h ) } )." )
2026-10-14 16:00:40 +02:00
r = o . rayon
2026-10-26 19:07:50 +01:00
coupes , centres , croix = {}, {}, {}
2026-10-14 16:00:40 +02:00
for j , h in enumerate ( heures ):
2026-10-26 14:55:46 +01:00
img = plt . imread ( images [ proche [ h ]])
2026-10-14 16:00:40 +02:00
for i , s in enumerate ( noms ):
2026-10-26 14:55:46 +01:00
m = min (( m for m in par [ s ] if m [ "x" ] is not None ), key = lambda m : abs ( m [ "t" ] - proche [ h ]))
2026-10-26 19:07:50 +01:00
x , y = centres [ i ] if o . fixe and j else ( round ( m [ "x" ]), round ( m [ "y" ]))
if j == 0 :
centres [ i ] = ( x , y )
2026-10-26 14:47:00 +01:00
c = img [ max ( y - r , 0 ): y + r , max ( x - r , 0 ): x + r ]
2026-10-26 19:07:50 +01:00
croix [ i , j ] = ( m [ "x" ] - max ( x - r , 0 ), m [ "y" ] - max ( y - r , 0 ), x , y )
2026-10-26 14:47:00 +01:00
gris = c [ ... , : 3 ] . mean ( axis =- 1 ) if c . ndim == 3 else c
gris = gris * 255 if gris . max () <= 1 and c . dtype . kind == "f" else gris
coupes [ i , j ] = ( c , gris )
2026-10-26 14:55:46 +01:00
print ( f " { s } { iso ( h ) } : x= { m [ 'x' ] : .1f } y= { m [ 'y' ] : .1f } (mesure de { iso ( m [ 't' ]) } ), { os . path . basename ( images [ proche [ h ]]) } , "
2026-10-26 14:47:00 +01:00
f "fond { centile ( gris , 50 ) : .0f } , p99 { centile ( gris , 99 ) : .0f } , pic { gris . max () : .0f } " )
bornes = {}
if o . contraste :
if o . contraste == "auto" :
bornes = dict ( vmin = min ( centile ( g , 1 ) for _ , g in coupes . values ()), vmax = max ( g . max () for _ , g in coupes . values ()))
else :
bornes = dict ( zip (( "vmin" , "vmax" ), map ( float , o . contraste . split ( "," ))))
print ( f "Étirement commun : { bornes [ 'vmin' ] : .0f } à { bornes [ 'vmax' ] : .0f } (niveaux de gris, 0 à 255)" )
fig , axes = plt . subplots ( len ( noms ), len ( heures ), figsize = ( 2.6 * len ( heures ), 2.8 * len ( noms )), squeeze = False )
for ( i , j ), ( c , gris ) in coupes . items ():
ax = axes [ i , j ]
if o . contraste :
ax . imshow ( gris , cmap = "gray" , interpolation = "nearest" , ** bornes )
else :
ax . imshow ( c , interpolation = "nearest" )
2026-10-26 14:55:46 +01:00
ax . set_title ( f " { noms [ i ] } { proche [ heures [ j ]] . strftime ( ' %d /%m %H:%MZ' ) } " + ( "" if proche [ heures [ j ]] == heures [ j ] else " (demandée " + heures [ j ] . strftime ( '%H:%MZ' ) + ")" ), fontsize = 9 )
2026-10-26 19:07:50 +01:00
cx , cy , x , y = croix [ i , j ]
if o . fixe :
ax . plot ( cx , cy , "+" , color = "r" , ms = 10 , mew = 1 )
ax . set_xlabel ( f "centre du cadre { x } , { y } " + ( f " \n x, y { cx + max ( x - r , 0 ) : .1f } , { cy + max ( y - r , 0 ) : .1f } " if o . fixe else "" ), fontsize = 7 )
2026-10-26 14:47:00 +01:00
ax . set_xticks ([])
ax . set_yticks ([])
2026-10-14 16:00:40 +02:00
station = os . path . basename ( os . path . normpath ( o . dossier ))
fig . suptitle ( f " { station } : vignettes de { 2 * r } px autour de chaque capteur (heures UTC)" , fontsize = 10 )
os . makedirs ( o . sortie , exist_ok = True )
2026-10-15 10:52:58 +02:00
sortie = os . path . join ( o . sortie , f " { station } _vignettes_ { '-' . join ( noms ) } _"
2026-10-26 19:07:50 +01:00
f " { '-' . join ( h . strftime ( ' %d %H%M' ) for h in heures ) }{ '_contraste' if o . contraste else '' }{ '_fixe' if o . fixe else '' } .png" )
2026-10-14 16:00:40 +02:00
fig . savefig ( sortie , dpi = 100 , bbox_inches = "tight" )
print ( sortie )
if __name__ == "__main__" :
main ()