# 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="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-590f333576491cdcf62424e64e09f929fd04afba%2Fimage%20(237).png?alt=media" 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="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-65218db6ad1b02ba1b97958a2a45f921283c2243%2Fimage%20(238).png?alt=media" alt=""><figcaption><p>Local recomendado para este exemplo</p></figcaption></figure>

<figure><img src="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-fbb69d476af2f62b61c941d2ecbf22e2e4d32ca3%2Fimage%20(240).png?alt=media" 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="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-26ebb6bcb55e4f9e3ff93256880c7c25b9431ab9%2Fimage%20(242).png?alt=media" alt="" width="329"><figcaption><p>Nodo reservatório</p></figcaption></figure>

**## #Notice**: certifique-se de usar o nó 'Reservatório': <img src="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-cf7194232a7669b4f9aed2ff96e7f6e5609f8e03%2Fimage%20(243).png?alt=media" alt="" data-size="line">e não o nó 'Armazenamento': <img src="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-d421e0aa49918b52681dc29266baa5e275209291%2Fimage%20(244).png?alt=media" alt="" data-size="line">.

<figure><img src="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-9dca7c81befee69561bb41c30452ca2e5138858f%2Fimage%20(255).png?alt=media" 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="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-a34d3beb7c3f7bc31b5d87ba23b0085cc3a4dfdb%2Fimage%20(247).png?alt=media" 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="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-b03154074eb4368a784f6c6c5cfd0df382d8fd23%2Fimage%20(256).png?alt=media" 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="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-a17b35f72ea3dcafd340e09428474f2a4d981c51%2Fimage%20(249).png?alt=media" 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="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-959486d107ab5819201ac7c1a5c55f6a37812f22%2Fimage%20(258).png?alt=media" 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="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-bb75a2481cefbc816b1716b20cf6ead67ec5bf8f%2Fimage%20(252).png?alt=media" 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="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-a8f865774268a9cd3a2225c489db67e6d00f4998%2Fimage%20(259).png?alt=media" 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="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-56babef3a95801f43855d762497f82c58808c6b8%2Fimage%20(254).png?alt=media" 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="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-f332b29d9a2316506b5eb18304c864d5e35e5f12%2Fimage%20(261).png?alt=media" 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="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-04ff52777184f291a693349d3a0742829b1475da%2Fimage%20(277).png?alt=media" 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="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-ed9af2ca3d368dff48d4fc58b16cf65605e9626e%2Fimage%20(262).png?alt=media" 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](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="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-6eaea8c5b144651afd015a31df35777718213a63%2Fimage%20(263).png?alt=media" 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="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-8405cc2da7d1e14bb6d917af6c8609eec67c8fde%2Fimage%20(264).png?alt=media" 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="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-4d11b732df06c1703ebc1c22343b88e019837120%2Fimage%20(265).png?alt=media" 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="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-fc3b70caeee323303aa4fcca6ef32d277ae37d5e%2Fimage%20(65).png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-1b178375c2dcb0a5c6a47e81ea4de85d476267a7%2Fimage%20(267).png?alt=media" 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="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-649c6d362c645acc2fabcf84f4144fb995271b27%2Fimage%20(269).png?alt=media" 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="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-5502f36ed365bc2dd8000bf4dde253a3711075ba%2Fimage%20(270).png?alt=media" 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="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-da9b7302bd7e0343f3bfb6af743207e2563b2349%2Fimage%20(271).png?alt=media" 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="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-97403645670a93602d3d86ddcb80d660d0933ceb%2Fimage%20(272).png?alt=media" alt="" width="294"><figcaption><p>Configuração do link de liberação</p></figcaption></figure>

### **2.9 Execute o modelo**

<figure><img src="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-fff7568edffeb85cf61f7bd0cd16323ca79d7247%2Fimage%20(273).png?alt=media" alt="" width="375"><figcaption><p>Execute o modelo</p></figcaption></figure>

<figure><img src="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-0f2448df0ad3cae7a1e5acf4cb45ec372c31d9fc%2Fimage%20(274).png?alt=media" 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="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-8a1ad6d77b69728d67054ad4ca033f11ad9939f5%2Fimage%20(278).png?alt=media" alt=""><figcaption><p>Obtenha resultados calculados</p></figcaption></figure>

* Clique na visualização 'Plot'.

<figure><img src="https://2780811623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft4nCBOybr5foLIqkmwa6%2Fuploads%2Fgit-blob-b9597eda0c965eefaf980a28c6c3e3ee0c097c41%2Fimage%20(280).png?alt=media" 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.**
