doc: Update French version of grille

Refs #401

docs/fr/calculators/devalaison/grille.md

 # Calcul de la perte de charge sur une grille de prise d'eau
 
+La perte de charge \(\Delta H\) due au plan de grille se calcule comme suit :
+
+$$ \Delta H = \xi \frac{V_1^2}{2g} $$
+
+La vitesse débitante amont \(V_1\) est calculée à partir du débit entonné \(Q\), de la hauteur d’eau \(H_1\)
+et de la largeur de la prise d’eau \(B\) à l’amont du plan de grille :
+
+$$ V_1 = \frac{Q}{H_1 \times B} $$
+
+Le calcul du coefficient de pertes de charge \(\xi\) se fait à partir des caractéristiques de la grille. Pour une description complète des hypothèses, des formules et des limitations de la méthode, se référer au rapport de Raynal et al. (2012)[^1] disponible ici : https://continuite-ecologique.fr/wp-content/uploads/2019/11/2012_014.pdf
+
 ## Grille conventionnelle
 
-Plans de grille conventionnels : perpendiculaires à l'écoulement et peu inclinés par rapport à l'horizontale
+Plans de grille conventionnels : perpendiculaires à l'écoulement et peu inclinés par rapport à l'horizontale.
 
 ### Formule
 
-Utilisation de la formule F1 de Raynal et al. (2012) pour calculer les pertes de charge.
+Le calcul des pertes de charges s'effectue à l'aide de la formule F1 de Raynal et al. (2012)[^1] :
+
+$$\xi = a * K_O * K_\beta$$
+
+Avec :
+
+- \(\xi\) : coefficient de perte de charge totale (-)
+- \(a\) : coefficient de forme des barreaux (-), voir ci-dessous le paragraphe "Profil des barreaux"
+- \(K_O\) : coefficient de perte de charge dû à l'obstruction totale due aux barreaux, éléments longitudinaux et colmatage (-)
+- \(K_\beta\) : coefficient de perte de charge dû à l'inclinaison de la grille par rapport à la verticale (-)
+
+$$K_O = \left ( \frac{O_C}{1-O_C} \right )^{1.6}$$
+
+Avec \(O_C\) le coefficient d'obstruction totale due aux barreaux, éléments longitudinaux et colmatage rapporté à la section d'écoulement (-) :
 
-$$\xi = K_F * K_O * K_\beta = a * \left ( \frac{O}{1-O} \right )^{1.6} * \left ( 1 - \cos{\beta} \right )^{0.39}$$
+$$ O_C = O + (1 - O) \times C $$
+
+Avec :
+
+- \(O\) l'obstruction globale de la grille, définie comme le ratio adimensionnel entre la surface immergée, effectivement apparente depuis l’amont, de tous les éléments de la grille (barreaux, entretoises, supports), et la surface immergée du plan de grille
+- \(C\) le taux de colmatage
+
+$$K_\beta = \left ( 1 - \cos{\beta} \right )^{0.39}$$
+
+Avec \(\beta\) l'angle d’inclinaison de la grille par rapport à la verticale (°).
 
 
 ## Grille orientée
@@ -21,10 +54,18 @@ Plans de grille orientés par rapport à l'écoulement et quasi-verticaux.
 
 ### Formule
 
-Utilisation de la formule F2 de Raynal et al. (2012) pour calculer les pertes de charge.
+Le calcul des pertes de charges s'effectue à l'aide de la formule F2 de Raynal et al. (2012)[^1] ou encore de l'équation (7) de Raynal et al. (2013)[^2]
+
+$$\xi = a * K_O * K_\alpha$$
 
-$$\xi = K_F * K_O * K_\alpha = a * \left ( \frac{O}{1-O} \right )^{1.6} * \left ( 1 + c * \left ( \frac{90 - \alpha}{90} \right )^{2.35} * \left ( \frac{1 - O}{O} \right )^{3} \right )$$
+Avec \(K_\alpha\) coefficient de perte de charge dû à l'inclinaison de la grille par rapport à l'horizontale (-)
 
+$$K_\alpha = 1 + c * \left ( \frac{90 - \alpha}{90} \right )^{2.35} * \left ( \frac{1 - O}{O} \right )^{3} $$
+
+Avec:
+
+- \(\alpha\) : angle d’inclinaison de la grille par rapport à l'horizontale (°)
+- \(c\) : coefficient de forme des barreaux, voir ci-dessous le paragraphe "Profil des barreaux"
 
 ## Grille inclinée
 
@@ -38,27 +79,40 @@ Plans de grille perpendiculaires à l'écoulement, et inclinés par rapport à l
 
 ### Formule
 
-Utilisation de la formule F3 de Raynal et al. (2012) pour calculer les pertes de charge.
+Le calcul des pertes de charges s'effectue à l'aide de la formule F3 de Raynal et al. (2012)[^1] ou encore de l'équation (11) de Raynal et al. (2013)[^3]
+
+$$\xi = a * K_b * K_\beta + K_{Fent} * K_{entH}$$
+
+Avec :
+
+- \(K_b\) : coefficient de perte de charge dû à l'obstruction totale due aux barreaux, éléments longitudinaux et colmatage (-)
+- \(K_{Fent}\) : coefficient de forme moyen des entretoises et éléments transversaux (-), voir ci-dessous le paragraphe dédié
+- \(K_{entH}\) : coefficient de perte de charge dû aux entretoises et éléments de support transversaux (-)
 
-$$\xi = K_{F, b} * K_b * K_\beta + K_{Fent} * K_{entH} = a * \left ( \frac{O_b}{1-O_b} \right )^{1.65} * \left ( \sin \beta \right )^{2} + c * \left ( \frac{O_{entH}}{1-O_{entH}} \right )^{0.77}$$
+$$K_b = \left ( \frac{O_{b,C}}{1-O_{b,C}} \right )^{1.65}$$
 
+Avec \(O_{b,C} = O_b + (1 - O_b) \times C\) et \(O_b\) l'obstruction due aux barreaux et autres éléments longitudinaux du plan de grille, définie comme le ratio adimensionnel entre la surface immergée, effectivement apparente depuis l’amont, de ces
+éléments, et la surface immergée du plan de grille.
 
+$$K_\beta = \left ( \sin \beta \right )^{2}$$
+
+$$K_{entH} = \left ( \frac{O_{entH}}{1-O_{entH}} \right )^{0.77}$$
+
+Avec \(O_{entH}\) l'obstruction effective due aux entretoises et éléments de support transversaux (rapportée à la section d'écoulement), voir ci-dessous le paragraphe dédié.
 
 ## Paramètres
 
 ### Cote du sommet immergé du plan de grille
 
-Peut être différent du niveau d'eau si le sommet du plan de grille est noyé.
-
-### Largeur de la section
+Cette cote peut être différent du niveau d'eau si le sommet du plan de grille est noyé.
 
-#### grille conventionnelle ou inclinée
+### Largeur de la section \(B\)
 
-Doit également correspondre à la largeur du plan de grille.
+Dans les configurations grille conventionnelle ou inclinée, la largeur de la section doit correspondre à la largeur du plan de grille.
 
 ### Vitesse d'approche moyenne pour le débit maximum turbiné, en soustrayant la partie supérieure éventuellement obturée
 
-Valeur "maximalisée" de la vitesse d'approche prise en compte dans le calcul du perte de charge, dans une approche sécuritaire.
+C'est une valeur "maximalisée" de la vitesse d'approche prise en compte dans le calcul du perte de charge, dans une approche sécuritaire.
 
 ### Inclinaison par rapport à l'horizontale
 
@@ -75,6 +129,7 @@ La légère inclinaison des plans de grille (β≈ 75/80°), souvent mise en pla
 #### grille inclinée
 
 Domaine de validité de la formule : 15° ≤ β ≤ 90°
+
 Préconisation pour le guidage des poissons : β ≤ 26°
 
 ### Orientation par rapport à la direction de l'écoulement
@@ -93,47 +148,43 @@ Préconisation pour le guidage des poissons : α ≤ 45°
 
 Plans de grille perpendiculaires à l'écoulement (α = 90°)
 
-### Vitesse normale moyenne pour le débit maximum turbiné
-
-#### grille conventionnelle
+### Vitesse normale moyenne pour le débit maximum turbiné \(V_N\)
 
-Préconisation pour éviter le placage des poissons sur le plan de grille (barrière physique) ou leur passage prématuré au travers (barrière comportementale) : VN ≤ 0.5 m/s.
+Préconisation pour éviter le placage des poissons sur le plan de grille (barrière physique) ou leur passage prématuré au travers (barrière comportementale) : \(V_N \leq 0.5\) m/s.
 
 #### grille orientée ou inclinée
 
-Préconisation pour éviter le placage des poissons sur le plan de grille (barrière physique) ou leur passage prématuré au travers (barrière comportementale) : VN ≤ 0.5 m/s.
-
 Au-delà de la valeur moyenne calculée ici, se reporter impérativement aux préconisations tirées de la caractérisation expérimentale des valeurs effectives de vitesses.
 
-### Rapport de forme des barreaux
+### Rapport de forme des barreaux \(b/p\)
+
+Avec \(b\) l'épaisseur et \(p\) la profondeur des barreaux.
 
 #### grille orientée
 
-Domaine de validité de la formule : rapport b / p voisin de 0.125
+Domaine de validité de la formule : rapport \(b/p\) voisin de 0.125
 
 ### Rapport espacement/épaisseur des barreaux
 
 #### grille orientée
 
-Domaine de validité de la formule : 1 ≤ e / b ≤ 3
+Domaine de validité de la formule : \(1 \leq e / b \leq 3\) avec \(e\) l'espacement libre entre les barreaux.
 
-### Obstruction globale du plan de grille (barreaux + entretoises + éléments de supports longitudinaux et transversaux) retenue
+### Obstruction globale du plan de grille pour les grilles conventionnelles et orientées
 
-A déterminer à partir des plans de la grille.
+L'obstruction globale (barreaux + entretoises + éléments de supports longitudinaux et transversaux) retenue \(O\) est à déterminer à partir des plans de la grille. Elle doit être supérieure à l'obstruction due aux barreaux seuls qui est donnée par la formule \(b / (b + e)\).
 
-#### grille conventionnelle
+Domaine de validité de la formule pour les grilles conventionnelles : \(0.2 \leq O \leq 0.60\)
 
-Domaine de validité de la formule : 0.2 ≤ O ≤ 0.60
+Domaine de validité de la formule pour les grilles orientées : \(0.35 \leq O \leq 0.60\)
 
-#### grille orientée
-
-Domaine de validité de la formule : 0.35 ≤ O ≤ 0.60
+### Obstruction globale du plan de grille pour les grilles inclinées
 
-#### grille inclinée
+Elle est décomposé en deux parties.
 
-Obstruction due aux barreaux et éléments de supports longitudinaux retenue \(O_b\). A déterminer à partir des plans de la grille.
+L'obstruction due aux barreaux et éléments de supports longitudinaux retenue \(O_b\). A déterminer à partir des plans de la grille. Elle doit être supérieure ou égale à l'obstruction due aux barreaux seuls qui est donnée par la formule \(b / (b + e)\). Domaine de validité de la formule : \(0.28 \leq O \leq 0.53\).
 
-Domaine de validité de la formule : 0.28 ≤ Ob ≤ 0.53
+L'obstruction effective due aux entretoises et éléments de support transversaux rapportée à la section d'écoulement à déterminer à partir des plans de la grille. Domaine de validité de la formule : \(O_{entH} \leq 0.28\)
 
 ### Profil des barreaux
 
@@ -155,17 +206,16 @@ Le coefficient de forme des barreaux \(c\) vaut 1.69 pour le profil rectangulair
 
 Le coefficient de forme des barreaux \(a\) vaut 3.85 pour le profil rectangulaire (PR) et 2.10 pour le profil hydrodynamique (PH).
 
-### Obstruction effective due aux entretoises et éléments de support transversaux rapportée à la section d'écoulement
+### Coefficient de forme moyen des entretoises et éléments transversaux, pondérés selon leurs parts respectives
 
 #### grille inclinée
 
 A déterminer à partir des plans de la grille.
-Domaine de validité de la formule : OentH ≤ 0.28
 
-### Coefficient de forme moyen des entretoises et éléments transversaux, pondérés selon leurs parts respectives
+Vaut par exemple 1.79 pour les entretoises cylindriques, 2.42 pour les entretoises rectangulaires, et de l'ordre de 4 pour les poutres carrées et IPN.
 
-#### grille inclinée
+[^1]: Raynal, S., Courret, D., Chatellier, L., Larinier, M., David, L., 2012. Définition de prises d’eau ichtyocompatibles -Pertes de charge au passage des plans de grille inclinés ou orientés dans des configurations ichtyocompatibles et champs de vitesse à leur approche (POLE RA11.02). https://continuite-ecologique.fr/wp-content/uploads/2019/11/2012_014.pdf
 
-A déterminer à partir des plans de la grille.
+[^2]: Raynal, S., Chatellier, L., Courret, D., Larinier, M., David, L., 2013. An experimental study on fish-friendly trashracks–Part 2. Angled trashracks. Journal of Hydraulic Research 51, 67–75.
 
-Vaut par exemple 1.79 pour les entretoises cylindriques, 2.42 pour les entretoises rectangulaires, et de l'ordre de 4 pour les poutres carrées et IPN.
+[^3]: Raynal, S., Courret, D., Chatellier, L., Larinier, M., David, L., 2013. An experimental study on fish-friendly trashracks–Part 1. Inclined trashracks. Journal of Hydraulic Research 51, 56–66.

src/app/calculators/grille/config.json

@@ -10,7 +10,7 @@
             },
             {
                 "id": "B",
-                "help": "devalaison/grille.html#largeur-de-la-section"
+                "help": "devalaison/grille.html#largeur-de-la-section-b"
             }
         ]
     },
@@ -74,12 +74,12 @@
             },
             {
                 "id": "O",
-                "help": "devalaison/grille.html#obstruction-globale-du-plan-de-grille-barreaux-entretoises-elements-de-supports-longitudinaux-et-transversaux-retenue",
+                "help": "devalaison/grille.html#obstruction-globale-du-plan-de-grille-pour-les-grilles-conventionnelles-et-orientees",
                 "allowEmpty": true
             },
             {
                 "id": "OEntH",
-                "help": "devalaison/grille.html#obstruction-effective-due-aux-entretoises-et-elements-de-support-transversaux-rapportee-a-la-section-decoulement",
+                "help": "devalaison/grille.html##obstruction-globale-du-plan-de-grille-pour-les-grilles-inclinees",
                 "allowEmpty": true
             },
             {
@@ -95,7 +95,7 @@
         "help": "devalaison/grille.html",
         "resultsHelp": {
             "VAPDG": "devalaison/grille.html#vitesse-dapproche-moyenne-pour-le-debit-maximum-turbine-en-soustrayant-la-partie-superieure-eventuellement-obturee",
-            "VN": "devalaison/grille.html#vitesse-normale-moyenne-pour-le-debit-maximum-turbine",
+            "VN": "devalaison/grille.html#vitesse-normale-moyenne-pour-le-debit-maximum-turbine-v_n",
             "RFB": "devalaison/grille.html#rapport-de-forme-des-barreaux",
             "REEB": "devalaison/grille.html#rapport-espacementepaisseur-des-barreaux"
         }