> 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/portugues/tutoriais/creating-a-reservoir-system/adding-a-dam-reservoir.md).

# Adicionando uma barragem (reservatório)

## 1. Diferença entre nós de armazenamento e reservatório

Observe que existem dois nós em WaterStrategy e Pywr que representam reservatórios. O primeiro é um [**armazenamento** ](https://water-strategy.gitbook.io/water-strategy/modelling-fundamentals/node-types/storage-node)nodo e o segundo é um [**reservatório** ](https://water-strategy.gitbook.io/water-strategy/modelling-fundamentals/node-types/reservoir-node)nodo.

Ambos os nós armazenam água. O nó do reservatório funciona exatamente como um storage node, mas tem parâmetros embutidos que permitem ***evaporação*** e ***precipitação*** para ser representado diretamente no nó. Para representar ***evaporação*** e ***precipitação*** com um storage node, um nó de captação conectado ao storage node é usado para representar a precipitação e o nó de saída que retira água do storage node é usado para representar a evaporação.

Este tutorial usará nós de reservatório para construir o modelo do sistema de reservatório.

## 2. Crie o exemplo de modelo de sistema de reservatório

### **2.1 Clique na rede criada na última seção e abra-a**

<figure><img src="/files/5sUbdOlIrM7gz97IoUuE" alt=""><figcaption><p>Abra a rede criada</p></figcaption></figure>

### **2.2 Encontre um rio no mapa**

Este tutorial tem um local recomendado, mas não importa se você não consegue encontrar o local exato, basta encontrar outro local com um rio.

<figure><img src="/files/3PIRS0maIX3TfXxjcfP6" alt=""><figcaption><p>Local recomendado para este exemplo</p></figcaption></figure>

<figure><img src="/files/2gtWcnqGpPCRVb5PkDQf" alt=""><figcaption><p>O rio usado neste exemplo</p></figcaption></figure>

### **2.3 Adicione os seguintes nós à rede**

* Coloque um **nó do reservatório** até o rio.

<figure><img src="/files/e0F7BTTaA0mbbtOt78mn" alt="" width="329"><figcaption><p>Nodo reservatório</p></figcaption></figure>

**## #Notice**: certifique-se de usar o nó 'Reservatório': <img src="/files/MjjmQy0oTn7YGL9vmQps" alt="" data-size="line">e não o nó 'Armazenamento': <img src="/files/vyCqAzVImPYnYnz5fbbk" alt="" data-size="line">.

<figure><img src="/files/zXxib9AEJHt1ONNsdyBU" alt=""><figcaption><p>Adicionando um nó de reservatório</p></figcaption></figure>

* Coloque um \[**captação**] (<https://water-strategy.gitbook.io/water-strategy/modelling-fundamentals/node-types/catchment-node)node> <img src="/files/CqQg880GbINaHy016QSY" alt="" data-size="line"> a montante do reservatório. O nó de captação representa o rio que flui para o reservatório.

<figure><img src="/files/ltCXW5hhV1JvgNkTKBMN" alt=""><figcaption><p>Adicionando um nó de captação</p></figcaption></figure>

* Coloque um \[**saída**] (<https://water-strategy.gitbook.io/water-strategy/modelling-fundamentals/node-types/output-node)node> <img src="/files/lgmcdUbo1PEbSGrHwAHO" alt="" data-size="line">a jusante do reservatório. O nó de saída, nesse caso, representa a saída do rio.

<figure><img src="/files/1Qi4bmVFzNSK468F3gns" alt=""><figcaption><p>Adicionando um nó de saída</p></figcaption></figure>

* Coloque dois \[**link**] (<https://water-strategy.gitbook.io/water-strategy/modelling-fundamentals/node-types/link-node)nodes> <img src="/files/jt3zPtYF1JRhTxrcVBBN" alt="" data-size="line">entre o reservatório e os nós de saída (conforme mostrado abaixo). Nesse caso, esses nós de ligação representam (1) as liberações do reservatório e (2) o derramamento.

<figure><img src="/files/f9hyqc3MAnZUHi9XN3k4" alt=""><figcaption><p>Adicionando nós de link</p></figcaption></figure>

O **superior link node** representar a liberação do reservatório representa o fluxo que sai do reservatório como resultado de quaisquer regras de liberação ou para atender às alocações a jusante. As regras de lançamento geralmente seriam especificadas nesse nó. As regras de liberação do reservatório definidas nesse nó geralmente são representadas por um parâmetro definido no atributo max\ \_flow dos nós.

O **poder link node** representa o vazamento do reservatório. O derramamento é usado se as regras de liberação do reservatório forem definidas restringindo a quantidade de água que pode ser liberada por meio desse nó e se precisar liberar mais água do que a permitida pelas regras de liberação (por exemplo, se o reservatório estiver acima da capacidade). Como o vazamento geralmente é usado somente quando o reservatório está acima da capacidade, esse nó geralmente tem uma penalidade de alocação altamente positiva.

Conecte os nós com bordas que são comumente referidas *links*. <img src="/files/3AGaqjSuNo31UuO94bSG" alt="" data-size="line">

**## #Notice**: lembre-se de conectar os nós clicando primeiro no nó upstream e depois no nó downstream.

Você pode ver como adicionar bordas na **vídeo** abaixo.

{% embed url="<https://www.youtube.com/watch?t=204s&v=ub-fv-0u10A>" %}
Orientação sobre como adicionar bordas
{% endembed %}

O **sistema de reservatório** deve se parecer com o **figurar** abaixo.

<figure><img src="/files/COfL39qxhotWLRwJF4TP" alt=""><figcaption><p>O exemplo de sistema de reservatório</p></figcaption></figure>

### **2.4 Configure o intervalo de tempo e o horizonte de tempo**

<figure><img src="/files/tP9leOtZ3r39eHVN8r2L" alt=""><figcaption><p><strong>Configure o intervalo de tempo e o horizonte temporal</strong></p></figcaption></figure>

### **2.5 Renomeie os nós para nomes que façam sentido com seus contextos**

* a **Bacia hidrográfica** node para '*Exemplo de catchment*',
* a **Reservatório** node para '*Exemplo de reservatório*'
* a **Saída** node para '*Exemplo outlet*'.
* a **Link** nós para '*Lançamento*'e o outro'*Derrama*'.

A figura abaixo mostra onde clicar para renomear o nó de captação. O mesmo processo pode ser repetido para todos os outros nós.

<figure><img src="/files/rb64EOGIgcpzi8zX4Byw" alt=""><figcaption><p>Renomeie o nó de captação</p></figcaption></figure>

### **2.6 Inserindo dados no nó de captação**

Acesse o link a seguir para encontrar os dados da série temporal desta etapa.

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

* Clique no **Nó de captação** e siga os cliques (setas vermelhas) mostradas na sequência de figuras abaixo.

<figure><img src="/files/c06LMguTPmijmUbyAwbc" alt=""><figcaption><p>Clique no nó de captação e, em seguida, no botão de edição do atributo Flow.</p></figcaption></figure>

<figure><img src="/files/1iYY8A3q6j2z5SJmQzDW" alt="" width="375"><figcaption><p>O tipo de parâmetro a ser usado para o parâmetro de fluxo deve ser definido como PYWR Dataframe, que é uma série temporal.</p></figcaption></figure>

<figure><img src="/files/pjWwypSA9lxfV4JimEky" alt=""><figcaption><p>Clique em 'OK' para aceitar a alteração do tipo de parâmetro.</p></figcaption></figure>

* No link do Excel, você terá uma série temporal. Copie a primeira (ou a única série temporal, se houver apenas uma). Certifique-se de copiar as datas também.

<figure><img src="/files/irOHWg0dXBBxAWr19LeQ" alt=""><figcaption></figcaption></figure>

* Cole a série temporal na célula **A1** na **Guia Dataframe**

<figure><img src="/files/xLg0wMZlQgluLEAy90hr" alt=""><figcaption><p>Colar dados de entrada</p></figcaption></figure>

* Você deve ter uma série temporal, conforme mostrado abaixo. Clique **Salvar**.

<figure><img src="/files/Q49mJh1pjqGabM5vM7Ys" alt=""><figcaption><p>Salvar dados de entrada</p></figcaption></figure>

### **2.7 Inserindo dados no nó do reservatório de exemplo**

* Clique no **Exemplo de nó de reservatório**
* Defina o **máximo\_volume** até 25 Mm3. Essa é a capacidade máxima da barragem neste tutorial.
* Defina o **inicial\_volume** até 15 Mm3. Esse é o nível de armazenamento com o qual a simulação começa na primeira etapa.
* Defina o **penalidade de alocação** para -200. Freqüentemente, os reservatórios têm uma penalidade de alocação negativa. As penalidades de alocação são frequentemente usadas para equilibrar o uso de reservatórios ou outras fontes de água em sistemas com vários reservatórios e com várias fontes.

Os atributos no reservatório devem ser semelhantes aos abaixo:

<figure><img src="/files/nG8XynyPUuwsa0U2HXvV" alt=""><figcaption><p>Dados do reservatório</p></figcaption></figure>

### \*\*2.8 Inserindo dados nos nós Spill e Release Link. \*\*

* Na **O nó Spill Link** definiu a 'Penalidade de alocação' para 1000

<figure><img src="/files/1It9my7vwqphW4HR57Ip" alt="" width="291"><figcaption><p>Configuração de penalidade de alocação de derramamentos</p></figcaption></figure>

* O **O nó Release Link** não deve ter nenhuma entrada de dados.

<figure><img src="/files/y5OyEWoTzu2HM3zoqcPb" alt="" width="294"><figcaption><p>Configuração do link de liberação</p></figcaption></figure>

### **2.9 Execute o modelo**

<figure><img src="/files/4GC55pJpD3EbVWUgpSud" alt="" width="375"><figcaption><p>Execute o modelo</p></figcaption></figure>

<figure><img src="/files/HXxyP5CqqSdlyEPFa7sj" alt="" width="375"><figcaption><p>Execute o modelo</p></figcaption></figure>

### **2.10 Veja os resultados calculados**

* Veja o '**simulado\_volume**'do nó do reservatório para ver o volume de armazenamento do reservatório ao longo do tempo.

<figure><img src="/files/VgSZkWX2B2wHsAvHrxiu" alt=""><figcaption><p>Obtenha resultados calculados</p></figcaption></figure>

* Clique na visualização 'Plot'.

<figure><img src="/files/crk90qYXnitzJiW8nztf" alt=""><figcaption><p>Veja o volume do reservatório</p></figcaption></figure>

O reservatório é visto se enchendo e permanecendo cheio na maior parte do horizonte temporal. Isso ocorre porque não há demanda no reservatório nem há perdas por evaporação definidas.

**Para ver um vídeo sobre como executar o modelo e visualizar as saídas, clique aqui.**


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
