description: Assista a uma visão geral da interface WaterStrategy; segue um resumo em texto.

Visita à interface

Projeto: A pasta que contém redes relacionadas também pode conter outras pastas do projeto (subprojetos).

\ -Cada pasta do projeto exibe a quantidade de redes e pastas de subprojetos dentro dela.

Rede: Modelo.

1. Na página inicial da interface, selecione o projeto “Material de treinamento”.

2. Selecione a rede Demo 1.

\ -Dentro da rede, na parte superior da página, você verá uma barra parecida com esta abaixo.

\ -As guias “Início” e “Meus projetos” o levarão de volta à página inicial da interface.

\ - “Documentação e treinamento” leva você aos vídeos tutoriais de interfaces e à página de instruções escritas.

\ -A guia “Favoritos” permite marcar projetos, redes e cenários como favoritos. Também permite acessar projetos e redes recentemente acessados e modificados recentemente.

\ - “Voltar ao 'Material de treinamento'” leva você de volta à pasta do projeto Material de Treinamento.

\ -O botão verde play executa um modelo.

\ -O botão de chave inglesa fornece acesso a utilitários de rede avançados, como importar ou exportar dados de rede.

\ -A seta para baixo no botão retangular serve para baixar o modelo, usada para executar offline ou enviar para alguém.

\ -As três linhas são “Exibir dados da rede”.

1. Clique em “Exibir dados da rede”.

\ -Em “Detalhes”, você pode alterar o nome da rede.

\ -Às vezes, é necessário sair da rede para atualizar.

\ -Em “Entradas”, você pode alterar o início, o fim e o intervalo de tempo do seu modelo.

\ -D=dia, M=mês, Y=ano para intervalo de tempo.

1. Clique no ícone da chave inglesa para acessar “Configurações”.

Exibir rótulos - exibe os nomes dos nós

Direção do link- mostra a direção do fluxo dos links

Mostrar dicas de ferramentas- exibe as informações do nó ao passar o mouse sobre ele

0__Ocultar barra lateral automaticamente - oculta a barra lateral quando não está sendo usada

Sempre categorize os atributos por tipo - Dentro de um nó, agrupará os atributos como escalares, descritores, etc.

1. Clique no “i” para ir até “Informações”.

\ -Você pode ver seu “ID de rede” e outras informações.

1. Feche a barra lateral e vá para a seção de cenários no lado esquerdo da página.

\ -Os cenários são variações de dados de entrada, hidrologia etc. em um modelo.

\ -Comum criar vários cenários em um modelo.

Botão 1 (à esquerda) - Cenário de clone

Botão 2- Editar cenário

Botão 3- Excluir cenário

Botão 4- Atualizar lista de cenários

Botão 5- Cenário de favoritos

Botão 6 (à direita) - Compare cenários

\ -Para criar um novo cenário, clone um cenário preexistente dando-lhe um novo nome. Uma vez criado, altere os dados de entrada do modelo conforme desejado.

1. Clique no botão “Executar um modelo”.

\ -Mantenha o cenário básico.

\ -Mantenha todos os outros padrões.

1. Clique em “Enviar”.

\ -Na seção “Corridas” no lado esquerdo da página, você verá sua nova corrida e as anteriores.

\ -Yellow=Executar na fila

\ -Blue=Execução em andamento

\ -Green=Execução bem-sucedida

\ -Red=A execução falhou

1. Clique em “Construir” abaixo da seção “Executar”.

\ -Isso fornece todos os nós e links necessários para criar um modelo.

\ -Depois de inserir um nó, os dados precisam ser inseridos.

1. Clique em “Pesquisar” abaixo da seção “Construir”.

\ -Isso permite que você encontre facilmente nós e links em modelos grandes.

O botão de bomba no canto superior esquerdo do mapa permite que você expanda seu modelo para torná-lo menos cheio, se necessário.

Map- Mostra o modelo

Recursos- Pode visualizar seus nós, links e grupos

Metrics- Fornece funcionalidades para agregação de saídas do modelo

Regras personalizadas - Regras operacionais personalizadas

Parâmetros- Adicione parâmetros não incluídos no pywr

Gravadores- Adicione gravadores não incluídos no pywr

Members- Mostra os membros que precisam acessar o modelo e as permissões que eles possuem. Também pode adicionar membros nesta guia e escolher as permissões que eles têm

Análise- Comparando nós e links em cenários

Criando um novo projeto e rede

1. Na página inicial da interface, clique em “Criar projeto” no canto superior direito.

2. Digite o nome do seu projeto e selecione “Adicionar”.

3. Insira seu novo projeto.

4. Clique em “Criar rede” no lado direito.

5. Escolha a guia “Manual”.

6. Insira um nome de rede.

7. Escolha um desses dois modelos pywr.

\ -Os outros modelos são para outros sistemas de modelagem, como sistemas de energia.

1. Escolha “Usar mapa” para exibir o mapa-múndi para construção de modelos.

2. Clique em “Enviar”.

3. Entre na rede criada.

4. Alterne e amplie para uma área ao longo do Nilo.

1. Selecione o menu suspenso “Criar”.

1. Arraste uma captação, um link e dois nós de saída para o modelo, conforme mostrado abaixo.

\ -O segundo nó de saída (fora do rio) será usado como um nó de captação de água.

\ -Observe que o nó de captação está rio acima e o nó de saída está rio abaixo.

(o Nilo flui para o norte nesta parte e no geral)

1. Usando o recurso “Links”, conecte os nós na direção do fluxo.

\ -Isso é feito clicando primeiro no nó de fluxo ascendente e depois no nó de fluxo descendente.

WaterStrategy não é necessário para executar um modelo Pywr; ele existe para ajudar a facilitar o uso dos modelos Pywr. Se você tiver um arquivo de entrada do modelo Pywr (eles são chamados de arquivos 'JSON') e tiver as bibliotecas Python e Pywr necessárias instaladas em seu computador, poderá executar seu modelo Pywr sem WaterStrategy (Nota: habilidades em Python são necessárias). Da mesma forma, se você tiver um modelo Pywr existente (um arquivo JSON), poderá importá-lo para WaterStrategy.

Esta página mostra como exportar modelos de WaterStrategy para um arquivo JSON Pywr e como importar modelos Pywr existentes (arquivos JSON) para WaterStrategy

Exportação e importação de modelos

Exportar arquivos Pywr

Esta seção usa a “rede demo one” fornecida quando você cria uma conta.

Primeiro clique no botão de download.

Em seguida, vamos escolher nosso formato.

Escolha primeiro o formato Hydra JSON. Se você quiser ativar quebras de linha que facilitem a leitura do código ou do texto. Se for um arquivo grande, você pode compactá-lo.

Envie-o.

Em seguida, baixe o formato Pywr JSON.

Em seguida, você pode encontrar os dois arquivos na pasta em que escolheu salvá-los.

Importar arquivos Pywr

Vamos ver como importar arquivos Pywr.

Primeiro, clique em “Criar projeto” para criar uma pasta de projeto em sua conta Water Strategy.

Dê um nome ao projeto e clique em “Adicionar”.

Clique no projeto criado.

Clique em “Criar rede”.

Selecione 'Hydra JSON'.

Clique em “Escolher arquivo”.

Escolha o arquivo Hydra JSON.

Selecione o modelo.

Clique em “Enviar”.

Em seguida, você pode descobrir que a rede foi importada.

Para importar o arquivo JSON Pywr, você pode seguir estas etapas.

Clique em “Criar rede” novamente.

Escolha o 'Pywr JSON'.

Clique em “Escolher arquivo”.

Escolha o arquivo JSON Pywr.

Escolha o modelo.

Para projeção, você pode escolher 'Nenhum', 'Reino Unido' ou 'Mundo'. Nesse caso, escolheremos o 'Mundo'.

Clique em “Enviar”.

Finalmente, você pode acessar a rede importada aqui.

description: Como criar uma conta gratuita em WaterStrategy

Criando uma conta

Assista ao vídeo ou siga o texto abaixo. WaterStrategy as contas são feitas em https://hydra.org.uk/register ('Hydra' é o nome do nosso servidor web).

Criando uma conta

1. Na WaterStrategy na página da web, selecione “LOGIN” no canto superior direito.

1. Selecione “Criar uma conta” na parte inferior da página da web “Login”.

2. Na página de registro, digite seu e-mail, nome, sobrenome, tipo de organização, organização, país ou região, crie uma senha, selecione “Não sou um robô” e marque as três caixas.

3. Em seguida, selecione “Registrar”.

4. Um e-mail de confirmação será enviado a você para confirmar sua conta. Certifique-se também de verificar sua pasta de spam.

5. Sua conta foi criada.

Login

1. Para fazer login, visite https://hydra.org.uk/login ou use a página da web WaterStrategy “Login”

1. Digite seu e-mail e senha e marque as três caixas inferiores novamente. Escolha “Lembrar de mim” se desejar.

2. Em seguida, selecione “Login”.

3. Você estará na página inicial da interface Water Strategy.

description: Esta página mostra como fazer login em WaterStrategy

Fazendo login

1. Para fazer login, acesse https://hydra.org.uk/login (Hydra é o servidor seguro onde atualmente hospedamos WaterStrategy)

2. Digite seu nome de usuário e senha WaterStrategy

3. Clique em 'Login'

Se você esqueceu sua senha, clique em 'Esqueci a senha'link.

Observação: permita cookies quando solicitado.

description: Há diferentes maneiras de solicitar suporte para WaterStrategy.

Suporte

O canal Discord de WaterStrategy é monitorado regularmente, oferecendo suporte de desenvolvedores e usuários. Você pode relatar bugs ou solicitar novos recursos lá. Inscreva-se por meio deste link:

https://discord.gg/bQVmgkFcf7

Como alternativa, você pode enviar um e-mail support@waterstrategy.org

description: Como compartilhar um projeto ou uma rede com outros WaterStrategy usuários

Compartilhando projetos e redes

Projetos: são como pastas que agrupam subprojetos e redes.

Redes: cada modelo com uma rede exclusiva é chamado de 'Rede' em WaterStrategy.

Ícone de pessoa: indica que você só tem acesso ao projeto ou à rede.

Ícone de pessoas: indica que várias pessoas têm acesso a um projeto ou rede.

Creator: Criou o projeto ou a rede.

Compartilhado diretamente: o projeto ou a rede foi especificamente compartilhado com um usuário.

Herdado de: (“Nome do projeto”): O usuário tem acesso a esse subprojeto ou rede ao compartilhar um projeto que o envolve.

1. Para compartilhar um projeto, entre no projeto e clique na guia de membros.

1. Digite o e-mail da conta do destinatário com a qual você gostaria de compartilhar.

Há duas permissões que você pode escolher conceder a um destinatário.

Permitir que os usuários compartilhem novamente? : permite que eles compartilhem o projeto e os projetos/redes internos com outras pessoas.

Permitir que os usuários editem o projeto? : permite que eles editem os projetos/redes dentro do projeto.

1. Selecione “Convidar” depois de escolher as permissões.

Abaixo, você pode ver com quem o projeto foi compartilhado, gerenciar com quem foi compartilhado, ver suas permissões e ver como eles receberam acesso.

Há permissões que você pode escolher conceder a um destinatário.

Permitir que os usuários compartilhem novamente? : permite que eles compartilhem a rede com outras pessoas.

Permitir que os usuários editem o projeto? : permite que eles editem a rede.

Rede de clones: cria uma rede duplicada. Evita alterações na rede preexistente. Tem as opções abaixo se “Rede clonada” for escolhida.

Incluir resultados na nova rede? : inclua os resultados da execução na rede clonada.

Incluir todos os cenários? : inclua os cenários criados na rede clonada.

Nome da rede: Crie o nome da rede clonada.

1. Digite o e-mail da conta do destinatário com a qual você gostaria de compartilhar.

2. Clique em “Compartilhar” depois de escolher as permissões.

description: Termos-chave usados em Pywr.

Conceitos de Pywr

Pywr, uma biblioteca Python usada por WaterStrategy, permite simular a alocação de recursos representando um sistema de recursos como uma rede usando 'Nodes' e 'Edges'. A alocação de recursos é orientada por regras operacionais usando “Penalidades de alocação”, “Restrições” e “Parâmetros”, e as saídas do modelo são capturadas e salvas usando “Gravadores”. As variações das entradas do modelo podem ser especificadas e executadas em paralelo usando 'Cenários'.

Embora os conceitos gerais usados para criar um modelo de simulação de alocação de recursos no Pywr sejam semelhantes aos de outras ferramentas, o uso de termos pode ser diferente. Nesta seção, definimos os principais termos do Pywr e suas funções nos modelos de simulação.

Nodo

Os nós representam locais no sistema de água simulado onde a água é adicionada, armazenada, usada, consumida ou transmitida. Existem diferentes tipos de nós no Pywr para ajudá-lo a construir seu modelo de sistema de água; você pode aprender mais sobre eles no Tipos de nós seção. Os dados que definem as características físicas e o comportamento de um nó podem ser adicionados diretamente ao nó ou indiretamente por meio de referência a um parâmetro (descrito abaixo).

Borda

Para formar uma rede, os nós são conectados usando links que representam o transporte de água. Pywr chama isso de “Edges”. Uma borda tem um nó inicial e um final, e a água flui do nó inicial para o nó final. O Pywr não atribui informações a essas conexões (as bordas), mas atribui dados aos nós de origem e de destino. Todos os dados necessários para simular o gerenciamento da água são armazenados nos nós, as bordas determinam apenas a direção do fluxo de água. Um modelador Pywr diria que “as bordas do Pywr determinam a topologia da rede”, o que significa que “as conexões entre os nós determinam como a água se move no modelo de computador”.

Restrição

As restrições podem ser definidas em vários tipos de nós para ajudar a representar o comportamento do sistema. Por exemplo, um nó de rio pode ter valores de fluxo máximo e/ou mínimo para representar a capacidade de transporte. Em Pywr, muitos nós têm o 'max_fluxo' e 'min_atributos de fluxo para definir os limites superior e inferior do fluxo através do nó, se necessário. O atributo 'max\ _flow' não exige que o fluxo através desse nó atinja esse valor, mas se o volume e a prioridade da água forem suficientes, o modelo tentará atingir o 'Fluxo máximo'. As restrições mínimas de fluxo devem ser usadas com cuidado, pois podem resultar na inviabilidade do modelo se o mínimo não puder ser atingido.

Penalidade de alocação ou “custo”

As penalidades de alocação são atributos do nó que controlam a prioridade de alocação de água. Normalmente, eles são expressos como penalidades ou “custos”, e o modelo aloca água primeiro para o nó com a menor penalidade. Se você preferir alocar por benefício, enviando água para onde ela tem o maior benefício primeiro, você precisará expressar suas prioridades no Pywr como custos negativos (ou seja, usar números negativos). Na verdade, ambos podem ser usados juntos, então, por exemplo, se 3 nós tiverem penalidades -10, 2, 6, eles obterão água nessa ordem (o nó com uma penalidade de -10 recebe água primeiro e o nó com penalidade de alocação 6 recebe água por último).

Parâmetro

Os parâmetros no Pywr fornecem uma maneira flexível e conveniente de fornecer entradas para os nós. Por exemplo, um determinado tipo de parâmetro pode ser usado para carregar dados de entrada ou demanda de um arquivo do Microsoft Excel. Os parâmetros também oferecem uma maneira flexível e personalizável de definir as regras operacionais de um sistema (por exemplo, regras que regem as liberações do reservatório). A maioria dos dados de entrada do modelo pode ser fornecida usando parâmetros.

Gravador

Os gravadores Pywr são usados para pós-processar os resultados. Ao criar um gravador, você pode observar e salvar os resultados da simulação. Alguns gravadores permitem agregar resultados ao longo do tempo (por exemplo, do diário ao anual) e do espaço (por exemplo, água alocada para um grupo de nós).

Cenário

No Pywr, você pode criar e simular cenários com diferentes dados de entrada sobre oferta, demanda ou outras mudanças. Os planejadores de água usam cada vez mais simulações de longo prazo com muitos cenários para avaliar mudanças futuras ou testar possíveis intervenções. Ser capaz de simular rapidamente muitos cenários futuros plausíveis é um dos principais benefícios do Pywr.

Nota:

Para obter mais detalhes, consulte o documento de acesso aberto intitulado: Um simulador de recursos hídricos em Python.

Descrição geral

Os nós de entrada representam entradas de água no sistema.

Em cada etapa de tempo, um nó de entrada pode fornecer tanta água quanto definido pelo Fluxo máximo atributo. No entanto, ao contrário que são necessários para liberar o volume de água definido em seu atributo Flow, os nós de entrada não precisam liberar água, a menos que tenham um valor diferente de zero Fluxo mínimo.

Os nós de entrada geralmente são usados para representar fontes definidas por rendimentos. Eles são frequentemente usados para representar a produção de água subterrânea.

.

Atributos primários

Exemplos

em breve...

Descrição geral

O nó de captação é um outro tipo de nó de entrada com uma entrada fixa. Os nós de captação são frequentemente usados para representar o rio ou outro tipo de entrada no sistema. Qualquer fluxo definido neles deve fluir para o sistema.

Freqüentemente, séries temporais de entrada (por exemplo, quadros de dados Pywr) são definidas no corrente atributo para representar as entradas de captação, no entanto, outros parâmetros também podem ser usados (por exemplo, perfil constante, mensal, etc...).

API Referência.

Atributos primários

Exemplos

em breve...

Descrição geral

O nó de entrada proporcional destina-se a um caso simples em que é necessário distribuir uma taxa fixa de fluxo para várias rotas a jusante. .

Atributos primários

Exemplos

em breve...

Descrição geral

O link node representa um link no sistema de água ou outro ponto de interesse onde uma restrição de fluxo máximo ou mínimo ou uma prioridade de alocação são atribuídas. Observe que no Pywr, as bordas (links) não podem receber restrições de fluxo e, portanto, os nós de link são frequentemente usados para essa finalidade. API Referência.

Atributos primários

_corrente

Exemplos

em breve...

description: Para construir um 'gêmeo digital' (um simulador de computador) do seu sistema de água, WaterStrategy usa Pywr ('Python Water Resources').

O que é Pywr?

Pywr é uma biblioteca de software em linguagem Python gratuita e de código aberto que permite criar modelos de simulação de alta qualidade (detalhados e precisos) de sistemas de recursos hídricos.

Os modelos Pywr são executados rapidamente em seu computador ou, no caso de WaterStrategy, na nuvem. Eles podem representar pequenos sistemas de recursos hídricos, como o abastecimento de água de uma cidade, ou sistemas muito grandes, como bacias hidrográficas que abrangem vários países com centenas de usuários de água e ativos de infraestrutura. O Pywr pode simular períodos curtos (como alguns meses) ou períodos mais longos (como 100 anos) em uma variedade de intervalos de tempo (de diários a mensais).

Aqui está um resumo do processo de modelagem do Pywr:

1. Configurar o modelo

Primeiro, é necessário um mapa espacial do sistema hídrico e dados de demanda hidrológica e de água associados. WaterStrategy ajuda você a criar esse mapa de rede de todos os locais ('nós') onde a água está entrando no sistema ('entradas'), onde a água está sendo usada ('demandas de água') e onde a água é gerenciada (locais de infraestrutura). Esses nós formam uma rede conectada por rios, canais ou oleodutos (Pywr os chama de “links” ou “bordas”). Depois de configurar seu mapa de rede, você fornece dados de abastecimento e demanda de água (normalmente como séries temporais).

2. Execute uma simulação

Quando todos os dados são inseridos, incluindo o intervalo de tempo e o horizonte temporal, o modelo está pronto para simular (ou seja, percorrer o tempo e realizar a contabilidade da água em todo o sistema). No início de cada etapa de tempo, o computador começa injetando água em todos os locais de entrada, depois essa água é encaminhada pela rede e alocada para os diferentes locais de demanda de água e infraestrutura. Esse processo de alocação é realizado com uma técnica de computação chamada programação linear. Depois que uma etapa de tempo é concluída, o modelo atualiza os armazenamentos, registra quais locais receberam a quantidade de água e continua com a próxima etapa de tempo até o final do horizonte temporal simulado.

Cada nó de demanda de água recebe uma prioridade para representar a alocação de água no modelo. Cada nó tem uma penalidade associada, e o algoritmo de alocação distribui água por toda a rede para minimizar a penalidade geral. Essa abordagem simples permite simulações rápidas e fáceis de manter, que têm a flexibilidade de representar regras detalhadas e realistas de gerenciamento de água.

3. Revise os resultados

As saídas do modelo incluem quanta água entra em cada local (nó) e quanta é armazenada, consumida ou passa por ela em cada etapa de tempo. Isso permite rastrear como a infraestrutura está sendo usada e se cidades, ecossistemas, áreas de irrigação, usinas de energia etc. estão recebendo água suficiente. Os resultados criam uma imagem detalhada de como o sistema de gerenciamento de água está funcionando e como os benefícios da água são distribuídos.

Inicialmente, os modelos são mal parametrizados e produzem previsões imprecisas (a fase de “entrada de lixo, saída de lixo”). No entanto, com o tempo, à medida que o modelo é aprimorado (“calibrado”), ele pode se tornar um valioso gêmeo digital para ajudar a operar ou planejar um sistema de água. A ferramenta ajuda sua organização a avaliar de forma rápida e econômica os impactos de possíveis mudanças e intervenções futuras na água e a tomar boas decisões.

Boa sorte!

Descrição geral

O RiverSplit node é uma divisão na rede fluvial. Ele se destina a um caso simples em que é necessário distribuir uma taxa fixa de fluxo para várias rotas a jusante. .

Atributos primários

). _nomes

Exemplos

em breve...

Descrição geral

O BreakLink node pode ser usado para reduzir o número de rotas em um modelo.

Por exemplo, em um modelo com forma (3, 1, 3), ou seja, 3 (A, B, C) entradas conectadas a 3 saídas (D, E, F) por meio de um gargalo (X), existem 3\ *3 rotas = 9 rotas.

UM -->\/--> D
B --> X --> E
C -->/\--> F

Se X for um armazenamento, existem apenas 6 rotas: A->X_Não, B->X_Não, C->X_o e X_i->D_Não, X_Eu->e_Não, X_i->f\ _o.

O BreakLink node é um nó composto composto por um Armazenamento com volume zero e um Link. Ele pode ser usado no lugar de um Link normal, mas com a vantagem de reduzir o número de rotas no modelo (na situação descrita acima). O LP resultante é mais fácil de resolver. API Referência.

Atributos primários

: anterior)_corrente

Exemplos

Esta tabela apresenta os tipos de nós Pywr mais usados:

Os tipos de nós Pywr também podem ser subdivididos em 6 categorias: Entrada de água, Transporte de água, Armazenamento de água, Saída de água, Energia hidrelétrica, e Outros. Você pode encontrar mais detalhes sobre esses agrupamentos de nós e tipos de nós nas subseções da seção “Tipos de nós”.

Mais detalhes

Uma visão geral dos nós em Pywr pode ser encontrada aqui. A lista completa de nós integrados no Pywr pode ser encontrada aqui.

Descrição geral

O nodo do rio é um nó na rede fluvial, que pode ter vários nós a montante (ou seja, uma confluência), mas apenas um nó a jusante. API Referência.

Atributos primários

_corrente

Exemplos

em breve...

description: WaterStrategy ajuda pessoas e organizações a entender seu sistema de água e avaliar planos futuros. A documentação de WaterStrategy ajuda você a construir, refinar e usar um gêmeo digital do seu sistema de água. layout: description: visible: true outline: visible: true pagination: visible: true tableOfContents: visible: true title: visible: true

WaterStrategy Documentação

Descrição geral

O nodo de atraso é um nó que atrasa o fluxo por um determinado número de etapas de tempo ou dias. Esse nó será usado quando o tempo de propagação da água não puder ser ignorado, em comparação com a escala de tempo selecionada. .

Atributos primários

Exemplos

em breve...

description: Como isso funciona? o que isso produz? e como é usado?

Modelagem do sistema de recursos hídricos?

Para entender como um sistema de água funciona hoje e avaliar os impactos das mudanças futuras, os planejadores constroem modelos de sistemas de recursos hídricos.

Os sistemas de recursos hídricos podem ser pequenos, como uma cidade e suas fontes de abastecimento de água, ou grandes, como um país com muitos rios diferentes, ativos de infraestrutura hídrica e usuários de água. Se você está tentando avaliar a confiabilidade das fontes atuais ou avaliando novas intervenções sob condições futuras plausíveis, esse modelo de computador ajuda a rastrear a água em todo o sistema (espacialmente) e ao longo do tempo.

Com dados sobre fluxos hidrológicos e clima, demandas e uso de água e regras e alocação de gerenciamento de água, um modelo de sistema de água gera fluxos e volumes de água em cada local e etapa de tempo modelados. Quando esses resultados são agregados, eles fornecem uma imagem precisa de como diferentes intervenções hídricas (mudanças nas políticas ou na infraestrutura da água) podem funcionar.

Em WaterStrategy, os usuários têm a flexibilidade de gerenciar conjuntos de dados grandes e complexos com mais eficiência carregando dados de arquivos externos como usando a palavra-chave “url”, em vez de incorporar todos os dados diretamente na interface. Os formatos de arquivo incluem:

• CSV

• Excel

• HDF5

Nota: Entre as opções anteriores, os arquivos do Excel têm o desempenho mais lento, enquanto os arquivos HDF5 têm o melhor desempenho e são preferidos para grandes conjuntos de dados.

Para fazer upload de um arquivo em WaterStrategy, navegue até seu projeto e clique na guia Arquivos. A partir daí, clique em Escolha arquivos e selecione o arquivo que você deseja enviar e clique em .

Isso adicionará o arquivo ao seu projeto, disponibilizando-o para uso em todas as redes do projeto.

Depois que os arquivos forem carregados, eles serão exibidos no Arquivos guia dentro do seu projeto. A partir daí, você pode facilmente visualizá-los, gerenciá-los e compartilhá-los em todas as redes do projeto.

layout: description: visible: false outline: visible: true pagination: visible: true tableOfContents: visible: true title: visible: true

Entrada de água

Os nós de entrada de água são o mecanismo pelo qual a água pode ser inserida no sistema. Aqui, apresentamos os três nós mais usados para entrada de água.

layout: description: visible: false outline: visible: true pagination: visible: true tableOfContents: visible: true title: visible: true

Transporte de água

O tipo de nó de transporte de água permite que os usuários definam como a água flui por diferentes nós de acordo com as condições do mundo real. Abaixo estão os nós de transporte de água mais usados:

layout: description: visible: false outline: visible: true pagination: visible: true tableOfContents: visible: true title: visible: true

Lidando com erros de modelo

WaterStrategy relata erros quando há uma falha técnica ou quando o modelo foi configurado incorretamente. Aprender a entender e usar um relatório de erro de modelo para encontrar um problema em um modelo é uma habilidade de modelagem importante e essencial.

Este capítulo fornece um exemplo de como ler um relatório de erro para encontrar a parte de um modelo que leva ao erro.

Como obter o relatório de erro

Quando uma execução falhar, você verá a execução ficar vermelha na seção de corridas.

Clique na barra vermelha de execução e você terá uma visão geral da execução, incluindo o relatório de erros.

Role até o final do relatório. É aqui que a execução relatará seu erro.

Para esta execução, pode-se verificar que um perfil mensal não foi inserido corretamente.

Em alguns casos, serão fornecidos mais detalhes sobre um erro no relatório de execução. É importante examinar os registros de execução para ver se há alguma pista sobre o problema.

Ao rolar para cima, vemos “CRÍTICO”. Isso é uma indicação de que um erro foi reconhecido. Na mesma linha, indica onde está o erro.

A entrada 'evaporação' do nó 'Exemplo de reservatório' está incorreta.

Podemos editar o parâmetro 'evaporação' para resolver esse problema.

Há valores 13 no perfil mensal. Precisamos remover o valor que não pertence. Nesse caso, '3.14' não deveria estar no perfil mensal.

Salve o parâmetro e execute esse modelo novamente.

Agora, o modelo foi executado com sucesso.

Descrição geral

O Nodo RiverGauge é uma estação de medição fluvial, com um fluxo residual mínimo (MRF). API Referência.

Atributos primários

Exemplos

em breve...

Descrição geral

O RiverSplitWithGauge node é uma divisão na rede fluvial com um fluxo residual mínimo (MRF). De acordo com Rio Split mas, por padrão, cria outra rota no objeto subjacente para modelar um MRF. Essa rota é tal que o MRF não faz parte das proporções forçadas. A intenção desse objeto é modelar o caso em que uma proporção do fluxo pode ser abstraída acima do MRF (por exemplo, 90% do fluxo acima do MRF). API Referência.

Atributos primários

custo O custo Fatores

Exemplos

em breve...

Descrição geral

O Nó de armazenamento virtual contínuo é um storage node virtual contínuo útil para implementar licenças contínuas. API Referência.

Notas:

TODO: A propriedade de custo não é respeitada atualmente. Veja a edição #242.

Atributos primários

volume

Exemplos

em breve...

layout: description: visible: false outline: visible: true pagination: visible: true tableOfContents: visible: true title: visible: true

Armazenamento de água

O tipo de água storage node permite que os usuários construam diferentes reservatórios com diferentes modos de operação. Abaixo estão os nós de armazenamento de água mais usados:

Descrição geral

O MultiSplitLink node é uma extensão do Link por peça que inclui slots adicionais para conexão.

Conceitualmente, esse nó se parece com o seguinte internamente,

         / -->-- X0 -->-- \
UM -->-- Então -->-- X1 -->-- Xi -->-- C
         \ -->-- X2 -->-- /
                 |
                 Bo -->-- Bi --> D

Um sublink adicional no PieceWiseLink (ou seja, X2 acima) e nós (ou seja, Bo e Bi) nessa classe são adicionados para cada slot extra.

Finalmente, um mecanismo é fornecido para (opcionalmente) fixar a razão entre o último sublink não dividido (ou seja, X1) e cada um dos sublinks extras (ou seja, X2). Este mecanismo usa Nodo agregado internamente. API Referência.

Notas: Os usuários devem ter cuidado ao usar o mecanismo fatorial. Os fatores usam o último sublink não dividido (ou seja, X1, mas não X0). Se esse link for restrito com um fluxo máximo ou mínimo, ou se houver outro link irrestrito (ou seja, se X0 não for restrito), as proporções em todo esse nó podem não ser aplicadas conforme o esperado.

Atributos primários

_espaçosnomes

Exemplos

em breve...

Descrição geral

O Nó anual de armazenamento virtual é um armazenamento virtual que é reiniciado anualmente, útil para licenças. API Referência.

Atributos primários

para redefinir o volume para o valor inicial Redefinição necessária

Exemplos

em breve...

Descrição geral

O nodo reservatório é uma subclasse de storage node com funcionalidade adicional para representar evaporação e precipitação. API Referência.

Atributos primários

volume pc o , precipitação) Unidade opcional

Exemplos

em breve...

Descrição geral

O storage node é um nó geral que pode armazenar água, com restrições de volume mínimas e máximas. .

Atributos primários

volume pc o

Exemplos

em breve...

Descrição geral

O nó de saída (API Referência) é uma saída geral em qualquer ponto da rede. Os nós de saída removem a água do sistema.

Os nós de saída são necessários no final de um rio e, nesse caso de uso, geralmente não têm uma penalidade de alocação ou fluxo máximo atribuído.

Os nós de saída também são usados para representar as demandas de consumo de água. Nesse caso de uso, eles tendem a ter penalidades de alocação negativas atribuídas para que o programa linear aloque água para eles, bem como um fluxo máximo que pode ser uma constante ou um parâmetro representando a demanda de água.

Atributos primários

_corrente

Exemplos

em breve...

Descrição geral

UM link de perda permite a definição de uma perda proporcional fixa de fluxo que passa por esse nó. Links de perda são frequentemente usados para representar obras de tratamento de água potável que incorrem em algumas perdas de processo.

Os atributos de fluxo máximo e mínimo definidos são aplicados à saída líquida após as perdas.

O próprio nó registra a saída líquida em seu atributo de fluxo (que seria usado por qualquer gravador conectado).

Atributos primários

Exemplo

Neste exemplo, 10% da quantidade bruta de água que flui para o nodo é perdida.

Descrição geral

O nodo de turbina pode representar uma turbina de uma usina hidrelétrica. Ele calcula o fluxo necessário para gerar uma meta específica de produção de energia hidrelétrica em cada etapa de tempo. API Referência.

Atributos primários

, máximo)_corrente, ,

Exemplos

em breve...

Os cenários em WaterStrategy permitem que os usuários simulem e explorem várias estratégias de gerenciamento de água ajustando diferentes elementos de um modelo. Eles fornecem uma estrutura para entender como as mudanças nas entradas, suposições ou dados podem influenciar os resultados em diferentes condições.

WaterStrategy oferece dois tipos de cenários para atender a várias necessidades na modelagem de gerenciamento de água:

1. WaterStrategy Cenários: Esse tipo é usado quando os usuários precisam ajustar comportamentos, parâmetros ou dados específicos em uma escala localizada ou menor. Esses cenários são ideais para casos em que apenas alguns elementos do modelo precisam ser ajustados sem alterar todo o conjunto de dados. Ele permite modificações específicas, facilitando o teste dos efeitos de mudanças individuais no sistema.

2. Cenários PyWR: Esse tipo de cenário foi projetado para lidar com casos mais complexos, particularmente aqueles que envolvem incerteza. Ele é especializado em combinar dados em várias escalas, permitindo uma avaliação abrangente de diferentes variáveis. Essa abordagem é especialmente útil ao trabalhar com entradas incertas ou ao modelar condições futuras, pois permite explorar como diferentes combinações de dados e suposições podem impactar os resultados.

Descrição geral

O Nó de armazenamento virtual sazonal é um storage node virtual que opera somente por um período especificado dentro de um ano.

Esse nó é mais útil para representar licenças que só são aplicadas durante períodos específicos. O redefinir_dia e redefinir_mês os parâmetros indicam quando o nó começa a operar e o fim_dia e fim_mês quando ele para de funcionar. Durante o período em que o nó não está operando, o volume do nó permanece inalterado e o nó não aplica nenhuma restrição ao modelo.

O fim_dia e fim_mês pode representar uma data anterior ao ano em que a redefinição_dia e reiniciar_mês. Essa situação representa uma licença que opera além de um limite de um ano. Por exemplo, um que esteja ativo entre outubro e março e não ativo entre abril e setembro.API Referência.

Atributos primários

dia . volume_dia

Exemplos

em breve...

layout: description: visible: false outline: visible: true pagination: visible: true tableOfContents: visible: true title: visible: true

Saída de água

Os nós de saída são locais onde a água sai do sistema. Abaixo estão os nós de saída de água mais usados:

layout: description: visible: false outline: visible: true pagination: visible: true tableOfContents: visible: true title: visible: true

Energia hidrelétrica

O tipo de nó hidrelétrico permite que os usuários definam detalhes relevantes das turbinas nas barragens e calculem a geração de energia hidrelétrica.

WaterStrategy Os cenários fornecem uma ferramenta para fazer ajustes específicos em elementos específicos dentro de um modelo de gerenciamento de água. Esses cenários são particularmente úteis quando você deseja experimentar alterações localizadas em parâmetros, comportamentos ou dados de forma flexível e controlada.

Quando um cenário WaterStrategy é criado, ele age como um garfo de um modelo de rede existente. A rede original é atribuída ao cenário de linha de base, que representa as condições padrão ou iniciais do sistema. A partir dessa linha de base, um cenário WaterStrategy permite modificações precisas, seja alterando as entradas de dados ou ajustando parâmetros que definem o comportamento dos principais elementos do sistema.

Essa capacidade de modificar certos aspectos do modelo e deixar o restante inalterado torna os cenários WaterStrategy ideais para testar o impacto de mudanças individuais. Por exemplo, você pode alterar as regras de operação do reservatório ou modificar as previsões de demanda sem precisar reconstruir todo o modelo. Essa abordagem focada ajuda os usuários a avaliar rapidamente como modificações específicas influenciam os resultados das estratégias de gerenciamento de água de refino.

Criando um cenário WaterStrategy

Comece clicando no ícone Clonar um cenário.

Selecione o cenário que você deseja clonar e nomeie seu cenário

Para um tutorial detalhado, consulte o WaterStrategy tutorial sobre a criação e execução de um novo cenário

Os cenários pywr são compatíveis com os seguintes parâmetros:

• Parâmetro do DataFrame

• Parâmetro de cenário constante

• Parâmetro ConstantScenarioIndex

• Parâmetro de perfil diário do cenário

• Parâmetro de perfil semanal do cenário

• Parâmetro de perfil mensal do cenário

• Parâmetro de cenário indexado da matriz

• Parâmetro de fatores mensais do cenário indexado de matriz

• Parâmetro do Scenario Wrapper

Todos os Parâmetro subclasses em pira descendem de uma classe base comum.

layout: description: visible: false outline: visible: true pagination: visible: true tableOfContents: visible: true title: visible: true

Outros

O outro tipo de nó permite que os usuários obtenham resultados de computação especialmente projetados do sistema de recursos hídricos.

Descrição geral

Inicialize a si mesmo. Consulte a ajuda (digite (self)) para obter uma assinatura precisa. API Referência

Atributos

Exemplo

em breve...

{

}

Descrição geral

O Nó agregado é uma soma agregada de outros Nodo nós.

Este objeto deve se comportar como Nodo retornando a corrente corrente. No entanto, esse objeto não pode ser conectado a outros dentro da rede. API Referência.

Observações: Esse nó não pode ser conectado a outros nós na rede.

Atributos primários

Exemplos

em breve...

Descrição geral

O Nó de armazenamento agregado é uma soma agregada de outros Armazenamento nós

Este objeto deve se comportar como Armazenamento retornando a corrente corrente, volume e atual_pc. No entanto, esse objeto não pode ser conectado a outros dentro da rede. API Referência.

Observações: Esse nó não pode ser conectado a outros nós na rede.

Atributos primários

Exemplos

em breve...

Descrição geral

O PiecewiseLink node é uma extensão do Node que representa um elemento não linear Link com uma função de custo por peça. Este objeto tem como objetivo modelar situações em que há um benefício em fornecer determinadas taxas de fluxo, mas além de um limite fixo, há uma mudança no custo (ou zero). API Referência.

Esse Node é implementado usando uma estrutura de nó composta, como a seguinte:

        | Domínio separado         |
Saída -> Sublink 0 -> Sub-saída -> Entrada
       -> Sublink 1 ---^
       ...             |
       -> Sublink n ---|

Isso significa que as rotas não atravessam diretamente esse nó devido ao domínio separado no meio. Em vez disso, várias novas rotas são criadas para cada um dos sublinks e conexões com o nó de saída/entrada. O motivo dessa interrupção da rota é evitar um aumento geométrico no número de rotas quando vários PieceWiselinks estão presentes na mesma rota.

Atributos primários

_corrente

Exemplos

em breve...

Os cenários Pywr oferecem uma abordagem mais avançada e abrangente para a modelagem de gerenciamento de água, especialmente ao trabalhar com incertezas e avaliar várias combinações de dados e comportamentos do sistema e entradas de dados. Ao contrário dos cenários WaterStrategy, que se concentram em ajustes localizados, os cenários Pywr permitem que você experimente uma ampla gama de possibilidades variando várias entradas e combinações simultaneamente.

Em cenários de Pywr:

• Os usuários podem definir vários cenários, com cada cenário contendo várias variações (ou tamanhos).

• O sistema simulará todas as combinações dessas variações, a menos que uma combinação específica seja selecionada para simulação.

Por exemplo, se dois cenários Pywr forem definidos, cada um com três variações (tamanho = 3), o número total de simulações será 9 (3 x 3). Essa abordagem permite que os usuários explorem uma ampla gama de possíveis resultados e interações entre diferentes fatores no modelo.

1. Ativando cenários de Pywr

Em uma rede, clique em Exibir dados de rede ícone

Isso abrirá o painel direito. Na seção Entradas, digite”cenários” e clique em Adicionar uma entrada ícone

Uma janela será exibida, digite”cenários”, selecione o cenários atribua e clique Salvar conforme mostrado na imagem a seguir

Uma nova janela aparecerá, selecione PYWR_CENÁRIOS e clique em Salvar

2. Criação de cenários pywr

Depois que o painel de personalização de cenários estiver aberto, você poderá definir quantos cenários Pywr forem necessários. Para criar um novo cenário Pywr, siga estas etapas:

Clique

Edite o cenário padrão atual clicando em

Inserir um Nome para o cenário Pywr e especifique o Tamanho (número de variações).

O Kit o atributo é opcional e ajuda a acompanhar cenários de índice específicos dentro do cenário Pywr

Depois de criar os cenários pywr, o sistema exibirá as seguintes informações:

Clicando no JSON A guia exibirá a versão automática do JSON do Cenário Pywr definição

Para carregar os dados como h5 DataFrameParameter, consulte Seção de parâmetros HDF5 para acessar adequadamente os dados do cenário

Descrição geral

O VirtualStorage node é uma unidade de armazenamento virtual. API Referência.

Notas:

TODO: A propriedade de custo não é respeitada atualmente. Veja a edição #242.

Atributos primários

volume

Exemplos

em breve...

Descrição geral

Um parâmetro simples que define um valor constante. API Referência

Atributos

Exemplo

{
    tipo: 'parâmetro constante',
    valor: 123
}

description: Uma visão geral dos parâmetros Pywr suportados por WaterStrategy

Parâmetros

Parâmetros são funções que retornam um valor no modelo em cada etapa de tempo. Esses valores podem ser constantes, com base no tempo (por exemplo, no dia ou no mês), um cálculo baseado no armazenamento do reservatório da etapa de tempo e muitos outros cálculos. O parâmetro personalizado também pode ser escrito em Python.

Esta página descreve (a maioria) os tipos de parâmetros suportados pelo Pywr. Uma visão geral dos parâmetros em Pywr pode ser encontrada aqui. A lista completa de parâmetros embutidos do Pywr é encontrada aqui.

1. Criando um parâmetro

Em uma rede, clique na guia “Parâmetros”:

Ao lado da seção “Categorias do tipo de parâmetros”, clique no botão '+' e selecione 'PYWR\ _PARAMETER'.

Uma entrada de texto aparecerá. Digite o nome do seu parâmetro:\

Modifique o parâmetro conforme necessário no editor JSON fornecido:

2. Editores de parâmetros em WaterStrategy

Para simplificar as modificações de parâmetros, WaterStrategy oferece editores para parâmetros comumente usados, como parâmetros de perfil mensal, com valores padrão pré-preenchidos, e editores gráficos para simplificar a inserção de dados.

Exemplo de editor de parâmetros

Na guia Parâmetros, ao adicionar um novo parâmetro, selecione 'PYWR_PARÂMETRO_\ _PROFILE' MENSAL, conforme mostrado:\

Observe que o editor exibido mostrará uma guia JSON, mas também uma guia Plot and Table. A modificação dos dados na tabela atualizará automaticamente os dados no JSON, conforme mostrado:\

Essas alterações atualizam automaticamente o JSON:

As penalidades de alocação são atributos do nó que permitem ao Pywr simular a alocação de água. Eles também podem ser chamados de “prioridades de alocação” ou “custos”.

Uma penalidade baixa terá a maior prioridade de alocação, um número alto terá a mais baixa.

Então, por exemplo, se três nós têm prioridades 100, 3 e -2, então o nó com -2 obtém sua água primeiro, depois 3 e depois 100.

Aqui estão algumas perguntas sobre penalidades de alocação de água que você possa ter e algumas respostas curtas:

1. Por que e como Pywr aloca água dessa forma? Em cada etapa de tempo, o algoritmo de alocação do Pywr (um programa linear) minimiza a penalidade de alocação de todo o sistema. O fluxo através dos nós é multiplicado por suas respectivas penalidades de alocação. Essa técnica tem sido usada desde a década de 1950 por planejadores de energia, transporte e água e por empresas de logística. Todos eles querem sistemas que operem de forma barata, então normalmente usavam os custos operacionais financeiros como penalidade. Isso faz sentido, pois permite usar o modelo para equilibrar uma rede de oferta e demanda com o menor custo.

2. Você acha confusa a ideia de uma penalidade negativa? Se sim, pense em uma penalidade negativa como um custo negativo, o que é isso? um benefício! Portanto, se você quiser alocar água para onde ela gera mais benefícios em seu modelo Pywr, você usará penalidades negativas. Nesse caso, em vez de chamar esses atributos do nó de penalidades ou custos de alocação, você pode se referir a eles como prioridades de alocação. Nesse caso, um nó com uma prioridade de alocação de -99 receberá água muito antes de -10. Conforme mostrado no exemplo da terceira frase acima, penalidades de alocação negativas e positivas podem ser usadas no mesmo modelo.

3. As penalidades de alocação têm algum significado especial? Não, eles não têm. Eles estão lá apenas para ajudar seu modelo a alocar água de uma forma que faça sentido para você, gerente e planejador da água.

4. Como sei se defini as penalidades de alocação de água corretamente? Se o seu modelo está alocando água adequadamente em condições normais, mas também durante inundações e secas, você definiu as penalidades apropriadas. Parabéns! seu modelo está prestes a se tornar “bem calibrado”.

5. Se eu fizer uma grande mudança em meu modelo, como adicionar uma grande nova infraestrutura ou adicionar um novo tipo de usuário de água, preciso alterar as penalidades em meu modelo? Sim, algumas penalidades em seu modelo podem precisar de algum refinamento, dependendo da importância da alteração. Experimente e veja.

6. Posso usar qualquer número para penalidades? Por exemplo, se meu modelo tem 2 nós, posso usar um milhão negativo e positivo como minhas penalidades? Sim, mas é uma má ideia. Use números que estejam o mais próximos possível. Caso contrário, à medida que seu modelo cresce, você pode ficar sem penalidades disponíveis e seu modelo começará a cometer erros de arredondamento. No entanto, se você usar penalidades muito semelhantes, seu modelo pode ser insensível a elas (ou seja, não considerá-las adequadamente ao simular alocações). Com um pouco de experiência, você aprenderá a definir penalidades que funcionem bem. Para obter essa experiência, tente alterar as penalidades e veja como isso afeta as saídas do seu modelo.

Finalmente, fornecemos mais alguns detalhes técnicos sobre penalidades:

• Os nós de reservatório e armazenamento têm penalidades de alocação atribuídas a eles. Uma penalidade negativa significa que o reservatório tenderá a acumular água, a menos que uma penalidade menor em outro nó resulte em menor prioridade no armazenamento do reservatório.

• As penalidades de alocação podem ser constantes (parâmetros constantes) ou perfis (mensais, diários, semanais) que mudam com o tempo. Além disso, as penalidades de alocação podem ter diferentes níveis definidos por diferentes curvas de controle com base no volume do reservatório. Apesar das penalidades de alocação de reservatórios e armazenamento influenciarem o armazenamento de água, as liberações desses nós resultarão de um equilíbrio de penalidades no sistema, considerando as penalidades de alocação a jusante, à medida que o algoritmo tenta minimizar a penalidade geral do sistema em cada etapa de tempo.

Descrição geral

Parâmetro que leva negativo de outro Parâmetro.

Atributos

tamanho tamanho variável

Exemplo

em breve...

Descrição geral

Uma coleção de IndexParameters. Essa classe se comporta como um conjunto. Os parâmetros podem ser adicionados ou removidos dele. Seu valor é o valor de seus parâmetros filhos agregados usando uma função de agregação (por exemplo, soma).

Atributos

Exemplo

Nesse caso, o parâmetro agregado está multiplicando dois parâmetros juntos

• Fator de demanda da curva de controle

Este exemplo mostra uma demanda de linha de base sendo multiplicada por um fator que reduz a demanda com base em uma curva de controle do reservatório. Você pode clicar em cada um desses parâmetros para ver como eles são definidos.

Descrição geral

Parâmetro que leva no mínimo outro Parâmetro e valor constante (limite).

Essa classe é uma versão mais eficiente do Parâmetro agregado onde um único Parâmetro é comparado ao valor constante. API Referência

Atributos

tamanho tamanho variável

Exemplo

em breve...

{

}

Descrição geral

Parâmetro que divide um Parâmetro por outro. API Referência

Atributos

Exemplo

em breve...

{

}

Descrição geral

Um cenário que varia IndexParameter. Os valores nesse parâmetro são constantes no tempo, mas variam em um único cenário. API Referência

Atributos

Exemplo

em breve...

{

}

Descrição geral

Parâmetro base fornecendo um índice método. API Referência

Atributos

Exemplo

em breve...

{

}

Descrição geral

Um cenário que varia o parâmetro. Os valores nesse parâmetro são constantes no tempo, mas variam em um único cenário. API Referência

Atributos

tamanho tamanho variável

Exemplo

em breve...

{

}

Descrição geral

Parâmetro que assume o mínimo do negativo de um Parâmetro e valor constante (limite).

Atributos

tamanho tamanho variável

Exemplo

em breve...

Descrição geral

Parâmetro que leva o máximo de outro Parâmetro e valor constante (limite).

Essa classe é uma versão mais eficiente do Parâmetro agregado onde um único Parâmetro é comparado ao valor constante.

Atributos

tamanho tamanho variável

Exemplo

em breve...

Descrição geral

O perfil semanal contém 52 semanas por ano. A última semana do ano terá mais de 7 dias, pois 365/7 não é inteiro. API Referência

Atributos

Exemplo

{
    tipo: 'perfil semanal',
    valores: [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1...]
}

Descrição geral

Parâmetro que fornece um valor uniformemente reduzido de um a zero.

Esse parâmetro deve ser usado com um Armazenamento virtual anual nó para fornecer um perfil que represente a utilização média perfeita do volume anual. Ele retorna um valor de 1 no dia da reinicialização e, posteriormente, é reduzido em 1/366 todos os dias seguintes. API Referência

Atributos

para redefinir o volume para o valor inicial Sim redefinir

Exemplo

em breve...

{

}

Descrição geral

Parâmetro que fornece um perfil mensal. O perfil mensal retorna um valor diferente com base no mês da etapa de tempo atual. API Referência

Atributos

Exemplo

{
    tipo: 'perfil mensal',
    valores: [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1]
}

Water Strategy oferece uma forma alternativa de trabalhar com perfis mensais.

Descrição geral

Parâmetro que compensa outro Parâmetro por um valor constante.

Essa classe é uma versão mais eficiente do Parâmetro agregado onde um único Parâmetro é compensado por um valor constante. API Referência

Atributos

tamanho tamanho variável otimização superior_pula

Exemplo

em breve...

{

}

Descrição geral

Parâmetro que fornece um perfil diário.

O perfil diário retorna um valor diferente com base no mês do intervalo de tempo atual. API Referência

Atributos

Exemplo

{
    tipo: 'perfil diário',
    valores: [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1...]
}

Descrição geral

Parâmetro que toma o máximo do negativo de um Parâmetro e valor constante (limite). API Referência

Atributos

tamanho tamanho variável

Exemplo

em breve...

{

}

Descrição geral

Uma coleção de parâmetros de índice

Essa classe se comporta como um conjunto. Os parâmetros podem ser adicionados ou removidos dele. Seu índice é o índice de seus parâmetros filhos agregados usando uma função de agregação (por exemplo, soma). API Referência

Atributos

Exemplo

em breve...

{

}

Descrição geral

Parâmetro de variação de tempo usando uma matriz e TimeStep.index com fatores multiplicativos por cenário.

Os valores são os dados da série temporal da linha de base que são perturbados por um fator. O fator é obtido de fatores que são forma (scenario.size, 12). Portanto, os fatores variam com os cenários individuais no cenário e no mês.

Atributos

Exemplo

em breve...

Descrição geral

Parâmetro que fornece um perfil diário por cenário.

Esse parâmetro fornece um perfil anual repetido com uma resolução diária. Um perfil diferente é retornado para cada membro de um determinado cenário.

Atributos

Exemplo

em breve...

Descrição geral

Parâmetro que fornece um perfil mensal por cenário.

O comportamento é o mesmo que Parâmetro de perfil mensal exceto que um perfil diferente é retornado para cada conjunto em um determinado cenário.

Atributos

Exemplo

em breve...

Descrição geral

Parâmetro que interpola um perfil diário usando uma função de base radial (RBF).

O perfil diário é calculado durante o modelo restabelecer usando uma função de base radial com o dia do ano como variáveis independentes. Os dias do ano são definidos pelo usuário junto com os valores a serem usados em cada um desses dias para a interpolação. O primeiro dia dos anos deve ser sempre um, e seu valor é repetido como o 366º valor. Além disso, o segundo e o penúltimo valor são espelhados para incentivar que um gradiente consistente apareça além do limite. Os cálculos da RBF são realizados usando o Scipy.interpolate.rbf objeto, consulte a documentação do Scipy para obter mais informações.

Atributos

Sim, superior

Exemplo

em breve...

Descrição geral

Parâmetro que fornece um perfil semanal por cenário

Esse parâmetro fornece um perfil anual repetido com uma resolução semanal. Um perfil diferente é retornado para cada membro de um determinado cenário.

Atributos

Exemplo

em breve...

Descrição geral

Classe base para parâmetros que retornam um dos dois valores, dependendo de outro estado. API Referência

Atributos

Exemplo

em breve...

{

}

Descrição geral

Um cenário que varia o parâmetro.

Os valores nesse parâmetro variam no tempo com base no índice e variam em um único cenário. API Referência

Atributos

Exemplo

em breve...

{

}

Descrição geral

Parâmetro de série temporal com alinhamento e reamostragem automáticos. API Referência

Atributos

Exemplo

{
	“tipo”: “DataFrameParameter”,
	“url”: “Entradas_mm3_day.csv “,
	“coluna”: “Bacia hidrográfica 1",
	“index_col”: “etapa de tempo”,
	“parse_dates”: verdadeiro
}

Descrição geral

Retorna um dos dois valores, dependendo do valor de um parâmetro. API Referência

Atributos

Exemplo

em breve...

{

}

Descrição geral

Retorna um dos dois valores, dependendo do fluxo anterior em um nó. API Referência

Atributos

Exemplo

em breve...

{

}

Descrição geral

Retorna um dos dois valores, dependendo do volume atual em um Storage node. API Referência

Atributos

Exemplo

em breve...

{

}

Descrição geral

Parâmetro de variação de tempo usando uma matriz e TimeStep.index

Os valores nesse parâmetro são constantes em todos os cenários. API Referência

Atributos

Exemplo

em breve...

{

}

layout: description: visible: false outline: visible: true pagination: visible: true tableOfContents: visible: true title: visible: true

Parâmetros de interpolação

Descrição geral

Este parâmetro lê dados de matriz de um banco de dados HDF PyTables.

O parâmetro lê dados usando a interface de matriz PyTables e, portanto, não exige o carregamento de todo o conjunto de dados na memória. Isso é útil para grandes execuções de modelos. API Referência

Ao armazenar arquivos HDF5 no formato “fixo”, os usuários podem obter velocidades ideais de acesso aos dados, tornando o HDF5 uma ferramenta eficaz para cenários PyWR que usam DataFrames como parâmetros, onde a recuperação rápida de dados é crucial. Os arquivos HDF5 são lidos como um dicionário, onde cada chave representa um DataFrame pandas. Por exemplo, a estrutura de um arquivo.h5 de entrada pode conter três chaves, cada uma representando um rio diferente. Cada chave contém três séries temporais que podem ser atribuídas a um cenário Pywr de tamanho 3.

Se estiver usando o arquivo h5 DataFrame para executar cenários pywr, consulte para ativar esse recurso

Nota: O tamanho dos cenários pywr deve corresponder ao número de chaves no arquivo h5

Atributos