Manuel-utilisateur/Post-traitement-des-vitesses-calculées.md

@@ -4,12 +4,12 @@
 
 - [Filtrage des résultats instantanés](#filtrage-des-r%C3%A9sultats-instantan%C3%A9s)
    - [1. Test médian](#1-test-médian)
-   - [2. Seuil vitesse](#2.-seuil-vitesse)
-   - [3. Seuil corrélation](#3.-seuil-corrélation)
-   - [4. Pic de corrélation](#4.-pic-de-corrélation)
-   - [5. Distribution des vitesses](#5.-distribution-des-vitesses)
-   - [6. Dispersion des vitesses](#6.-dispersion-des-vitesses) 
-   - [7. Dispersion angulaire](#7.-dispersion-angulaire)
+   - [2. Seuil vitesse](#2-seuil-vitesse)
+   - [3. Seuil corrélation](#3-seuil-corrélation)
+   - [4. Pic de corrélation](#4-pic-de-corrélation)
+   - [5. Distribution des vitesses](#5-distribution-des-vitesses)
+   - [6. Dispersion des vitesses perpendiculaires au transect](#6-dispersion-des-vitesses-perpendiculaires au-transect) 
+   - [7. Dispersion angulaire](#7-dispersion-angulaire)
 - [Moyenne des résultats](#moyenne-des-r%C3%A9sultats)
 - [Statistiques des résultats de vitesse](#statistiques-des-r%C3%A9sultats-de-vitesse)
 
@@ -22,15 +22,15 @@ L’étape de post-traitement comprend le filtrage et la moyenne des résultats
 # Filtrage des résultats instantanés
 
 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!
+1. Test médian : filtre sur la 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  
+5. Distribution des vitesses : filtre sur la cohérence temporelle des vitesses
+6. Dispersion des vitesses perpendiculaires au transect: filtre vérifiant la cohérence temporelle des vitesses 
+7. Dispersion angulaire : filtre vérifiant la cohérence temporelle des vitesses  
 
-Ces filtres sont appliqués en séquence, dans l'ordre présenté ci-dessus. Pour utiliser chacun des filtres, **activer la case à cocher** et **renseigner les valeurs**. 
+Ces filtres sont appliqués en séquence, dans l'ordre présenté ci-dessus. Cela signifie que chaque filtre traite les vitesses restantes après application des filtres antérieurs (donc, seul le test médian traite directement toutes les vitesses calculées). Pour utiliser chacun des filtres, **activer la case à cocher** et **renseigner les valeurs**. 
 
 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). 
 
@@ -44,15 +44,16 @@ Les étapes du test médian sont les suivantes :
 - Comparaison de l'écart calculé à un **seuil de tolérance** (paramètre ***r0 = 2*** par défaut).
    - Si l'écart **dépasse** le seuil de tolérance, la vitesse au point est **rejetée**. 
 
-## 2. Seuil vitesse 
+> Il est possible que le median test rejette de nombreux vecteurs dans le cas d'un **champ de vitesse complexe avec des gradients spatiaux importants**. Dans ce cas, le paramètre ***epsilon*** peut être ajusté (0.2 ou 0.3 par exemple). 
+> - Pour des champs de vitesse complexes, il est conseillé d'utiliser une grille dense pour limiter les gradients spatiaux.    
+   
+## 2. Seuil vitesse ![filtres_vitesse](uploads/be4fdc8bf75177d335f7f9fb0d5a8ab8/filtres_vitesse.png)
 
-![filtres_vitesse](uploads/be4fdc8bf75177d335f7f9fb0d5a8ab8/filtres_vitesse.png)
 Le filtre sur seuil de vitesse permet de ne conserver que les vitesses ayant une valeur de norme ou de composante Vx ou Vy comprises dans une gamme définie. Les ***valeurs minimales et maximales*** sont à renseigner pour chaque donnée (norme, Vx, Vy). 
 
-## 3. Seuil de corrélation 
+## 3. Seuil de corrélation ![filtres_corr](uploads/5bb8eec56da320dc580efa054ea433e8/filtres_corr.png)
 
-![filtres_corr](uploads/5bb8eec56da320dc580efa054ea433e8/filtres_corr.png)
-Le filtre sur seuil de 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](Manuel-utilisateur/Approfondissements#principes-de-la-mesure-de-la-vitesse-de-d%C3%A9placement-des-traceurs) pour plus de détails. 
+Le filtre sur seuil de corrélation permet de ne conserver les vitesses 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](Manuel-utilisateur/Approfondissements#principes-de-la-mesure-de-la-vitesse-de-d%C3%A9placement-des-traceurs) pour plus de détails. 
 
 > **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). 
@@ -61,7 +62,7 @@ Le filtre sur seuil de corrélation permet de ne conserver les vitesses calculé
 > 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).
 
-## 4. Pic de corrélation 
+## 4. Pic de corrélation ![filtres_corrPeak](uploads/65b99f38de5870d070124e255e49c6d9/filtres_corrPeak.png)
 
 Le filtre sur largeur du pic de corrélation permet de rejeter les points où le pic de corrélation est trop large par rapport à la vitesse calculée. 
 
@@ -77,11 +78,33 @@ Le rapport entre la largeur à 80% du pic et la norme du vecteur vitesse est cal
 
 > Un seuil de tolérance tel que ***rhomax = 0.5*** signifie que la largeur du pic ne doit pas représenter plus que la moitié (50%) de la norme de la vitesse calculée.  
 
-## 5. Distribution des vitesses
-## 6. Dispersion des vitesses
-## 7. Dispersion angulaire  
+## 5. Distribution des vitesses ![filtres_disp](uploads/bb0220c6a2910c1bfac397ccf7400215/filtres_disp.png)   
+
+Le filtre sur la distribution des vitesses assure la cohérence temporelle des résultats en un point donné. L'ensemble des normes des vitesses au point (après passage des filtres antérieurs) sont utilisées pour déterminer la norme moyenne au point et son écart-type. 
+
+Pour chacun des pas de temps, si la **norme s'écarte de plus de 3 écarts-types de la norme moyenne**, alors la vitesse calculée est rejetée (paramètre ***n_std = 3*** par défaut).  
+
+## 6. Dispersion des vitesses perpendiculaires au transect ![filtres_dispCourant](uploads/c4ba9ab8c75889fc451e4386ff79b823/filtres_dispCourant.png)
+
+Le filtre de dispersion des vitesses perpendiculaires au transect écarte les points présentant une dispersion trop importante des vitesses (composante normale au transect). Ce filtre est plus drastique que les précédents, il rejette directement **toutes les vitesses au point**. 
+
+> Ce filtre est dédié aux applications de mesure de débit. Il **nécessite qu'un transect bathymétrique** ait été renseigné. 
+
+La composante normale au transect est déterminée pour chacune des vitesses au point (après passage des filtres antérieurs). Le **coefficient de variation** de cette composante est ensuite calculé (rapport de l'écart-type sur la moyenne). 
 
+Les points présentant un coefficient de variation de la vitesse perpendiculaire au transect supérieur à un **seuil de tolérance** sont rejetés (paramètre ***CoVmax = 0.4*** par défaut).   
 
+## 7. Dispersion angulaire ![filtres_dispAng](uploads/1a669c57d0deddb66ae9ad17e72d422c/filtres_dispAng.png)  
+
+Le filtre de dispersion angulaire écarte les points présentant une dispersion trop importante des orientation des vitesses. Ce filtre est plus drastique que les précédents, il rejette directement **toutes les vitesses au point**. 
+
+Toutes les vitesses au point (après passage des filtres antérieurs) sont utilisées pour calculer la **variance circulaire**. 
+
+> La **variance circulaire** varie entre **0 (orientations identiques)** et **1 (orientations uniformément réparties)**. 
+
+Les points présentant une variance circulaire supérieure à un **seuil de tolérance** sont rejetés (paramètre ***circvarmax = 0.25***) 
+
+# 
 
 Les champs de vitesses instantanées filtrés sont stockés dans le dossier **_vel_filter_**. Le groupe de calque **_Résultats filtrés (F)_** est créé.