Merge branch 'devel'

.eslintrc.js

+/*
+👋 Hi! This file was autogenerated by tslint-to-eslint-config.
+https://github.com/typescript-eslint/tslint-to-eslint-config
+
+It represents the closest reasonable ESLint configuration to this
+project's original TSLint configuration.
+
+We recommend eventually switching this configuration to extend from
+the recommended rulesets in typescript-eslint. 
+https://github.com/typescript-eslint/tslint-to-eslint-config/blob/master/docs/FAQs.md
+
+Happy linting! 💖
+*/
+module.exports = {
+    "env": {
+        "browser": true,
+        "node": true
+    },
+    "parser": "@typescript-eslint/parser",
+    "parserOptions": {
+        "project": "tsconfig.json",
+        "sourceType": "module"
+    },
+    "plugins": [
+        "eslint-plugin-import",
+        "@angular-eslint/eslint-plugin",
+        "@typescript-eslint",
+        "@typescript-eslint/tslint"
+    ],
+    "root": true,
+    "rules": {
+        "@angular-eslint/component-class-suffix": "error",
+        "@angular-eslint/component-selector": [
+            "error",
+            {
+                "type": "element",
+                "prefix": "kebab-case"
+            }
+        ],
+        "@angular-eslint/directive-class-suffix": "error",
+        "@angular-eslint/directive-selector": [
+            "error",
+            {
+                "type": "attribute",
+                "prefix": "app",
+                "style": "camelCase"
+            }
+        ],
+        "@angular-eslint/no-host-metadata-property": "error",
+        "@angular-eslint/no-input-rename": "error",
+        "@angular-eslint/no-inputs-metadata-property": "error",
+        "@angular-eslint/no-output-on-prefix": "error",
+        "@angular-eslint/no-output-rename": "error",
+        "@angular-eslint/no-outputs-metadata-property": "error",
+        "@angular-eslint/use-lifecycle-interface": "error",
+        "@angular-eslint/use-pipe-transform-interface": "error",
+        "@typescript-eslint/consistent-type-definitions": "error",
+        "@typescript-eslint/dot-notation": "off",
+        "@typescript-eslint/explicit-member-accessibility": [
+            "off",
+            {
+                "accessibility": "explicit"
+            }
+        ],
+        "@typescript-eslint/indent": "error",
+        "@typescript-eslint/member-delimiter-style": [
+            "error",
+            {
+                "multiline": {
+                    "delimiter": "semi",
+                    "requireLast": true
+                },
+                "singleline": {
+                    "delimiter": "semi",
+                    "requireLast": false
+                }
+            }
+        ],
+        "@typescript-eslint/member-ordering": "error",
+        "@typescript-eslint/naming-convention": "error",
+        "@typescript-eslint/no-empty-function": "off",
+        "@typescript-eslint/no-empty-interface": "error",
+        "@typescript-eslint/no-inferrable-types": [
+            "error",
+            {
+                "ignoreParameters": true
+            }
+        ],
+        "@typescript-eslint/no-misused-new": "error",
+        "@typescript-eslint/no-non-null-assertion": "error",
+        "@typescript-eslint/no-shadow": [
+            "error",
+            {
+                "hoist": "all"
+            }
+        ],
+        "@typescript-eslint/no-unused-expressions": "error",
+        "@typescript-eslint/prefer-function-type": "error",
+        "@typescript-eslint/quotes": [
+            "error",
+            "double"
+        ],
+        "@typescript-eslint/semi": [
+            "error",
+            "always"
+        ],
+        "@typescript-eslint/type-annotation-spacing": "error",
+        "@typescript-eslint/unified-signatures": "error",
+        "arrow-body-style": "error",
+        "brace-style": [
+            "error",
+            "1tbs"
+        ],
+        "constructor-super": "error",
+        "curly": "error",
+        "dot-notation": "off",
+        "eol-last": "error",
+        "eqeqeq": [
+            "error",
+            "smart"
+        ],
+        "guard-for-in": "off",
+        "id-denylist": "off",
+        "id-match": "off",
+        "import/no-deprecated": "warn",
+        "indent": "error",
+        "max-len": [
+            "error",
+            {
+                "code": 140
+            }
+        ],
+        "no-bitwise": "error",
+        "no-caller": "error",
+        "no-console": [
+            "error",
+            {
+                "allow": [
+                    "log",
+                    "warn",
+                    "dir",
+                    "timeLog",
+                    "assert",
+                    "clear",
+                    "count",
+                    "countReset",
+                    "group",
+                    "groupEnd",
+                    "table",
+                    "dirxml",
+                    "error",
+                    "groupCollapsed",
+                    "Console",
+                    "profile",
+                    "profileEnd",
+                    "timeStamp",
+                    "context"
+                ]
+            }
+        ],
+        "no-debugger": "error",
+        "no-empty": "off",
+        "no-empty-function": "off",
+        "no-eval": "error",
+        "no-fallthrough": "error",
+        "no-new-wrappers": "error",
+        "no-restricted-imports": [
+            "error",
+            "rxjs/Rx"
+        ],
+        "no-shadow": "error",
+        "no-throw-literal": "error",
+        "no-trailing-spaces": "error",
+        "no-undef-init": "error",
+        "no-underscore-dangle": "off",
+        "no-unused-expressions": "error",
+        "no-unused-labels": "error",
+        "no-var": "error",
+        "prefer-const": "error",
+        "quotes": "error",
+        "radix": "error",
+        "semi": "error",
+        "spaced-comment": [
+            "error",
+            "always",
+            {
+                "markers": [
+                    "/"
+                ]
+            }
+        ],
+        "@typescript-eslint/tslint/config": [
+            "error",
+            {
+                "rules": {
+                    "import-spacing": true,
+                    "whitespace": [
+                        true,
+                        "check-branch",
+                        "check-decl",
+                        "check-operator",
+                        "check-separator",
+                        "check-type"
+                    ]
+                }
+            }
+        ]
+    }
+};

.gitignore

@@ -9,6 +9,7 @@
 /docs/fr/pdf
 /docs/en/pdf
 /release
+docs/pdf_build
 
 # dependencies
 /node_modules
@@ -31,6 +32,7 @@
 !.vscode/extensions.json
 
 # misc
+/.angular/cache
 /.sass-cache
 /connect.lock
 /coverage
@@ -60,3 +62,6 @@ install_jalhyd
 # Cordova
 platforms/**
 plugins/**
+
+# Jalhyd directory (so far, to be removed if we make jalhyd a Git submodule)
+/jalhyd

.gitlab-ci.yml

 stages:
-  - jalhyd
   - install
   - test
   - build
@@ -11,7 +10,7 @@ stages:
 
 default:
   tags: [docker]
-  image: geaucassiopee/ci-cd-cross-platform-webapp:first
+  image: geaucassiopee/ci-cd-cross-platform-webapp:v2
 
 variables:
 # from Gitlab CI/CD environment variables :
@@ -22,7 +21,6 @@ variables:
 # - production server :
 #   PROD_HOST : deployment server hostname
 #   PROD_LOGIN : user on deployment server
-#   PROD_PASS : password for user on deployment server
 #   PROD_PATH : path base on deployment server
   LC_ALL: C.UTF-8
   ANDROID_HOME: "/usr/local/android-sdk" # should already be defined in the Docker image
@@ -46,9 +44,10 @@ cache:
       - package.json
   paths:
     - node_modules/
+    - jalhyd/
 
-jalhyd:
-  stage: jalhyd
+install:
+  stage: install
   only:
     - pushes
     - tags
@@ -60,22 +59,13 @@ jalhyd:
     - if [ "$CI_COMMIT_REF_NAME" = "master" ]; then JALHYD_BRANCH="master"; fi
     - if [ "$CI_COMMIT_REF_NAME" = "devel" ]; then JALHYD_BRANCH="devel"; fi
     - echo "Branche JalHyd - $JALHYD_BRANCH"
-    - cd ..
     - rm -rf jalhyd
     - git clone https://gitlab-ci-token:${CI_JOB_TOKEN}@gitlab.irstea.fr/cassiopee/jalhyd.git
     - cd jalhyd
     - git checkout "$JALHYD_BRANCH" || git checkout devel
     - npm ci --force
     - npm run build
-
-install:
-  stage: install
-  only:
-    - pushes
-    - tags
-    - schedules
-    - web
-  script:
+    - cd ..
     - rm -rf node_modules
     - npm ci --force --unsafe-perm
 
@@ -124,6 +114,17 @@ deploy-dev:
     # Copie de la branche / du tag
     - ./scripts/deploy-version.sh $CI_COMMIT_REF_NAME $DEV_LOGIN $DEV_HOST $DEV_PATH
 
+# déploiement de la version devel sur OVH
+deploy-ovh-dev:
+  stage: deploy-dev
+  only:
+    - devel
+  dependencies:
+    - build
+  script:
+    # Copie de la branche / du tag
+    - ./scripts/deploy-version.sh prod-devel $PROD_LOGIN $PROD_HOST $PROD_DEV_PATH
+
 deploy-prod:
   stage: deploy-prod
   only:
@@ -132,7 +133,7 @@ deploy-prod:
   dependencies:
     - build
   script:
-    - ./scripts/deploy-version.sh prod $PROD_LOGIN $PROD_HOST $PROD_PATH $PROD_PASS
+    - ./scripts/deploy-version.sh prod $PROD_LOGIN $PROD_HOST $PROD_PATH
 
 releases-nightly:
   stage: releases-nightly

CHANGELOG.md

 # Historique des versions
 
+### 4.16.0 - 2022-10-12 (Anguilla anguilla)
+
+#### Nouvelles fonctionnalités
+
+* PAB : ajout de la charge et l'ennoiement dans le tableau de résultat et l'export ([jalhyd#324](https://gitlab.irstea.fr/cassiopee/jalhyd/-/issues/324), [nghyd#518](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/518))
+* Courbe de remous (et bief) : remontée d'une erreur quand le pas de discrétisation est supérieur à la longueur du bief ([jalhyd#316](https://gitlab.irstea.fr/cassiopee/jalhyd/-/issues/316), [nghyd#565](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/565))
+* Section paramétrée : profil de section : option axes orthonormés ([nghyd#497](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/497))
+* URL de routeur "/loadsession" pour charger un exemple ([nghyd#476](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/476))
+* Deploy devel branch on cassiopee-dev.g-eau.fr ([nghyd#564](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/564))
+
+#### Correction de bogues
+
+* Les caractères UTF8 ne sont pas imprimés dans la doc PDF ([nghyd#556](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/556))
+* PréBarrages: La sélection de l'amont ou l'aval n'est pas visible au premier clic ([nghyd#560](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/560))
+* Solveur: le paramètre recherché n'est pas conservé ([nghyd#555](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/555))
+* PAB: Bugs de format du tableau NgPrime ([nghyd#562](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/562))
+* Section paramétrée: crash de l'appli sur variation de paramètre ([jalhyd#319](https://gitlab.irstea.fr/cassiopee/jalhyd/-/issues/319), [nghyd#561](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/561))
+* Module avec une section : le mode champs vide ne fonctionne pas ([jalhyd#327](https://gitlab.irstea.fr/cassiopee/jalhyd/-/issues/327), [nghyd#569](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/569))
+* Déplacement du paramètre calculé lors de la duplication d'un Nub ([jalhyd#322](https://gitlab.irstea.fr/cassiopee/jalhyd/-/issues/322), [nghyd#567](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/567))
+* Lois d'ouvrages : mauvaise gestion du paramètre calculé sur suppression d'ouvrage ([jalhyd#321](https://gitlab.irstea.fr/cassiopee/jalhyd/-/issues/321), [nghyd#566](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/566))
+
+#### Changements
+
+* Ouvrages: modification des types d'ouvrages (ajout de seuil/orifice rectangulaire, vanne rectangulaire renommée en vanne de fond rectangulaire) ([jalhyd#326](https://gitlab.irstea.fr/cassiopee/jalhyd/-/issues/326), [nghyd#511](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/511))
+* Prébarrages : regroupement de la saisie des bassins ([nghyd#522](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/522))
+
+#### Documentation
+
+* corrections diverses ([nghyd#559](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/559))
+* MacroRugo : ajout d'un schéma rugosité de fond ([nghyd#524](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/524))
+* Lois d'ouvrages : définition seuil mince/épais ([nghyd#514](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/514))
+* Ajout d'un tableau synthétiques des lois d'ouvrages ([nghyd#513](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/513))
+* MAJ de la documentation des grilles avec les données de Lemkecher et al. (2020) ([nghyd#438](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/438))
+
+#### Changements internes
+
+* Mise à jour vers Angular 14 ([nghyd#500](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/500))
+* CI : MAJ de l'image Docker vers Debian Bullseye compatibilité TLS) ([cassiopee2-integration#10](https://gitlab.irstea.fr/cassiopee/cassiopee2-integration/-/issues/10))
+* Angular : compilation avec Ivy ([nghyd#369](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/369))
+* Déplacer le répertoire Jalhyd dans celui de Nghyd ([nghyd#558](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/558))
+* Déménagement de l'intégration continue sur les serveurs gitlab à Lyon ([nghyd#557](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/557))
+* Mise à jour de Chartjs ([nghyd#554](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/554))
+* MAJ vers PrimeNG 10 ([nghyd#481](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/481))
+
 ### 4.15.1 - 2022-07-04
 
 #### Nouvelles fonctionnalités
@@ -16,6 +60,7 @@
 
 #### Correction de bogues
 
+* Plantage PAB si un paramètre est passé en mode variable puis annulé ([nghyd#549](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/549))
 * Liens inaccessibles pour certains modules ([jalhyd#289](https://gitlab.irstea.fr/cassiopee/jalhyd/-/issues/289), [nghyd#547](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/547))
 * Plantage du calcul sur modules liés ([jalhyd#286](https://gitlab.irstea.fr/cassiopee/jalhyd/-/issues/286))
 * PréBarrages: les champs ne sont pas vides à la création du module ([jalhyd#310](https://gitlab.irstea.fr/cassiopee/jalhyd/-/issues/310), [nghyd#546](https://gitlab.irstea.fr/cassiopee/nghyd/-/issues/546))

DEVELOPERS.md

@@ -575,7 +575,7 @@ Dans la configuration du module, dans le "fieldset_template", ajouter un sélect
     "id": "fs_ouvrage",
     "type": "fieldset_template",
     "calcType": "Structure",
-    "defaultStructType": "VanneRectangulaire",
+    "defaultStructType": "VanneFondRectangulaire",
     "defaultLoiDebit": "GateCem88v",
     "fields": [
         {
@@ -594,7 +594,7 @@ Dans la configuration du module, dans le "fieldset_template", ajouter un sélect
                 "SeuilRectangulaire_WeirVillemonte": "structures/kivi.html",
                 "SeuilRectangulaire_WeirSubmergedLarinier": "structures/fente_noyee.html",
                 "SeuilRectangulaire_WeirCunge80": "structures/cunge_80.html",
-                "VanneRectangulaire_GateCunge80": "structures/cunge_80.html",
+                "VanneFondRectangulaire_GateCunge80": "structures/cunge_80.html",
                 "SeuilTriangulaire_TriangularWeirFree": "structures/dever_triang.html",
                 "SeuilTriangulaire_TriangularWeirBroad": "structures/dever_triang.html",
                 "SeuilTriangulaireTrunc_TriangularTruncWeirFree": "structures/dever_triang_tronque.html"

README.md

@@ -38,7 +38,7 @@ More details on how to use it on vscode are available at https://gitlab.irstea.f
 ### Install dependencies
 
 #### JaLHyd
-Clone JalHyd next to ngHyd, for ex. respectively in `/home/foo/jalhyd` and `/home/foo/nghyd`.
+Clone JalHyd into to ngHyd, for ex. respectively in `/home/foo/nghyd` and `/home/foo/nghyd/jalhyd`.
 
 In `jalhyd` folder, run :
 
@@ -280,7 +280,7 @@ The `stable` tag should be set **before** the version tag, so that `git describe
 
 ### Release script
 
-**Important:** the release script assumes that you run it from the current nghyd source directory `nghyd`, and that JaLHyd source directory `jalhyd` is present at the same level.
+**Important:** the release script assumes that you run it from the current nghyd source directory `nghyd`, and that JaLHyd source directory `jalhyd` is present under the `nghyd` directory.
 
 Before running the script:
  * update `CHANGELOG.md` in both JaLHyd and NgHyd

angular.json

@@ -11,7 +11,6 @@
         "build": {
           "builder": "@angular-devkit/build-angular:browser",
           "options": {
-            "aot": true,
             "outputPath": "dist",
             "index": "src/index.html",
             "main": "src/main.ts",
@@ -44,14 +43,13 @@
               "node_modules/material-design-icons/iconfont/material-icons.css",
               "node_modules/roboto-fontface/css/roboto/roboto-fontface.css",
               "node_modules/primeng/resources/primeng.min.css",
-              "node_modules/primeng/resources/themes/nova-light/theme.css",
+              "node_modules/primeng/resources/themes/nova/theme.css",
               "node_modules/katex/dist/katex.min.css"
             ],
             "scripts": [
-              "node_modules/marked/lib/marked.js",
+              "node_modules/marked/marked.min.js",
               "node_modules/katex/dist/katex.min.js"
             ],
-            "showCircularDependencies": false,
             "allowedCommonJsDependencies": [
               "chartjs-plugin-zoom",
               "angular2-chartjs/dist/chart.component",
@@ -60,7 +58,6 @@
               "base-64",
               "he",
               "svg-pan-zoom",
-              "mermaid",
               "pako",
               "file-saver",
               "hammerjs",
@@ -72,7 +69,13 @@
               "graphlibrary",
               "dagre-layout",
               "dagre-d3-renderer"
-            ]
+            ],
+            "vendorChunk": true,
+            "extractLicenses": false,
+            "buildOptimizer": false,
+            "sourceMap": true,
+            "optimization": false,
+            "namedChunks": true
           },
           "configurations": {
             "production": {
@@ -85,9 +88,7 @@
               "optimization": true,
               "outputHashing": "all",
               "sourceMap": false,
-              "extractCss": true,
               "namedChunks": false,
-              "aot": true,
               "extractLicenses": true,
               "vendorChunk": false,
               "buildOptimizer": true,
@@ -98,18 +99,13 @@
                 }
               ]
             }
-          }
+          },
+          "defaultConfiguration": ""
         },
         "serve": {
           "builder": "@angular-devkit/build-angular:dev-server",
           "options": {
             "browserTarget": "ngHyd:build",
-            "aot": true,
-            "sourceMap": {
-              "scripts": true,
-              "styles": true,
-              "vendor": true
-            }
           },
           "configurations": {
             "production": {
@@ -143,18 +139,6 @@
               "src/**/*.png"
             ]
           }
-        },
-        "lint": {
-          "builder": "@angular-devkit/build-angular:tslint",
-          "options": {
-            "tsConfig": [
-              "src/tsconfig.app.json",
-              "src/tsconfig.spec.json"
-            ],
-            "exclude": [
-              "**/node_modules/**"
-            ]
-          }
         }
       }
     },
@@ -170,22 +154,10 @@
             "devServerTarget": "ngHyd:serve",
             "port": 4201
           }
-        },
-        "lint": {
-          "builder": "@angular-devkit/build-angular:tslint",
-          "options": {
-            "tsConfig": [
-              "e2e/tsconfig.e2e.json"
-            ],
-            "exclude": [
-              "**/node_modules/**"
-            ]
-          }
         }
       }
     }
   },
-  "defaultProject": "ngHyd",
   "schematics": {
     "@schematics/angular:component": {
       "prefix": "app",

docs/en/calculators/devalaison/grille.md

@@ -215,7 +215,11 @@ The shape coefficient of the bars \(c\) is 1.69 for the rectangular profile (PR)
 
 #### inclined trashrack
 
-The shape coefficient of the bars \(a\) is 3.85 for the rectangular profile (PR) and 2.10 for the hydrodynamic profile (PH).
+| Bar shape | Droplet | Plétina | Tadpole 8 | Tadpole 10 | Hydrodynamic | Rectangular |
+| --- | --- | --- | --- | --- | --- | --- |
+| Bar coefficient $A_i$| 2.47 | 1.75 | 1.27 | 1.79 | 2.10 | 3.85 |
+
+After Lemkecher et al. (2020)[^4]
 
 <div style="position: relative"><a id="coefficient-de-forme-moyen-des-entretoises-et-elements-transversaux-ponderes-selon-leurs-parts-respectives" style="position: absolute; top: -60px;"></a></div>
 ### Average shape coefficient of spacers and transverse elements, weighted according to their respective shares
@@ -228,6 +232,8 @@ For example, 1.79 for cylindrical spacers, 2.42 for rectangular spacers, and aro
 
 [^1]: 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
 
-[^2]: Raynal, S., Chatellier, L., Courret, D., Larinier, M., David, L., 2013. An experimental study on fish-friendly trashracks–Part 2. Angled trashracks. Journal of Hydraulic Research 51, 67–75.
+[^2]: Raynal, S., Chatellier, L., Courret, D., Larinier, M., David, L., 2013. 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
+
+[^3]: Raynal, S., Courret, D., Chatellier, L., Larinier, M., David, L., 2013. 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
 
-[^3]: Raynal, S., Courret, D., Chatellier, L., Larinier, M., David, L., 2013. An experimental study on fish-friendly trashracks–Part 1. Inclined trashracks. Journal of Hydraulic Research 51, 56–66.
+[^4]: 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

docs/en/calculators/pam/macrorugo.md

@@ -25,3 +25,8 @@ 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 drag coefficient of a single block (1 for round, 2 for square).
+
+<div style="position: relative"><a id="rugosite-de-fond" style="position: absolute; top: -60px;"></a></div>
+# Bed roughness
+
+![](schema_rugosite_fond.png)

docs/en/calculators/pam/macrorugo_theorie.md

@@ -192,7 +192,7 @@ with
 
 $$Re = u_0 \times h / \nu$$
 
-Else (Eq. 3, Cassan et al., 2016 d'après Rice et al., 1998)
+Else (Eq. 3, Cassan et al., 2016 d'après Rice et al., 1998[^5])
 
 $$C_f = \frac{2}{(5.1 \mathrm{log} (h/k_s)+6)^2}$$
 
@@ -232,6 +232,12 @@ $$C_f = \frac{2}{(5.1 \mathrm{log} (h/k_s)+6)^2}$$
 - \(z_0\): hydraulic roughness (m)
 - \(\tilde{z}\): dimensionless stand \(\tilde{z} = z / k\)
 
-[^1]: Cassan L, Laurens P. 2016. Design of emergent and submerged rock-ramp fish passes. Knowl. Manag. Aquat. Ecosyst., 417, 45
+[^1]: 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
 
 [^2]: 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
+
+[^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
+
+[^4]: 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
+
+[^5]: 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)

docs/en/calculators/structures/liste.md

 # Stage-discharge equations list
 
-| Equation | Default discharge coefficient | Available in |
-|---------------------------|----------------:|-------------------------------|
-| [Broad-crested weir / Orifice (Cemagref-D)](./cem_88_d.md) | 0.4 | Parallel Structures |
-| [Broad-crested weir / sluice gate (Cemagref-V)](./cem_88_v.md) | 0.6 | Parallel Structures |
-| [Broad-crested weir / orifice (Cunge)](./cunge_80.md) | 0.6 | Parallel Structures, Cross walls, Downwall |
-| [Free flow sluice gate](./vanne_denoyee.md) | 0.6 | Parallel Structures |
-| [Submerged sluice gate](./vanne_noyee.md) | 0.8 | Parallel Structures |
-| [Free flow sharp-crested weir (Poleni)](./seuil_denoye.md) | 0.4 | Parallel Structures, Free flow weir stage-discharge laws |
-| [Deeply submerged sharp-crested weir (Rajaratnam)](./seuil_noye.md) | 0.9 | Parallel Structures |
-| [Submerged slot (Larinier)](./fente_noyee.md) | 0.75 | Parallel Structures, Cross walls, Downwall |
-| [Sharp-crested weir (Kindsvater-Carter + Villemonte)](./kivi.md) | \(\alpha\)=0.4, \(\beta\)=0.001 | Parallel Structures |
-| [Triangular weir sharp-crested (Villemonte) and broad-crested (Bos)](./dever_triang.md) | 1.36 | Parallel Structures, Free flow weir stage-discharge laws, Cross walls, Downwall |
-| [Truncated triangular weir (Villemonte)](./dever_triang_tronque.md) | 1.36 | Parallel Structures, Free flow weir stage-discharge laws, Cross walls, Downwall |
-| [Submerged orifice (Bernoulli)](./orifice_noye.md) | 0.7 | Parallel Structures, Cross walls, Downwall |
-| [Free flow orifice (Bernoulli)](./orifice_denoye.md) | 0.7 | Parallel Structures |
-| [Sharp-crested weir (Villemonte)](./villemonte_1947.md) | 0.4 | Parallel Structures, Cross walls, Downwall |
-| [Regulated notch (Villemonte)](../pab/pab.md#the-downstream-partition) | 0.4 | Downwall |
-| [Regulated submerged slot (Larinier)](../pab/pab.md#the-downstream-partition) | 0.75 | Downwall |
+| Structure typology                                    | Structure geometry   | Structure type                           | Flow regimes     | Name of equation                            | Default flow coefficient  | Modules                                                                         |
+|-------------------------------------------------------|----------------------|------------------------------------------|------------------|---------------------------------------------|---------------------------|---------------------------------------------------------------------------------|
+| Weir                                                  | Rectangular          | Sharp-crested weir (notch)               | Free             | [Poleni](./seuil_denoye.md)                 | 0.4                       | Parallel structures, free flow weir stage-discharge laws                        |
+|                                                       |                      | Sharp-crested weir (slot)                | Submerged        | [Rajaratnam](./seuil_noye.md)               | 0.9                       | Parallel structures                                                             |
+|                                                       |                      | Sharp-crested weir (slot)                | Submerged        | [Larinier slot](./fente_noyee.md)           | to be defined by designer | Parallel structures, cross walls, downwall                                      |
+|                                                       |                      | Sharp-crested weir (notch)               | Submerged / free | [Kindsvater-Carter & Villemonte](./kivi.md) | ⍺ = 0.4; ß = 0.001        | Parallel structures                                                             |
+|                                                       |                      | Sharp-crested weir (notch)               | Submerged / free | [Villemonte](./villemonte_1947.md)          | 0.4                       | Parallel structures, cross walls, downwall                                      |
+|                                                       |                      | Sharp-crested regulated weir (notch)     | Submerged / free | [Villemonte](./villemonte_1947.md)          | 0.4                       | Downwall                                                                        |
+|                                                       |                      | Sharp-crested regulated weir (slot)      | Submerged        | [Larinier slot](./fente_noyee.md)           | To be defined by designer | Downwall                                                                        |
+|                                                       | Triangular           | Sharp-crested weir (notch)               | Submerged / free | [Villemonte](./dever_triang.md)             | 1.36                      | Parallel structures, free flow weir stage-discharge laws, cross walls, downwall |
+|                                                       |                      | Broad-crested weir (notch)               | Submerged / free | [Bos](./dever_triang.md)                    | 1.36                      | Parallel structures, free flow weir stage-discharge laws, cross walls, downwall |
+|                                                       | Triangular truncated | Sharp-crested weir (notch)               | Submerged / free | [Villemonte](./dever_triang_tronque.md)     | 1.36                      | Parallel structures, free flow weir stage-discharge laws, cross walls, downwall |
+| Orifice / Sluice gate handling free surface weir flow | Rectangular          | Broad-crested weir (notch) / orifice     | Submerged / free | [Cemagref-D](./cem_88_d.md)                 | 0.4                       | Parallel structures, cross walls, pre-dams                                      |
+|                                                       | Rectangular          | Broad-crested weir (notch) / orifice     | Submerged / free | [Cunge](./cunge_80.md)                      | 1                         | Parallel structures, pre-dams                                                   |
+|                                                       | Rectangular          | Broad-crested weir (notch) / bottom gate | Submerged / free | [Cemagref-V](./cem_88_v.md)                 | 0.6                       | Parallel structures, downwall, pre-dams                                         |
+| Orifice / Sluice gate                                 | Rectangular          | Sluice gate                              | Free             | [Free flow sluice gate](./vanne_denoyee.md) | 0.6                       | Parallel structures                                                             |
+|                                                       | Rectangular          | Sluice gate                              | Submerged        | [Submerged sluice gate](./vanne_noyee.md)   | 0.8                       | Parallel structures                                                             |
+|                                                       | Undefined            | Orifice                                  | Submerged        | [Free flow orifice](./orifice_denoye.md)    | 0.7                       | Parallel structures, cross walls, downwall                                      |
+|                                                       | Undefined            | Orifice                                  | Free             | [Submerged orifice](./orifice_noye.md)      | 0.7                       | Parallel structures                                                             |
 
 Table: Stage-discharge equations list
+
+## 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.
+
+> The type of weir is related to the flow at the right of the structure. 
+> 
+> Indeed, the more the breadth of the crest of the weir is negligible compared to the upstream water height above it, the more the weir appears transparent to the flow and thus the sharper the crest of the weir appears. 
+>
+> On the other hand, the closer the upstream water line is to the weir crest, the greater the width of the weir appears in relation to the breadth of the water flowing over it and therefore the broader the weir crest appears. 
+> A weir in a river thus belongs to one of the three following categories: 
+> - sharp-crested weir
+> - broad-crested weir
+> - weir with undefined crest 
+>
+> In order to determine the type of weir studied, the following conditions must be verified:
+> - if $`C < \frac{H_1}{2}`$, then the threshold is sharp-crested;
+> - if $`C > \frac{2H_1}{3}`$, then the threshold is broad-crested.

docs/en/calculators/structures/vanne_denoyee.md

-# Free flow gate
+# Free flow sluice gate
 
-![Free flow gate diagram](vanne_denoyee_schema.png)
+![Free flow sluice gate diagram](vanne_denoyee_schema.png)
 
 *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.
-The dewatered valve equation is derived from Bernoulli's load conservation relationship between the upstream side of the valve and the contracted section.
+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 free flow gate equation is often expressed as a function of a flow coefficient in the form of:
+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}}\)
 
@@ -17,4 +17,4 @@ So we have the relationship between \(C_d\) and \(C_c\) :
 
 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.
 
-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 gate, from 0.6 to 0.7 for a radial gate, up to 0.8 for a gate inclined with respect to the vertical.
+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.

docs/en/calculators/structures/vanne_noyee.md

-# Submerged gate
+# Submerged sluice gate
 
 ![Submerged gate diagram](vanne_noyee_schema.png)
 
 *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.*
 
-## Submerged gate equation
+## Submerged sluice gate equation
 
 \(Q = C'_d LW \sqrt{2g}\sqrt{h_{am} - h_{av}}\)
 

docs/fr/calculators/devalaison/grille.md

@@ -204,7 +204,11 @@ Le coefficient de forme des barreaux \(c\) vaut 1.69 pour le profil rectangulair
 
 #### grille inclinée
 
-Le coefficient de forme des barreaux \(a\) vaut 3.85 pour le profil rectangulaire (PR) et 2.10 pour le profil hydrodynamique (PH).
+| Forme des barreaux | Droplet | Plétina | Tadpole 8 | Tadpole 10 | Hydrodynamique | Rectangulaire |
+| --- | --- | --- | --- | --- | --- | --- |
+| Coefficient de forme $A_i$| 2.47 | 1.75 | 1.27 | 1.79 | 2.10 | 3.85 |
+
+Extrait de Lemkecher et al. (2020)[^4]
 
 ### Coefficient de forme moyen des entretoises et éléments transversaux, pondérés selon leurs parts respectives
 
@@ -216,6 +220,8 @@ Vaut par exemple 1.79 pour les entretoises cylindriques, 2.42 pour les entretois
 
 [^1]: 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
 
-[^2]: Raynal, S., Chatellier, L., Courret, D., Larinier, M., David, L., 2013. An experimental study on fish-friendly trashracks–Part 2. Angled trashracks. Journal of Hydraulic Research 51, 67–75.
+[^2]: Raynal, S., Chatellier, L., Courret, D., Larinier, M., David, L., 2013. 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
+
+[^3]: Raynal, S., Courret, D., Chatellier, L., Larinier, M., David, L., 2013. 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
 
-[^3]: Raynal, S., Courret, D., Chatellier, L., Larinier, M., David, L., 2013. An experimental study on fish-friendly trashracks–Part 1. Inclined trashracks. Journal of Hydraulic Research 51, 56–66.
+[^4]: 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

docs/fr/calculators/pam/macrorugo.md

@@ -26,3 +26,6 @@ Il nécessite d'entrer les valeurs suivantes :
 - La hauteur utile des blocs \(k\) (m) ;
 - Le coefficient de trainée d'un bloc (1 pour rond, 2 pour carré).
 
+# Rugosité de fond
+
+![](schema_rugosite_fond.png)

docs/fr/calculators/pam/macrorugo_theorie.md

@@ -189,7 +189,7 @@ avec
 
 $$Re = u_0 \times h / \nu$$
 
-Sinon (Eq. 3, Cassan et al., 2016 d'après Rice et al., 1998)
+Sinon (Eq. 3, Cassan et al., 2016 d'après Rice et al., 1998[^5])
 
 $$C_f = \frac{2}{(5.1 \mathrm{log} (h/k_s)+6)^2}$$
 
@@ -237,3 +237,4 @@ $$C_f = \frac{2}{(5.1 \mathrm{log} (h/k_s)+6)^2}$$
 
 [^4]: 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
 
+[^5]: 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)

docs/fr/calculators/structures/liste.md

 # Liste des équations d'ouvrages
 
-| Équation | Coefficient de débit par défaut | Disponible dans |
-|---------------------------|----------------:|-------------------------------|
-| [Seuil épais / orifice (Cemagref-D)](./cem_88_d.md) | 0.4 | Lois d'ouvrages |
-| [Seuil épais / vanne de fond (Cemagref-V)](./cem_88_v.md) | 0.6 | Lois d'ouvrages |
-| [Seuil épais / orifice (Cunge)](./cunge_80.md) | 1 | Lois d'ouvrages, Cloisons, Cloison aval |
-| [Vanne de fond dénoyée](./vanne_denoyee.md) | 0.6 | Lois d'ouvrages |
-| [Vanne de fond noyée](./vanne_noyee.md) | 0.8 | Lois d'ouvrages |
-| [Seuil mince dénoyé (Poleni)](./seuil_denoye.md) | 0.4 | Lois d'ouvrages, Lois de déversoirs dénoyés |
-| [Seuil mince noyé (Rajaratnam)](./seuil_noye.md) | 0.9 | Lois d'ouvrages |
-| [Fente noyée (Larinier)](./fente_noyee.md) | 0.75 | Lois d'ouvrages, Cloisons, Cloison aval |
-| [Kindsvater-Carter et Villemonte](./kivi.md) | \(\alpha\)=0.4, \(\beta\)=0.001 | Lois d'ouvrages |
-| [Seuil triangulaire mince (Villemonte) et épais (Bos)](./dever_triang.md) | 1.36 | Lois d'ouvrages, Lois de déversoirs dénoyés, Cloisons, Cloison aval |
-| [Seuil triangulaire tronqué (Villemonte)](./dever_triang_tronque.md) | 1.36 | Lois d'ouvrages, Lois de déversoirs dénoyés, Cloisons, Cloison aval |
-| [Orifice noyé (Bernoulli)](./orifice_noye.md) | 0.7 | Lois d'ouvrages, Cloisons, Cloison aval |
-| [Orifice dénoyé (Bernoulli)](./orifice_denoye.md) | 0.7 | Lois d'ouvrages |
-| [Seuil mince (Villemonte)](./villemonte_1947.md) | 0.4 | Lois d'ouvrages, Cloisons, Cloison aval |
-| [Échancrure régulée (Villemonte)](../pab/pab.md#la-cloison-aval) | 0.4 | Cloison aval |
-| [Fente noyée régulée (Larinier)](../pab/pab.md#la-cloison-aval) | 0.75 | Cloison aval |
+| Typologie d'ouvrages                                        | Géométrie de l'ouvrage | Type d'ouvrage                           | Régimes d'écoulement | Nom de l'équation              | Coef. Débit par défaut  | Modules                                                           |
+|-------------------------------------------------------------|------------------------|------------------------------------------|----------------------|--------------------------------|-------------------------|-------------------------------------------------------------------|
+| Seuil déversant à surface libre                             | Rectangulaire          | Seuil mince (échancrure)                 | Dénoyé               | [Poleni](./seuil_denoye.md)    | 0,4                     | Lois d'ouvrages, lois déversoirs dénoyés                          |
+|                                                             |                        | Seuil mince (fente)                      | Noyé                 | [Rajaratnam](./seuil_noye.md)  | 0,9                     | Lois d'ouvrages                                                   |
+|                                                             |                        | Seuil mince (fente)                      | Noyé                 | [Fente Larinier](./fente_noyee.md) | à définir par projeteur | Lois d'ouvrages, cloisons, cloison aval                           |
+|                                                             |                        | Seuil mince (échancrure)                 | Noyé / dénoyé        | [Kindsvater-Carter & Villemonte](./kivi.md) | ⍺ = 0.4 ; ß = 0.001     | Lois d'ouvrages                                                   |
+|                                                             |                        | Seuil mince (échancrure)                 | Noyé / dénoyé        | [Villemonte](./villemonte_1947.md) | 0,4                     | Lois d'ouvrages, cloisons, cloison aval                           |
+|                                                             |                        | Seuil mince régulé (échancrure)          | Noyé / dénoyé        | [Villemonte](./villemonte_1947.md)    | 0,4                     | Cloison aval                                                      |
+|                                                             |                        | Seuil mince régulé (fente)               | Noyé                 | [Fente Larinier](./fente_noyee.md)    | à définir par projeteur | Cloison aval                                                      |
+|                                                             | Triangulaire           | Seuil mince (échancrure)                 | Noyé / dénoyé        | [Villemonte](./dever_triang.md) | 1,36                    | Lois d'ouvrages, lois déversoirs dénoyés, cloisons, cloisons aval |
+|                                                             |                        | Seuil épais (échancrure)                 | Noyé / dénoyé        | [Bos](./dever_triang.md)       | 1,36                    | Lois d'ouvrages, lois déversoirs dénoyés, cloisons, cloisons aval |
+|                                                             | Triangulaire tronqué   | Seuil mince (échancrure)                 | Noyé / dénoyé        | [Villemonte](./dever_triang_tronque.md) | 1,36                    | Lois d'ouvrages, lois déversoirs dénoyés, cloisons, cloisons aval |
+| Orifice / vanne de fond supportant l'écoulement déversant à surface libre | Rectangulaire          | Seuil épais (échancrure) / orifice       | Noyé / dénoyé        | [Cemagref-D](./cem_88_d.md)    | 0,4                     | Lois ouvrages, cloisons, pré-barrages                             |
+|                                                             | Rectangulaire          | Seuil épais (échancrure) / orifice       | Noyé / dénoyé        | [Cunge](./cunge_80.md)                        | 1                       | Lois ouvrages, pré-barrages                                       |
+|                                                             | Rectangulaire          | Seuil épais (échancrure) / vanne de fond | Noyé / dénoyé        | [Cemagref-V](./cem_88_v.md)                   | 0,6                     | Lois ouvrages, cloison aval, pré-barrages                         |
+| Vannes / orifices en charge                                 | Rectangulaire          | Vanne de fond                            | Dénoyé               | [Vanne de fond dénoyée (Bernoulli)](./vanne_denoyee.md) | 0,6                     | Lois d'ouvrages                                                   |
+|                                                             | Rectangulaire          | Vanne de fond                            | Noyé                 | [Vanne de fond noyée](./vanne_noyee.md) | 0,8                     | Lois d'ouvrages                                                   |
+|                                                             | Indéfini               | Orifice  | Dénoyé               | [Orifice dénoyé (Bernoulli)](./orifice_denoye.md)     | 0,7                     | Lois d'ouvrages                                                   |
+|                                                             | Indéfini               | Orifice                                  | Noyé                 | [Orifice noyé (Bernoulli)](./orifice_noye.md)       | 0,7                     | Lois d'ouvrages, cloisons, cloison aval  
 
 Table: Liste des équations d'ouvrages
+
+## 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.
+
+> Le type de seuil est relatif à l’écoulement au droit de l’ouvrage. 
+> 
+> En effet, plus l’épaisseur de la crête du seuil est négligeable devant la hauteur d’eau amont au-dessus de celui-ci, plus le seuil paraît transparent vis-à-vis de l’écoulement et donc plus la crête du seuil paraît mince. 
+>
+> A l’inverse, plus la ligne d’eau amont se rapproche de la crête du seuil, plus la largeur du seuil paraît grande vis-à-vis de l’épaisseur de la lame d’eau qui y transite et donc plus la crête du seuil paraît épaisse. 
+> Un déversoir en rivière appartient ainsi à l’une des trois catégories suivantes : 
+> - seuil à crête mince
+> - seuil à crête épaisse
+> - seuil à crête non définie 
+>
+> Afin de déterminer le type de seuil étudié, les conditions suivantes doivent être vérifiées :
+> - si $`C < \frac{H_1}{2}`$, alors le seuil est à crête mince ;
+> - si $`C > \frac{2H_1}{3}`$, alors le seuil est à crête épaisse.
\ No newline at end of file

docs/mathjax-scrollbar.css

+/* suppression de l'ascenseur horizontal sur les formules Mathjax */
+.arithmatex {
+    overflow-x: auto;
+}
+
+/* suppression de l'ascenseur vertical sur certaines formules Mathjax */
+mjx-math {
+    overflow-y: clip;
+}