Manuel-utilisateur.md

@@ -95,6 +95,7 @@ Version du 08/03/2024
 - [Le modèle sténopé et sa résolution : cas particulier 2D](#le-mod%C3%A8le-st%C3%A9nop%C3%A9-et-sa-r%C3%A9solution-cas-particulier-2d)
 - [Création des orthoimages](#cr%C3%A9ation-des-orthoimages)
 - [Principes de la mesure de la vitesse de déplacement des traceurs](#principes-de-la-mesure-de-la-vitesse-de-d%C3%A9placement-des-traceurs)
+- [Présentation détaillée des filtres](#présentation-détaillée-des-filtres)
 - [Principes du calcul de débit](#principes-du-calcul-de-d%C3%A9bit)
 - [Définition et interpolation du profil bathymétrique](#d%C3%A9finition-et-interpolation-du-profil-bathym%C3%A9trique)
 - [Estimation de la vitesse moyenne en chaque point du transect](#estimation-de-la-vitesse-moyenne-en-chaque-point-du-transect)
@@ -624,14 +625,22 @@ Il permet de visualiser les vitesses calculées pour les paires d'images sous fo
 
 L’étape de post-traitement comprend le filtrage et la moyenne des résultats de vitesse. Il est également possible d’afficher quelques statistiques simples sur les résultats de vitesse.
 
-![](./media/image70.png)
+![image70](uploads/1d1dcd6d6167fa949b94ca8182eb0eee/image70.png)
 
 ## Filtrage des résultats instantanés
 
-Le menu **_Post-traitement🡪 Filtrage des résultats instantanés_** lance l’interface de filtrage. Deux onglets sont disponibles :
+Le menu **_Post-traitement🡪 Filtrage des résultats instantanés_** lance l’interface de filtrage. Plusieurs filtres sont disponibles : 
+1. Test médian : filtre de cohérence spatiale des vitesses!
+2. Seuil vitesse : filtre sur les composantes des vecteurs vitesses 
+3. Seuil corrélation : filtre sur le niveau de corrélation (identification traceur entre images)
+4. Pic de corrélation : filtre sur la largeur du pic de corrélation (qualité du traceur)
+5. Distribution des vitesses : filtre de cohérence temporelle des vitesses
+6. Dispersion des vitesses : filtre de cohérence temporelle des vitesses (dans le sens du courant)
+7. Dispersion angulaire : filtre de cohérence temporelle des vitesses  
 
-![](./media/image71.png) ![](./media/image72.png)
+Ces filtres sont appliqués en séquence, dans l'ordre présenté ci-dessus. Dans cette section une présentation brève est proposée. Pour plus de détails, se référer à la section de [présentation détaillée des filtres](#présentation-détaillée-des-filtres). 
 
+1. Le test médian compare les composantes Vx et Vy d'un vecteur avec ses 8 voisins les plus proches (paramètre n_neighbor).   
 - L’onglet **_Vitesse_** permet de filtrer sur des valeurs de norme ou de composantes Vx ou Vy. Pour utiliser ce filtre, activer la case à cocher **_Filtrer les vitesses_** et renseigner les valeurs minimale et maximale pour les différents filtres proposés. Par défaut, la valeur seuil de norme de vitesse minimale est zéro et elle ne peut pas être strictement négative.
 - L’onglet **_Corrélation_** permet de ne conserver les vitesses calculées que dans une certaine gamme de valeur de corrélation, voir la page des [Principes de la mesure de la vitesse de déplacement des traceurs](#principes-de-la-mesure-de-la-vitesse-de-d%C3%A9placement-des-traceurs) pour plus de détails. Pour utiliser ce filtre, activer la case à cocher **_Filtrer les corrélations_** et renseigner les valeurs minimale et maximale de la plage de corrélation pour laquelle les vitesses sont à conserver. La valeur minimale dépend de la qualité des traceurs et de leur conservation temporelle. Pour des traceurs non déformables (objets durs, traceurs artificiels) on pourra exiger des corrélations élevées (de l’ordre de 0.7). Pour des traceurs se déformant (figures de turbulence, écume), on demandera un seuil minimal plus faible (de l’ordre de 0.4). En fixant une borne maximale à 0.98, on évitera des artifices si la grille de calcul déborde de l’écoulement et empiète sur des zones statiques (berge, bord l’image). Par défaut, les valeurs seuils sont fixées à 0.4 (min) et 0.98 (max).
 
@@ -977,7 +986,11 @@ La position sub-pixel du maximum de corrélation est don calculée comme _b<sub>
 
 Les vitesses de surface sont calculées à partir des déplacements _b<sub>i+∆i,j+∆j.</sub>-a<sub>i,j</sub>_ divisés par _∆t_. Le calcul est reproduit de manière itérative sur toute l'image pour chaque nœud de la [grille de calcul](#grille-de-calcul). On calcule ainsi un champ de vitesse 2D de surface, "instantané" (entre deux images successives).
 
-**_Fudaa-LSPIV_** permet [d'appliquer des filtres](#filtrage-des-r%C3%A9sultats-instantan%C3%A9s) pour éliminer les vitesses aberrantes issues du calcul statistique. Des filtres sur la valeur minimale du coefficient de corrélation, sur l'amplitude et l'orientation des vitesses sont implémentés dans le logiciel.
+## Présentation détaillée des filtres
+
+**_Fudaa-LSPIV_** permet [d'appliquer des filtres](#filtrage-des-r%C3%A9sultats-instantan%C3%A9s) pour éliminer les vitesses aberrantes issues du calcul statistique. La gamme de filtre disponible a été étendue depuis la version 1.11, d'après les travaux de [Bodart et al., (2024)](https://doi.org/10.1029/2023WR034740).
+
+Des filtres sur la valeur minimale du coefficient de corrélation, sur l'amplitude et l'orientation des vitesses sont implémentés dans le logiciel.
 
 Enfin, **_Fudaa-LSPIV_** permet de [moyenner](#moyenne-des-r%C3%A9sultats) les champs de vitesses instantanées filtrées pour calculer un champ de vitesses moyennées sur la durée de la séquence d’images.
 
@@ -1090,3 +1103,5 @@ Oyallon, E., Rabin, J., An Analysis of the SURF Method, Image Processing On Line
 Piton, G., Recking, A., Le Coz, J., Bellot, H., Hauet, A., Jodeau, M. (2018) - Reconstructing depth-averaged open-channel flows using image velocimetry and photogrammetry, Water Resources Research (in press)
 
 Theule, J.I., Crema, S., Marchi, L., Cavalli, M., Comiti, F. (2018) Exploiting LSPIV to assess debris-flow velocities in the field, Natural Hazards and Earth System Sciences, 18(1), 1-13
+
+Bodart, G., Le Coz, J., Jodeau, M., & Hauet, A. (2024). Quantifying and reducing the operator effect in LSPIV discharge measurements. Water Resources Research, 60. 
\ No newline at end of file