> For the complete documentation index, see [llms.txt](https://water-strategy.gitbook.io/waterstrategy/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://water-strategy.gitbook.io/waterstrategy/francais/tutoriels/creating-a-reservoir-system/adding-a-dam-reservoir.md).

# Ajouter un barrage (réservoir)

## 1. Différence entre les nœuds de stockage et de réservoir

Veuillez noter qu'il existe deux nœuds dans WaterStrategy et Pywr qui représentent des réservoirs. Le premier est un [**stockage** ](https://water-strategy.gitbook.io/water-strategy/modelling-fundamentals/node-types/storage-node)nœud et le second est un [**réservoir** ](https://water-strategy.gitbook.io/water-strategy/modelling-fundamentals/node-types/reservoir-node)nœud.

Les deux nœuds stockent l'eau. Le nœud du réservoir fonctionne comme un storage node, mais il possède des paramètres intégrés permettant ***évaporation*** et ***précipitation*** à représenter directement sur le nœud. Représenter ***évaporation*** et ***précipitation*** avec un storage node, un nœud de captage connecté au storage node est utilisé pour représenter les précipitations et un nœud de sortie puisant l'eau du storage node est utilisé pour représenter l'évaporation.

Ce didacticiel utilisera des nœuds de réservoir pour créer le modèle du système de réservoir.

## 2. Créez l'exemple de modèle de système de réservoir

### **2.1 Cliquez sur le réseau créé dans la dernière section et ouvrez-le**

<figure><img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-590f333576491cdcf62424e64e09f929fd04afba%2Fimage%20(237).png?alt=media" alt=""><figcaption><p>Ouvrez le réseau créé</p></figcaption></figure>

### **2.2 Trouvez une rivière sur la carte**

Ce didacticiel propose un emplacement recommandé, mais peu importe si vous ne trouvez pas l'emplacement exact, trouvez simplement un autre endroit avec une rivière.

<figure><img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-65218db6ad1b02ba1b97958a2a45f921283c2243%2Fimage%20(238).png?alt=media" alt=""><figcaption><p>Emplacement recommandé pour cet exemple</p></figcaption></figure>

<figure><img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-fbb69d476af2f62b61c941d2ecbf22e2e4d32ca3%2Fimage%20(240).png?alt=media" alt=""><figcaption><p>La rivière utilisée dans cet exemple</p></figcaption></figure>

### **2.3 Ajoutez les nœuds suivants au réseau**

* Placer un **réservoir**, nœud vers la rivière.

<figure><img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-26ebb6bcb55e4f9e3ff93256880c7c25b9431ab9%2Fimage%20(242).png?alt=media" alt="" width="329"><figcaption><p>Nœud de réservoir</p></figcaption></figure>

**## #Notice**: assurez-vous d'utiliser le nœud « Réservoir » : <img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-cf7194232a7669b4f9aed2ff96e7f6e5609f8e03%2Fimage%20(243).png?alt=media" alt="" data-size="line">et non le nœud « Storage » : <img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-d421e0aa49918b52681dc29266baa5e275209291%2Fimage%20(244).png?alt=media" alt="" data-size="line">.

<figure><img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-9dca7c81befee69561bb41c30452ca2e5138858f%2Fimage%20(255).png?alt=media" alt=""><figcaption><p>Ajouter un nœud de réservoir</p></figcaption></figure>

* Placer un \[**captage**] (<https://water-strategy.gitbook.io/water-strategy/modelling-fundamentals/node-types/catchment-node)node> <img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-a34d3beb7c3f7bc31b5d87ba23b0085cc3a4dfdb%2Fimage%20(247).png?alt=media" alt="" data-size="line"> en amont du réservoir. Le nœud de captage représente la rivière qui se jette dans le réservoir.

<figure><img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-b03154074eb4368a784f6c6c5cfd0df382d8fd23%2Fimage%20(256).png?alt=media" alt=""><figcaption><p>Ajouter un nœud de captage</p></figcaption></figure>

* Placez un \[**sortie**] (<https://water-strategy.gitbook.io/water-strategy/modelling-fundamentals/node-types/output-node)node> <img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-a17b35f72ea3dcafd340e09428474f2a4d981c51%2Fimage%20(249).png?alt=media" alt="" data-size="line">en aval du réservoir. Dans ce cas, le nœud de sortie représente la sortie de la rivière.

<figure><img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-959486d107ab5819201ac7c1a5c55f6a37812f22%2Fimage%20(258).png?alt=media" alt=""><figcaption><p>Ajouter un nœud de sortie</p></figcaption></figure>

* Deuxième place \[**lien**] (<https://water-strategy.gitbook.io/water-strategy/modelling-fundamentals/node-types/link-node)nodes> <img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-bb75a2481cefbc816b1716b20cf6ead67ec5bf8f%2Fimage%20(252).png?alt=media" alt="" data-size="line">entre le réservoir et les nœuds de sortie (comme indiqué ci-dessous). Dans ce cas, ces nœuds de liaison représentent (1) les rejets du réservoir et (2) le déversement.

<figure><img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-a8f865774268a9cd3a2225c489db67e6d00f4998%2Fimage%20(259).png?alt=media" alt=""><figcaption><p>Ajouter des nœuds de liaison</p></figcaption></figure>

Le **supérieur link node** la représentation de la libération du réservoir représente le débit qui quitte le réservoir à la suite de toute règle de libération ou pour répondre à des allocations en aval. Les règles de publication seraient généralement spécifiées sur ce nœud. Les règles de libération des réservoirs définies sur ce nœud sont généralement représentées par un paramètre défini sur l'attribut max \ \_flow du nœud.

Le **inférieur link node** représente le déversement provenant du réservoir. Le déversement est utilisé si des règles de libération du réservoir sont définies pour limiter la quantité d'eau pouvant être libérée via ce nœud et qu'il faut libérer plus d'eau que ce qui est autorisé par les règles de libération (par exemple si le réservoir est en surcapacité). Comme le déversement n'est généralement utilisé que lorsque le réservoir est en surcapacité, ce nœud présente généralement une pénalité d'allocation très positive.

Connectez les nœuds avec des arêtes, communément appelées *liens*. <img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-56babef3a95801f43855d762497f82c58808c6b8%2Fimage%20(254).png?alt=media" alt="" data-size="line">

**## #Notice**: pensez à connecter les nœuds en cliquant d'abord sur le nœud en amont puis sur le nœud en aval.

Vous pouvez voir comment ajouter des arêtes dans **vidéo** ci-dessous.

{% embed url="<https://www.youtube.com/watch?t=204s&v=ub-fv-0u10A>" %}
Conseils sur la façon d'ajouter des arêtes
{% endembed %}

Le **système de réservoir** devrait ressembler à **chiffre** ci-dessous.

<figure><img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-f332b29d9a2316506b5eb18304c864d5e35e5f12%2Fimage%20(261).png?alt=media" alt=""><figcaption><p>L'exemple de système de réservoir</p></figcaption></figure>

### **2.4 Configurer le pas de temps et l'horizon temporel**

<figure><img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-04ff52777184f291a693349d3a0742829b1475da%2Fimage%20(277).png?alt=media" alt=""><figcaption><p><strong>Définissez le pas de temps et l'horizon temporel</strong></p></figcaption></figure>

### **2.5 Renommez les nœuds avec des noms qui correspondent à leur contexte**

* le **Bassin versant** nœud vers '*Exemple « catchment*' »,
* le **Réservoir** nœud vers '*Exemple : 'reservoir*'
* le **sortie** nœud vers '*Exemple « outlet*' ».
* le **Lien** nœuds vers '*Libération*'et l'autre'*Déverser*'.

La figure ci-dessous montre où cliquer pour renommer le nœud de captage. Le même processus peut être répété pour tous les autres nœuds.

<figure><img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-ed9af2ca3d368dff48d4fc58b16cf65605e9626e%2Fimage%20(262).png?alt=media" alt=""><figcaption><p>Renommer le nœud de captage</p></figcaption></figure>

### **2.6 Entrée de données dans le nœud de captage**

Cliquez sur le lien suivant pour trouver les données des séries chronologiques pour cette étape.

<https://docs.google.com/spreadsheets/d/1MR1Xxk77gFzcY3J3r6c6g38UB8pd1HMY/edit?usp=sharing&ouid=103362449956532179397&rtpof=true&sd=true>

* Cliquez sur le **Nœud de captage** et suivez les clics (flèches rouges) indiqués dans la séquence de figures ci-dessous.

<figure><img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-6eaea8c5b144651afd015a31df35777718213a63%2Fimage%20(263).png?alt=media" alt=""><figcaption><p>Cliquez sur le nœud du bassin versant, puis sur le bouton Modifier de l'attribut Flow.</p></figcaption></figure>

<figure><img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-8405cc2da7d1e14bb6d917af6c8609eec67c8fde%2Fimage%20(264).png?alt=media" alt="" width="375"><figcaption><p>Le type de paramètre à utiliser pour le paramètre de flux doit être défini sur PYWR Dataframe, qui est une série chronologique.</p></figcaption></figure>

<figure><img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-4d11b732df06c1703ebc1c22343b88e019837120%2Fimage%20(265).png?alt=media" alt=""><figcaption><p>Cliquez sur « OK » pour accepter le changement de type de paramètre.</p></figcaption></figure>

* Dans le lien Excel, vous aurez une série chronologique. Veuillez recopier la première (ou uniquement la série chronologique s'il n'y en a qu'une). Veillez également à recopier les dates.

<figure><img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-fc3b70caeee323303aa4fcca6ef32d277ae37d5e%2Fimage%20(65).png?alt=media" alt=""><figcaption></figcaption></figure>

* Collez la série chronologique dans la cellule **A1** dans le **Onglet Dataframe**

<figure><img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-1b178375c2dcb0a5c6a47e81ea4de85d476267a7%2Fimage%20(267).png?alt=media" alt=""><figcaption><p>Coller les données de flux entrants</p></figcaption></figure>

* Vous devriez disposer d'une série chronologique comme indiqué ci-dessous. Cliquez **Sauvegarder**.

<figure><img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-649c6d362c645acc2fabcf84f4144fb995271b27%2Fimage%20(269).png?alt=media" alt=""><figcaption><p>Enregistrer les données de flux entrants</p></figcaption></figure>

### **2.7 Entrée de données dans le nœud de réservoir**

* Cliquez sur le **Exemple de nœud de réservoir**
* Réglez le **maximum \_volume** à 25 Mm3. Il s'agit de la capacité maximale du barrage dans ce didacticiel.
* Réglez le **initiale \_volume** à 15 Mm3. Il s'agit du niveau de stockage avec lequel la simulation commence lors de la première étape.
* Réglez le **pénalité d'attribution** à -200. Les réservoirs sont souvent soumis à une pénalité d'allocation négative. Les pénalités d'allocation sont souvent utilisées pour équilibrer l'utilisation des réservoirs ou d'autres sources d'eau dans les systèmes à réservoirs multiples et à sources multiples.

Les attributs du réservoir doivent ressembler à ceux ci-dessous :

<figure><img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-5502f36ed365bc2dd8000bf4dde253a3711075ba%2Fimage%20(270).png?alt=media" alt=""><figcaption><p>Données sur les réservoirs</p></figcaption></figure>

### \*\*2.8 Entrée de données sur les nœuds Spill and Release Link. \*\*

* Sur le **Le nœud Spill link** définit la « pénalité d'allocation » sur 1000

<figure><img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-da9b7302bd7e0343f3bfb6af743207e2563b2349%2Fimage%20(271).png?alt=media" alt="" width="291"><figcaption><p>Fixation des pénalités d'attribution en cas</p></figcaption></figure>

* Le **Le nœud Release link** ne doit pas avoir d'entrée de données.

<figure><img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-97403645670a93602d3d86ddcb80d660d0933ceb%2Fimage%20(272).png?alt=media" alt="" width="294"><figcaption><p>Paramètre du lien de publication</p></figcaption></figure>

### **2.9 Exécuter le modèle**

<figure><img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-fff7568edffeb85cf61f7bd0cd16323ca79d7247%2Fimage%20(273).png?alt=media" alt="" width="375"><figcaption><p>Exécutez le modèle</p></figcaption></figure>

<figure><img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-0f2448df0ad3cae7a1e5acf4cb45ec372c31d9fc%2Fimage%20(274).png?alt=media" alt="" width="375"><figcaption><p>Exécutez le modèle</p></figcaption></figure>

### **2.10 Voir les résultats calculés**

* Consultez le »**simulé \_volume**'du nœud du réservoir pour voir le volume de stockage du réservoir au fil du temps.

<figure><img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-8a1ad6d77b69728d67054ad4ca033f11ad9939f5%2Fimage%20(278).png?alt=media" alt=""><figcaption><p>Obtenir des résultats calculés</p></figcaption></figure>

* Cliquez sur la vue « Tracé ».

<figure><img src="https://3963071958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHeDWQ47cDExIYi6YhdD2%2Fuploads%2Fgit-blob-b9597eda0c965eefaf980a28c6c3e3ee0c097c41%2Fimage%20(280).png?alt=media" alt=""><figcaption><p>Afficher le volume du réservoir</p></figcaption></figure>

Le réservoir semble se remplir et rester plein pendant la majeure partie de l'horizon temporel. C'est le cas car le réservoir n'est soumis à aucune demande et aucune perte par évaporation n'est définie.

**Pour voir une vidéo expliquant comment exécuter le modèle et visualiser les sorties, cliquez ici.**


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://water-strategy.gitbook.io/waterstrategy/francais/tutoriels/creating-a-reservoir-system/adding-a-dam-reservoir.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
