From 12dbcfe6e24ed9905edfe22dfcd9a0888e0f34d7 Mon Sep 17 00:00:00 2001 From: "mathias.chouet" <mathias.chouet@irstea.fr> Date: Fri, 14 Aug 2020 14:14:25 +0200 Subject: [PATCH] Fix #434 - doc for Verificateur --- .../calculators/verif/especes_predefinies.md | 26 +++++ docs/en/calculators/verif/macrorugo.md | 46 ++++++++ docs/en/calculators/verif/pab.md | 105 ++++++++++++++++++ docs/en/calculators/verif/par.md | 36 ++++++ docs/en/calculators/verif/principe.md | 29 +++++ .../calculators/verif/especes_predefinies.md | 26 +++++ docs/fr/calculators/verif/macrorugo.md | 46 ++++++++ docs/fr/calculators/verif/pab.md | 105 ++++++++++++++++++ docs/fr/calculators/verif/par.md | 36 ++++++ docs/fr/calculators/verif/principe.md | 29 +++++ mkdocs-en.yml | 14 +++ mkdocs-fr.yml | 6 + src/locale/messages.en.json | 24 ++-- 13 files changed, 516 insertions(+), 12 deletions(-) create mode 100644 docs/en/calculators/verif/especes_predefinies.md create mode 100644 docs/en/calculators/verif/macrorugo.md create mode 100644 docs/en/calculators/verif/pab.md create mode 100644 docs/en/calculators/verif/par.md create mode 100644 docs/en/calculators/verif/principe.md create mode 100644 docs/fr/calculators/verif/especes_predefinies.md create mode 100644 docs/fr/calculators/verif/macrorugo.md create mode 100644 docs/fr/calculators/verif/pab.md create mode 100644 docs/fr/calculators/verif/par.md create mode 100644 docs/fr/calculators/verif/principe.md diff --git a/docs/en/calculators/verif/especes_predefinies.md b/docs/en/calculators/verif/especes_predefinies.md new file mode 100644 index 000000000..a8c0bde15 --- /dev/null +++ b/docs/en/calculators/verif/especes_predefinies.md @@ -0,0 +1,26 @@ +# Crossability verification: Predefined species + +From _"Informations sur la Continuité Écologique - ICE, Onema 2014"_. + +| ICE group | Species | +|-------------------------|----------------| +| 1 | Atlantic salmon (Salmo salar)<br>Sea or river trout [50-100] (Salmo trutta) | +| 2 | Mules (Chelon labrosus, Liza ramada) | +| 3a | Gread shad (Alosa alosa) | +| 3b | Shad (Alosa fallax fallax) | +| 3c | Sea lamprey (Petromyzon marinus) | +| 4a | River trout or sea trout [25-55] (Salmo trutta) | +| 4b | River trout [15-30] (Salmo trutta) | +| 5 | Aspe (Aspius aspius)<br>Pike (Esox lucius) | +| 6 | Common grayling (Thymallus thymallus) | +| 7a | Common barbel (Barbus barbus)<br>Chub (Squalius cephalus)<br>Nase (Chondrostoma nasus) | +| 7b | River lamprey (Lampetra fluviatilis) | +| 8a | Common carp (Cyprinus carpio) | +| 8b | Common bream (Abramis brama)<br>Pike-perch (Sander lucioperca) | +| 8c | White bream (Blicca bjoerkna)<br>Ide (Leuciscus idus)<br>Burbot (Lota lota)<br>Perch (Perca fluviatilis)<br>Tench (Tinca tinca) | +| 8d | Common dace (Leuciscus sp but Idus) | +| 9a | Bleak (Alburnus alburnus)<br>Sprirlin (Alburnoides bipunctatus)<br>Mediterranean barbel (Barbus meridionalis)<br>Souffia (Telestes souffia)<br>Crucian carp (Carassius carassius)<br>Prussian carp (Carassius gibelio)<br>Roach (Rutilus rutilus)<br>Common rudd (Scardinius erythrophthalmus)<br>South-west european nase (Parachondrostoma toxostoma) | +| 9b | Apron (Zingel asper)<br>Cottus sp<br>Gobio sp<br>Ruffe (Gymnocephalus cernuus)<br>Brook lamprey (Lampetra planeri)<br>Stone loach ( Barbatula barbatula)<br>Spined loach (Cobitis taenia) | +| 10 | Sunbleak (Leucaspius delineatus)<br>European bitterling (Rhodeus amarus)<br>Three-spined stickleback (Gasterosteus gymnurus)<br>Ninespine stickleback (Pungitius laevis)<br>Minnows (Phoxinus sp) | + +Table: List of predefined group species diff --git a/docs/en/calculators/verif/macrorugo.md b/docs/en/calculators/verif/macrorugo.md new file mode 100644 index 000000000..bb41fb93f --- /dev/null +++ b/docs/en/calculators/verif/macrorugo.md @@ -0,0 +1,46 @@ +# Crossability verification: Rock-ramp fishpasses + +## Compound rock-ramp fishpasses + +In the case of compound rock-ramp fishpasses, each apron (reminder: inclined apron are discretised) is verified like an independent rock-ramp fishpass. + +If at least one apron is crossable, the pass is considered crossable. + +Maximum crossable width, wich is the maximum of the sums of the widths of contiguous crossable aprons, is given at the end of the verification. + +## Criteria + +### Minimum water level \(YMin\), in m + +Water level \(Y\) in the pass should be greater than minimum water level. + +### Limit maximum flow velocity \(VeMax\), in m/s + +Maximum flow velocity \(VMax\) in the pass should be lower than limit maximum flow velocity. + +## Criteria values for predefined species groups + +From _"Informations sur la Continuité Écologique - ICE, Onema 2014"_. + +| ICE group | Species | Minimum water level (m) | Limit maximum flow velocity (m/s) | +|-------------------------|----------------|----------------|----------------| +| 1 | Atlantic salmon (Salmo salar)<br>Sea or river trout [50-100] (Salmo trutta) | 0.4 | 2.5 | +| 2 | Mules (Chelon labrosus, Liza ramada) | 0.3 | 2.5 | +| 3a | Gread shad (Alosa alosa) | 0.4 | 2 | +| 3b | Shad (Alosa fallax fallax) | 0.4 | 2 | +| 3c | Sea lamprey (Petromyzon marinus) | 0.15 | 2 | +| 4a | River trout or sea trout [25-55] (Salmo trutta) | 0.3 | 2 | +| 4b | River trout [15-30] (Salmo trutta) | 0.2 | 2 | +| 5 | Aspe (Aspius aspius)<br>Pike (Esox lucius) | 0.3 | 2 | +| 6 | Common grayling (Thymallus thymallus) | 0.3 | 2 | +| 7a | Common barbel (Barbus barbus)<br>Chub (Squalius cephalus)<br>Nase (Chondrostoma nasus) | 0.3 | 2 | +| 7b | River lamprey (Lampetra fluviatilis) | 0.15 | 2 | +| 8a | Common carp (Cyprinus carpio) | 0.3 | 1.5 | +| 8b | Common bream (Abramis brama)<br>Pike-perch (Sander lucioperca) | 0.3 | 1.5 | +| 8c | White bream (Blicca bjoerkna)<br>Ide (Leuciscus idus)<br>Burbot (Lota lota)<br>Perch (Perca fluviatilis)<br>Tench (Tinca tinca) | 0.3 | 1.5 | +| 8d | Common dace (Leuciscus sp but Idus) | 0.3 | 1.5 | +| 9a | Bleak (Alburnus alburnus)<br>Sprirlin (Alburnoides bipunctatus)<br>Mediterranean barbel (Barbus meridionalis)<br>Souffia (Telestes souffia)<br>Crucian carp (Carassius carassius)<br>Prussian carp (Carassius gibelio)<br>Roach (Rutilus rutilus)<br>Common rudd (Scardinius erythrophthalmus)<br>South-west european nase (Parachondrostoma toxostoma) | 0.2 | 1.5 | +| 9b | Apron (Zingel asper)<br>Cottus sp<br>Gobio sp<br>Ruffe (Gymnocephalus cernuus)<br>Brook lamprey (Lampetra planeri)<br>Stone loach ( Barbatula barbatula)<br>Spined loach (Cobitis taenia) | 0.2 | 1.5 | +| 10 | Sunbleak (Leucaspius delineatus)<br>European bitterling (Rhodeus amarus)<br>Three-spined stickleback (Gasterosteus gymnurus)<br>Ninespine stickleback (Pungitius laevis)<br>Minnows (Phoxinus sp) | 0.2 | 1.5 | + +Table: List of predefined values for crossing criteria of a rock-ramp fishpass diff --git a/docs/en/calculators/verif/pab.md b/docs/en/calculators/verif/pab.md new file mode 100644 index 000000000..6d5a7e7ca --- /dev/null +++ b/docs/en/calculators/verif/pab.md @@ -0,0 +1,105 @@ +# Crossability verification: Fish ladders + +When verifying a fish ladder, basins and walls are sequentially tested, as well as every device of each wall. If at least one basin is not crossable, then the pass is not crossable. + +Criteria differ depending on the jet type generated by the device being verified. If a wall has several devices, it will be considered crossable if at least one device is crossable. + +Orifices are considered uncrossable. + +## Criteria + +### Diving jet support + +Some species do not support diving jets. For such species, each device leading to a diving jet is marked as not crossable. + +### Maximum fall \(DHMaxS\) and \(DHMaxP\), in m + +Basin fall \(DH\) must be lower than maximum fall. + +### Minimum slot width \(BMin\), in m (surface jet only) + +Slot width \(L\) must be greater than minimum width. For orifices, surface \(S\) must be greater than minimum width squared. + +### Minimum head on weir \(HMin\), in m + +Head \(h1\) on weir must be greater than minimum head. + +### Minimum basin depth \(PMinS\) and \(PMinP\), in m + +Basin depth \(YMOY\) must be greater than minimum depth. For diving jets, depth must be greater than twice the basin fall \(DH\). + +### Minimum basin length \(LMinS\) and \(LMinP\), in m + +Basin length \(LB\) must be greater than minimum length. + +### Recommanded maximum dissipated power \(PVMaxPrec\) and limit maximum dissipated power \(PVMaxLim\), in W/m³ + +Maximal dissipated power \(PVMax\) in the basin must be lower than limit maximum dissipated power. If it is greater than recommanded maximum dissipated power, a warning is thrown. + +**Important:** maximum dissipated power verification is **disabled** in the current Cassiopée version. + +## Criteria values for predefined species groups + +From _"Informations sur la Continuité Écologique - ICE, Onema 2014"_, and D. Courret. + +### Common values for surface jet and diving jet + +| ICE group | Species | Minimum head on weir (m) | Recommanded maximum dissipated power (W/m³) | Limit maximum dissipated power (W/m³) | +|------------|---------|---------|---------|---------| +| 1 | Atlantic salmon (Salmo salar)<br>Sea or river trout [50-100] (Salmo trutta) | 0.3 | 200 | 250 | +| 2 | Mules (Chelon labrosus, Liza ramada) | 0.2 | 200 | 250 | +| 3a | Gread shad (Alosa alosa) | 0.4 | 150 | 200 | +| 3b | Shad (Alosa fallax fallax) | 0.4 | 150 | 200 | +| 3c | Sea lamprey (Petromyzon marinus) | 0.15 | 200 | 250 | +| 4a | River trout or sea trout [25-55] (Salmo trutta) | 0.2 | 200 | 250 | +| 4b | River trout [15-30] (Salmo trutta) |0.2 | 200 | 250 | +| 5 | Aspe (Aspius aspius)<br>Pike (Esox lucius) | 0.2 | 150 | 200 | +| 6 | Common grayling (Thymallus thymallus) | 0.2 | 200 | 250 | +| 7a | Common barbel (Barbus barbus)<br>Chub (Squalius cephalus)<br>Nase (Chondrostoma nasus) | 0.2 | 150 | 200 | +| 7b | River lamprey (Lampetra fluviatilis) | 0.15 | 130 | 150 | +| 8a | Common carp (Cyprinus carpio) | 0.2 | - | - | +| 8b | Common bream (Abramis brama)<br>Pike-perch (Sander lucioperca) | 0.2 | 150 | 200 | +| 8c | White bream (Blicca bjoerkna)<br>Ide (Leuciscus idus)<br>Burbot (Lota lota)<br>Perch (Perca fluviatilis)<br>Tench (Tinca tinca) | 0.2 | 130 | 150 | +| 8d | Common dace (Leuciscus sp but Idus) | 0.2 | 150 | 200 | +| 9a | Bleak (Alburnus alburnus)<br>Sprirlin (Alburnoides bipunctatus)<br>Mediterranean barbel (Barbus meridionalis)<br>Souffia (Telestes souffia)<br>Crucian carp (Carassius carassius)<br>Prussian carp (Carassius gibelio)<br>Roach (Rutilus rutilus)<br>Common rudd (Scardinius erythrophthalmus)<br>South-west european nase (Parachondrostoma toxostoma) | 0.2 | 130 | 150 | +| 9b | Apron (Zingel asper)<br>Cottus sp<br>Gobio sp<br>Ruffe (Gymnocephalus cernuus)<br>Brook lamprey (Lampetra planeri)<br>Stone loach ( Barbatula barbatula)<br>Spined loach (Cobitis taenia) | 0.2 | 130 | 150 | +| 10 | Sunbleak (Leucaspius delineatus)<br>European bitterling (Rhodeus amarus)<br>Three-spined stickleback (Gasterosteus gymnurus)<br>Ninespine stickleback (Pungitius laevis)<br>Minnows (Phoxinus sp) | 0.2 | 100 | 150 | + +Table: List of predefined values for crossing criteria of a fish ladder + +### Surface jet + +| ICE group | Species | Maximum fall (m) | Minimum slot width (m) | Minimum basin depth (m) | Minimum basin length (m) | +|------------|---------|---------|---------|--------------|----------| +| 1 | Atlantic salmon (Salmo salar)<br>Sea or river trout [50-100] (Salmo trutta) | 0.35 | 0.3 | 1 | 2.5 | +| 2 | Mules (Chelon labrosus, Liza ramada) | 0.35 | 0.2 | 1 | 1.75 | +| 3a | Gread shad (Alosa alosa) | 0.3 | 0.4 | 1 | 3.5 | +| 3b | Shad (Alosa fallax fallax) | 0.3 | 0.4 | 1 | 3.5 | +| 3c | Sea lamprey (Petromyzon marinus) | 0.3 | 0.15 | 1 | 1.25 | +| 4a | River trout or sea trout [25-55] (Salmo trutta) | 0.35 | 0.2 | 1 | 1.75 | +| 4b | River trout [15-30] (Salmo trutta) | 0.3 | 0.15 | 0.75 | 1.75 | +| 5 | Aspe (Aspius aspius)<br>Pike (Esox lucius) | 0.3 | 0.3 | 0.75 | 2.5 | +| 6 | Common grayling (Thymallus thymallus) | 0.3 | 0.2 | 0.75 | 1.75 | +| 7a | Common barbel (Barbus barbus)<br>Chub (Squalius cephalus)<br>Nase (Chondrostoma nasus) | 0.3 | 0.25 | 0.75 | 2 | +| 7b | River lamprey (Lampetra fluviatilis) | 0.3 | 0.15 | 0.75 | 1.25 | +| 8a | Common carp (Cyprinus carpio) | 0.25 | 0.3 | 0.75 | 2.5 | +| 8b | Common bream (Abramis brama)<br>Pike-perch (Sander lucioperca) | 0.25 | 0.3 | 0.75 | 2.5 | +| 8c | White bream (Blicca bjoerkna)<br>Ide (Leuciscus idus)<br>Burbot (Lota lota)<br>Perch (Perca fluviatilis)<br>Tench (Tinca tinca) | 0.25 | 0.3 | 0.75 | 2.5 | +| 8d | Common dace (Leuciscus sp but Idus) | 0.25 | 0.3 | 0.75 | 2.5 | +| 9a | Bleak (Alburnus alburnus)<br>Sprirlin (Alburnoides bipunctatus)<br>Mediterranean barbel (Barbus meridionalis)<br>Souffia (Telestes souffia)<br>Crucian carp (Carassius carassius)<br>Prussian carp (Carassius gibelio)<br>Roach (Rutilus rutilus)<br>Common rudd (Scardinius erythrophthalmus)<br>South-west european nase (Parachondrostoma toxostoma) | 0.25 | 0.25 | 0.75 | 2 | +| 9b | Apron (Zingel asper)<br>Cottus sp<br>Gobio sp<br>Ruffe (Gymnocephalus cernuus)<br>Brook lamprey (Lampetra planeri)<br>Stone loach ( Barbatula barbatula)<br>Spined loach (Cobitis taenia) | 0.2 | 0.15 | 0.5 | 1.25 | +| 10 | Sunbleak (Leucaspius delineatus)<br>European bitterling (Rhodeus amarus)<br>Three-spined stickleback (Gasterosteus gymnurus)<br>Ninespine stickleback (Pungitius laevis)<br>Minnows (Phoxinus sp) | 0.2 | 0.15 | 0.5 | 1.25 | + +Table: List of predefined values for crossing criteria of a fish ladder, with surface jet + +### Diving jet + +| ICE Group | Species | Maximum fall (m) | Minimum basin depth (m) | Minimum basin length (m) | +|------------|---------|---------|-----------|--------------| +| 1 | Atlantic salmon (Salmo salar)<br>Sea or river trout [50-100] (Salmo trutta) | 0.75 | 1 | 2 | +| 2 | Mules (Chelon labrosus, Liza ramada) | 0.6 | 0.75 | 1.25 | +| 4a | River trout or sea trout [25-55] (Salmo trutta) | 0.4 | 0.75 | 1.25 | +| 4b | River trout [15-30] (Salmo trutta) | 0.3 | 0.75 | 1 | +| 6 | Common grayling (Thymallus thymallus) | 0.3 | 0.75 | 1 | + +Table: List of predefined values for crossing criteria of a fish ladder, with diving jet diff --git a/docs/en/calculators/verif/par.md b/docs/en/calculators/verif/par.md new file mode 100644 index 000000000..7a2462687 --- /dev/null +++ b/docs/en/calculators/verif/par.md @@ -0,0 +1,36 @@ +# Crossability verification: Humpback fishways (simulation) + +## Criteria + +### Incompatible and discouraged species + +Species groups 3a, 3b and 7b are discouraged for crossing humpback fishways. This leads to a warning, but does not make the pass not crossable. + +Species groups 8a, 8b, 8c, 8d, 9a, 9b and 10 are unable to cross humpback fishways. + +### Minimum water level \(YMinPB\) and \(YMinSB\), in m + +Water level \(h\) in the pass must be greater than the minimum water level, depending on baffles type: + + * plane and Fatou baffles: \(YMinPB\) + * superactive and chevron baffles: \(YMinSB\) + +## Criteria values for predefined species groups + +From _"Informations sur la Continuité Écologique - ICE, Onema 2014"_. + +| ICE group | Species | Minimum water level on plane baffles (m) | Minimum water level on superactive baffles (m) | +|------------|---------|---------|-----------| +| 1 | Atlantic salmon (Salmo salar)<br>Sea or river trout [50-100] (Salmo trutta) | 0.3 | 0.2 | +| 2 | Mules (Chelon labrosus, Liza ramada) | 0.25 | 0.15 | +| 3a | Gread shad (Alosa alosa) | 0.3 | 0.2 | +| 3b | Shad (Alosa fallax fallax) | 0.25 | 0.15 | +| 3c | Sea lamprey (Petromyzon marinus) | 0.1 | 0.1 | +| 4a | River trout or sea trout [25-55] (Salmo trutta) | 0.25 | 0.15 | +| 4b | River trout [15-30] (Salmo trutta) | 0.2 | 0.1 | +| 5 | Aspe (Aspius aspius)<br>Pike (Esox lucius) | 0.3 | 0.2 | +| 6 | Common grayling (Thymallus thymallus) | 0.25 | 0.15 | +| 7a | Common barbel (Barbus barbus)<br>Chub (Squalius cephalus)<br>Nase (Chondrostoma nasus) | 0.25 | 0.15 | +| 7b | River lamprey (Lampetra fluviatilis) | 0.1 | 0.1 | + +Table: List of predefined values for crossing criteria of a humpback fishway diff --git a/docs/en/calculators/verif/principe.md b/docs/en/calculators/verif/principe.md new file mode 100644 index 000000000..6313c5cce --- /dev/null +++ b/docs/en/calculators/verif/principe.md @@ -0,0 +1,29 @@ +# Crossability verification + +This module allows to verify the capacity of different fish species to cross the following types of fish passes: + +- [fish ladders](pab.md) +- [humpback fishways](par.md) +- [rock-ramp fishpasses](macrorugo.md) + +## Principle + +For each pass type, several crossability criteria are checked, expressed as threshold values (ex: minimal basin depth, for a fish ladder). + +Exceeding the threshold value of a criterion leads to an explicit error mentioning the quantity concerned and the threshold value, and results in the pass not being crossable. + +Some criteria such as maximal dissipated power have both an alert value (crossability is possible but not guaranteed) and a limit value (crossing the pass is impossible). + +For a given pass, one can check at once the crossing capabilities of several species, over multiple modalities (variation of one or more parameters in the pass). + +## Predefined species + +[Several common species groups](especes_predefinies.md) are predefined: default values are associated to crossability criteria. + +Default values for some of those criteria might be missing for a species group, when the latter is considered unabled to cross the pass type the criterion is related to. + +## Custom species + +The `Fish species characteristics` module allows to define custom values for all criteria, before running a pass verification. + +If a criterion is applicable to the pass that is being checked, but no value was given, an error will be triggered when running the verification, leading to the pass being not crossable. diff --git a/docs/fr/calculators/verif/especes_predefinies.md b/docs/fr/calculators/verif/especes_predefinies.md new file mode 100644 index 000000000..dbb388400 --- /dev/null +++ b/docs/fr/calculators/verif/especes_predefinies.md @@ -0,0 +1,26 @@ +# Vérification des critères de franchissement : Espèces prédéfinies + +D'après _"Informations sur la Continuité Écologique - ICE, Onema 2014"_. + +| Groupe ICE | Espèces | +|-------------------------|----------------| +| 1 | Saumon atlantique (Salmo salar)<br>Truite de mer ou de rivière [50-100] (Salmo trutta) | +| 2 | Mulets (Chelon labrosus, Liza ramada) | +| 3a | Grande alose (Alosa alosa) | +| 3b | Alose feinte (Alosa fallax fallax) | +| 3c | Lamproie marine (Petromyzon marinus) | +| 4a | Truite de rivière ou truite de mer [25-55] (Salmo trutta) | +| 4b | Truite de rivière [15-30] (Salmo trutta) | +| 5 | Aspe (Aspius aspius)<br>Brochet (Esox lucius) | +| 6 | Ombre commun (Thymallus thymallus) | +| 7a | Barbeau fluviatile (Barbus barbus)<br>Chevaine (Squalius cephalus)<br>Hotu (Chondrostoma nasus) | +| 7b | Lamproie fluviatile (Lampetra fluviatilis) | +| 8a | Carpe commune (Cyprinus carpio) | +| 8b | Brème commune (Abramis brama)<br>Sandre (Sander lucioperca) | +| 8c | Brème bordelière (Blicca bjoerkna)<br>Ide melanote (Leuciscus idus)<br>Lotte de rivière (Lota lota)<br>Perche (Perca fluviatilis)<br>Tanche (Tinca tinca) | +| 8d | Vandoises (Leuciscus sp hors Idus) | +| 9a | Ablette commune (Alburnus alburnus)<br>Ablette sprirlin (Alburnoides bipunctatus)<br>Barbeau méridional (Barbus meridionalis)<br>Blageon (Telestes souffia)<br>Carassin commun (Carassius carassius)<br>Carassin argenté (Carassius gibelio)<br>Gardon (Rutilus rutilus)<br>Rotengle (Scardinius erythrophthalmus)<br>Toxostome (Parachondrostoma toxostoma) | +| 9b | Apron (Zingel asper)<br>Chabots (Cottus sp)<br>Goujons (Gobio sp)<br>Grémille (Gymnocephalus cernuus)<br>Lamproie de Planer (Lampetra planeri)<br>Loche franche ( Barbatula barbatula)<br>Loche de rivière (Cobitis taenia) | +| 10 | Able de Heckel (Leucaspius delineatus)<br>Bouvière (Rhodeus amarus)<br>Epinoche (Gasterosteus gymnurus)<br>Epinochette (Pungitius laevis)<br>Vairons (Phoxinus sp) | + +Table: Liste des groupe d'espèces prédéfinis diff --git a/docs/fr/calculators/verif/macrorugo.md b/docs/fr/calculators/verif/macrorugo.md new file mode 100644 index 000000000..4cab10c41 --- /dev/null +++ b/docs/fr/calculators/verif/macrorugo.md @@ -0,0 +1,46 @@ +# Vérification des critères de franchissement : Passes à macrorugosités + +## Passes à macrorugosités complexes + +Dans le cas des pases à macrorugosités complexes, chaque radier (rappel : les radiers inclinés sont discrétisés) est vérifié comme une passe à macrorugosités indépendante. + +Si au moins un radier est franchissable, la passe est considérée comme franchissable. + +La largeur maximale franchissable, maximum des sommes des largeurs des radiers franchissables contigus, est indiquée à l'issue de la vérification. + +## Critères + +### Tirant d'eau minimal \(YMin\), en m + +Le tirant d'eau \(Y\) dans la passe doit être supérieur au tirant d'eau minimal. + +### Vitesse d'écoulement maximale limite \(VeMax\), en m/s + +La vitesse d'écoulement maximale \(VMax\) dans la passe doit être inférieure à la vitesse d'écoulement maximale limite. + +## Valeurs des critères pour les groupes d'espèces prédéfinis + +D'après _"Informations sur la Continuité Écologique - ICE, Onema 2014"_. + +| Groupe ICE | Espèces | Tirant d'eau minimal (m) | Vitesse d'écoulement maximale limite (m/s) | +|-------------------------|----------------|----------------|----------------| +| 1 | Saumon atlantique (Salmo salar)<br>Truite de mer ou de rivière [50-100] (Salmo trutta) | 0.4 | 2.5 | +| 2 | Mulets (Chelon labrosus, Liza ramada) | 0.3 | 2.5 | +| 3a | Grande alose (Alosa alosa) | 0.4 | 2 | +| 3b | Alose feinte (Alosa fallax fallax) | 0.4 | 2 | +| 3c | Lamproie marine (Petromyzon marinus) | 0.15 | 2 | +| 4a | Truite de rivière ou truite de mer [25-55] (Salmo trutta) | 0.3 | 2 | +| 4b | Truite de rivière [15-30] (Salmo trutta) | 0.2 | 2 | +| 5 | Aspe (Aspius aspius)<br>Brochet (Esox lucius) | 0.3 | 2 | +| 6 | Ombre commun (Thymallus thymallus) | 0.3 | 2 | +| 7a | Barbeau fluviatile (Barbus barbus)<br>Chevaine (Squalius cephalus)<br>Hotu (Chondrostoma nasus) | 0.3 | 2 | +| 7b | Lamproie fluviatile (Lampetra fluviatilis) | 0.15 | 2 | +| 8a | Carpe commune (Cyprinus carpio) | 0.3 | 1.5 | +| 8b | Brème commune (Abramis brama)<br>Sandre (Sander lucioperca) | 0.3 | 1.5 | +| 8c | Brème bordelière (Blicca bjoerkna)<br>Ide melanote (Leuciscus idus)<br>Lotte de rivière (Lota lota)<br>Perche (Perca fluviatilis)<br>Tanche (Tinca tinca) | 0.3 | 1.5 | +| 8d | Vandoises (Leuciscus sp hors Idus) | 0.3 | 1.5 | +| 9a | Ablette commune (Alburnus alburnus)<br>Ablette sprirlin (Alburnoides bipunctatus)<br>Barbeau méridional (Barbus meridionalis)<br>Blageon (Telestes souffia)<br>Carassin commun (Carassius carassius)<br>Carassin argenté (Carassius gibelio)<br>Gardon (Rutilus rutilus)<br>Rotengle (Scardinius erythrophthalmus)<br>Toxostome (Parachondrostoma toxostoma) | 0.2 | 1.5 | +| 9b | Apron (Zingel asper)<br>Chabots (Cottus sp)<br>Goujons (Gobio sp)<br>Grémille (Gymnocephalus cernuus)<br>Lamproie de Planer (Lampetra planeri)<br>Loche franche ( Barbatula barbatula)<br>Loche de rivière (Cobitis taenia) | 0.2 | 1.5 | +| 10 | Able de Heckel (Leucaspius delineatus)<br>Bouvière (Rhodeus amarus)<br>Epinoche (Gasterosteus gymnurus)<br>Epinochette (Pungitius laevis)<br>Vairons (Phoxinus sp) | 0.2 | 1.5 | + +Table: Liste des valeurs prédéfinies pour les critères de franchissement d'une passe à macrorugosités diff --git a/docs/fr/calculators/verif/pab.md b/docs/fr/calculators/verif/pab.md new file mode 100644 index 000000000..b86c8b864 --- /dev/null +++ b/docs/fr/calculators/verif/pab.md @@ -0,0 +1,105 @@ +# Vérification des critères de franchissement : Passes à bassins + +Lors de la vérification d'une passe à bassins, les bassins et les cloisons sont testés séquentiellement, ainsi que tous les ouvrages de chaque cloison. Si au moins un bassin est infranchissable, alors la passe est infranchissable. + +Les critères diffèrent selon que l'ouvrage considéré donne lieu à un jet plongeant ou à un jet de surface. Si une cloison possède plusieurs ouvrages, elle sera considérée comme franchissable si au moins un ouvrage est franchissable. + +Les orifices sont considérés comme infranchissables. + +## Critères + +### Jet plongeant + +Certaines espèces ne supportent pas les jets plongeants. Pour ces espèces, chaque ouvrage donnant lieu à un jet plongeant est marqué comme infranchissable. + +### Chute maximale \(DHMaxS\) et \(DHMaxP\), en m + +La chute \(DH\) du bassin doit être inférieure à la chute maximale. + +### Largeur minimale de fente ou échancrure latérale \(BMin\), en m (jet de surface seulement) + +La largeur \(L\) de la fente ou échancrure doit être supérieure à la largeur minimale. Dans le cas d'un orifice, la surface \(S\) de l'orifice doit être supérieure à la largeur minimale au carré. + +### Charge minimale sur l'échancrure \(HMin\), en m + +La charge \(h1\) sur l'échancrure doit être supérieure à la charge minimale. + +### Profondeur minimale de bassin \(PMinS\) et \(PMinP\), en m + +La profondeur \(YMOY\) du bassin doit être supérieure à la profondeur minimale. Dans le cas d'un jet plongeant, la profondeur doit être supérieure au double de la chute \(DH\) du bassin. + +### Longueur minimale de bassin \(LMinS\) et \(LMinP\), en m + +La longueur \(LB\) du bassin doit être supérieure à la longueur minimale. + +### Puissance dissipée maximale préconisée \(PVMaxPrec\) et maximale limite \(PVMaxLim\), en W/m³ + +La puissance dissipée maximale \(PVMax\) dans le bassin doit être inférieure à la puissance dissipée maximale limite. Si elle est supérieure à la puissance dissipée maximale préconisée, un avertissement est émis. + +**Important :** la vérification de la puissance dissipée maximale est **désactivée** dans la version actuelle de Cassiopée + +## Valeurs des critères pour les groupes d'espèces prédéfinis + +D'après _"Informations sur la Continuité Écologique - ICE, Onema 2014"_, et D. Courret. + +### Valeurs communes pour jet de surface et jet plongeant + +| Groupe ICE | Espèces | Charge minimale sur l'échancrure (m) | Puissance dissipée maximale préconisée (W/m³) | Puissance dissipée maximale limite (W/m³) | +|------------|---------|---------|---------|---------| +| 1 | Saumon atlantique (Salmo salar)<br>Truite de mer ou de rivière [50-100] (Salmo trutta) | 0.3 | 200 | 250 | +| 2 | Mulets (Chelon labrosus, Liza ramada) | 0.2 | 200 | 250 | +| 3a | Grande alose (Alosa alosa) | 0.4 | 150 | 200 | +| 3b | Alose feinte (Alosa fallax fallax) | 0.4 | 150 | 200 | +| 3c | Lamproie marine (Petromyzon marinus) | 0.15 | 200 | 250 | +| 4a | Truite de rivière ou truite de mer [25-55] (Salmo trutta) | 0.2 | 200 | 250 | +| 4b | Truite de rivière [15-30] (Salmo trutta) |0.2 | 200 | 250 | +| 5 | Aspe (Aspius aspius)<br>Brochet (Esox lucius) | 0.2 | 150 | 200 | +| 6 | Ombre commun (Thymallus thymallus) | 0.2 | 200 | 250 | +| 7a | Barbeau fluviatile (Barbus barbus)<br>Chevaine (Squalius cephalus)<br>Hotu (Chondrostoma nasus) | 0.2 | 150 | 200 | +| 7b | Lamproie fluviatile (Lampetra fluviatilis) | 0.15 | 130 | 150 | +| 8a | Carpe commune (Cyprinus carpio) | 0.2 | - | - | +| 8b | Brème commune (Abramis brama)<br>Sandre (Sander lucioperca) | 0.2 | 150 | 200 | +| 8c | Brème bordelière (Blicca bjoerkna)<br>Ide melanote (Leuciscus idus)<br>Lotte de rivière (Lota lota)<br>Perche (Perca fluviatilis)<br>Tanche (Tinca tinca) | 0.2 | 130 | 150 | +| 8d | Vandoises (Leuciscus sp hors Idus) | 0.2 | 150 | 200 | +| 9a | Ablette commune (Alburnus alburnus)<br>Ablette sprirlin (Alburnoides bipunctatus)<br>Barbeau méridional (Barbus meridionalis)<br>Blageon (Telestes souffia)<br>Carassin commun (Carassius carassius)<br>Carassin argenté (Carassius gibelio)<br>Gardon (Rutilus rutilus)<br>Rotengle (Scardinius erythrophthalmus)<br>Toxostome (Parachondrostoma toxostoma) | 0.2 | 130 | 150 | +| 9b | Apron (Zingel asper)<br>Chabots (Cottus sp)<br>Goujons (Gobio sp)<br>Grémille (Gymnocephalus cernuus)<br>Lamproie de Planer (Lampetra planeri)<br>Loche franche ( Barbatula barbatula)<br>Loche de rivière (Cobitis taenia) | 0.2 | 130 | 150 | +| 10 | Able de Heckel (Leucaspius delineatus)<br>Bouvière (Rhodeus amarus)<br>Epinoche (Gasterosteus gymnurus)<br>Epinochette (Pungitius laevis)<br>Vairons (Phoxinus sp) | 0.2 | 100 | 150 | + +Table: Liste des valeurs prédéfinies pour les critères de franchissement d'une passe à bassins + +### Jet de surface + +| Groupe ICE | Espèces | Chute maximale (m) | Largeur minimale de fente ou échancrure latérale (m) | Profondeur minimale de bassin (m) | Longueur minimale de bassin (m) | +|------------|---------|---------|---------|--------------|----------| +| 1 | Saumon atlantique (Salmo salar)<br>Truite de mer ou de rivière [50-100] (Salmo trutta) | 0.35 | 0.3 | 1 | 2.5 | +| 2 | Mulets (Chelon labrosus, Liza ramada) | 0.35 | 0.2 | 1 | 1.75 | +| 3a | Grande alose (Alosa alosa) | 0.3 | 0.4 | 1 | 3.5 | +| 3b | Alose feinte (Alosa fallax fallax) | 0.3 | 0.4 | 1 | 3.5 | +| 3c | Lamproie marine (Petromyzon marinus) | 0.3 | 0.15 | 1 | 1.25 | +| 4a | Truite de rivière ou truite de mer [25-55] (Salmo trutta) | 0.35 | 0.2 | 1 | 1.75 | +| 4b | Truite de rivière [15-30] (Salmo trutta) | 0.3 | 0.15 | 0.75 | 1.75 | +| 5 | Aspe (Aspius aspius)<br>Brochet (Esox lucius) | 0.3 | 0.3 | 0.75 | 2.5 | +| 6 | Ombre commun (Thymallus thymallus) | 0.3 | 0.2 | 0.75 | 1.75 | +| 7a | Barbeau fluviatile (Barbus barbus)<br>Chevaine (Squalius cephalus)<br>Hotu (Chondrostoma nasus) | 0.3 | 0.25 | 0.75 | 2 | +| 7b | Lamproie fluviatile (Lampetra fluviatilis) | 0.3 | 0.15 | 0.75 | 1.25 | +| 8a | Carpe commune (Cyprinus carpio) | 0.25 | 0.3 | 0.75 | 2.5 | +| 8b | Brème commune (Abramis brama)<br>Sandre (Sander lucioperca) | 0.25 | 0.3 | 0.75 | 2.5 | +| 8c | Brème bordelière (Blicca bjoerkna)<br>Ide melanote (Leuciscus idus)<br>Lotte de rivière (Lota lota)<br>Perche (Perca fluviatilis)<br>Tanche (Tinca tinca) | 0.25 | 0.3 | 0.75 | 2.5 | +| 8d | Vandoises (Leuciscus sp hors Idus) | 0.25 | 0.3 | 0.75 | 2.5 | +| 9a | Ablette commune (Alburnus alburnus)<br>Ablette sprirlin (Alburnoides bipunctatus)<br>Barbeau méridional (Barbus meridionalis)<br>Blageon (Telestes souffia)<br>Carassin commun (Carassius carassius)<br>Carassin argenté (Carassius gibelio)<br>Gardon (Rutilus rutilus)<br>Rotengle (Scardinius erythrophthalmus)<br>Toxostome (Parachondrostoma toxostoma) | 0.25 | 0.25 | 0.75 | 2 | +| 9b | Apron (Zingel asper)<br>Chabots (Cottus sp)<br>Goujons (Gobio sp)<br>Grémille (Gymnocephalus cernuus)<br>Lamproie de Planer (Lampetra planeri)<br>Loche franche ( Barbatula barbatula)<br>Loche de rivière (Cobitis taenia) | 0.2 | 0.15 | 0.5 | 1.25 | +| 10 | Able de Heckel (Leucaspius delineatus)<br>Bouvière (Rhodeus amarus)<br>Epinoche (Gasterosteus gymnurus)<br>Epinochette (Pungitius laevis)<br>Vairons (Phoxinus sp) | 0.2 | 0.15 | 0.5 | 1.25 | + +Table: Liste des valeurs prédéfinies pour les critères de franchissement d'une passe à bassins, en jet de surface + +### Jet plongeant + +| Groupe ICE | Espèces | Chute maximale (m) | Profondeur minimale de bassin (m) | Longueur minimale de bassin (m) | +|------------|---------|---------|-----------|--------------| +| 1 | Saumon atlantique (Salmo salar)<br>Truite de mer ou de rivière [50-100] (Salmo trutta) | 0.75 | 1 | 2 | +| 2 | Mulets (Chelon labrosus, Liza ramada) | 0.6 | 0.75 | 1.25 | +| 4a | Truite de rivière ou truite de mer [25-55] (Salmo trutta) | 0.4 | 0.75 | 1.25 | +| 4b | Truite de rivière [15-30] (Salmo trutta) | 0.3 | 0.75 | 1 | +| 6 | Ombre commun (Thymallus thymallus) | 0.3 | 0.75 | 1 | + +Table: Liste des valeurs prédéfinies pour les critères de franchissement d'une passe à bassins, en jet plongeant diff --git a/docs/fr/calculators/verif/par.md b/docs/fr/calculators/verif/par.md new file mode 100644 index 000000000..e053af8fa --- /dev/null +++ b/docs/fr/calculators/verif/par.md @@ -0,0 +1,36 @@ +# Vérification des critères de franchissement : Passes à ralentisseurs (simulation) + +## Critères + +### Espèces déconseillées et incompatibles + +Les groupes d'espèces 3a, 3b et 7b sont déconseillés pour le franchissement d'une passe à ralentisseurs. Cela donne lieu à un avertissement, sans pour autant entraîner l'infranchissabilité de la passe. + +Les groupes d'espèces 8a, 8b, 8c, 8d, 9a, 9b et 10 sont incapables de franchir des passes à ralentisseurs. + +### Tirant d'eau minimal \(YMinPB\) et \(YMinSB\), en m + +Le tirant d'eau \(h\) dans la passe doit être supérieur au tirant d'eau minimal, selon le type de ralentisseurs : + + * ralentisseurs plans et Fatou : \(YMinPB\) + * ralentisseurs suractifs et chevrons : \(YMinSB\) + +## Valeurs des critères pour les groupes d'espèces prédéfinis + +D'après _"Informations sur la Continuité Écologique - ICE, Onema 2014"_. + +| Groupe ICE | Espèces | Tirant d'eau minimal sur les ralentisseurs plans (m) | Tirant d'eau minimal sur les ralentisseurs suractifs (m) | +|------------|---------|---------|-----------| +| 1 | Saumon atlantique (Salmo salar)<br>Truite de mer ou de rivière [50-100] (Salmo trutta) | 0.3 | 0.2 | +| 2 | Mulets (Chelon labrosus, Liza ramada) | 0.25 | 0.15 | +| 3a | Grande alose (Alosa alosa) | 0.3 | 0.2 | +| 3b | Alose feinte (Alosa fallax fallax) | 0.25 | 0.15 | +| 3c | Lamproie marine (Petromyzon marinus) | 0.1 | 0.1 | +| 4a | Truite de rivière ou truite de mer [25-55] (Salmo trutta) | 0.25 | 0.15 | +| 4b | Truite de rivière [15-30] (Salmo trutta) | 0.2 | 0.1 | +| 5 | Aspe (Aspius aspius)<br>Brochet (Esox lucius) | 0.3 | 0.2 | +| 6 | Ombre commun (Thymallus thymallus) | 0.25 | 0.15 | +| 7a | Barbeau fluviatile (Barbus barbus)<br>Chevaine (Squalius cephalus)<br>Hotu (Chondrostoma nasus) | 0.25 | 0.15 | +| 7b | Lamproie fluviatile (Lampetra fluviatilis) | 0.1 | 0.1 | + +Table: Liste des valeurs prédéfinies pour les critères de franchissement d'une passe à ralentisseurs diff --git a/docs/fr/calculators/verif/principe.md b/docs/fr/calculators/verif/principe.md new file mode 100644 index 000000000..bce6ec0e9 --- /dev/null +++ b/docs/fr/calculators/verif/principe.md @@ -0,0 +1,29 @@ +# Vérification des critères de franchissement + +Cet outil permet de vérifier la capacité des différentes espèces de poissons à franchir les types de passes suivants : + +- [passes à bassins](pab.md) +- [passes à ralentisseurs](par.md) +- [passes à macrorugosités](macrorugo.md) + +## Principe + +Pour chaque type de passe, on contrôle plusieurs critères de franchissabilité, exprimés sous forme de valeurs limites (ex: profondeur minimale de bassin, pour une passe à bassins). + +Tout dépassement de la valeur limite d'un critère donne lieu à une erreur explicite mentionnant la grandeur concernée et la valeur limite, et entraîne la non franchissabilité de la passe. + +Certains critères comme la puissance maximale dissipée possèdent à la fois une valeur d'alerte (la franchissabilité n'est pas garantie mais reste possible) et une valeur limite (le franchissement est impossible). + +Pour une même passe, on peut verifier simultanément la capacité de franchissement de plusieurs espèces, sur plusieurs modalités (variation d'un ou plusieurs paramètres de la passe). + +## Espèces prédéfinies + +[Plusieurs groupes d'espèces communes](especes_predefinies.md) sont prédéfinis : des valeurs par défaut sont associées aux critères de franchissement. + +Les valeurs par défaut de certains critères peuvent être absentes pour un groupe d'espèces, lorsque celui-ci est considéré comme incapable de franchir le type de passes auquel le critère est rattaché. + +## Espèces personnalisées + +Le module `Espèce` permet de définir des valeurs personnalisées pour tous les critères, avant de lancer la vérification d'une passe. + +Si un critère est applicable à la passe à vérifier mais aucune valeur n'a été saisie, une erreur sera affichée lors de la vérification, entraînant la non franchissabilité de la passe. diff --git a/mkdocs-en.yml b/mkdocs-en.yml index 5adfe779a..88e7fd794 100644 --- a/mkdocs-en.yml +++ b/mkdocs-en.yml @@ -64,6 +64,20 @@ nav: - calculators/pam/macrorugo_theorie.md - calculators/pam/macrorugo_complexe.md - calculators/pam/concentration.md + - Humpback fishways: + - calculators/par/calage.md + - calculators/par/simulation.md + - calculators/par/formules.md + - calculators/par/theorie_plans.md + - calculators/par/theorie_fatou.md + - calculators/par/theorie_suractif.md + - calculators/par/theorie_mixte.md + - Crossability verification: + - Principle: calculators/verif/principe.md + - Fish ladders: calculators/verif/pab.md + - Humpback fishways: calculators/verif/par.md + - Rock-ramp fishpasses: calculators/verif/macrorugo.md + - Predefined species: calculators/verif/especes_predefinies.md - Downstream migration: - Loss of charge, water grid: calculators/devalaison/grille.md - Jet impact: calculators/devalaison/jet.md diff --git a/mkdocs-fr.yml b/mkdocs-fr.yml index 20a6b9fa6..f7ac501cd 100644 --- a/mkdocs-fr.yml +++ b/mkdocs-fr.yml @@ -72,6 +72,12 @@ nav: - calculators/par/theorie_fatou.md - calculators/par/theorie_suractif.md - calculators/par/theorie_mixte.md + - Vérification des critères de franchissement: + - Principe: calculators/verif/principe.md + - Passes à bassins: calculators/verif/pab.md + - Passes à ralentisseurs: calculators/verif/par.md + - Passes à macrorugosités: calculators/verif/macrorugo.md + - Espèces prédéfinies: calculators/verif/especes_predefinies.md - Dévalaison: - Perte de charge sur grille de prise d'eau: calculators/devalaison/grille.md - Impact de jet: calculators/devalaison/jet.md diff --git a/src/locale/messages.en.json b/src/locale/messages.en.json index 927f0081d..b4b6e6ca1 100644 --- a/src/locale/messages.en.json +++ b/src/locale/messages.en.json @@ -143,23 +143,23 @@ "INFO_ENUM_PARFLOWREGIME_0": "Free", "INFO_ENUM_PARFLOWREGIME_1": "Submerged", "INFO_ENUM_SPECIES_1": "Salmon, trout [50-100] (1)", - "INFO_ENUM_SPECIES_2": "Mules (2)", - "INFO_ENUM_SPECIES_3a": "Great Shad (3a)", - "INFO_ENUM_SPECIES_3b": "Shad shad (3b)", + "INFO_ENUM_SPECIES_2": "Mule (2)", + "INFO_ENUM_SPECIES_3a": "Great shad (3a)", + "INFO_ENUM_SPECIES_3b": "Shad (3b)", "INFO_ENUM_SPECIES_3c": "Sea lamprey (3c)", "INFO_ENUM_SPECIES_4a": "Trout [25-55] (4a)", "INFO_ENUM_SPECIES_4b": "River trout [15-30] (4b)", "INFO_ENUM_SPECIES_5": "Aspe, pike (5)", - "INFO_ENUM_SPECIES_6": "Common Shadow (6)", - "INFO_ENUM_SPECIES_7a": "Barbeau, chevaine, hotu (7a)", - "INFO_ENUM_SPECIES_7b": "River Lamprey (7b)", - "INFO_ENUM_SPECIES_8a": "Common Carp (8a)", + "INFO_ENUM_SPECIES_6": "Common grayling (6)", + "INFO_ENUM_SPECIES_7a": "Barbel, chub, nase (7a)", + "INFO_ENUM_SPECIES_7b": "River lamprey (7b)", + "INFO_ENUM_SPECIES_8a": "Common carp (8a)", "INFO_ENUM_SPECIES_8b": "Common bream, pike-perch (8b)", - "INFO_ENUM_SPECIES_8c": "Brim bream, ide, monkfish, perch, tench (8c)", - "INFO_ENUM_SPECIES_8d": "Vandoises (8d)", - "INFO_ENUM_SPECIES_9a": "Ablette, cockle, carrassin, roach... (9a)", - "INFO_ENUM_SPECIES_9b": "Apron, sculpins, bolts, loche... (9b)", - "INFO_ENUM_SPECIES_10": "Able, cowherd, stickleback, minnows (10)", + "INFO_ENUM_SPECIES_8c": "White bream, ide, burbot, perch, tench (8c)", + "INFO_ENUM_SPECIES_8d": "Common dace (8d)", + "INFO_ENUM_SPECIES_9a": "Bleak, spirlin, barbel, souffia, crucian carp, roach... (9a)", + "INFO_ENUM_SPECIES_9b": "Apron, sculpins, ruffe, loach... (9b)", + "INFO_ENUM_SPECIES_10": "Sunbleak, bitterling, stickleback, minnow (10)", "INFO_ENUM_SPECIES_11a": "European eel [yellow] (11a)", "INFO_ENUM_SPECIES_11b": "European Eel [glass eel] (11b)", "INFO_ENUM_STRUCTUREFLOWMODE_0": "Weir", -- GitLab