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] 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