From dee9da8793b56a4af6b21945c0690d671a86d560 Mon Sep 17 00:00:00 2001
From: David Dorchies <david.dorchies@inrae.fr>
Date: Thu, 27 Feb 2025 16:38:48 +0000
Subject: [PATCH 1/6] docs: rename Cemagref discharge laws

Refs #512
---
 docs/fr/calculators/structures/cem_88_d.md | 13 ++++++++++---
 docs/fr/calculators/structures/cem_88_v.md | 10 ++++++----
 src/locale/messages.en.json                |  6 +++---
 src/locale/messages.fr.json                |  6 +++---
 4 files changed, 22 insertions(+), 13 deletions(-)

diff --git a/docs/fr/calculators/structures/cem_88_d.md b/docs/fr/calculators/structures/cem_88_d.md
index 8f40ee292..2fcc2508a 100644
--- a/docs/fr/calculators/structures/cem_88_d.md
+++ b/docs/fr/calculators/structures/cem_88_d.md
@@ -1,8 +1,9 @@
-# CEM88(D) : Déversoir / Orifice (pelle importante)
+# Cemagref-D : Déversoir / Orifice (pelle importante)
 
 ![Schéma CEM 88 D](cem_88_d_schema.jpg)
 
 ## Déversoir - régime dénoyé
+
 (\(h_1 < W et h_2 \leq \frac{2}{3} h_1\))
 
 \(Q = \mu_F L \sqrt{2g} h_1^{3/2}\)
@@ -10,6 +11,7 @@
 Formulation classique du déversoir dénoyé (\(\mu_F \simeq 0.4\)).
 
 ## Déversoir - régime noyé
+
 (\(h_1 < W\) et \(h_2 \geq \frac{2}{3} h_1\))
 
 $$Q = \mu_S L \sqrt{2g} (h_1-h_2)^{1/2} h_2$$
@@ -27,6 +29,7 @@ On peut calculer un coefficient de débit dénoyé équivalent :
 qui permet de juger du degré d’ennoiement du seuil en le comparant au coefficient dénoyé \(\mu_F\) introduit. En effet, le coefficient directeur de l’ouvrage introduit est celui du déversoir dénoyé (\(\mu_F\) proche de \(0.4\)).
 
 ## Orifice - régime dénoyé
+
 (\(h_1 \geq W\) et \(h_2 \leq \frac{2}{3} h_1\))
 
 On prend une formulation du type :
@@ -44,18 +47,20 @@ La continuité vers le fonctionnement à surface libre est assuré quand :
 Il existe deux formulations suivant que l’on est partiellement noyé ou totalement noyé.
 
 ### Régime partiellement noyé
+
 (\(h_1 \geq W\) et \(\frac{2}{3} h_1 < h_2 < \frac{2}{3} h_1 + \frac{W}{3}\))
 
 \(Q = \mu_F L \sqrt{2g} \left[ \frac{3\sqrt{3}}{2} \left( \left( h_1 - h_2 \right)^{1/2} h_2 \right) - \left(h_1 - W \right)^{3/2} \right]\)
 
 ### Régime totalement noyé
+
 (\(h_1 \geq W\) et \(\frac{2}{3} h_1 + \frac{W}{3} < h_2\))
 
 $$Q = \mu' L \sqrt{2g} (h_1-h_2)^{1/2} \left[ h_2 - (h_2 - W) \right] \Rightarrow Q = \mu' L \sqrt{2g} (h_1-h_2)^{1/2} W$$
 
 Formulation classique des orifices noyés, avec \(\mu' = \mu_S\).
 
-Le fonctionnement déversoir orifice est représenté par les équations ci-dessus et la figure 19. Quel que soit le type d’écoulement en charge, on calcule un coefficient de débit dénoyé équivalent correspondant à la formulation classique de l’orifice dénoyé :
+Le fonctionnement déversoir orifice est représenté par les équations ci-dessus et la figure ci-dessous. Quel que soit le type d’écoulement en charge, on calcule un coefficient de débit dénoyé équivalent correspondant à la formulation classique de l’orifice dénoyé :
 
 \(C_F = \frac{Q}{L \sqrt{2g} W (h_1 - 0.5 W)^{1/2}}\)
 
@@ -67,4 +72,6 @@ Le fonctionnement déversoir orifice est représenté par les équations ci-dess
  * (16) : Orifice - totalement noyé
  * (14) : Orifice - dénoyé
 
-Figure 19. Déversoir - Orifice
+## Références
+
+Baume, Jean-Pierre. 1988. « Modélisation des ouvrages de type : déversoir, vanne, orifice, dans les modèles d’hydraulique à surface libre ». Montpellier n°205-Document de travail 87.1. Montpellier, France: CEMAGREF. https://hal.inrae.fr/hal-04970129
diff --git a/docs/fr/calculators/structures/cem_88_v.md b/docs/fr/calculators/structures/cem_88_v.md
index 1dbc77682..1393e1bc1 100644
--- a/docs/fr/calculators/structures/cem_88_v.md
+++ b/docs/fr/calculators/structures/cem_88_v.md
@@ -1,4 +1,4 @@
-# CEM88(V) : Déversoir / Vanne de fond (pelle faible)
+# Cemagref-V : Déversoir / Vanne de fond (pelle faible)
 
 ![Schéma CEM 88 V](cem_88_v_schema.jpg)
 
@@ -62,7 +62,7 @@ avec : \(\alpha_1 = 1 - 0.14 \frac{h_2 - W}{W}\)
 
 \((\alpha_1 = \alpha (h_2-W))\)
 
-Le fonctionnement déversoir-vanne est représenté par les équations ci-dessus et la figure 20. Quel que soit le type d’écoulement en charge, on calcule un coefficient de débit dénoyé équivalent correspondant à une formulation classique de la vanne dénoyée :
+Le fonctionnement déversoir-vanne est représenté par les équations ci-dessus et la figure ci-dessous. Quel que soit le type d’écoulement en charge, on calcule un coefficient de débit dénoyé équivalent correspondant à une formulation classique de la vanne dénoyée :
 
 \(C_F = \frac{Q}{L\sqrt{2g} W \sqrt{h_1}}\)
 
@@ -70,7 +70,7 @@ Le coefficient directeur par défaut pour l’ouvrage est un coefficient \(C_G\)
 
 Remarque : il est possible d’obtenir \(C_F \neq C_G\), même en régime dénoyé, du moment que le coefficient de débit augmente avec le rapport \(\frac{h_1}{W}\).
 
-![Graphique CEM 88 V](cem_88_v_graphique.jpg)
+![Abaque de l'ennoiement pour la formule Cemagref-V](cem_88_v_graphique.jpg)
 
  * (12) : Déversoir - dénoyé
  * (19) : Orifice - partiellement noyé
@@ -78,4 +78,6 @@ Remarque : il est possible d’obtenir \(C_F \neq C_G\), même en régime dénoy
  * (20) : Orifice - totalement noyé
  * (18) : Orifice - dénoyé
 
-Figure 20. Déversoir - orifice
+## Références
+
+Baume, Jean-Pierre. 1988. « Modélisation des ouvrages de type : déversoir, vanne, orifice, dans les modèles d’hydraulique à surface libre ». Montpellier n°205-Document de travail 87.1. Montpellier, France: CEMAGREF. https://hal.inrae.fr/hal-04970129
diff --git a/src/locale/messages.en.json b/src/locale/messages.en.json
index 69a48fd7e..86c128dcf 100755
--- a/src/locale/messages.en.json
+++ b/src/locale/messages.en.json
@@ -331,8 +331,8 @@
     "INFO_LIB_LOIDEBIT_TRIANGULARWEIRBROAD": "Broad-crested weir (Bos)",
     "INFO_LIB_LOIDEBIT_TRIANGULARWEIRFREE": "Sharp-crested weir (Villemonte)",
     "INFO_LIB_LOIDEBIT_TRIANGULARTRUNCWEIRFREE": "Sharp-crested weir (Villemonte)",
-    "INFO_LIB_LOIDEBIT_GATECEM88D": "Broad-crested weir / Orifice (Cemagref)",
-    "INFO_LIB_LOIDEBIT_GATECEM88V": "Broad-crested weir / sluice gate (Cemagref)",
+    "INFO_LIB_LOIDEBIT_GATECEM88D": "Broad-crested weir / Orifice (Cemagref-D)",
+    "INFO_LIB_LOIDEBIT_GATECEM88V": "Broad-crested weir / sluice gate (Cemagref-V)",
     "INFO_LIB_LOIDEBIT_WEIRCEM88D": "Broad-crested weir (Cemagref-D)",
     "INFO_LIB_LOIDEBIT_WEIRCEM88V": "Broad-crested weir (Cemagref-V)",
     "INFO_LIB_LOIDEBIT_CUNGE80": "Broad-crested weir / orifice (Cunge)",
@@ -484,7 +484,7 @@
     "INFO_PAB_LOIDEBIT_TRIANGULARWEIRBROAD": "V-notch broad-crested weir (Bos)",
     "INFO_PAB_LOIDEBIT_TRIANGULARWEIRFREE": "V-notch sharp-crested weir (Villemonte)",
     "INFO_PAB_LOIDEBIT_TRIANGULARTRUNCWEIRFREE": "Truncated triangular weir (Villemonte)",
-    "INFO_PAB_LOIDEBIT_GATECEM88D": "Broad-crested weir / Orifice (Cemagref)",
+    "INFO_PAB_LOIDEBIT_GATECEM88D": "Broad-crested weir / Orifice (Cemagref-D)",
     "INFO_PAB_LOIDEBIT_VANLEVLARINIER": "Regulated submerged slot (Larinier)",
     "INFO_PAB_LOIDEBIT_VANLEVVILLEMONTE": "Regulated notch (Villemonte)",
     "INFO_PAB_LOIDEBIT_WEIRCEM88D": "Broad-crested weir (Cemagref-D)",
diff --git a/src/locale/messages.fr.json b/src/locale/messages.fr.json
index a7bfbdfd0..6dac4cd3c 100755
--- a/src/locale/messages.fr.json
+++ b/src/locale/messages.fr.json
@@ -332,8 +332,8 @@
     "INFO_LIB_LOIDEBIT_TRIANGULARWEIRBROAD": "Seuil épais (Bos)",
     "INFO_LIB_LOIDEBIT_TRIANGULARWEIRFREE": "Seuil mince (Villemonte)",
     "INFO_LIB_LOIDEBIT_TRIANGULARTRUNCWEIRFREE": "Seuil mince (Villemonte)",
-    "INFO_LIB_LOIDEBIT_GATECEM88D": "Seuil épais / Orifice (Cemagref)",
-    "INFO_LIB_LOIDEBIT_GATECEM88V": "Seuil épais / Vanne de fond (Cemagref)",
+    "INFO_LIB_LOIDEBIT_GATECEM88D": "Seuil épais / Orifice (Cemagref-D)",
+    "INFO_LIB_LOIDEBIT_GATECEM88V": "Seuil épais / Vanne de fond (Cemagref-V)",
     "INFO_LIB_LOIDEBIT_WEIRCEM88D": "Seuil épais (Cemagref-D)",
     "INFO_LIB_LOIDEBIT_WEIRCEM88V": "Seuil épais (Cemagref-V)",
     "INFO_LIB_LOIDEBIT_CUNGE80": "Seuil épais / orifice (Cunge)",
@@ -485,7 +485,7 @@
     "INFO_PAB_LOIDEBIT_TRIANGULARWEIRBROAD": "Déversoir triangulaire épais (Bos)",
     "INFO_PAB_LOIDEBIT_TRIANGULARWEIRFREE": "Déversoir triangulaire mince (Villemonte)",
     "INFO_PAB_LOIDEBIT_TRIANGULARTRUNCWEIRFREE": "Déversoir triangulaire tronqué (Villemonte)",
-    "INFO_PAB_LOIDEBIT_GATECEM88D": "Seuil épais / Orifice (Cemagref)",
+    "INFO_PAB_LOIDEBIT_GATECEM88D": "Seuil épais / Orifice (Cemagref-D)",
     "INFO_PAB_LOIDEBIT_VANLEVLARINIER": "Fente noyée régulée (Larinier)",
     "INFO_PAB_LOIDEBIT_VANLEVVILLEMONTE": "Échancrure régulée (Villemonte)",
     "INFO_PAB_LOIDEBIT_WEIRCEM88D": "Seuil épais (Cemagref-D)",
-- 
GitLab


From 0ae7a239977ea2e80f0e62ff2343607d5ed7f611 Mon Sep 17 00:00:00 2001
From: David Dorchies <david.dorchies@inrae.fr>
Date: Thu, 27 Feb 2025 17:00:02 +0000
Subject: [PATCH 2/6] docs: add scheme to truncated triangular weir

Refs #512
---
 .../structures/dever_triang_tronque.md          |   4 +++-
 .../structures/dever_triang_tronque_schema.jpg  | Bin 0 -> 51093 bytes
 .../structures/dever_triang_tronque.md          |   4 +++-
 .../structures/dever_triang_tronque_schema.jpg  | Bin 0 -> 51093 bytes
 4 files changed, 6 insertions(+), 2 deletions(-)
 create mode 100644 docs/en/calculators/structures/dever_triang_tronque_schema.jpg
 create mode 100644 docs/fr/calculators/structures/dever_triang_tronque_schema.jpg

diff --git a/docs/en/calculators/structures/dever_triang_tronque.md b/docs/en/calculators/structures/dever_triang_tronque.md
index d7aa9ab98..a98d2a52f 100644
--- a/docs/en/calculators/structures/dever_triang_tronque.md
+++ b/docs/en/calculators/structures/dever_triang_tronque.md
@@ -1,6 +1,8 @@
 # Truncated triangular weir formula
 
-TT1 caracterized by:
+![Diagram of a truncated triangular weir](dever_triang_tronque_schema.jpg)
+
+The truncated triangular weir is characterized by the following parameters:
 
 * \(C_d\): discharge coefficient
 * \(Z_d\): triangle's lower overflow elevation
diff --git a/docs/en/calculators/structures/dever_triang_tronque_schema.jpg b/docs/en/calculators/structures/dever_triang_tronque_schema.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..1a0c6d9064bcf8abc1a0cd2e4ba9e97921e54387
GIT binary patch
literal 51093
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
Uw6s3|0BK?W0J2d|>~=^0*{tIv>;M1&

literal 0
HcmV?d00001

diff --git a/docs/fr/calculators/structures/dever_triang_tronque.md b/docs/fr/calculators/structures/dever_triang_tronque.md
index e6542d8eb..9a82f4694 100644
--- a/docs/fr/calculators/structures/dever_triang_tronque.md
+++ b/docs/fr/calculators/structures/dever_triang_tronque.md
@@ -1,6 +1,8 @@
 # Formule du déversoir triangulaire tronqué
 
-TT1 caractérisé par&nbsp;:
+![Schéma d'un seuil triangulaire tronqué](dever_triang_tronque_schema.jpg)
+
+Le déversoir triangulaire tronqué est caractérisée par les paramètres suivants&nbsp;:
 
 * \(C_d\)&nbsp;: coefficient de débit
 * \(Z_d\)&nbsp;: cote de déversement basse du triangle
diff --git a/docs/fr/calculators/structures/dever_triang_tronque_schema.jpg b/docs/fr/calculators/structures/dever_triang_tronque_schema.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..1a0c6d9064bcf8abc1a0cd2e4ba9e97921e54387
GIT binary patch
literal 51093
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
Uw6s3|0BK?W0J2d|>~=^0*{tIv>;M1&

literal 0
HcmV?d00001

-- 
GitLab


From 1180adda38764e71a30b1892936c4b731b1a60c5 Mon Sep 17 00:00:00 2001
From: David Dorchies <david.dorchies@inrae.fr>
Date: Thu, 27 Feb 2025 17:24:01 +0000
Subject: [PATCH 3/6] docs: add relationship between water level and head

Refs #512
---
 docs/en/calculators/structures/liste.md | 17 +++++++++++++++++
 docs/fr/calculators/structures/liste.md | 17 +++++++++++++++++
 2 files changed, 34 insertions(+)

diff --git a/docs/en/calculators/structures/liste.md b/docs/en/calculators/structures/liste.md
index 59ee1a21f..e636e661d 100644
--- a/docs/en/calculators/structures/liste.md
+++ b/docs/en/calculators/structures/liste.md
@@ -22,6 +22,23 @@
 
 Table: Stage-discharge equations list
 
+## Relationship between water level and load
+
+Most of the flow laws in this documentation refer to the
+**water level** or to the **head**.
+These two concepts are generally confused because kinetic energy is neglected
+(See the detailed calculation of the load in the tool [‘Free flow weir stage-discharge laws’](dever.md)).
+These quantities correspond to the difference in elevation between the upstream free surface
+\(Z_1\) or downstream \(Z_2\) and the base of the weir \(Z_{d}\).
+
+We then have:
+
+$$ h_1 = Z_1 - Z_{d} $$
+
+and
+
+$$ h_2 = Z_2 - Z_{d} $$
+
 ## Sharp-crested or broad-crested weir?
 
 Extract from CETMEF, 2005. Note on weirs : synthesis of flow laws at the right of weirs and spillways. Centre d'Études Techniques Maritimes Et Fluviales, Compiègne.
diff --git a/docs/fr/calculators/structures/liste.md b/docs/fr/calculators/structures/liste.md
index 29f05d56b..a7c6feb1e 100644
--- a/docs/fr/calculators/structures/liste.md
+++ b/docs/fr/calculators/structures/liste.md
@@ -22,6 +22,23 @@
 
 Table: Liste des équations d'ouvrages
 
+## Relation entre cote de l'eau et charge
+
+La plupart des lois de débit de cette documentation font référence à la
+**hauteur d'eau** \(h\) ou à la **charge** \(H\).
+Ces deux notions sont généralement confondues car l'énergie cinétique est négligée
+(Voir le détail du calcul de la charge dans l'outil ["Lois de déversoirs dénoyés"](dever.md)).
+Ces grandeurs correspondent à la différence de cote entre la surface libre amont
+\(Z_1\) ou aval \(Z_2\) et la base du seuil déversant \(Z_{d}\).
+
+On a alors:
+
+$$ h_1 = Z_1 - Z_{d} $$
+
+et
+
+$$ h_2 = Z_2 - Z_{d} $$
+
 ## Seuil à crête mince ou crête épaisse ?
 
 Extrait de 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.
-- 
GitLab


From c046463897cb5fce9d4bc419030a538cf90f0b92 Mon Sep 17 00:00:00 2001
From: David Dorchies <david.dorchies@inrae.fr>
Date: Thu, 27 Feb 2025 17:24:39 +0000
Subject: [PATCH 4/6] docs: homogenise h1 h2 for discharge laws

Refs #512
---
 docs/en/calculators/structures/cunge_80.md           |  2 +-
 .../calculators/structures/dever_triang_tronque.md   |  8 ++++----
 docs/en/calculators/structures/seuil_denoye.md       |  4 ++--
 docs/en/calculators/structures/seuil_noye.md         |  4 ++--
 docs/en/calculators/structures/vanne_denoyee.md      |  8 ++++----
 docs/en/calculators/structures/vanne_noyee.md        |  2 +-
 docs/fr/calculators/structures/cunge_80.md           |  2 +-
 .../calculators/structures/dever_triang_tronque.md   |  8 ++++----
 docs/fr/calculators/structures/seuil_denoye.md       |  4 ++--
 docs/fr/calculators/structures/seuil_noye.md         | 12 ++++++------
 docs/fr/calculators/structures/vanne_denoyee.md      |  8 ++++----
 docs/fr/calculators/structures/vanne_noyee.md        |  2 +-
 12 files changed, 32 insertions(+), 32 deletions(-)

diff --git a/docs/en/calculators/structures/cunge_80.md b/docs/en/calculators/structures/cunge_80.md
index 6748bf7d7..70a367e77 100644
--- a/docs/en/calculators/structures/cunge_80.md
+++ b/docs/en/calculators/structures/cunge_80.md
@@ -38,7 +38,7 @@ $$ W \leq Z_2$$
 
 The free flow gate equation uses a fixed contraction coefficient \(C_c\) with:
 
-\(C_d = \frac{C_c}{\sqrt{1 + C_c W / h_{am}}}\)
+\(C_d = \frac{C_c}{\sqrt{1 + C_c W / h_1}}\)
 
 For all other flow regimes, used equations here are the following as they can be used independently:
 
diff --git a/docs/en/calculators/structures/dever_triang_tronque.md b/docs/en/calculators/structures/dever_triang_tronque.md
index a98d2a52f..ac02ef3f7 100644
--- a/docs/en/calculators/structures/dever_triang_tronque.md
+++ b/docs/en/calculators/structures/dever_triang_tronque.md
@@ -11,13 +11,13 @@ The truncated triangular weir is characterized by the following parameters:
 
 ## Formula
 
-### for \(Z_{am} \leq Z_t\)
+### for \(Z_1 \leq Z_t\)
 
-$$Q = C_d \frac{B}{2 (Z_t - Z_d)} \left ( Z_{am} - Z_d \right )^{2.5}$$
+$$Q = C_d \frac{B}{2 (Z_t - Z_d)} \left ( Z_1 - Z_d \right )^{2.5}$$
 
-### for \(Z_{am} > Z_t\)
+### for \(Z_1 > Z_t\)
 
-$$Q = C_d \frac{B}{2 (Z_t - Z_d)} \left ( \left ( Z_{am} - Z_d \right )^{2.5} - \left ( Z_{am} - Z_t \right )^{2.5} \right )$$
+$$Q = C_d \frac{B}{2 (Z_t - Z_d)} \left ( \left ( Z_1 - Z_d \right )^{2.5} - \left ( Z_1 - Z_t \right )^{2.5} \right )$$
 
 Thin wall weir: \(C_d\) = 1.37
 
diff --git a/docs/en/calculators/structures/seuil_denoye.md b/docs/en/calculators/structures/seuil_denoye.md
index 395b1d86c..f756f9dc7 100644
--- a/docs/en/calculators/structures/seuil_denoye.md
+++ b/docs/en/calculators/structures/seuil_denoye.md
@@ -2,9 +2,9 @@
 
 The formula is derived from the original formula of Poleni (1717).
 
-In a free flow, the flow rate depends only on the upstream water level \(h_{amont}\):
+In a free flow, the flow rate depends only on the upstream water level \(h_1\):
 
-$$Q = Cd \sqrt{2g} L h_{amont}^{3/2}$$
+$$Q = Cd \sqrt{2g} L h_1^{3/2}$$
 
 With:
 
diff --git a/docs/en/calculators/structures/seuil_noye.md b/docs/en/calculators/structures/seuil_noye.md
index 2fb05939a..4dc2a7051 100644
--- a/docs/en/calculators/structures/seuil_noye.md
+++ b/docs/en/calculators/structures/seuil_noye.md
@@ -5,9 +5,9 @@
 
 *Excerpt from: Rajaratnam, N., Muralidhar, D., 1969. Flow below deeply submerged rectangular weirs. Journal of Hydraulic Research 7, 355–374.*
 
-In submerged flow, the flow rate depends on the upstream water level \(h_{amont}\) and the downstream water level \(h_{aval}\) (Rajaratnam et al., 1969):
+In submerged flow, the flow rate depends on the upstream water level \(h_1\) and the downstream water level \(h_2\) (Rajaratnam et al., 1969):
 
-$$Q = Cd \sqrt{2g} Lh_{aval} \sqrt{h_{amont}-h_{aval}}$$
+$$Q = Cd \sqrt{2g} Lh_2 \sqrt{h_1-h_2}$$
 
 With:
 
diff --git a/docs/en/calculators/structures/vanne_denoyee.md b/docs/en/calculators/structures/vanne_denoyee.md
index 72dbb3b4f..0f603a49f 100644
--- a/docs/en/calculators/structures/vanne_denoyee.md
+++ b/docs/en/calculators/structures/vanne_denoyee.md
@@ -4,17 +4,17 @@
 
 *Excerpt from Baume, J.-P., Belaud, G., Vion, P.-Y., 2013. Hydraulique pour le génie rural, Formations de Master, Mastère Spécialisé, Ingénieur agronome. UMR G-EAU, Irstea, SupAgro Montpellier.*
 
-\(W\) is the gate opening, \(h_{am}\) the upstream water level and \(L\) the date width.
+\(W\) is the gate opening, \(h_1\) the upstream water level and \(L\) the date width.
 The stage-discharge equation of the free flow sluice gate is derived from Bernoulli's load conservation relationship between the upstream side of the valve and the contracted section.
 
 The height \(h_2\) corresponds to the contracted section and is equal to \(C_c W\) where \(C_c\) is the contraction coefficient. The stage-discharge equation is often expressed as a function of a flow coefficient \(C_{d}\) in the form of:
 
-\(Q = C_d L W \sqrt{2g} \sqrt{h_{am}}\)
+\(Q = C_d L W \sqrt{2g} \sqrt{h_1}\)
 
 So we have the relationship between \(C_d\) and \(C_c\) :
 
-\(C_d = \frac{C_c}{\sqrt{1 + C_c W / h_{am}}}\)
+\(C_d = \frac{C_c}{\sqrt{1 + C_c W / h_1}}\)
 
-Numerous experiments were conducted to evaluate \(C_d\), which varies little around 0.6. As a first approximation, for a low \(W / h_{am}\) (undershot gate, most frequent case), \(C_d\) is close to \(C_c\) and can be chosen equal to 0.6.
+Numerous experiments were conducted to evaluate \(C_d\), which varies little around 0.6. As a first approximation, for a low \(W / h_1\) (undershot gate, most frequent case), \(C_d\) is close to \(C_c\) and can be chosen equal to 0.6.
 
 Discharge coefficients \(C_d\) are given by abacuses, which can be found in specialized books if necessary. They range from 0.5 to 0.6 for a vertical sluice gate, from 0.6 to 0.7 for a radial gate, up to 0.8 for an inclined sluice gate.
diff --git a/docs/en/calculators/structures/vanne_noyee.md b/docs/en/calculators/structures/vanne_noyee.md
index b79759ae4..ef5332ecb 100644
--- a/docs/en/calculators/structures/vanne_noyee.md
+++ b/docs/en/calculators/structures/vanne_noyee.md
@@ -6,6 +6,6 @@
 
 ## Submerged sluice gate equation
 
-\(Q = C'_d LW \sqrt{2g}\sqrt{h_{am} - h_{av}}\)
+\(Q = C'_d LW \sqrt{2g}\sqrt{h_1 - h_2}\)
 
 Coefficient \(C'_d\) is around 0.8.
diff --git a/docs/fr/calculators/structures/cunge_80.md b/docs/fr/calculators/structures/cunge_80.md
index d49de88c7..78d31b377 100644
--- a/docs/fr/calculators/structures/cunge_80.md
+++ b/docs/fr/calculators/structures/cunge_80.md
@@ -40,7 +40,7 @@ $$ W \leq Z_2$$
 
 L'équation de la vanne dénoyée utilise un coefficient de contraction \(C_c\) fixe avec &nbsp;:
 
-\(C_d = \frac{C_c}{\sqrt{1 + C_c W / h_{am}}}\)
+\(C_d = \frac{C_c}{\sqrt{1 + C_c W / h_1}}\)
 
 Pour tous les autres régimes d'écoulement les équations utilisées sont les suivantes telles qu'elles peuvent être indépendamment utilsées&nbsp;:
 
diff --git a/docs/fr/calculators/structures/dever_triang_tronque.md b/docs/fr/calculators/structures/dever_triang_tronque.md
index 9a82f4694..493b9e554 100644
--- a/docs/fr/calculators/structures/dever_triang_tronque.md
+++ b/docs/fr/calculators/structures/dever_triang_tronque.md
@@ -11,13 +11,13 @@ Le déversoir triangulaire tronqué est caractérisée par les paramètres suiva
 
 ## Formule
 
-### pour \(Z_{am} \leq Z_t\)
+### pour \(Z_1 \leq Z_t\)
 
-$$Q = C_d \frac{B}{2 (Z_t - Z_d)} \left ( Z_{am} - Z_d \right )^{2.5}$$
+$$Q = C_d \frac{B}{2 (Z_t - Z_d)} \left ( Z_1 - Z_d \right )^{2.5}$$
 
-### pour \(Z_{am} > Z_t\)
+### pour \(Z_1 > Z_t\)
 
-$$Q = C_d \frac{B}{2 (Z_t - Z_d)} \left ( \left ( Z_{am} - Z_d \right )^{2.5} - \left ( Z_{am} - Z_t \right )^{2.5} \right )$$
+$$Q = C_d \frac{B}{2 (Z_t - Z_d)} \left ( \left ( Z_1 - Z_d \right )^{2.5} - \left ( Z_1 - Z_t \right )^{2.5} \right )$$
 
 Déversoir en mince paroi&nbsp;: \(C_d\) = 1.37
 
diff --git a/docs/fr/calculators/structures/seuil_denoye.md b/docs/fr/calculators/structures/seuil_denoye.md
index 9923c7141..896951248 100644
--- a/docs/fr/calculators/structures/seuil_denoye.md
+++ b/docs/fr/calculators/structures/seuil_denoye.md
@@ -3,9 +3,9 @@
 
 La formule est dérivée de la formule originale de Poleni (1717).
 
-En régime dénoyé, le débit ne dépend que de la hauteur d'eau amont \(h_{amont}\)&nbsp;:
+En régime dénoyé, le débit ne dépend que de la hauteur d'eau amont \(h_1\)&nbsp;:
 
-$$Q = Cd \sqrt{2g} L h_{amont}^{3/2}$$
+$$Q = Cd \sqrt{2g} L h_1^{3/2}$$
 
 Avec&nbsp;:
 
diff --git a/docs/fr/calculators/structures/seuil_noye.md b/docs/fr/calculators/structures/seuil_noye.md
index 37fbfa811..4a65ce01d 100644
--- a/docs/fr/calculators/structures/seuil_noye.md
+++ b/docs/fr/calculators/structures/seuil_noye.md
@@ -2,16 +2,16 @@
 
 ![Schéma du seuil noyé](seuil_noye_schema.png)
 
-En régime noyé, le débit dépend de la hauteur d'eau amont \(h_{amont}\) et de la hauteur aval \(h_{aval}\) (Rajaratnam et al., 1969)&nbsp;:
+En régime noyé, le débit dépend de la hauteur d'eau amont \(h_1\) et de la hauteur aval \(h_2\) (Rajaratnam et al., 1969)&nbsp;:
 
-$$Q = Cd \sqrt{2g} Lh_{aval} \sqrt{h_{amont}-h_{aval}}$$
+$$Q = Cd \sqrt{2g} Lh_2 \sqrt{h_1-h_2}$$
 
 Avec&nbsp;:
 
-* *L* la largeur du seuil en m&nbsp;
-* *h<sub>amont</sub>* la charge sur le seuil à l'amont en m&nbsp;
-* *h<sub>aval</sub>* la charge sur le seuil à l'aval en m&nbsp;
-* *C<sub>d</sub>* le coefficient de débit (égal à 0.9 par défaut).
+* \(L\) la largeur du seuil en m&nbsp;
+* \(h_1\) la charge sur le seuil à l'amont en m
+* \(h_2\) la charge sur le seuil à l'aval en m&nbsp;
+* \(C_d\) le coefficient de débit (égal à 0.9 par défaut).
 
 Cette formule n'est pas conseillée pour un ennoiement inférieur à 80%.
 
diff --git a/docs/fr/calculators/structures/vanne_denoyee.md b/docs/fr/calculators/structures/vanne_denoyee.md
index 602a94f1f..63e0e6b34 100644
--- a/docs/fr/calculators/structures/vanne_denoyee.md
+++ b/docs/fr/calculators/structures/vanne_denoyee.md
@@ -4,17 +4,17 @@
 
 *Extrait de Baume, J.-P., Belaud, G., Vion, P.-Y., 2013. Hydraulique pour le génie rural, Formations de Master, Mastère Spécialisé, Ingénieur agronome. UMR G-EAU, Irstea, SupAgro Montpellier.*
 
-\(W\) est l'ouverture de la vanne, \(h_{am}\) la hauteur d'eau à l'amont et \(L\) la largeur de la vanne.
+\(W\) est l'ouverture de la vanne, \(h_1\) la hauteur d'eau à l'amont et \(L\) la largeur de la vanne.
 L'équation de la vanne dénoyée s'obtient à partir de la relation de Bernoulli de conservation de la charge entre l'amont de la vanne et la section contractée.
 
 La hauteur \(h_2\) correspond à la section contractée et est égale à \(C_c W\) où \(C_c\) est le coefficient de contraction. On exprime souvent l'équation de la vanne dénoyée en fonction d'un coefficient de débit sous la forme :
 
-\(Q = C_d L W \sqrt{2g} \sqrt{h_{am}}\)
+\(Q = C_d L W \sqrt{2g} \sqrt{h_1}\)
 
 Ainsi, on a la relation entre \(C_d\) et \(C_c\) :
 
-\(C_d = \frac{C_c}{\sqrt{1 + C_c W / h_{am}}}\)
+\(C_d = \frac{C_c}{\sqrt{1 + C_c W / h_1}}\)
 
-De nombreuses expériences ont été faites pour évaluer \(C_d\), qui varie peu autour de 0.6. En première approximation, pour \(W / h_{am}\) faible (vanne de fond, cas le plus classique), \(C_d\) est proche de \(C_c\) et peut être pris égal à 0.6.
+De nombreuses expériences ont été faites pour évaluer \(C_d\), qui varie peu autour de 0.6. En première approximation, pour \(W / h_1\) faible (vanne de fond, cas le plus classique), \(C_d\) est proche de \(C_c\) et peut être pris égal à 0.6.
 
 Les coefficients de débit \(C_d\) sont donnés par des abaques, que l'on trouvera dans des ouvrages spécialisés si besoin. Ils sont de l'ordre de 0.5 à 0.6 pour une vanne verticale, de 0.6 à 0.7 pour une vanne radiale, jusqu'à 0.8 pour une vanne inclinée par rapport à la verticale.
diff --git a/docs/fr/calculators/structures/vanne_noyee.md b/docs/fr/calculators/structures/vanne_noyee.md
index c56bfd02c..7ea58ea17 100644
--- a/docs/fr/calculators/structures/vanne_noyee.md
+++ b/docs/fr/calculators/structures/vanne_noyee.md
@@ -6,6 +6,6 @@
 
 ## Équation de la vanne noyée
 
-\(Q = C'_d LW \sqrt{2g}\sqrt{h_{am} - h_{av}}\)
+\(Q = C'_d LW \sqrt{2g}\sqrt{h_1 - h_2}\)
 
 Le coefficient \(C'_d\) est de l'ordre de 0.8.
-- 
GitLab


From 82fdd3f8ce582cb8846844558955199a70496c02 Mon Sep 17 00:00:00 2001
From: David Dorchies <david.dorchies@inrae.fr>
Date: Fri, 28 Feb 2025 07:46:00 +0100
Subject: [PATCH 5/6] docs: add markdown link syntax to all links

Refs #512
---
 docs/en/calculators/devalaison/grille.md             | 11 ++++++-----
 docs/en/calculators/devalaison/jet.md                |  6 +++++-
 docs/en/calculators/pab/passe_rangees_periodiques.md |  7 ++++---
 docs/en/calculators/pam/concentration.md             |  2 +-
 docs/en/calculators/pam/macrorugo.md                 |  4 ++--
 docs/en/calculators/pam/macrorugo_theorie.md         | 10 +++++-----
 docs/en/calculators/pam/rugofond.md                  |  6 +++---
 docs/fr/calculators/devalaison/grille.md             | 12 ++++++------
 docs/fr/calculators/devalaison/jet.md                |  6 +++++-
 docs/fr/calculators/pab/passe_rangees_periodiques.md |  2 +-
 docs/fr/calculators/pam/concentration.md             |  2 +-
 docs/fr/calculators/pam/macrorugo.md                 |  2 +-
 docs/fr/calculators/pam/macrorugo_theorie.md         | 10 +++++-----
 docs/fr/calculators/pam/rugofond.md                  |  4 ++--
 docs/fr/calculators/structures/cem_88_d.md           |  2 +-
 docs/fr/calculators/structures/cem_88_v.md           |  2 +-
 16 files changed, 49 insertions(+), 39 deletions(-)

diff --git a/docs/en/calculators/devalaison/grille.md b/docs/en/calculators/devalaison/grille.md
index 408a0cdd6..2740cd232 100644
--- a/docs/en/calculators/devalaison/grille.md
+++ b/docs/en/calculators/devalaison/grille.md
@@ -9,7 +9,8 @@ and the intake width \(B\) upstream the trashrack:
 
 $$ V_1 = \frac{Q}{H_1 \times B} $$
 
-The calculation of the head loss coefficient \(\xi\) is based on the characteristics of the trashrack. For a full description of the assumptions, formulas and limitations of the method, please refer to the Raynal et al. (2012) report available here (in French): https://continuite-ecologique.fr/wp-content/uploads/2019/11/2012_014.pdf
+The calculation of the head loss coefficient \(\xi\) is based on the characteristics of the trashrack.
+For a full description of the assumptions, formulas and limitations of the method, please refer to the Raynal et al. (2012) report.
 
 
 <div style="position: relative"><a id="grille-conventionnelle" style="position: absolute; top: -60px;"></a></div>
@@ -229,10 +230,10 @@ For example, 1.79 for cylindrical spacers, 2.42 for rectangular spacers, and aro
 
 ## References
 
-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
+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](https://continuite-ecologique.fr/wp-content/uploads/2019/11/2012_014.pdf)
 
-Raynal, S., Courret, D., Chatellier, L., Larinier, M., David, L., 2013a. An experimental study on fish-friendly trashracks–Part 1. Inclined trashracks. Journal of Hydraulic Research 51, 56–66. https://doi.org/10.1080/00221686.2012.753647
+Raynal, S., Courret, D., Chatellier, L., Larinier, M., David, L., 2013a. An experimental study on fish-friendly trashracks–Part 1. Inclined trashracks. Journal of Hydraulic Research 51, 56–66. [https://doi.org/10.1080/00221686.2012.753647](https://doi.org/10.1080/00221686.2012.753647)
 
-Raynal, S., Chatellier, L., Courret, D., Larinier, M., David, L., 2013b. An experimental study on fish-friendly trashracks–Part 2. Angled trashracks. Journal of Hydraulic Research 51, 67–75. https://doi.org/10.1080/00221686.2012.753646
+Raynal, S., Chatellier, L., Courret, D., Larinier, M., David, L., 2013b. An experimental study on fish-friendly trashracks–Part 2. Angled trashracks. Journal of Hydraulic Research 51, 67–75. [https://doi.org/10.1080/00221686.2012.753646](https://doi.org/10.1080/00221686.2012.753646)
 
-Lemkecher, F., Chatellier, L., Courret, D., David, L., 2020. Contribution of Different Elements of Inclined Trash Racks to Head Losses Modeling. Water 12, 966. https://doi.org/10.3390/w12040966
+Lemkecher, F., Chatellier, L., Courret, D., David, L., 2020. Contribution of Different Elements of Inclined Trash Racks to Head Losses Modeling. Water 12, 966. [https://doi.org/10.3390/w12040966](https://doi.org/10.3390/w12040966)
diff --git a/docs/en/calculators/devalaison/jet.md b/docs/en/calculators/devalaison/jet.md
index 02a37c2c6..e67d0cea9 100644
--- a/docs/en/calculators/devalaison/jet.md
+++ b/docs/en/calculators/devalaison/jet.md
@@ -14,7 +14,7 @@ The bottom elevation is used to calculate the depth and the depth to fall ratio.
 
 The downstream fish evacuation outlet ends with a device that empties into the plant's tailrace. This module calculates the position and velocity at the point of impact of the free fall or water vein on the surface of the tailrace water taking into account the initial angle and velocity of the jet and the drop height.
 
-Excerpt from Courret, Dominique, and Michel Larinier. Guide for the design of ichthyocompatible water intakes for small hydroelectric power plants, 2008. https://doi.org/10.13140/RG.2.1.2359.1449, p.24:
+Excerpt from Courret and Larinier (2008), p.24:
 
 > Speeds in the structure and at the point of impact in the tailrace must remain below about 10 m/s, with some organizations even recommending that they not exceed 7-8 m/s (ASCE 1995). (...) The head between the outlet and the water body must not exceed a dozen metres to avoid any risk of injury to fish on impact, whatever their size and mode of fall (free fall or fall in the water vein) (Larinier and Travade 2002). The discharge must also be made in an area of sufficient depth to avoid any risk of injury from mechanical shock. Odeh and Orvis (1998) recommend a minimum depth of about a quarter of the fall, with a minimum of about 1 m.
 
@@ -51,3 +51,7 @@ $$V_z = V_0 \sin \alpha - t * g$$
 ### Speed at impact
 
 $$V_t = \sqrt{ V_x^{2} + V_z^{2} }$$
+
+## References
+
+Courret, Dominique, and Michel Larinier. Guide for the design of ichthyocompatible water intakes for small hydroelectric power plants, 2008. [https://doi.org/10.13140/RG.2.1.2359.1449](https://doi.org/10.13140/RG.2.1.2359.1449)
diff --git a/docs/en/calculators/pab/passe_rangees_periodiques.md b/docs/en/calculators/pab/passe_rangees_periodiques.md
index 05848aa92..4c59a919a 100644
--- a/docs/en/calculators/pab/passe_rangees_periodiques.md
+++ b/docs/en/calculators/pab/passe_rangees_periodiques.md
@@ -1,8 +1,8 @@
 # Nature-like fish passage with riprap in periodic rows
 
 It is stated on p.16 of the design guide for nature-like fishways
-(Larinier et al., 2006)[^passe_rangees_periodiques1] that rock-rigged fishways
-in periodic rows are similar to fish ladders, and their design criteria are identical to those of.
+(Larinier et al., 2006) that rock-rigged fishways in periodic rows are similar
+to fish ladders, and their design criteria are identical to those of.
 
 It is therefore possible to use the various tools in the "[fish ladder](pab.md)" module
 module to design this type of device.
@@ -30,5 +30,6 @@ with, for example, overflows from the weir to different basins in the system
 
 An example of a pass can be accessed directly via [this link](https://cassiopee.g-eau.fr/#/loadsession/app%2Fexamples%2Fpasse_rangees_periodiques.json).
 
+## References
 
-[^passe_rangees_periodiques1]: Larinier, Michel, Dominique Courret, et Peggy Gomes. 2006. « Guide technique pour la conception des passes à poissons “naturelles” ». Rapport GHAPPE RA. Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne. http://dx.doi.org/10.13140/RG.2.1.1834.8562.
+Larinier, Michel, Dominique Courret, et Peggy Gomes. 2006. « Guide technique pour la conception des passes à poissons “naturelles” ». Rapport GHAPPE RA. Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne. [http://dx.doi.org/10.13140/RG.2.1.1834.8562](http://dx.doi.org/10.13140/RG.2.1.1834.8562)
diff --git a/docs/en/calculators/pam/concentration.md b/docs/en/calculators/pam/concentration.md
index 127f6d1dc..28a31f85a 100644
--- a/docs/en/calculators/pam/concentration.md
+++ b/docs/en/calculators/pam/concentration.md
@@ -37,4 +37,4 @@ Tolerance is of the order of a centimetre.
 
 ## References
 
-Larinier, Michel, Courret, D., Gomes, P., 2006. Technical guide for the design of "natural" fish passes, GHAPPE RA Report. Compagnie Nationale du Rhône / Adour Garonne Water Agency. http://dx.doi.org/10.13140/RG.2.1.1834.8562
+Larinier, Michel, Courret, D., Gomes, P., 2006. Technical guide for the design of "natural" fish passes, GHAPPE RA Report. Compagnie Nationale du Rhône / Adour Garonne Water Agency. [http://dx.doi.org/10.13140/RG.2.1.1834.8562](http://dx.doi.org/10.13140/RG.2.1.1834.8562)
diff --git a/docs/en/calculators/pam/macrorugo.md b/docs/en/calculators/pam/macrorugo.md
index fe107c2a0..95a19ea7d 100644
--- a/docs/en/calculators/pam/macrorugo.md
+++ b/docs/en/calculators/pam/macrorugo.md
@@ -28,6 +28,6 @@ It requires the following values to be entered:
 
 ![](schema_rugosite_fond.png)
 
-## references
+## References
 
-Larinier, Michel, Courret, D., Gomes, P., 2006. Technical guide for the design of "natural" fish passes, GHAPPE RA Report. Compagnie Nationale du Rhône / Adour Garonne Water Agency. http://dx.doi.org/10.13140/RG.2.1.1834.8562
+Larinier, Michel, Courret, D., Gomes, P., 2006. Technical guide for the design of "natural" fish passes, GHAPPE RA Report. Compagnie Nationale du Rhône / Adour Garonne Water Agency. [http://dx.doi.org/10.13140/RG.2.1.1834.8562](http://dx.doi.org/10.13140/RG.2.1.1834.8562)
diff --git a/docs/en/calculators/pam/macrorugo_theorie.md b/docs/en/calculators/pam/macrorugo_theorie.md
index 197eef646..eda7a67dc 100644
--- a/docs/en/calculators/pam/macrorugo_theorie.md
+++ b/docs/en/calculators/pam/macrorugo_theorie.md
@@ -234,12 +234,12 @@ $$C_f = \frac{2}{(5.1 \mathrm{log} (h/k_s)+6)^2}$$
 
 ## References
 
-Cassan L, Laurens P. 2016. Design of emergent and submerged rock-ramp fish passes. Knowl. Manag. Aquat. Ecosyst., 417, 45. https://doi.org/10.1051/kmae/2016032
+Cassan L, Laurens P. 2016. Design of emergent and submerged rock-ramp fish passes. Knowl. Manag. Aquat. Ecosyst., 417, 45. [https://doi.org/10.1051/kmae/2016032](https://doi.org/10.1051/kmae/2016032)
 
-Cassan, L., Tien, T.D., Courret, D., Laurens, P., Dartus, D., 2014. Hydraulic Resistance of Emergent Macroroughness at Large Froude Numbers: Design of Nature-Like Fishpasses. Journal of Hydraulic Engineering 140, 04014043. https://doi.org/10.1061/(ASCE)HY.1943-7900.0000910
+Cassan, L., Tien, T.D., Courret, D., Laurens, P., Dartus, D., 2014. Hydraulic Resistance of Emergent Macroroughness at Large Froude Numbers: Design of Nature-Like Fishpasses. Journal of Hydraulic Engineering 140, 04014043. [https://doi.org/10.1061/(ASCE)HY.1943-7900.0000910](https://doi.org/10.1061/(ASCE)HY.1943-7900.0000910)
 
-Larinier, Michel, Courret, D., Gomes, P., 2006. Guide technique pour la conception des passes à poissons “naturelles,” Rapport GHAPPE RA. Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne. http://dx.doi.org/10.13140/RG.2.1.1834.8562
+Larinier, Michel, Courret, D., Gomes, P., 2006. Guide technique pour la conception des passes à poissons “naturelles,” Rapport GHAPPE RA. Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne. [http://dx.doi.org/10.13140/RG.2.1.1834.8562](http://dx.doi.org/10.13140/RG.2.1.1834.8562)
 
-Rice C. E., Kadavy K. C., et Robinson K. M., 1998. Roughness of Loose Rock Riprap on Steep Slopes. Journal of Hydraulic Engineering 124, 179-85. https://doi.org/10.1061/(ASCE)0733-9429(1998)124:2(179)
+Rice C. E., Kadavy K. C., et Robinson K. M., 1998. Roughness of Loose Rock Riprap on Steep Slopes. Journal of Hydraulic Engineering 124, 179-85. [https://doi.org/10.1061/(ASCE)0733-9429(1998)124:2(179)](https://doi.org/10.1061/(ASCE)0733-9429(1998)124:2(179))
 
-Tran, T.D., Chorda, J., Laurens, P., Cassan, L., 2016. Modelling nature-like fishway flow around unsubmerged obstacles using a 2D shallow water model. Environmental Fluid Mechanics 16, 413–428. https://doi.org/10.1007/s10652-015-9430-3
+Tran, T.D., Chorda, J., Laurens, P., Cassan, L., 2016. Modelling nature-like fishway flow around unsubmerged obstacles using a 2D shallow water model. Environmental Fluid Mechanics 16, 413–428. [https://doi.org/10.1007/s10652-015-9430-3](https://doi.org/10.1007/s10652-015-9430-3)
diff --git a/docs/en/calculators/pam/rugofond.md b/docs/en/calculators/pam/rugofond.md
index 8036216fc..813133559 100644
--- a/docs/en/calculators/pam/rugofond.md
+++ b/docs/en/calculators/pam/rugofond.md
@@ -32,7 +32,7 @@ flow slices".
 ### Relationship between upstream head on the crest and flow rate
 
 The relationship between the upstream load and the flow is represented by a [formula of
-free weir].(../structures/seuil_denoye.md).
+free weir](../structures/seuil_denoye.md).
 
 ### Relationship between water depth, flow velocity and uniform flow
 
@@ -56,9 +56,9 @@ With \(a\) the **Strickler correction coefficient** function of how the riprap i
 
 Larinier, M., J. Chorda, et O. Ferlin. 1995. « Le franchissement des seuils en
 enrochements par les poissons migrateurs : étude expérimentale ». GHAAPPE
-95/05-HYDRE 161. irstea. https://hal.inrae.fr/hal-02575575.
+95/05-HYDRE 161. irstea. [https://hal.inrae.fr/hal-02575575](https://hal.inrae.fr/hal-02575575)
 
 Larinier, Michel, Dominique Courret, et Peggy Gomes. 2006. « Guide technique
 pour la conception des passes à poissons “naturelles” ». Rapport GHAPPE RA.
 Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne.
-http://dx.doi.org/10.13140/RG.2.1.1834.8562.
+[http://dx.doi.org/10.13140/RG.2.1.1834.8562](http://dx.doi.org/10.13140/RG.2.1.1834.8562)
diff --git a/docs/fr/calculators/devalaison/grille.md b/docs/fr/calculators/devalaison/grille.md
index 76094f95f..b4fa00eb5 100644
--- a/docs/fr/calculators/devalaison/grille.md
+++ b/docs/fr/calculators/devalaison/grille.md
@@ -9,7 +9,8 @@ et de la largeur de la prise d’eau \(B\) à l’amont du plan de grille&nbsp;:
 
 $$ 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) disponible ici&nbsp;: https://continuite-ecologique.fr/wp-content/uploads/2019/11/2012_014.pdf
+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).
 
 ## Grille conventionnelle
 
@@ -216,11 +217,10 @@ A déterminer à partir des plans de la grille.
 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.
 
 ## Références
+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](https://continuite-ecologique.fr/wp-content/uploads/2019/11/2012_014.pdf)
 
-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
+Raynal, S., Courret, D., Chatellier, L., Larinier, M., David, L., 2013a. An experimental study on fish-friendly trashracks–Part 1. Inclined trashracks. Journal of Hydraulic Research 51, 56–66. [https://doi.org/10.1080/00221686.2012.753647](https://doi.org/10.1080/00221686.2012.753647)
 
-Raynal, S., Courret, D., Chatellier, L., Larinier, M., David, L., 2013a. An experimental study on fish-friendly trashracks–Part 1. Inclined trashracks. Journal of Hydraulic Research 51, 56–66. https://doi.org/10.1080/00221686.2012.753647
+Raynal, S., Chatellier, L., Courret, D., Larinier, M., David, L., 2013b. An experimental study on fish-friendly trashracks–Part 2. Angled trashracks. Journal of Hydraulic Research 51, 67–75. [https://doi.org/10.1080/00221686.2012.753646](https://doi.org/10.1080/00221686.2012.753646)
 
-Raynal, S., Chatellier, L., Courret, D., Larinier, M., David, L., 2013b. An experimental study on fish-friendly trashracks–Part 2. Angled trashracks. Journal of Hydraulic Research 51, 67–75. https://doi.org/10.1080/00221686.2012.753646
-
-Lemkecher, F., Chatellier, L., Courret, D., David, L., 2020. Contribution of Different Elements of Inclined Trash Racks to Head Losses Modeling. Water 12, 966. https://doi.org/10.3390/w12040966
+Lemkecher, F., Chatellier, L., Courret, D., David, L., 2020. Contribution of Different Elements of Inclined Trash Racks to Head Losses Modeling. Water 12, 966. [https://doi.org/10.3390/w12040966](https://doi.org/10.3390/w12040966)
diff --git a/docs/fr/calculators/devalaison/jet.md b/docs/fr/calculators/devalaison/jet.md
index 22fcdaf40..f76180203 100644
--- a/docs/fr/calculators/devalaison/jet.md
+++ b/docs/fr/calculators/devalaison/jet.md
@@ -14,7 +14,7 @@ La cote du fond est utilisée pour calculer la profondeur et le rapport profonde
 
 L'exutoire d'évacuation des poissons vers l'aval se termine par un dispositif se jetant dans le canal de fuite de la centrale. Le présent module permet de calculer la position et la vitesse au point d'impact de la chute libre ou de la veine d'eau à la surface de l'eau du canal de fuite compte tenu de l'angle et de la vitesse initiaux du jet et de la hauteur de chute.
 
-Extrait de Courret, Dominique, et Michel Larinier. Guide pour la conception de prise d’eau ichtyocompatibles pour les petites centrales hydroélectriques, 2008. https://doi.org/10.13140/RG.2.1.2359.1449, p.24&nbsp;:
+Extrait de Courret et Larinier (2008), p.24&nbsp;:
 
 > Les vitesses dans l’ouvrage et au point d’impact dans le bief aval doivent rester inférieures à une dizaine de m/s, certains organismes préconisant même de ne pas dépasser 7-8 m/s (ASCE 1995). (...) La hauteur de chute entre le débouché et le plan d’eau ne doit pas dépasser une douzaine de mètres pour éviter tout risque de blessures des poissons à l’impact, quels que soient leur taille et leur mode de chute (chute libre ou chute dans la veine d’eau) (Larinier et Travade 2002). Le rejet doit également se faire dans une zone d’une profondeur suffisante pour éviter tout risque de blessure par choc mécanique. Odeh et Orvis (1998) préconisent une profondeur minimale de l’ordre du quart de la chute, avec un minimum d’environ 1 m.
 
@@ -51,3 +51,7 @@ $$V_z = V_0 \sin \alpha - t * g$$
 ### Vitesse à l'impact
 
 $$V_t = \sqrt{ V_x^{2} + V_z^{2} }$$
+
+## Références
+
+Courret, Dominique, et Michel Larinier. Guide pour la conception de prise d’eau ichtyocompatibles pour les petites centrales hydroélectriques, 2008. [https://doi.org/10.13140/RG.2.1.2359.1449](https://doi.org/10.13140/RG.2.1.2359.1449)
\ No newline at end of file
diff --git a/docs/fr/calculators/pab/passe_rangees_periodiques.md b/docs/fr/calculators/pab/passe_rangees_periodiques.md
index 017dbb0c8..e1d87fb2a 100644
--- a/docs/fr/calculators/pab/passe_rangees_periodiques.md
+++ b/docs/fr/calculators/pab/passe_rangees_periodiques.md
@@ -32,4 +32,4 @@ avec par exemple des déversés du seuil vers différents bassins du dispositif
 Un exemple de passe est directement accessible via [ce lien](https://cassiopee.g-eau.fr/#/loadsession/app%2Fexamples%2Fpasse_rangees_periodiques.json).
 
 
-[^passe_rangees_periodiques1]: Larinier, Michel, Dominique Courret, et Peggy Gomes. 2006. « Guide technique pour la conception des passes à poissons “naturelles” ». Rapport GHAPPE RA. Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne. http://dx.doi.org/10.13140/RG.2.1.1834.8562.
+[^passe_rangees_periodiques1]: Larinier, Michel, Dominique Courret, et Peggy Gomes. 2006. « Guide technique pour la conception des passes à poissons “naturelles” ». Rapport GHAPPE RA. Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne. [https://dx.doi.org/10.13140/RG.2.1.1834.8562](https://dx.doi.org/10.13140/RG.2.1.1834.8562).
diff --git a/docs/fr/calculators/pam/concentration.md b/docs/fr/calculators/pam/concentration.md
index 0f73795ea..10e742557 100644
--- a/docs/fr/calculators/pam/concentration.md
+++ b/docs/fr/calculators/pam/concentration.md
@@ -37,4 +37,4 @@ La tolérance est de l'ordre du centimètre.
 
 ## Références
 
-Larinier, Michel, Courret, D., Gomes, P., 2006. Guide technique pour la conception des passes à poissons “naturelles,” Rapport GHAPPE RA. Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne. http://dx.doi.org/10.13140/RG.2.1.1834.8562
+Larinier, Michel, Courret, D., Gomes, P., 2006. Guide technique pour la conception des passes à poissons “naturelles,” Rapport GHAPPE RA. Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne. [https://dx.doi.org/10.13140/RG.2.1.1834.8562](https://dx.doi.org/10.13140/RG.2.1.1834.8562)
diff --git a/docs/fr/calculators/pam/macrorugo.md b/docs/fr/calculators/pam/macrorugo.md
index fa963b019..434cd0270 100644
--- a/docs/fr/calculators/pam/macrorugo.md
+++ b/docs/fr/calculators/pam/macrorugo.md
@@ -29,4 +29,4 @@ Il nécessite d'entrer les valeurs suivantes&nbsp;:
 
 ## Références
 
-Larinier, Michel, Courret, D., Gomes, P., 2006. Guide technique pour la conception des passes à poissons “naturelles,” Rapport GHAPPE RA. Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne. http://dx.doi.org/10.13140/RG.2.1.1834.8562
+Larinier, Michel, Courret, D., Gomes, P., 2006. Guide technique pour la conception des passes à poissons “naturelles,” Rapport GHAPPE RA. Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne. [http://dx.doi.org/10.13140/RG.2.1.1834.8562](http://dx.doi.org/10.13140/RG.2.1.1834.8562)
diff --git a/docs/fr/calculators/pam/macrorugo_theorie.md b/docs/fr/calculators/pam/macrorugo_theorie.md
index f1bb2c461..4cea24b90 100644
--- a/docs/fr/calculators/pam/macrorugo_theorie.md
+++ b/docs/fr/calculators/pam/macrorugo_theorie.md
@@ -231,12 +231,12 @@ $$C_f = \frac{2}{(5.1 \mathrm{log} (h/k_s)+6)^2}$$
 
 ## Références
 
-Cassan L, Laurens P. 2016. Design of emergent and submerged rock-ramp fish passes. Knowl. Manag. Aquat. Ecosyst., 417, 45. https://doi.org/10.1051/kmae/2016032
+Cassan L, Laurens P. 2016. Design of emergent and submerged rock-ramp fish passes. Knowl. Manag. Aquat. Ecosyst., 417, 45. [https://doi.org/10.1051/kmae/2016032](https://doi.org/10.1051/kmae/2016032)
 
-Cassan, L., Tien, T.D., Courret, D., Laurens, P., Dartus, D., 2014. Hydraulic Resistance of Emergent Macroroughness at Large Froude Numbers: Design of Nature-Like Fishpasses. Journal of Hydraulic Engineering 140, 04014043. https://doi.org/10.1061/(ASCE)HY.1943-7900.0000910
+Cassan, L., Tien, T.D., Courret, D., Laurens, P., Dartus, D., 2014. Hydraulic Resistance of Emergent Macroroughness at Large Froude Numbers: Design of Nature-Like Fishpasses. Journal of Hydraulic Engineering 140, 04014043. [https://doi.org/10.1061/(ASCE)HY.1943-7900.0000910](https://doi.org/10.1061/(ASCE)HY.1943-7900.0000910)
 
-Larinier, Michel, Courret, D., Gomes, P., 2006. Guide technique pour la conception des passes à poissons “naturelles,” Rapport GHAPPE RA. Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne. http://dx.doi.org/10.13140/RG.2.1.1834.8562
+Larinier, Michel, Courret, D., Gomes, P., 2006. Guide technique pour la conception des passes à poissons “naturelles,” Rapport GHAPPE RA. Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne. [http://dx.doi.org/10.13140/RG.2.1.1834.8562](http://dx.doi.org/10.13140/RG.2.1.1834.8562)
 
-Rice C. E., Kadavy K. C., et Robinson K. M., 1998. Roughness of Loose Rock Riprap on Steep Slopes. Journal of Hydraulic Engineering 124, 179-85. https://doi.org/10.1061/(ASCE)0733-9429(1998)124:2(179)
+Rice C. E., Kadavy K. C., et Robinson K. M., 1998. Roughness of Loose Rock Riprap on Steep Slopes. Journal of Hydraulic Engineering 124, 179-85. [https://doi.org/10.1061/(ASCE)0733-9429(1998)124:2(179)](https://doi.org/10.1061/(ASCE)0733-9429(1998)124:2(179))
 
-Tran, T.D., Chorda, J., Laurens, P., Cassan, L., 2016. Modelling nature-like fishway flow around unsubmerged obstacles using a 2D shallow water model. Environmental Fluid Mechanics 16, 413–428. https://doi.org/10.1007/s10652-015-9430-3
+Tran, T.D., Chorda, J., Laurens, P., Cassan, L., 2016. Modelling nature-like fishway flow around unsubmerged obstacles using a 2D shallow water model. Environmental Fluid Mechanics 16, 413–428. [https://doi.org/10.1007/s10652-015-9430-3](https://doi.org/10.1007/s10652-015-9430-3)
diff --git a/docs/fr/calculators/pam/rugofond.md b/docs/fr/calculators/pam/rugofond.md
index 79ed896d1..89233612c 100644
--- a/docs/fr/calculators/pam/rugofond.md
+++ b/docs/fr/calculators/pam/rugofond.md
@@ -61,9 +61,9 @@ de leur niveau de jointement (Larinier et al., 2006):
 
 Larinier, M., J. Chorda, et O. Ferlin. 1995. « Le franchissement des seuils en
 enrochements par les poissons migrateurs : étude expérimentale ». GHAAPPE
-95/05-HYDRE 161. irstea. https://hal.inrae.fr/hal-02575575.
+95/05-HYDRE 161. irstea. [https://hal.inrae.fr/hal-02575575](https://hal.inrae.fr/hal-02575575).
 
 Larinier, Michel, Dominique Courret, et Peggy Gomes. 2006. « Guide technique
 pour la conception des passes à poissons “naturelles” ». Rapport GHAPPE RA.
 Compagnie Nationale du Rhône / Agence de l'Eau Adour Garonne.
-http://dx.doi.org/10.13140/RG.2.1.1834.8562.
+[https://dx.doi.org/10.13140/RG.2.1.1834.8562](https://dx.doi.org/10.13140/RG.2.1.1834.8562).
diff --git a/docs/fr/calculators/structures/cem_88_d.md b/docs/fr/calculators/structures/cem_88_d.md
index 2fcc2508a..186169582 100644
--- a/docs/fr/calculators/structures/cem_88_d.md
+++ b/docs/fr/calculators/structures/cem_88_d.md
@@ -74,4 +74,4 @@ Le fonctionnement déversoir orifice est représenté par les équations ci-dess
 
 ## Références
 
-Baume, Jean-Pierre. 1988. « Modélisation des ouvrages de type : déversoir, vanne, orifice, dans les modèles d’hydraulique à surface libre ». Montpellier n°205-Document de travail 87.1. Montpellier, France: CEMAGREF. https://hal.inrae.fr/hal-04970129
+Baume, Jean-Pierre. 1988. « Modélisation des ouvrages de type : déversoir, vanne, orifice, dans les modèles d’hydraulique à surface libre ». Montpellier n°205-Document de travail 87.1. Montpellier, France: CEMAGREF. [https://hal.inrae.fr/hal-04970129](https://hal.inrae.fr/hal-04970129)
diff --git a/docs/fr/calculators/structures/cem_88_v.md b/docs/fr/calculators/structures/cem_88_v.md
index 1393e1bc1..b53d7652f 100644
--- a/docs/fr/calculators/structures/cem_88_v.md
+++ b/docs/fr/calculators/structures/cem_88_v.md
@@ -80,4 +80,4 @@ Remarque : il est possible d’obtenir \(C_F \neq C_G\), même en régime dénoy
 
 ## Références
 
-Baume, Jean-Pierre. 1988. « Modélisation des ouvrages de type : déversoir, vanne, orifice, dans les modèles d’hydraulique à surface libre ». Montpellier n°205-Document de travail 87.1. Montpellier, France: CEMAGREF. https://hal.inrae.fr/hal-04970129
+Baume, Jean-Pierre. 1988. « Modélisation des ouvrages de type : déversoir, vanne, orifice, dans les modèles d’hydraulique à surface libre ». Montpellier n°205-Document de travail 87.1. Montpellier, France: CEMAGREF. [https://hal.inrae.fr/hal-04970129](https://hal.inrae.fr/hal-04970129)
-- 
GitLab


From 33d7b9204c57aa8bf85bc963561ed309649c9d39 Mon Sep 17 00:00:00 2001
From: David Dorchies <david.dorchies@inrae.fr>
Date: Fri, 28 Feb 2025 08:21:42 +0100
Subject: [PATCH 6/6] docs: add reference for Cemagref equations

Refs #512
---
 docs/en/calculators/structures/cem_88_d.md | 6 ++++--
 docs/en/calculators/structures/cem_88_v.md | 6 ++++--
 2 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/docs/en/calculators/structures/cem_88_d.md b/docs/en/calculators/structures/cem_88_d.md
index 84de84900..eadb4ebd1 100644
--- a/docs/en/calculators/structures/cem_88_d.md
+++ b/docs/en/calculators/structures/cem_88_d.md
@@ -55,7 +55,7 @@ $$Q = \mu' L \sqrt{2g} (h_1-h_2)^{1/2} \left[ h_2 - (h_2 - W) \right] \Rightarro
 
 Classical formulation of submerged orifices, with \(\mu' = \mu_S\).
 
-Orifice weir operation is represented by the equations above and Figure 19. Regardless of the type of flow under load, an equivalent free flow coefficient is calculated corresponding to the conventional free orifice formulation:
+Orifice weir operation is represented by the equations above and Figure below. Regardless of the type of flow under load, an equivalent free flow coefficient is calculated corresponding to the conventional free orifice formulation:
 
 \(C_F = \frac{Q}{L \sqrt{2g} W (h_1 - 0.5 W)^{1/2}}\)
 
@@ -67,4 +67,6 @@ Orifice weir operation is represented by the equations above and Figure 19. Rega
  * (16) : Orifice - totally submerged
  * (14) : Orifice - free flow
 
-Figure 19. Weir - Orifice
+## References
+
+Baume, Jean-Pierre. 1988. « Modélisation des ouvrages de type : déversoir, vanne, orifice, dans les modèles d’hydraulique à surface libre ». Montpellier n°205-Document de travail 87.1. Montpellier, France: CEMAGREF. [https://hal.inrae.fr/hal-04970129](https://hal.inrae.fr/hal-04970129)
diff --git a/docs/en/calculators/structures/cem_88_v.md b/docs/en/calculators/structures/cem_88_v.md
index 7565eea7e..334198b43 100644
--- a/docs/en/calculators/structures/cem_88_v.md
+++ b/docs/en/calculators/structures/cem_88_v.md
@@ -62,7 +62,7 @@ with : \(\alpha_1 = 1 - 0.14 \frac{h_2 - W}{W}\)
 
 \((\alpha_1 = \alpha (h_2-W))\)
 
-Weir gate operation is represented by the above equations and Figure 20. Regardless of the type of flow under load, an equivalent free flow coefficient is calculated corresponding to a conventional free flow gate design:
+Weir gate operation is represented by the above equations and Figure below. Regardless of the type of flow under load, an equivalent free flow coefficient is calculated corresponding to a conventional free flow gate design:
 
 \(C_F = \frac{Q}{L\sqrt{2g} W \sqrt{h_1}}\)
 
@@ -78,4 +78,6 @@ Note: it is possible to obtain \(C_F \neq C_G\), even under free flow conditions
  * (20) : Orifice - totally submerged
  * (18) : Orifice - free flow
 
-Figure 20. Weir - orifice
+## References
+
+Baume, Jean-Pierre. 1988. « Modélisation des ouvrages de type : déversoir, vanne, orifice, dans les modèles d’hydraulique à surface libre ». Montpellier n°205-Document de travail 87.1. Montpellier, France: CEMAGREF. [https://hal.inrae.fr/hal-04970129](https://hal.inrae.fr/hal-04970129)
-- 
GitLab