Creación de un nuevo proyecto y red

1. En la página de inicio de la interfaz, haga clic en «Crear proyecto» en la esquina superior derecha.

2. Escriba el nombre de su proyecto y seleccione «Agregar».

3. Introduzca su nuevo proyecto.

4. Haga clic en «Crear red» en el lado derecho.

5. Elige la pestaña «Manual».

6. Introduzca un nombre de red.

7. Elige una de estas dos plantillas pywr.

\ -Las demás plantillas son para otros sistemas de modelado, como los sistemas de alimentación.

1. Elija «Usar mapa» para que se muestre el mapa mundial para la construcción de modelos.

2. Haga clic en «Enviar».

3. Introduzca la red creada.

4. Cambia y amplía un área a lo largo del Nilo.

1. Selecciona el menú desplegable «Construir».

1. Arrastre una cuenca hidrográfica, un enlace y dos nodos de salida al modelo, tal y como se muestra a continuación.

\ -El segundo nodo de salida (fuera del río) se utilizará como nodo de extracción de agua.

\ -Observe que el nodo de captación está río arriba y el nodo de salida está río abajo.

(el Nilo fluye hacia el norte en esta parte y en general)

1. Con la función «Enlaces», conecte los nodos en la dirección del flujo.

\ -Esto se hace haciendo clic primero en el nodo de flujo ascendente y luego en el nodo de flujo descendente.

description: Esta página muestra cómo iniciar sesión en WaterStrategy

Iniciar sesión

1. Para iniciar sesión, vaya a https://hydra.org.uk/login (Hydra es el servidor seguro en el que alojamos actualmente WaterStrategy)

2. Introduzca su nombre de usuario y contraseña WaterStrategy

3. Haga clic en «Iniciar sesión»

Si ha olvidado su contraseña, haga clic en el botón 'Contraseña olvidada'enlace.

Tenga en cuenta: permita las cookies cuando se le solicite.

description: Cómo crear una cuenta gratuita en WaterStrategy

Creación de una cuenta

Vea el vídeo o siga el texto que aparece a continuación. WaterStrategy las cuentas se realizan en https://hydra.org.uk/register («Hydra» es el nombre de nuestro servidor web).

Creación de una cuenta

1. En el WaterStrategy página web, seleccione «INICIAR SESIÓN» en la esquina superior derecha.

1. Selecciona «Crear una cuenta» en la parte inferior de la página web que te lleva a «Iniciar sesión».

2. En la página de registro, introduce tu correo electrónico, nombre, apellido, tipo de organización, organización, país o región, crea una contraseña, selecciona «No soy un robot» y marca las tres casillas.

3. Luego selecciona «Registrarse».

4. Se le enviará un correo electrónico de confirmación para confirmar su cuenta. Asegúrate de revisar también tu carpeta de correo no deseado.

5. Se ha creado su cuenta.

Iniciar sesión

1. Para iniciar sesión, visita https://hydra.org.uk/login o utilice la página web WaterStrategy «Iniciar sesión»

1. Introduce tu correo electrónico y contraseña y vuelve a marcar las tres casillas inferiores. Elige «Recordarme» si lo deseas.

2. Luego selecciona «Iniciar sesión».

3. Estará en la página principal de la interfaz Water Strategy.

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

Cómo tratar los errores del modelo

WaterStrategy informa de errores cuando hay una falla técnica o cuando el modelo se ha configurado incorrectamente. Aprender a entender y utilizar el informe de errores de un modelo para encontrar un problema en un modelo es una habilidad de modelización importante y esencial.

En este capítulo se ofrece un ejemplo de cómo leer un informe de errores para encontrar la parte de un modelo que provoca el error.

Cómo obtener el informe de errores

Cuando una ejecución falle, verás que la ejecución se pone roja en la sección de carreras.

Haga clic en la barra roja de ejecución y obtendrá una descripción general de la ejecución, incluido el informe de errores.

Desplázate hasta el final del informe. Aquí es donde la ejecución informará de su error.

Para esta ejecución, se puede observar que el perfil mensual no se ha introducido correctamente.

En algunos casos, se proporcionará más información sobre un error en el informe de ejecución. Es importante revisar los registros de ejecución para ver si hay alguna pista sobre el problema.

Al desplazarnos hacia arriba, vemos «CRÍTICO». Esto indica que se ha reconocido un error. En la misma línea, indica dónde está el error.

La entrada «evaporación» del nodo «Depósito de ejemplo» es incorrecta.

Podemos editar el parámetro «evaporación» para resolver este problema.

Hay 13 valores en el perfil mensual, necesitamos eliminar el valor que no pertenece. En este caso, '3.14' no estaba destinado a figurar en el perfil mensual.

Guarde el parámetro y vuelva a ejecutar este modelo.

Ahora el modelo se ha ejecutado correctamente.

En WaterStrategy, los usuarios tienen la flexibilidad de administrar conjuntos de datos grandes y complejos de manera más eficiente al cargar datos de archivos externos como Parámetro DataFrame utilizando la palabra clave «url», en lugar de incrustar todos los datos directamente en la interfaz. Los formatos de archivo incluyen:

• CSV

• Excel

• HDF5

Nota: Entre las opciones anteriores, los archivos de Excel tienen el rendimiento más lento, mientras que los archivos HDF5 tienen el mejor rendimiento y son los preferidos para conjuntos de datos de gran tamaño.

Para cargar un archivo en WaterStrategy, navegue hasta su proyecto y haga clic en la pestaña Archivos. Desde allí, haga clic Elige archivos y selecciona el archivo que quieres subir y haz clic .

Esto añadirá el archivo a tu proyecto y estará disponible para su uso en todas las redes del proyecto.

Una vez que se hayan subido los archivos, se mostrarán en el Expedientes pestaña dentro de tu proyecto. Desde allí, puedes verlos, administrarlos y compartirlos fácilmente en todas las redes del proyecto.

Descripción general

Los nodos de entrada representan las entradas de agua al sistema.

En cada paso de tiempo, un nodo de entrada puede proporcionar tanta agua como la establecida por el Flujo máximo atributo. Sin embargo, a diferencia Nodos de captación que son necesarios para liberar el volumen de agua definido en su atributo de flujo, los nodos de entrada no están obligados a liberar agua a menos que tengan un valor distinto de cero Flujo mínimo.

Los nodos de entrada se utilizan a menudo para representar fuentes definidas por los rendimientos. A menudo se utilizan para representar el rendimiento de las aguas subterráneas.

API Referencia.

Atributos principales

Ejemplos

próximamente...

Descripción general

El nodo de captación es otro tipo de nodo de entrada con un flujo de entrada fijo. Los nodos de captación se utilizan a menudo para representar ríos u otro tipo de afluencia al sistema. Cualquier flujo que se defina en ellos tiene que fluir al sistema.

A menudo, las series temporales de flujo de entrada (por ejemplo, los marcos de datos Pywr) se definen en el flujo atributo para representar las entradas de captación; sin embargo, también se pueden usar otros parámetros (por ejemplo, perfil constante, mensual, etc.).

API Referencia.

Atributos principales

Ejemplos

próximamente...

Descripción general

El nodo de entrada proporcional está diseñado para un caso simple en el que se requiere una proporción fija de flujo para distribuirse a múltiples rutas aguas abajo. API Referencia.

Atributos principales

Ejemplos

próximamente...

Descripción general

El link node representa un enlace en el sistema de agua u otro punto de interés donde se asigna una restricción de flujo máxima o mínima o una prioridad de asignación. Tenga en cuenta que en Pywr no se pueden asignar restricciones de flujo a los bordes (enlaces) y, por lo tanto, los nodos de enlace se utilizan con frecuencia para este propósito. API Referencia.

Atributos principales

_flujo

Ejemplos

próximamente...

Descripción general

El nodo de retardo es un nodo que retrasa el flujo durante un número determinado de intervalos de tiempo o días. Este nodo se utilizará cuando no se pueda ignorar el tiempo de propagación del agua en comparación con la escala de tiempo seleccionada. API Referencia.

Atributos principales

Ejemplos

próximamente...

Descripción general

El Nodo RiverGauge es una estación de medición fluvial, con un flujo residual mínimo (MRF). API Referencia.

Atributos principales

Ejemplos

próximamente...

Descripción general

El RiverSplitWithGauge node es una escisión de la red fluvial con un caudal residual mínimo (MRF). Según Río Split pero de forma predeterminada crea otra ruta en el objeto subyacente para modelar un MRF. Esta ruta es tal que el MRF no forma parte de las proporciones forzadas. La intención de este objeto es modelar el caso en el que una proporción del flujo se puede extraer por encima del MRF (por ejemplo, un 90% del flujo por encima del MRF). API Referencia.

Atributos principales

costo Factores

Ejemplos

próximamente...

Descripción general

El BreakLink node se puede usar para reducir la cantidad de rutas en un modelo.

Por ejemplo, en un modelo con forma (3, 1, 3), es decir, 3 entradas (A, B, C) conectadas a 3 salidas (D, E, F) a través de un cuello de botella (X), hay 3\ *3 rutas = 9 rutas.

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

Si X es un almacenamiento, solo hay 6 rutas: A->X_o, B->X_o, C->X_o y X_i->D_Entonces, X_i->E_Entonces, X_i->F\ _o.

El BreakLink node es un nodo compuesto por un Almacenamiento con volumen cero y un Enlace. Se puede usar en lugar de un enlace normal, pero con la ventaja de que reduce el número de rutas en el modelo (en la situación descrita anteriormente). El LP resultante es más fácil de resolver. API Referencia.

Atributos principales

Máximo opcional_flujo

Ejemplos

Descripción general

El RiverSplit node es una división en la red fluvial. Está pensada para un caso sencillo en el que sea necesario distribuir una proporción fija de caudal entre varias rutas aguas abajo. API Referencia.

Atributos principales

).

Ejemplos

próximamente...

Descripción general

El nodo fluvial es un nodo de la red fluvial, que puede tener varios nodos aguas arriba (es decir, una confluencia) pero solo un nodo aguas abajo. API Referencia.

Atributos principales

_flujo

Ejemplos

próximamente...

Descripción general

El PiecewiseLink node es una extensión de Node que representa un nodo no lineal Enlace con una función de coste por partes. El objetivo de este objetivo es modelar situaciones en las que el suministro de ciertos caudales es beneficioso, pero más allá de un límite fijo hay un cambio en el costo (o cero). API Referencia.

Este nodo se implementa utilizando una estructura de nodos compuesta como la siguiente:

        | Dominio separado         |
Salida -> Sublink 0 -> Sub salida -> Entrada
       -> Subenlace 1 ---^
       ...             |
       -> Subenlace ---|

Esto significa que las rutas no atraviesan directamente este nodo debido a que hay un dominio independiente en el medio. En su lugar, se crean varias rutas nuevas para cada uno de los subvínculos y conexiones al nodo de salida/entrada. El motivo de esta interrupción de la ruta es evitar un aumento geométrico en el número de rutas cuando hay varios enlaces por tramos en la misma ruta.

Atributos principales

_flujo

Ejemplos

próximamente...

Descripción general

El storage node es un nodo general que puede almacenar agua, que tiene restricciones de volumen mínimo y máximo. API Referencia.

Atributos principales

volumen pc

Ejemplos

próximamente...

Descripción general

El VirtualStorage node es una unidad de almacenamiento virtual. API Referencia.

Notas:

TODO: La propiedad de coste no se respeta actualmente. Consulte el número #242.

Atributos principales

volumen_volumen

Ejemplos

próximamente...

Descripción general

El Nodo anual de almacenamiento virtual es un almacenamiento virtual que se restablece anualmente, útil para las licencias. API Referencia.

Atributos principales

Ejemplos

próximamente...

Descripción general

El MultiSplitLink node es una extensión de Piece WiseLink que incluye ranuras adicionales desde las que conectarse.

Conceptualmente, este nodo tiene el siguiente aspecto interno,

         / -->-- X0 -->-- \
UN -->-- Xo -->-- X1 -->-- Xi -->-- C
         \ -->-- X2 -->-- /
                 |
                 Bo -->-- Bi --> D

Se añaden un subenlace adicional en PieceWiseLink (es decir, X2 arriba) y nodos (es decir, Bo y Bi) de esta clase por cada espacio adicional.

Finalmente, se proporciona un mecanismo para (opcionalmente) fijar la relación entre el último subenlace no dividido (es decir, X1) y cada uno de los subenlaces adicionales (es decir, X2). Este mecanismo utiliza Nodo agregado internamente. API Referencia.

Notas: Los usuarios deben tener cuidado al utilizar el mecanismo factorial. Los factores utilizan el último subenlace no dividido (es decir, X1 pero no X0). Si este enlace está restringido con un flujo máximo o mínimo, o si hay otro enlace sin restricciones (es decir, si X0 no está restringido), es posible que las proporciones en todo el nodo no se apliquen como se esperaba.

Atributos principales

_ranuras

Ejemplos

próximamente...

Descripción general

El Nodo de almacenamiento virtual estacional es un storage node virtual que funciona solo durante un período específico dentro de un año.

Este nodo es muy útil para representar las licencias que solo se aplican durante períodos específicos. El restablecer_día y restablecer_mes los parámetros indican cuándo el nodo comienza a funcionar y el final_día y final_mes cuando deja de funcionar. Durante el período en que el nodo no está en funcionamiento, el volumen del nodo permanece inalterado y el nodo no aplica ninguna restricción al modelo.

El final_día y fin_el mes puede representar una fecha anterior al año en que se restableció_día y reinicio_mes. Esta situación representa una licencia que opera más allá de un año. Por ejemplo, una que esté activa entre octubre y marzo y no entre abril y septiembre.API Referencia.

Atributos principales

día . volumen_día

Ejemplos

próximamente...

Descripción general

El Nodo Rolling VirtualStorage es un storage node virtual rodante útil para implementar licencias móviles. API Referencia.

Notas:

TODO: La propiedad de coste no se respeta actualmente. Consulte el número #242.

Atributos principales

volumen_volumen

Ejemplos

próximamente...

Descripción general

El Nodo AggregatedStorage es una suma agregada de otros Almacenamiento nodos

Este objeto debería comportarse como Almacenamiento devolviendo la corriente flujo, volumen y actual_PC. Sin embargo, este objeto no se puede conectar a otros dentro de la red. API Referencia.

Notas: Este nodo no se puede conectar a otros nodos de la red.

Atributos principales

Ejemplos

próximamente...

Descripción general

El nodo de embalse es una subclase de storage node con funcionalidad adicional para representar la evaporación y la precipitación. API Referencia.

Atributos principales

volumen pc , precipitación opcional

Ejemplos

próximamente...

Descripción general

UN enlace de pérdida permite la definición de una pérdida de flujo proporcional fija que pasa por este nodo. Los enlaces de pérdida se utilizan a menudo para representar obras de tratamiento de agua potable que incurren en algunas pérdidas de proceso.

Los atributos de flujo máximo y mínimo que se definen se aplican a la salida neta después de las pérdidas.

El propio nodo registra la salida neta en su atributo de flujo (que utilizaría cualquier grabador adjunto).

Atributos principales

Ejemplo

En este ejemplo, 10se pierde el% de la cantidad bruta de agua que fluye hacia el nodo.

Descripción general

El Nodo AggregatedNode es una suma agregada de otros Nodo nodos.

Este objeto debería comportarse como Nodo devolviendo la corriente flujo. Sin embargo, este objeto no se puede conectar a otros dentro de la red. API Referencia.

Notas: Este nodo no se puede conectar a otros nodos de la red.

Atributos principales

Ejemplos

próximamente...

Los escenarios de Pywr ofrecen un enfoque más avanzado y completo para la modelización de la gestión del agua, especialmente cuando se trabaja con incertidumbre y se evalúan varias combinaciones de datos y comportamientos del sistema y entradas de datos. A diferencia de los escenarios WaterStrategy, que se centran en los ajustes localizados, los escenarios Pywr permiten experimentar con una amplia gama de posibilidades variando varias entradas y combinaciones simultáneamente.

En los escenarios de Pywr:

• Los usuarios pueden definir varios escenarios, y cada escenario contiene múltiples variaciones (o tamaños).

• El sistema simulará todas las combinaciones de estas variaciones, a menos que se seleccione una combinación específica para la simulación.

Por ejemplo, si se definen dos escenarios de Pywr, cada uno con tres variaciones (tamaño = 3), el número total de simulaciones será de 9 (3 x 3). Este enfoque permite a los usuarios explorar una amplia gama de posibles resultados e interacciones entre los diferentes factores del modelo.

1. Activación de escenarios de Pywr

En una red, haga clic en Ver datos de red icono

Esto abrirá el panel derecho. En la sección Insumos, escriba»escenarios» y haga clic en Agregar una entrada icono

Aparecerá una ventana, escriba»escenarios», selecciona escenarios atribuir y hacer clic Guardar como se muestra en la siguiente imagen

Aparecerá una nueva ventana, selecciona PYR_ESCENARIOS y haga clic Guardar

2. Creando escenarios de pywr

Una vez abierto el panel de personalización de escenarios, puede definir tantos escenarios de Pywr como sea necesario. Para crear un nuevo escenario de Pywr, siga estos pasos:

Haga clic

Edite el escenario predeterminado actual haciendo clic en

Introduzca un Nombre para el Pywr-Scenario y especifique el Tamaño (número de variantes).

El Conjuntos el atributo es opcional y ayuda a realizar un seguimiento de escenarios de índice específicos dentro del escenario Pywr

Tras crear los escenarios de pywr-, el sistema mostrará la siguiente información:

Al hacer clic en el JSON la pestaña mostrará la versión JSON automática del Escenario Pywr definición

Para cargar los datos como h5 DataFrameParameter, consulte Sección de parámetros HDF5 para acceder correctamente a los datos del escenario

Descripción general

El nodo de turbina puede representar una turbina de una central hidroeléctrica. Calcula el flujo requerido para generar un objetivo de producción hidroeléctrica en particular en cada etapa de tiempo. API Referencia.

Atributos principales

_flujo_cabezaelevación

Ejemplos

próximamente...

description: Hay diferentes maneras de solicitar asistencia para WaterStrategy.

Soporte

El canal Discord de WaterStrategy se monitorea regularmente y ofrece apoyo por parte de desarrolladores y usuarios. Allí puedes denunciar errores o solicitar nuevas funciones. Inscríbete a través de este enlace:

https://discord.gg/bQVmgkFcf7

Como alternativa, puede enviar un correo electrónico support@waterstrategy.org

description: WaterStrategy ayuda a las personas y organizaciones a entender su sistema de agua y a evaluar los planes futuros. La documentación de WaterStrategy le ayuda a construir, refinar y usar un gemelo digital de su sistema de agua. layout: description: visible: true outline: visible: true pagination: visible: true tableOfContents: visible: true title: visible: true

WaterStrategy Documentación

Descripción general

Una colección de IndexParameters. Esta clase se comporta como un conjunto. Los parámetros se pueden añadir o eliminar de ella. Su valor es el valor de sus parámetros secundarios agregados mediante una función de agregación (por ejemplo, suma). API Referencia

Atributos

Ejemplo

{
	«tipo»: «Parámetro agregado»,
	«agg_func»: «producto»,
	«parámetros»: [
		«Demanda de referencia»,
		«Factor de demanda de la curva de control»
	]
}

En este caso, el parámetro agregado multiplica dos parámetros

• Demanda de referencia

• Factor de demanda de la curva de control

Este ejemplo muestra la multiplicación de una demanda de referencia por un factor que reduce la demanda en función de una curva de control de yacimientos. Puede hacer clic en cada uno de estos parámetros para ver cómo están definidos.

Descripción general

Parámetro que divide a uno Parámetro por otro. API Referencia

Atributos

Ejemplo

próximamente...

{

}

WaterStrategy Los escenarios proporcionan una herramienta para realizar ajustes específicos a elementos específicos dentro de un modelo de gestión del agua. Estos escenarios son especialmente útiles cuando se desea experimentar con cambios localizados en los parámetros, los comportamientos o los datos de forma flexible y controlada.

Cuando se crea un escenario WaterStrategy, actúa como horquilla de un modelo de red existente. La red original se asigna al escenario de referencia, que representa las condiciones iniciales o predeterminadas del sistema. A partir de esta línea de base, un escenario WaterStrategy permite realizar modificaciones precisas, ya sea para cambiar las entradas de datos o para ajustar los parámetros que definen el comportamiento de los elementos clave del sistema.

Esta capacidad de modificar ciertos aspectos del modelo sin modificar el resto hace que WaterStrategy Los escenarios sean ideales para probar el impacto de los cambios individuales. Por ejemplo, puede modificar las reglas de operación de un yacimiento o modificar las previsiones de demanda sin necesidad de reconstruir todo el modelo. Este enfoque centrado ayuda a los usuarios a evaluar rápidamente cómo las modificaciones específicas influyen en los resultados a la hora de refinar las estrategias de gestión del agua.

Creación de un escenario WaterStrategy

Comience haciendo clic en el icono Clonar un escenario.

Seleccione el escenario que desea clonar y asigne un nombre a su escenario

Para ver un tutorial detallado, consulte la WaterStrategy tutorial sobre la creación y ejecución de un nuevo escenario

description: Para construir un «gemelo digital» (un simulador de computadora) de su sistema de agua, WaterStrategy usa Pywr («Python Water Resources»).

¿Qué es Pywr?

Pywr es una biblioteca de software de lenguaje Python gratuita y de código abierto que permite crear modelos de simulación de alta calidad (detallados y precisos) de sistemas de recursos hídricos.

Los modelos Pywr se ejecutan rápidamente en su computadora o, en el caso de WaterStrategy, en la nube. Pueden representar sistemas de recursos hídricos pequeños, como el suministro de agua de una ciudad, o sistemas muy grandes, como cuencas fluviales que abarcan varios países con cientos de usuarios de agua y activos de infraestructura. Pywr puede simular períodos cortos (como unos pocos meses) o períodos más largos (como 100 años) en distintos intervalos de tiempo (desde diarios hasta mensuales).

Este es un resumen del proceso de modelado de Pywr:

1. Configure el modelo

En primer lugar, se necesita un mapa espacial del sistema hídrico y los datos hidrológicos y de demanda de agua asociados. WaterStrategy le ayuda a crear este mapa de red de todas las ubicaciones («nodos») donde el agua ingresa al sistema («entradas»), dónde se usa el agua («demandas de agua») y donde se administra el agua (ubicaciones de la infraestructura). Estos nodos forman una red conectada por ríos, canales o tuberías (Pywr los llama «enlaces» o «bordes»). Una vez que haya configurado el mapa de la red, proporcionará datos sobre el suministro y la demanda de agua (normalmente en forma de series temporales).

2. Ejecute una simulación

Cuando se ingresan todos los datos, incluidos el intervalo temporal y el horizonte temporal, el modelo está listo para la simulación (es decir, pasar por el tiempo y realizar la contabilidad del agua en todo el sistema). Al principio de cada etapa temporal, la computadora comienza inyectando agua en todas las ubicaciones de entrada, luego esta agua se envía por la red y se asigna a las diferentes ubicaciones de infraestructura y demanda de agua. Este proceso de asignación se lleva a cabo mediante una técnica informática denominada programación lineal. Una vez finalizado un paso temporal, el modelo actualiza los almacenamientos, registra qué ubicaciones recibieron la cantidad de agua y, a continuación, continúa con el siguiente paso temporal hasta el final del horizonte temporal simulado.

A cada nodo de demanda de agua se le asigna una prioridad para representar la asignación de agua en el modelo. Cada nodo tiene una penalización asociada y el algoritmo de asignación distribuye el agua por toda la red para minimizar la penalización general. Este enfoque simple permite realizar simulaciones rápidas y fáciles de mantener, que tienen la flexibilidad de representar reglas de gestión del agua detalladas y realistas.

3. Revisa los resultados

Los resultados del modelo incluyen la cantidad de agua que entra en cada ubicación (nodo) y la cantidad que se almacena, consume o pasa a través de ella en cada paso de tiempo. Esto permite rastrear cómo se utiliza la infraestructura y si las ciudades, los ecosistemas, las áreas de riego, las centrales eléctricas, etc. reciben suficiente agua. Los resultados crean una imagen detallada de cómo funciona el sistema de gestión del agua y cómo se distribuyen los beneficios del agua.

Inicialmente, los modelos están mal parametrizados y producen predicciones inexactas (la fase de «basura que entra, basura que sale»). Sin embargo, con el tiempo, a medida que el modelo se vaya mejorando («calibrando»), puede convertirse en un valioso gemelo digital que ayude a operar o planificar un sistema de agua. La herramienta ayuda a su organización a evaluar de forma rápida y económica los impactos de los posibles cambios e intervenciones futuros en materia de agua, y a tomar buenas decisiones.

¡Buena suerte!

Descripción general

Parámetro sencillo que define un valor constante. API Referencia

Atributos

Ejemplo

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

Descripción general

Una colección de IndexParameters

Esta clase se comporta como un conjunto. Los parámetros se pueden añadir o eliminar de ella. Su índice es el índice de sus parámetros secundarios agregados mediante una función de agregación (por ejemplo, suma). API Referencia

Atributos

Ejemplo

próximamente...

{

}

Descripción general

Parámetro que toma el máximo del negativo de un Parámetro y valor constante (umbral). API Referencia

Atributos

tamaño tamaño

Ejemplo

próximamente...

{

}

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

Entrada de agua

Los nodos de entrada de agua son el mecanismo por el cual se puede ingresar agua al sistema. Aquí presentamos los tres nodos más utilizados para la entrada de agua.

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

Transporte acuático

El tipo de nodo de transporte de agua permite a los usuarios definir cómo fluye el agua a través de los diferentes nodos de acuerdo con las condiciones del mundo real. A continuación se muestran los nodos de transporte acuático más utilizados:

description: Cómo compartir un proyecto o una red con otros usuarios WaterStrategy

Compartir proyectos y redes

Proyectos: son como carpetas que agrupan subproyectos y redes.

Redes: cada modelo con una red única se denomina «red» en WaterStrategy.

Icono de persona: indica que solo tienes acceso al proyecto o a la red.

Icono de personas: indica que varias personas tienen acceso a un proyecto o red.

Creador: creó el proyecto o la red.

Compartido directamente: el proyecto o la red se compartieron específicamente con un usuario.

Heredado de: («Nombre del proyecto»): el usuario tiene acceso a este subproyecto o red al compartir un proyecto que lo encierra.

1. Para compartir un proyecto, ingresa al proyecto y haz clic en la pestaña de miembros.

1. Escribe el correo electrónico de la cuenta del destinatario con la que quieres compartir.

Hay dos permisos que puede elegir para conceder a un destinatario.

¿Permitir que los usuarios vuelvan a compartir? : Les permite compartir el proyecto y los proyectos o redes que contiene con otros.

¿Permitir a los usuarios editar el proyecto? : Les permite editar los proyectos o redes dentro del proyecto.

1. Selecciona «Invitar» después de elegir los permisos.

A continuación puedes ver con quién se ha compartido el proyecto, gestionar con quién se ha compartido, ver sus permisos y ver cómo han recibido el acceso.

1. Para compartir una red, haga clic en el icono de compartir en una red.

0__Hay permisos que puede optar por conceder a un destinatario.

¿Permitir que los usuarios vuelvan a compartir? : Les permite compartir la red con otros.

¿Permitir a los usuarios editar el proyecto? : Les permite editar la red.

Red de clonación: crea una red duplicada. Impide los cambios en una red preexistente. Tiene las siguientes opciones si se elige «Red clonada».

¿Incluir los resultados en una nueva red? : Incluya los resultados de la ejecución en una red clonada.

¿Incluir todos los escenarios? : Incluya los escenarios creados en la red clonada.

Nombre de red: cree el nombre de la red clonada.

1. Escribe el correo electrónico de la cuenta del destinatario con la que quieres compartir.

2. Haz clic en «Compartir» después de elegir los permisos.

En esta tabla se presentan los tipos de nodos Pywr más utilizados:

Los tipos de nodos Pywr también se pueden subdividir en 6 categorías: Entrada de agua, Transporte acuático, Almacenamiento de agua, Salida de agua, Energía hidroeléctrica, y Otros. Puedes encontrar más detalles sobre estas agrupaciones de nodos y tipos de nodos en las subsecciones de la sección «Tipos de nodos».

Más detalles

Puede encontrar una descripción general de los nodos en Pywr aquí. Puede encontrar la lista completa de nodos integrados en Pywr aquí.

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

Almacenamiento de agua

El tipo storage node de agua permite a los usuarios construir diferentes depósitos con diferentes modos de operación. A continuación se muestran los nodos de almacenamiento de agua más utilizados:

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

Energía hidroeléctrica

El tipo de nodo hidroeléctrico permite a los usuarios definir los detalles relevantes de las turbinas de las presas y calcular la generación de energía hidroeléctrica.

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

Otros

El otro tipo de nodo permite a los usuarios obtener resultados de cálculo especialmente diseñados del sistema de recursos hídricos.

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

Salida de agua

Los nodos de salida son lugares donde el agua sale del sistema. A continuación se muestran los nodos de salida de agua más utilizados:

Las penalizaciones de asignación son atributos de nodo que permiten a Pywr simular la asignación de agua. También pueden denominarse «prioridades de asignación» o «costos».

Una penalización baja tendrá la prioridad de asignación más alta, mientras que un número alto tendrá la más baja.

Por ejemplo, si tres nodos tienen prioridades 100, 3 y -2, el nodo con -2 recibe el agua primero, luego 3 y luego 100.

Estas son algunas preguntas sobre las multas por asignación de agua que puede tener y algunas respuestas breves:

1. ¿Por qué y cómo distribuye Pywr el agua de esta manera? En cada paso del tiempo, el algoritmo de asignación de Pywr (un programa lineal) minimiza la penalización de asignación de todo el sistema. El flujo a través de los nodos se multiplica por sus respectivas penalizaciones de asignación. Esta técnica ha estado en uso desde la década de 1950 por los planificadores de energía, transporte y agua y por las empresas de logística. Todas quieren sistemas que funcionen a bajo costo, por lo que, por lo general, utilizan los costos operativos financieros como pena de penalización. Esto tiene sentido, ya que permite usar el modelo para equilibrar una red de oferta y demanda al menor costo.

2. ¿Le parece confusa la idea de una penalización negativa? Si es así, piensa en una penalización negativa como un coste negativo, ¿qué es eso? ¡un beneficio! Por lo tanto, si quieres asignar el agua a los lugares donde genere más beneficios en tu modelo Pywr, utilizarás penalizaciones negativas. En este caso, en lugar de denominar penalizaciones o costes de asignación a estos atributos de nodo, podrías llamarlos prioridades de asignación. En este caso, un nodo con una prioridad de asignación de -99 recibirá agua mucho antes que -10. Como se muestra en el ejemplo de la tercera oración anterior, en el mismo modelo se pueden usar penalizaciones de asignación tanto negativas como positivas.

3. ¿Las penalizaciones por asignación tienen algún significado especial? No, no lo tienen. Solo están ahí para ayudar a su modelo a asignar el agua de una manera que tenga sentido para usted, el administrador y planificador del agua.

4. ¿Cómo sé si he establecido correctamente las penalizaciones por asignación de agua? Si su modelo asigna el agua de manera adecuada en condiciones normales, pero también durante inundaciones y sequías, ha establecido las penalizaciones adecuadas. ¡Felicidades! su modelo está en camino de estar «bien calibrado».

5. Si realizo un cambio importante en mi modelo, como añadir una nueva infraestructura grande o añadir un nuevo tipo de usuario de agua, ¿tengo que cambiar las penalizaciones de mi modelo? Sí, es posible que algunas penalizaciones de su modelo deban refinarse, según la importancia del cambio. Pruébalo y verás.

6. ¿Puedo usar cualquier número para los penaltis? Por ejemplo, si mi modelo tiene 2 nodos, ¿puedo usar un millón negativo y positivo como penalizaciones? Sí, pero es una mala idea. Usa números que estén lo más cerca posible. De lo contrario, a medida que su modelo crezca, podría quedarse sin penalizaciones disponibles y su modelo empezará a cometer errores de redondeo. Sin embargo, si utiliza penalizaciones demasiado similares, es posible que su modelo no sea sensible a ellas (es decir, no las tenga en cuenta adecuadamente al simular las asignaciones). Con un poco de experiencia, aprenderás a establecer penalizaciones que funcionen bien. Para obtener esa experiencia, prueba a cambiar las penalizaciones y comprueba cómo afectan a los resultados de tu modelo.

Por último, proporcionamos algunos detalles técnicos más sobre las penalizaciones:

• Los nodos de depósito y almacenamiento tienen penalizaciones de asignación asignadas. Una penalización negativa significa que el depósito tenderá a acumular agua, a menos que una penalización más baja en otro nodo haga que el almacenamiento del depósito tenga una prioridad más baja.

• Las penalizaciones de asignación pueden ser constantes (parámetros constantes) o perfiles (mensuales, diarios o semanales) que cambian con el tiempo. Además, las penalizaciones por asignación pueden tener diferentes niveles definidos por diferentes curvas de control en función del volumen del depósito. A pesar de que las penalizaciones por la asignación de depósitos y depósitos influyen en el almacenamiento de agua, las liberaciones de esos nodos se deben a que el sistema tendrá en cuenta las penalizaciones de asignación aguas abajo, ya que el algoritmo intenta minimizar la penalización general del sistema en cada fase temporal.

description: ¿Cómo funciona? ¿qué produce? y ¿cómo se usa?

¿Modelado de sistemas de recursos hídricos?

Para comprender cómo funciona un sistema de agua en la actualidad y evaluar los impactos de los cambios futuros, los planificadores crean modelos de sistemas de recursos hídricos.

Los sistemas de recursos hídricos pueden ser pequeños, como una ciudad y sus fuentes de suministro de agua, o grandes, como un país con muchos ríos, activos de infraestructura hídrica y usuarios de agua diferentes. Ya sea que intentes evaluar la confiabilidad de las fuentes actuales o evaluar nuevas intervenciones en condiciones futuras plausibles, este modelo computarizado ayuda a rastrear el agua en todo el sistema (espacialmente) y a lo largo del tiempo.

Dados los datos sobre los flujos hidrológicos y el clima, la demanda y el uso del agua y las reglas y la asignación de la gestión del agua, un modelo de sistema de agua genera flujos y volúmenes de agua en cada ubicación y período de tiempo modelados. Cuando se agregan estos resultados, proporcionan una imagen precisa del rendimiento que podrían tener las diferentes intervenciones relacionadas con el agua (cambios en las políticas o la infraestructura del agua).

description: Vea una descripción general de la interfaz WaterStrategy; a continuación encontrará un resumen de texto.

Recorrido por la interfaz

Proyecto: carpeta que contiene redes relacionadas, también puede contener otras carpetas de proyectos (subproyectos).

\ -Cada carpeta de proyecto muestra la cantidad de redes y carpetas de subproyectos que contiene.

Red: modelo.

1. En la página de inicio de la interfaz, seleccione el proyecto «Material de formación».

2. Seleccione la red Demo 1.

\ -Dentro de la red, en la parte superior de la página, verás una barra con este aspecto a continuación.

\ -Las pestañas «Inicio» y «Mis proyectos» lo llevarán de vuelta a la página de inicio de la interfaz.

\ - «Documentación y formación» lo lleva a los vídeos tutoriales de las interfaces y a la página de instrucciones escritas.

\ -La pestaña «Favoritos» le permite marcar proyectos, redes y escenarios. También permite ir a los proyectos y redes a los que se ha accedido o modificado recientemente.

\ - «Volver a 'Material de capacitación'» lo lleva de vuelta a la carpeta del proyecto de material de capacitación.

\ -El botón verde de reproducción ejecuta un modelo.

\ -El botón de llave proporciona acceso a utilidades de red avanzadas, como la importación o exportación de datos de red.

\ -La flecha hacia abajo en el botón rectangular sirve para descargar el modelo, que se usa para ejecutarlo sin conexión o para enviárselo a alguien.

\ -Las tres líneas son «Ver datos de red».

1. Haga clic en «Ver datos de red».

\ -En «Detalles» puede cambiar el nombre de la red.

\ -A veces es necesario salir de la red para actualizarse.

\ -En «Entradas» puede cambiar el inicio, el final y la etapa temporal de su modelo.

\ -d=día, M=mes, Y=año para el intervalo temporal.

1. Haga clic en el icono de la llave inglesa para ir a «Configuración».

Mostrar etiquetas: muestra los nombres de los nodos

Dirección del enlace: muestra la dirección del flujo de los enlaces

Mostrar información sobre herramientas: muestra la información del nodo al pasar el ratón sobre él

0__Auto Hide Sidebar: oculta la barra lateral cuando no la usa

Clasifique siempre los atributos por tipo: dentro de un nodo, los atributos se agruparán como escalares, descriptores, etc.

1. Haga clic en la «i» para ir a «Información».

\ -Puedes ver tu «ID de red» y otra información.

1. Cierre la barra lateral y vaya a la sección de escenarios en el lado izquierdo de la página.

\ -Los escenarios son variaciones de los datos de entrada, la hidrología, etc. dentro de un modelo.

\ -Es común crear varios escenarios dentro de un modelo.

Botón 1 (izquierda): escenario de clonación

Botón 2- Editar escenario

Botón 3- Eliminar escenario

Botón 4: actualizar la lista de escenarios

Botón 5- Escenario de marcadores

Botón 6 (derecha): compara escenarios

\ -Para crear un escenario nuevo, clone un escenario preexistente dándole un nombre nuevo y, una vez creado, cambie los datos de entrada del modelo según lo desee.

1. Haga clic en el botón «Ejecutar un modelo».

\ -Mantenga el escenario de referencia.

\ -Conserva todos los demás valores predeterminados.

1. Haz clic en «Enviar».

\ -En la sección «Ejecuciones» de la parte izquierda de la página, verás tu nueva ejecución y las pasadas.

\ -Yellow=Ejecutar en cola

\ -Blue=Ejecución en curso

\ -Green=Ejecución exitosa

\ -Red=Falló la ejecución

1. Haz clic en «Construir» debajo de la sección «Ejecutar».

\ -Esto proporciona todos los nodos y enlaces necesarios para crear un modelo.

\ -Después de insertar un nodo, es necesario introducir los datos.

1. Haz clic en «Buscar» debajo de la sección «Construir».

\ -Esto le permite encontrar fácilmente nodos y enlaces en modelos grandes.

El botón bomba en la esquina superior izquierda del mapa te permite expandir tu modelo para que esté menos concurrido si es necesario.

Mapa- Muestra el modelo

Recursos: puede ver sus nodos, enlaces y grupos

Metrics: proporciona funcionalidades para la agregación de las salidas del modelo

Reglas personalizadas: reglas operativas personalizadas

Parámetros: agregue parámetros no incluidos en pywr

Grabadoras: agregue grabadoras no incluidas en pywr

Miembros- Muestra los miembros que tienen que acceder al modelo y los permisos que poseen, también pueden agregar miembros en esta pestaña y elegir los permisos que tienen

Análisis: comparación de nodos y enlaces dentro de escenarios

WaterStrategy no es necesario para ejecutar un modelo Pywr; está ahí para ayudar a facilitar el uso de los modelos Pywr. Si tiene un archivo de entrada del modelo Pywr (se denominan archivos «JSON») y tiene instaladas en su computadora las bibliotecas Python y Pywr necesarias, puede ejecutar su modelo Pywr sin WaterStrategy (Nota: se requieren conocimientos de Python). Del mismo modo, si ya tienes un modelo de Pywr (un archivo JSON), puedes importarlo a WaterStrategy.

Esta página muestra cómo exportar modelos de WaterStrategy a un archivo JSON de Pywr y cómo importar modelos Pywr existentes (archivos JSON) a WaterStrategy

Exportación e importación de modelos

Exportación de archivos Pywr

Esta sección utiliza la «red de demostración» que se proporciona al crear una cuenta.

Primero haz clic en el botón de descarga.

Luego, vamos a elegir nuestro formato.

Elija primero el formato JSON de Hydra. Si quieres habilitar los saltos de línea para que tu código o texto sea más fácil de leer. Si es un archivo grande, puedes comprimirlo.

Envíalo.

A continuación, descarga el formato Pywr JSON.

Luego, puedes encontrar los dos archivos en la carpeta en la que elegiste guardarlos.

Importar archivos Pywr

Veamos cómo importar archivos Pywr.

Primero, haz clic en «Crear proyecto» para crear una carpeta de proyectos en tu cuenta Water Strategy.

Asigne un nombre al proyecto y haga clic en «Agregar».

Haz clic en el proyecto creado.

Haz clic en «Crear red».

Selecciona «Hydra JSON».

Haz clic en «Elegir archivo».

Elija el archivo JSON de Hydra.

Selecciona la plantilla.

Haz clic en «Enviar».

Luego, puede ver que la red está importada.

Para importar el archivo JSON de Pywr, puedes seguir estos pasos.

Vuelva a hacer clic en «Crear red».

Elige el 'Pywr JSON'.

Haz clic en «Elegir archivo».

Elige el archivo JSON Pywr.

Elige la plantilla.

Para la proyección, puede elegir «Ninguno», «Reino Unido» o «Mundo». En este caso, elegiremos «Mundo».

Haz clic en «Enviar».

Por último, puede ver la red importada aquí.

Descripción general

Parámetro que toma el mínimo del negativo de un Parámetro y valor constante (umbral). API Referencia

Atributos

tamaño tamaño

Ejemplo

próximamente...

{

}

Descripción general

Un parámetro que varía en el escenario. Los valores de este parámetro son constantes en el tiempo, pero varían en un único escenario. API Referencia

Atributos

tamaño tamaño

Ejemplo

próximamente...

{

}

Descripción general

Parámetro que toma el mínimo de otro Parámetro y valor constante (umbral).

Esta clase es una versión más eficiente de Parámetro agregado donde un sencillo Parámetro se compara con el valor constante. API Referencia

Atributos

tamaño tamaño

Ejemplo

próximamente...

{

}

Todas las Parámetro subclases en pywr descienden de una clase base común.

Los escenarios de WaterStrategy permiten a los usuarios simular y explorar varias estrategias de gestión del agua ajustando diferentes elementos de un modelo. Proporcionan un marco para comprender cómo los cambios en las entradas, las suposiciones o los datos pueden influir en los resultados en diferentes condiciones.

WaterStrategy ofrece dos tipos de escenarios para abordar diversas necesidades en la modelización de la gestión del agua:

1. WaterStrategy Escenarios: Este tipo se usa cuando los usuarios necesitan ajustar comportamientos, parámetros o datos específicos a una escala localizada o más pequeña. Estos escenarios son ideales para los casos en los que solo es necesario modificar ciertos elementos del modelo sin alterar todo el conjunto de datos. Permite realizar modificaciones específicas, lo que facilita la prueba de los efectos de los cambios individuales en el sistema.

2. Escenarios de PyWR: Este tipo de escenario está diseñado para tratar casos más complejos, en particular aquellos que implican incertidumbre. Se especializa en combinar datos en múltiples escalas, lo que permite una evaluación integral de diferentes variables. Este enfoque es especialmente útil cuando se trabaja con datos inciertos o cuando se modelan condiciones futuras, ya que permite explorar cómo las diferentes combinaciones de datos y suposiciones pueden afectar a los resultados.

Descripción general

El nodo de salida (API Referencia) es una salida general en cualquier punto de la red. Los nodos de salida eliminan el agua del sistema.

Los nodos de salida son necesarios al final de un río y, en este caso de uso, generalmente no tienen una penalización de asignación ni un flujo máximo asignado.

Los nodos de salida también se utilizan para representar las demandas de agua para el consumo. En este caso de uso, suelen asignarles penalizaciones de asignación negativas, de modo que el programa lineal les asigna agua además de un caudal máximo, que puede ser una constante o un parámetro que represente la demanda de agua.

Atributos principales

_flujo

Ejemplos

próximamente...

los escenarios de pywr son compatibles con los siguientes parámetros:

• Parámetro de marco de datos

• Parámetro Constant Scenario

• Parámetro ConstantScenarioIndex

• Parámetro de perfil diario de escenario

• Parámetro de perfil semanal de escenario

• Parámetro de perfil mensual de escenario

• Parámetro ArrayIndexedScenario

• Parámetro ArrayIndexedScenarioMonthlyFactors

• Parámetro Wrapper de escenario

description: Términos clave utilizados en Pywr.

Conceptos de Pywr

Pywr, una biblioteca de Python utilizada por WaterStrategy, permite simular la asignación de recursos al representar un sistema de recursos como una red mediante «nodos» y «bordes». La asignación de recursos se rige por reglas operativas que utilizan «penalizaciones de asignación», «restricciones» y «parámetros», y las salidas del modelo se capturan y guardan mediante «grabadoras». Las variaciones de las entradas del modelo se pueden especificar y ejecutar en paralelo mediante «escenarios».

Si bien los conceptos generales utilizados para crear un modelo de simulación de asignación de recursos en Pywr son similares a los de otras herramientas, el uso de los términos puede diferir. En esta sección, definimos los términos clave de Pywr y sus funciones en los modelos de simulación.

Nodo

Los nodos representan ubicaciones en el sistema de agua simulado donde se agrega, almacena, usa, consume o transmite agua. Hay diferentes tipos de nodos en Pywr que le ayudarán a crear su modelo de sistema de agua; puede obtener más información sobre ellos en Tipos de nodos sección. Los datos que definen las características físicas y el comportamiento de un nodo se pueden agregar directamente al nodo o indirectamente haciendo referencia a un parámetro (que se describe a continuación).

Borde

Para formar una red, los nodos se conectan mediante enlaces que representan el transporte de agua. Pywr los llama «bordes». Una arista tiene un nodo inicial y otro final, y el agua fluye del nodo inicial al nodo final. Pywr no asigna información a estas conexiones (los bordes), sino que asigna datos a los nodos de origen y destino. Todos los datos necesarios para simular la gestión del agua se almacenan en nodos; los bordes solo determinan la dirección del flujo de agua. Un modelador de Pywr diría que «los bordes de Pywr determinan la topología de la red», lo que significa que «las conexiones entre los nodos determinan cómo se mueve el agua en el modelo de computadora».

Restricción

Se pueden establecer restricciones en varios tipos de nodos para ayudar a representar el comportamiento del sistema. Por ejemplo, un nodo fluvial puede tener valores de flujo máximos y/o mínimos para representar la capacidad de transporte. En Pywr, muchos nodos tienen el valor 'max_flow' y 'min_atributos de flujo para establecer los límites superior e inferior del flujo a través del nodo si es necesario. El atributo 'max\ _flow' no requiere que el flujo que pasa por este nodo alcance este valor, pero si el volumen de agua y la prioridad son suficientes, el modelo intentará alcanzar el 'flujo máximo'. Las restricciones de flujo mínimo deben usarse con cuidado, ya que pueden hacer que el modelo no sea viable si no se puede cumplir con el mínimo.

Penalización o «costo» de asignación

Las penalizaciones de asignación son atributos de los nodos que controlan la prioridad de asignación de agua. Por lo general, se expresan como penalizaciones o «costos», y el modelo asigna el agua primero al nodo con la penalización más baja. Si prefieres asignar por beneficio y enviar primero el agua a donde tenga el mayor beneficio, tendrás que expresar tus prioridades en Pywr como costos negativos (es decir, usa números negativos). De hecho, ambos se pueden usar juntos, por lo que, por ejemplo, si 3 nodos tienen penalizaciones -10, 2, 6, recibirán agua en ese orden (el nodo con una penalización de -10 recibe agua primero y el nodo con una penalización de asignación 6 recibe agua en último lugar).

Parámetro

Los parámetros de Pywr proporcionan una forma flexible y cómoda de proporcionar entradas a los nodos. Por ejemplo, se puede usar un tipo de parámetro determinado para cargar datos de entrada o demanda desde un archivo de Microsoft Excel. Los parámetros también ofrecen una forma flexible y personalizable de definir las reglas operativas de un sistema (por ejemplo, las reglas que rigen las liberaciones de depósitos). La mayoría de los datos de entrada del modelo se pueden proporcionar mediante parámetros.

Grabadora

Los grabadores Pywr se utilizan para posprocesar los resultados. Al crear una grabadora, puede observar y guardar los resultados de la simulación. Algunos registradores permiten agregar los resultados a lo largo del tiempo (por ejemplo, de diario a anual) y del espacio (por ejemplo, el agua asignada a un grupo de nodos).

Escenario

En Pywr puede crear y simular escenarios con diferentes datos de entrada sobre la oferta, la demanda u otros cambios. Los planificadores del agua utilizan cada vez más simulaciones a largo plazo con muchos escenarios para evaluar los cambios futuros o probar posibles intervenciones. Poder simular rápidamente muchos escenarios futuros plausibles es uno de los principales beneficios de Pywr.

Nota:

Para obtener más información, consulte el documento de acceso abierto titulado: Un simulador de recursos hídricos en Python.

description: Descripción general de los parámetros de Pywr compatibles con WaterStrategy

Parámetros

Los parámetros son funciones que devuelven un valor en el modelo en cada paso de tiempo. Estos valores pueden ser una constante basada en el tiempo (por ejemplo, el día o el mes), un cálculo basado en el almacenamiento del yacimiento en el intervalo de tiempo y muchos otros cálculos. El parámetro personalizado también se puede escribir en Python.

Esta página describe (la mayoría de) los tipos de parámetros admitidos por Pywr. Puede encontrar una descripción general de los parámetros de Pywr aquí. Se encuentra la lista completa de parámetros Pywr integrados aquí.

1. Creación de un parámetro

En una red, haga clic en la pestaña «Parámetros»:

Junto a la sección «Categorías de tipos de parámetros», haga clic en el botón «+» y seleccione «PYWR\ _PARAMETER».

Aparecerá una entrada de texto. Introduzca el nombre de su parámetro:\

Modifique el parámetro según sea necesario en el editor JSON proporcionado:

2. Editores de parámetros en WaterStrategy

Para simplificar las modificaciones de los parámetros, WaterStrategy ofrece editores para los parámetros más utilizados, como los parámetros del perfil mensual, con valores predeterminados rellenados previamente y editores gráficos para facilitar la introducción de datos.

Ejemplo de editor de parámetros

En la pestaña Parámetros, al añadir un nuevo parámetro, seleccione 'PYWR_PARÁMETRO_\ _PERFIL MENSUAL, como se muestra:\

Tenga en cuenta que el editor que aparece mostrará una pestaña JSON, pero también una pestaña Gráfica y Tabla. La modificación de los datos de la tabla actualizará automáticamente los datos del JSON como se muestra a continuación:\

Estos cambios actualizan automáticamente el JSON:

Descripción general

Parámetro que proporciona un valor que se reduce uniformemente de uno a cero.

Este parámetro está diseñado para usarse con un Almacenamiento virtual anual nodo para proporcionar un perfil que represente la utilización media perfecta del volumen anual. Devuelve un valor de 1 el día del restablecimiento y, posteriormente, se reduce en 1/366 cada día posterior. API Referencia

Atributos

Ejemplo

próximamente...

{

}

Descripción general

Parámetro variable en el tiempo mediante una matriz y Timestep.index con factores multiplicativos por escenario.

Los valores son los datos de series temporales de referencia que están perturbados por un factor. El factor se toma de los factores que son shape (scenario.size, 12). Por lo tanto, los factores varían según los escenarios individuales en cuanto al escenario y al mes. API Referencia

Atributos

Ejemplo

próximamente...

{

}

Descripción general

Un parámetro que varía en el escenario.

Los valores de este parámetro varían en el tiempo según el índice y varían dentro de un único escenario. API Referencia

Atributos

Ejemplo

próximamente...

{

}

Descripción general

Este parámetro lee los datos de la matriz de una base de datos HDF de PyTables.

El parámetro lee los datos mediante la interfaz de matriz PyTables y, por lo tanto, no requiere cargar todo el conjunto de datos en la memoria. Esto es útil para ejecuciones de modelos de gran tamaño. API Referencia

Al almacenar los archivos HDF5 en formato «fijo», los usuarios pueden alcanzar velocidades óptimas de acceso a los datos, lo que convierte a HDF5 en una herramienta eficaz para los escenarios de PyWR que utilizan DataFrames como parámetros, donde la recuperación rápida de datos es crucial. Los archivos HDF5 se leen como un diccionario, donde cada clave representa un DataFrame de pandas. Por ejemplo, la estructura de un archivo inflows.h5 puede contener tres claves, cada una de las cuales representa un río diferente. Cada clave contiene tres series temporales que se pueden asignar a un escenario de Pywr de tamaño 3.

Si utiliza el DataFrame del archivo h5 para ejecutar pywr-scenarios, consulte para activar esta función

Nota: El tamaño de pywr-scenarios debe coincidir con el número de claves del archivo h5

Atributos

Ejemplo

{
	«clave»: «Catchment River 1",
	«escenario»: «Cambio climático»,
	«tipo»: «Parámetro de marco de datos»,
	«url»: «inflows.h5",
	«index_col»: «paso de tiempo»,
	«parse_dates»: verdadero
}

Descripción general

Clase base para los parámetros que devuelven uno de los dos valores en función del otro estado.

Atributos

Ejemplo

próximamente...

Descripción general

Devuelve uno de los dos valores en función del flujo anterior de un nodo.

Atributos

Ejemplo

próximamente...

Descripción general

Devuelve uno de los dos valores en función del valor de un parámetro.

Atributos

Ejemplo

próximamente...

Descripción general

Parámetro que varía en el tiempo mediante una matriz y Timestep.index

Los valores de este parámetro son constantes en todos los escenarios.

Atributos

Ejemplo

próximamente...

Descripción general

Devuelve uno de los dos valores en función del valor de la grabadora y del umbral.

Atributos

Ejemplo

próximamente...

Descripción general

Parámetro base que proporciona un índice método.

Atributos

Ejemplo

próximamente...

Descripción general

Inicializa self. Consulte la ayuda (type (self)) para obtener una firma precisa.

Atributos

Ejemplo

próximamente...

Descripción general

Un escenario que varía el IndexParameter. Los valores de este parámetro son constantes en el tiempo, pero varían en un único escenario.

Atributos

Ejemplo

próximamente...

Descripción general

El valor del parámetro es igual a la cuadratura de la interpolación de otro parámetro.

Atributos

de los puntos de datos para la interpolación Coordenadas de los puntos interpolación Opcional inferior

Ejemplo

próximamente...

Descripción general

Devuelve uno de los dos valores según el volumen actual de un Storage node.

Atributos

Ejemplo

próximamente...

Descripción general

Parámetro de la curva de control que interpola entre tres o más valores.

Los valores devueltos se interpolan linealmente entre las curvas de control, siendo el primer y el último valor 100% y 0% respectivamente. API Referencia

Atributos

(

Ejemplo

próximamente...

{

}

Descripción general

Parámetro que toma el negativo de otro Parámetro. API Referencia

Atributos

tamaño tamaño

Ejemplo

próximamente...

{

}

Descripción general

El valor del parámetro es igual a la interpolación de otro parámetro. API Referencia

Atributos

Ejemplo

próximamente...

{

}

Descripción general

El perfil semanal contiene 52 semanas por año. La última semana del año tendrá más de 7 días, ya que 365/7 no es entero. API Referencia

Atributos

Ejemplo

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

Descripción general

Parámetro que proporciona un perfil mensual. El perfil mensual devuelve un valor diferente en función del mes del intervalo de tiempo actual. API Referencia

Atributos

Ejemplo

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

Water Strategy ofrece una forma alternativa de trabajar con perfiles mensuales.

Descripción general

Parámetro que toma el máximo de otro Parámetro y valor constante (umbral).

Esta clase es una versión más eficiente de Parámetro agregado donde un sencillo Parámetro se compara con el valor constante. API Referencia

Atributos

tamaño tamaño

Ejemplo

próximamente...

{

}

Descripción general

Parámetro que compensa a otro Parámetro por un valor constante.

Esta clase es una versión más eficiente de Parámetro agregado donde un sencillo Parámetro se compensa con un valor constante. API Referencia

Atributos

tamaño tamaño optimización (superior)_límites

Ejemplo

próximamente...

{

}

Descripción general

Parámetro que proporciona un perfil diario.

El perfil diario devuelve un valor diferente en función del mes del intervalo de tiempo actual.

Atributos

Ejemplo

Descripción general

Parámetro que proporciona un perfil mensual por escenario.

El comportamiento es el mismo que Parámetro de perfil mensual excepto que se devuelve un perfil diferente para cada conjunto en un escenario determinado.

Atributos

Ejemplo

próximamente...

Descripción general

Parámetro que proporciona un perfil semanal por escenario

Este parámetro proporciona un perfil anual repetido con una resolución semanal. Se devuelve un perfil diferente para cada miembro de un escenario determinado.

Atributos

Ejemplo

próximamente...

Descripción general

Devuelve uno de los dos valores en función del ordinal del intervalo de tiempo actual. API Referencia

Atributos

Ejemplo

próximamente...

{

}