Merge branch '635-ajouter-un-exemple-de-passe-a-rangees-periodiques' into 'devel'

Resolve "Ajouter un exemple de passe à rangées périodiques"

Closes #635

See merge request !244

docs/en/calculators/pab/pab.md

@@ -85,3 +85,9 @@ Two graphs are present:
 - A general graph allowing the selection of any parameter from the result table in abscissa and ordinate.
 
 If several results are available due to the variation of one or two hydraulic parameters of the pass, all calculated water lines are displayed in the long profile, and a drop-down list allows to select the result to be displayed in the generalist table and graph.
+
+## Example session
+
+An example illustrating the conception of a fish ladder can be directly loaded
+at the address:
+https://cassiopee.g-eau.fr/#/loadsession/app%2Fexamples%2Fpab-complete-chain.json

docs/en/calculators/pab/passe_rangees_periodiques.md

+# 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.
+
+It is therefore possible to use the various tools in the "[fish ladder](pab.md)" module
+module to design this type of device.
+In particular, the "[cloisons](cloisons.md)" tool can be used to enter the various
+dimensional characteristics of weirs (widths, overflow dimensions) and pseudo-basins
+pseudo-basins (length, width, mid-radius), which can be used to indirectly
+indirectly retrieve the sill height (\(p\)) and useful block height (\(k\)) parameters
+in the generated geometry table.
+Porosity (ratio between the free passage between the blocks and the total width
+width of the pseudo-wall) is not entered directly, but this parameter can be
+be deduced and examined elsewhere if necessary.
+
+According to this principle, each overhanging portion of the partition must be entered
+as an indentation or slot, as well as the dimension of the top of the blocks if the latter
+are flooded within the operating range of the device.
+In the case of notches, particular attention should be paid to the type of
+(thick or thin) in order to accurately reflect the conditions of flooding by the
+downstream of the weir.
+
+It is also possible to use the "[pre-dams](prebarrage.md)" tool (the equations
+implemented are the same as in the "[cloisons](cloisons.md)" tool),
+if the device is affected by complex feed modes,
+with, for example, overflows from the weir to different basins in the system
+(a less frequent case for a riprap pass in periodic rows).
+
+An example of a pass can be accessed directly via [this link](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.

docs/fr/calculators/pab/pab.md

@@ -85,3 +85,8 @@ Deux graphiques sont présents :
 - Un graphique général permettant de sélectionner n'importe quel paramètre du tableau de résultat en abscisse et en ordonnée.
 
 Si plusieurs résultats sont disponibles du fait de la variation d'un ou deux paramètres hydrauliques de la passe, toutes les lignes d'eau calculées s'affichent dans le profil en long, et une liste déroulante permet de sélectionner le résultat à afficher dans le tableau et le graphique généraliste.
+
+## Session exemple
+
+Un exemple de conception de passe à bassins peut être directement chargée à l'adresse :
+https://cassiopee.g-eau.fr/#/loadsession/app%2Fexamples%2Fpab-complete-chain.json

docs/fr/calculators/pab/passe_rangees_periodiques.md

+# Passe « naturelle » à enrochements en rangées périodiques
+
+Il est indiqué en p.16 du guide de conception des passes naturelles
+(Larinier et al., 2006)[^passe_rangees_periodiques1] que les passes en enrochements
+en rangées périodiques s’apparentent aux passes à bassins et leurs critères de
+conception sont identiques à ces dernières.
+
+Il est donc possible d’utiliser les différents outils du module « [passe à bassins](pab.md) »
+pour concevoir ce type de dispositif.
+Notamment, l’outil « [cloisons](cloisons.md) » permet de renseigner les différentes
+caractéristiques dimensionnelles des déversoirs (largeurs, cotes déversantes) et
+des pseudo-bassins (longueurs, largeurs, cote mi-radier), qui permettent de
+retrouver indirectement les paramètres hauteurs de seuils (\(p\)) et hauteurs utiles
+des blocs (\(k\)) dans le tableau de géométrie généré.
+La porosité (rapport entre le passage libre entre les blocs et la largeur totale
+de la pseudo-cloison) n’est pas renseignée directement, mais ce paramètre peut
+être déduit et examiné par ailleurs si besoin.
+
+Selon ce principe, chaque portion déversante de la cloison doit être renseignée
+en tant qu’échancrure ou fente, de même que la cote du sommet des blocs si ces
+derniers sont ennoyé sur la plage de fonctionnement du dispositif.
+Pour les échancrures, il convient de porter une attention particulière au type
+seuil (épais ou mince) afin de bien retranscrire les conditions d’ennoiement par
+l’aval du déversoir le cas échéant.
+
+Il est également possible d’utiliser l’outil « [pré-barrages](prebarrage.md) » (les équations
+implémentées sont les mêmes que dans l’outil « [cloisons](cloisons.md) »),
+si le dispositif est concerné par des modes alimentations complexes,
+avec par exemple des déversés du seuil vers différents bassins du dispositif
+(cas moins fréquent pour une passes en enrochements en rangées périodiques).
+
+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.

src/app/components/calculator-list/calculator-list.component.ts

@@ -270,6 +270,10 @@ export class CalculatorListComponent implements OnInit {
             {
                 label: this.intlService.localizeText("INFO_EXAMPLE_LABEL_PB"),
                 path: "prebarrage.json"
+            },
+            {
+                label: this.intlService.localizeText("INFO_EXAMPLE_LABEL_RANGEES_PERIOD"),
+                path: "passe_rangees_periodiques.json"
             }
         ];
     }

src/locale/messages.en.json

@@ -654,6 +654,7 @@
     "INFO_EXAMPLE_LABEL_PENTE_CRITIQUE_CANAL": "Canal critical slope",
     "INFO_EXAMPLE_LABEL_PB": "Pre-dam",
     "INFO_EXAMPLE_LABEL_PERR": "Rock-ramp fish pass",
+    "INFO_EXAMPLE_LABEL_RANGEES_PERIOD": "Rip-rap pass in periodic rows",
     "INFO_EXAMPLE_LABEL_WEIR_JET_LENGTH": "Weir jet length",
     "INFO_EXAMPLES_TITLE": "Examples",
     "INFO_EXAMPLES_SUBTITLE": "Load standard examples",

src/locale/messages.fr.json

@@ -655,6 +655,7 @@
     "INFO_EXAMPLE_LABEL_PENTE_CRITIQUE_CANAL": "Pente critique d'un canal",
     "INFO_EXAMPLE_LABEL_PB": "Pré-barrage",
     "INFO_EXAMPLE_LABEL_PERR": "Passe à enrochements régulièrement répartis",
+    "INFO_EXAMPLE_LABEL_RANGEES_PERIOD": "Passe à enrochement en rangées périodiques",
     "INFO_EXAMPLE_LABEL_WEIR_JET_LENGTH": "Longueur de jet d'un déversoir",
     "INFO_EXAMPLES_TITLE": "Exemples",
     "INFO_EXAMPLES_SUBTITLE": "Charger des exemples types",