From 9422fa7548e0b4667744c36053d7d69e842ac3f3 Mon Sep 17 00:00:00 2001
From: David Dorchies <david.dorchies@irstea.fr>
Date: Tue, 2 Feb 2021 17:53:27 +0100
Subject: [PATCH] doc: improve macrorugo concentration block documentation

---
 docs/en/calculators/pam/concentration.md | 22 ++++++++++++++++++++--
 docs/en/calculators/pam/macrorugo.md     |  4 ----
 docs/fr/calculators/pam/concentration.md | 23 +++++++++++++++++++++--
 docs/fr/calculators/pam/macrorugo.md     |  4 ----
 4 files changed, 41 insertions(+), 12 deletions(-)

diff --git a/docs/en/calculators/pam/concentration.md b/docs/en/calculators/pam/concentration.md
index 372c6b12d..347267607 100644
--- a/docs/en/calculators/pam/concentration.md
+++ b/docs/en/calculators/pam/concentration.md
@@ -1,6 +1,6 @@
 # Blocks concentration
 
-This module makes it possible to calculate the concentration of uniformly distributed blocks in a rock-ramp fish pass.
+This module makes it possible to calculate the concentration of uniformly distributed blocks in a [rock-ramp fish pass](./macrorugo.md).
 
 It allows to calculate one of the following values:
 
@@ -11,7 +11,25 @@ It allows to calculate one of the following values:
 
 ## Formula
 
-The formula is detailed in the [rock-ramp fish pass](./macrorugo.md) documentation.
+![Schematic of a regular arrangement of rockfill and notations](pam_schema_enrochement_regulier.png)
+
+*Excerpt from Larinier et al., 2006[^1]*
+
+[^1]: 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
+
+The spacing between the blocks is then calculated with the following formula:
+
+$$ax = ay = \frac{D}{\sqrt{C}}$$
+
+With :
+
+- \(ax\) and \(ay\) respectively the longitudinal and lateral distances between the centres of the blocks (m);
+- the width of the blocks facing the flow (m);
+- the concentration of the blocks (-).
+
+The number of blocks \(N\) for a pass of width \(B\) is then obtained with the equation:
+
+$$ N = B / ax $$
 
 ## Harmonization
 
diff --git a/docs/en/calculators/pam/macrorugo.md b/docs/en/calculators/pam/macrorugo.md
index bcd90f51e..f21969e08 100644
--- a/docs/en/calculators/pam/macrorugo.md
+++ b/docs/en/calculators/pam/macrorugo.md
@@ -25,7 +25,3 @@ It requires the following values to be entered:
 - The width of the blocks \(D\) facing the flow (m);
 - The useful height of the blocks \(k\) (m);
 - The shape parameter of the blocks (1 for round, 2 for square)
-
-The spacing between the blocks is then calculated with the following formula:
-
-$$ax = ay = \frac{D}{\sqrt{C}}$$
diff --git a/docs/fr/calculators/pam/concentration.md b/docs/fr/calculators/pam/concentration.md
index 2263ad332..5a8390bd2 100644
--- a/docs/fr/calculators/pam/concentration.md
+++ b/docs/fr/calculators/pam/concentration.md
@@ -1,6 +1,6 @@
 # Concentration de blocs
 
-Ce module permet de calculer la concentration de blocs uniformément répartis dans une passe à macro-rugosités.
+Ce module permet de calculer la concentration de blocs uniformément répartis dans une [passe à macro-rugosités](./macrorugo.md).
 
 L'outil permet de calculer l'une des valeurs suivantes&nbsp;:
 
@@ -11,7 +11,26 @@ L'outil permet de calculer l'une des valeurs suivantes&nbsp;:
 
 ## Formule
 
-La formule appliquée est détaillée dans la documentation de la [passe à macro-rugosités](./macrorugo.md).
+![Schéma d'une disposition régulière des enrochements et notations](pam_schema_enrochement_regulier.png)
+
+*Extrait de Larinier et al., 2006[^1]*
+
+[^1]: 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
+
+
+L'espacement entre les blocs se calcule ensuite avec la formule suivante&nbsp;:
+
+$$ax = ay = \frac{D}{\sqrt{C}}$$
+
+Avec :
+
+- \(ax\) et \(ay\) respectivement les distances longitudinales et latérales entre les centres des blocs (m)&nbsp;;
+- \(D\) la largeur des blocs face à l’écoulement (m)&nbsp;;
+- \(C\) la concentration des blocs (-).
+
+Le nombre de blocs \(N\)  pour une passe de largeur \(B\) s'obtient alors avec l'équation&nbsp;:
+
+$$ N = B / ax $$
 
 ## Harmonisation
 
diff --git a/docs/fr/calculators/pam/macrorugo.md b/docs/fr/calculators/pam/macrorugo.md
index 2a5992014..68083ecc8 100644
--- a/docs/fr/calculators/pam/macrorugo.md
+++ b/docs/fr/calculators/pam/macrorugo.md
@@ -25,7 +25,3 @@ Il nécessite d'entrer les valeurs suivantes&nbsp;:
 - La largeur des blocs \(D\) face à l’écoulement (m)&nbsp;;
 - La hauteur utile des blocs \(k\) (m)&nbsp;;
 - Le paramètre de forme des blocs (1 pour rond, 2 pour carré)
-
-L'espacement entre les blocs se calcule ensuite avec la formule suivante&nbsp;:
-
-$$ax = ay = \frac{D}{\sqrt{C}}$$
-- 
GitLab