feat: Add V-notch broad-crested weir discharge formula

- Add translations
- Update documentation

Fix #399

docs/en/calculators/structures/dever_triang.md

-# Triangular weir formula
+# V-notch weir formula
 
-T1 caracterized by: 
+![Perspective view of a triangular weir](dever_triang.png)
 
-* \(C_d\): discharge coefficient
-* \(\alpha\): half angle at the apex of the triangle
-* \(Z_d\): elevation of the tip of the triangle
+*Perspective view of a triangular weir (from CETMEF, 2005[^1])*
 
-## Formula
+## Free flow formula
 
-$$Q = C_d * tg \frac{\alpha}{2} \left ( Z_{am} - Z_d \right )^{2.5}$$
+$$Q = C_d * \tan \left( \frac{\alpha}{2} \right) \left ( Z_{1} - Z_d \right )^{2.5}$$
 
-Thin wall weir: \(C_d\) = 1.37
+Avec:
 
-Thick weir without contraction (rounded \(r > 0.1 * h1\)): \(C_d\) = 1.27
+* \(C_d\) : discharge coefficient
+* \(\alpha / 2\) : half-angle at the apex of the triangle
+* \(Z_1\) : upstream water elevation
+* \(Z_d\) : spill elevation at the tip of the triangle
 
-Triangular profile weir: (1/2 upstream, 1/2 or 1/5 downstream): \(C_d\) = 1.68 and 1.56
+The discharge coefficient \(C_d\) depends, among other things, on the thickness of the weir:
+
+- Sharp-crested weir : \(C_d\) = 1.37
+- Broad-crested weir (rounded off \(r > 0.1 * h1\)) : \(C_d\) = 1.27
+- triangular profile weir : (1/2 upstream, 1/2 or 1/5 downstream) : \(C_d\) = 1.68 and 1.56
+
+## Submergence of a V-notch sharp-crested weir
+
+The weir is submerged as soon as \(Z_{2} > Z_{d}\) and [the Villemonte reduction coefficient](villemonte_1947.md) is then applied to the discharge calculated in free flow.
+
+## Submergence of a V-notch broad-crested weir
+
+Submergence occurs for \(h_2 / h_1 > 4 / 5\) with \(h_1 = Z_1 - Z_d\) and \(h_2 = Z_2 - Z_d\), and with \(Z_2\) the downstream water elevation.
+
+The reduction coefficient proposed by Bos (1989) [^2] is then applied:
+
+![Submergence reduction factor for a V-notch broad-crested weir (from Bos, 1989 [^2])](dever_triang_abaque_bos.png)
+
+*Submergence reduction factor for a V-notch broad-crested weir (from Bos, 1989 [^2])*
+
+The abacus is approximated by the following formula:
+
+$$K_s = sin(3.9629 (1 - h_2 / h_1)^{0.575})$$
+
+[^1]: CETMEF, 2005. Notice sur les déversoirs : synthèse des lois d’écoulement au droit des seuils et déversoirs. Centre d’Études Techniques Maritimes Et Fluviales, Compiègne.
+
+[^2]: Bos, M.G., 1989. Discharge measurement structures., 3rd edition. ed, Publication. International Institute for Land Reclamation and Improvement, Wageningen, The Netherlands.

docs/fr/calculators/structures/dever_triang.md

 # Formule du déversoir triangulaire
 
-T1 caractérisé par : 
+![Vue en perspective d'un déversoir triangulaire](dever_triang.png)
+
+*Vue en perspective d'un déversoir triangulaire (d'après CETMEF, 2005[^1])*
+
+## Formule du déversoir dénoyé
+
+$$Q = C_d * \tan \left( \frac{\alpha}{2} \right) \left ( Z_{1} - Z_d \right )^{2.5}$$
+
+Avec:
 
 * \(C_d\) : coefficient de débit
-* \(\alpha\) : demi-angle au sommet du triangle
+* \(\alpha / 2\) : le demi-angle au sommet du triangle
+* \(Z_1\) : cote de l'eau à l'amont du seuil
 * \(Z_d\) : cote de déversement de la pointe du triangle
 
-## Formule
+Le coefficient de débit \(C_d\) dépend notamment de l'épaisseur du déversoir:
+
+- Déversoir en mince paroi : \(C_d\) = 1.37
+- Déversoir épais sans contraction (arrondi \(r > 0.1 * h1\)) : \(C_d\) = 1.27
+- Déversoir à profil triangulaire : (1/2 amont, 1/2 ou 1/5 aval) : \(C_d\) = 1.68 et 1.56
+
+## Ennoiement d'un seuil triangulaire mince
+
+Le seuil est noyé dès que \(Z_{2} > Z_{d}\) et [le coefficient de réduction de Villemonte](villemonte_1947.md) est alors appliqué sur le débit calculé en régime dénoyé.
+
+## Ennoiement d'un seuil triangulaire épais
+
+L'ennoiement a lieu pour \(h_2 / h_1 > 4 / 5\) avec \(h_1 = Z_1 - Z_d\) et \(h_2 = Z_2 - Z_d\), et avec \(Z_2\) la cote de l'eau à l'aval du seuil.
+
+Le coefficient de réduction proposé par Bos (1989)[^2] est alors appliqué:
+
+![Coefficient d'ennoiement pour un déversoir triangulaire à crête épaisse (d'après Bos, 1989 [^2])](dever_triang_abaque_bos.png)
+
+*Coefficient d'ennoiement pour un déversoir triangulaire à crête épaisse (extrait de Bos, 1989 [^2])*
 
-$$Q = C_d * tg \frac{\alpha}{2} \left ( Z_{am} - Z_d \right )^{2.5}$$
+L'abaque est approché par la formule suivante :
 
-Déversoir en mince paroi : \(C_d\) = 1.37
+$$K_s = sin(3.9629 (1 - h_2 / h_1)^{0.575})$$
 
-Déversoir épais sans contraction (arrondi \(r > 0.1 * h1\)) : \(C_d\) = 1.27
+[^1]: CETMEF, 2005. Notice sur les déversoirs : synthèse des lois d’écoulement au droit des seuils et déversoirs. Centre d’Études Techniques Maritimes Et Fluviales, Compiègne.
 
-Déversoir à profil triangulaire : (1/2 amont, 1/2 ou 1/5 aval) : \(C_d\) = 1.68 et 1.56
+[^2]: Bos, M.G., 1989. Discharge measurement structures., 3rd edition. ed, Publication. International Institute for Land Reclamation and Improvement, Wageningen, The Netherlands.

src/app/calculators/cloisons/config.json

@@ -35,6 +35,7 @@
                     "SeuilRectangulaire_WeirVillemonte": "structures/kivi.html",
                     "SeuilRectangulaire_WeirSubmergedLarinier": "structures/fente_noyee.html",
                     "SeuilTriangulaire_TriangularWeirFree": "structures/dever_triang.html",
+                    "SeuilTriangulaire_TriangularWeirBroad": "structures/dever_triang.html",
                     "SeuilTriangulaireTrunc_TriangularTruncWeirFree": "structures/dever_triang_tronque.html"
                 }
             },

src/app/calculators/cloisons/en.json

@@ -16,7 +16,8 @@
     "select_loidebit_SeuilRectangulaire_WeirSubmergedLarinier": "Submerged slot (Larinier 1992)",
     "select_loidebit_SeuilRectangulaire_WeirVillemonte": "Villemonte 1947",
 
-    "select_loidebit_SeuilTriangulaire_TriangularWeirFree": "Triangular weir (Villemonte)",
+    "select_loidebit_SeuilTriangulaire_TriangularWeirFree": "V-notch sharp-crested weir (Villemonte)",
+    "select_loidebit_SeuilTriangulaire_TriangularWeirBroad": "V-notch broad-crested weir (Bos)",
 
     "select_loidebit_SeuilTriangulaireTrunc_TriangularTruncWeirFree": "Truncated triangular weir (Villemonte)",
 

src/app/calculators/cloisons/fr.json

@@ -13,7 +13,8 @@
     "select_loidebit_SeuilRectangulaire_WeirSubmergedLarinier": "Fente noyée (Larinier 1992)",
     "select_loidebit_SeuilRectangulaire_WeirVillemonte": "Villemonte 1947",
 
-    "select_loidebit_SeuilTriangulaire_TriangularWeirFree": "Déversoir triangulaire (Villemonte)",
+    "select_loidebit_SeuilTriangulaire_TriangularWeirFree": "Déversoir triangulaire mince (Villemonte)",
+    "select_loidebit_SeuilTriangulaire_TriangularWeirBroad": "Déversoir triangulaire épais (Bos)",
 
     "select_loidebit_SeuilTriangulaireTrunc_TriangularTruncWeirFree": "Déversoir triangulaire tronqué (Villemonte)",
 

src/app/calculators/parallelstructure/config.json

@@ -40,6 +40,7 @@
                     "SeuilRectangulaire_WeirSubmerged": "structures/seuil_noye.html",
                     "SeuilRectangulaire_WeirFree": "structures/seuil_denoye.html",
                     "SeuilTriangulaire_TriangularWeirFree": "structures/dever_triang.html",
+                    "SeuilTriangulaire_TriangularWeirBroad": "structures/dever_triang.html",
                     "SeuilTriangulaireTrunc_TriangularTruncWeirFree": "structures/dever_triang_tronque.html"
                 }
             },

src/app/calculators/parallelstructure/en.json

@@ -17,7 +17,8 @@
     "select_loidebit_VanneRectangulaire_RectangularOrificeFree": "Free flow gate",
     "select_loidebit_VanneRectangulaire_RectangularOrificeSubmerged": "Submerged gate",
 
-    "select_loidebit_SeuilTriangulaire_TriangularWeirFree": "Triangular weir (Villemonte)",
+    "select_loidebit_SeuilTriangulaire_TriangularWeirFree": "V-notch sharp-crested weir (Villemonte)",
+    "select_loidebit_SeuilTriangulaire_TriangularWeirBroad": "V-notch broad-crested weir (Bos)",
 
     "select_loidebit_SeuilTriangulaireTrunc_TriangularTruncWeirFree": "Truncated triangular weir (Villemonte)",
 

src/app/calculators/parallelstructure/fr.json

@@ -17,7 +17,8 @@
     "select_loidebit_VanneRectangulaire_RectangularOrificeFree": "Vanne dénoyée",
     "select_loidebit_VanneRectangulaire_RectangularOrificeSubmerged": "Vanne noyée",
 
-    "select_loidebit_SeuilTriangulaire_TriangularWeirFree": "Déversoir triangulaire (Villemonte)",
+    "select_loidebit_SeuilTriangulaire_TriangularWeirFree": "Déversoir triangulaire mince (Villemonte)",
+    "select_loidebit_SeuilTriangulaire_TriangularWeirBroad": "Déversoir triangulaire épais (Bos)",
 
     "select_loidebit_SeuilTriangulaireTrunc_TriangularTruncWeirFree": "Déversoir triangulaire tronqué (Villemonte)",
 

src/locale/messages.en.json

@@ -305,7 +305,8 @@
     "INFO_LOIDEBIT_WeirSubmergedLarinier": "Submerged slot (Larinier 1992)",
     "INFO_LOIDEBIT_OrificeSubmerged": "Submerged orifice",
     "INFO_LOIDEBIT_OrificeFree": "Free orifice",
-    "INFO_LOIDEBIT_TriangularWeirFree": "Triangular weir (Villemonte)",
+    "INFO_LOIDEBIT_TriangularWeirBroad": "V-notch broad-crested weir (Bos)",
+    "INFO_LOIDEBIT_TriangularWeirFree": "V-notch sharp-crested weir (Villemonte)",
     "INFO_LOIDEBIT_TriangularTruncWeirFree": "Truncated triangular weir (Villemonte)",
     "INFO_LOIDEBIT_GateCem88d": "Weir/Orifice Cemagref 88",
     "INFO_LOIDEBIT_GateCem88v": "Weir/Undershot gate Cemagref 88",

src/locale/messages.fr.json

@@ -304,7 +304,8 @@
     "INFO_LOIDEBIT_WeirSubmergedLarinier": "Fente noyée (Larinier 1992)",
     "INFO_LOIDEBIT_OrificeSubmerged": "Orifice noyé",
     "INFO_LOIDEBIT_OrificeFree": "Orifice dénoyé",
-    "INFO_LOIDEBIT_TriangularWeirFree": "Déversoir triangulaire (Villemonte)",
+    "INFO_LOIDEBIT_TriangularWeirBroad": "Déversoir triangulaire épais (Bos)",
+    "INFO_LOIDEBIT_TriangularWeirFree": "Déversoir triangulaire mince (Villemonte)",
     "INFO_LOIDEBIT_TriangularTruncWeirFree": "Déversoir triangulaire tronqué (Villemonte)",
     "INFO_LOIDEBIT_GateCem88d": "Déversoir/Orifice Cemagref 88",
     "INFO_LOIDEBIT_GateCem88v": "Déversoir/Vanne de fond Cemagref 88",