Traducido del inglés al español - [Link].

com

Características de QEPANET para QGIS

v 0.92

1. Contenido
Este documento describe las principales características, escenarios de uso e interfaz gráfica de usuario del
complemento QEPANET para QGIS.

2. Introducción
EPANET es una herramienta reconocida y ampliamente utilizada para la modelización hidráulica de redes de
distribución de agua. QGIS es un software SIG de escritorio ampliamente utilizado. Ambos son gratuitos y de
código abierto. Dado que una red de distribución de agua tiene un componente espacial intrínseco, la integración
de EPANET con QGIS proporciona un entorno de modelado integrado que ofrece, por un lado, el potente motor de
simulación de EPANET y, por otro, las completas herramientas espaciales de QGIS. El plugin QEPANET para QGIS
intenta alcanzar este objetivo (fig. 1).
Existen otros complementos con la misma finalidad, pero ninguno proporciona un conjunto de
herramientas específicas para crear y editar la red, basándose en las herramientas de edición estándar de
QGIS. Este diseño facilita el acceso a estos complementos, ya que las herramientas que se utilizarán son
conocidas por el usuario promedio de QGIS, pero no considera explícitamente los aspectos topológicos de la
red. QEPANET, en cambio, ofrece un conjunto de herramientas que tienen en cuenta las especificaciones y
restricciones de la red EPANET, garantizando así que la red creada siempre sea compatible con el motor de
modelado.

Figura 1. QGIS muestra una red hidráulica y el panel QEPANET .

3. Requisitos principales del usuario
Los principales requisitos de usuario que han llevado al diseño de QEPANET son:
● Proporcionar un conjunto de herramientas fáciles de usar para dibujar y gestionar la red hidráulica. La ventaja de
este enfoque (como ya se ha descrito) reside principalmente en la capacidad de controlar la creación y edición
de la red, y en garantizar que esta se mantenga siempre en un estado consistente y compatible con el motor de
modelado. Además, también facilita la gestión de los atributos de los elementos de la red, proporcionando
valores predeterminados y comprobaciones de errores.
● Utilizar el formato de archivo .inp estándar de EPANET para almacenar todos los datos necesarios.
Este enfoque agiliza el trabajo del modelador, ya que solo se utiliza un archivo tanto dentro de QGIS
como como entrada de EPANET. Además, QEPANET permite visualizar y editar cualquier archivo .inp
estándar de EPANET, ampliando su aplicación a la innumerable red EPANET ya existente.

4. Características principales

QEPANET ofrece las siguientes características:

● La capacidad de cargar y guardar archivos .inp de EPANET, que se utilizan para almacenar toda la información de
la red.
Un conjunto de herramientas que permite crear y eliminar elementos de la red (uniones, depósitos,
tanques, tuberías, bombas y válvulas). Estas herramientas buscan preservar la consistencia de la
red. Por ejemplo, al crear una tubería, se crean dos uniones en sus extremos, o cuando una nueva
tubería toca una existente a lo largo de su segmento, se crea una nueva unión en el punto de
intersección.
● Para cada tipo de elemento de red, un panel donde se pueden configurar las propiedades del elemento: cada nuevo
elemento tendrá estas propiedades como predeterminadas).
● La opción de cargar un DEM ráster en QGIS que se utilizará para asignar las elevaciones a los nodos
de la red.
● La opción de especificar, para cada nodo, un valor de corrección de elevación (delta z) para tener en cuenta los
nodos que no están sobre el suelo, sino debajo o encima de él.
● La opción de utilizar el sistema de unidades SI o el imperial. Todas las propiedades de los elementos
de la red se ajustarán al sistema elegido.
● Soporte para editar todas las opciones principales de EPANET en cuanto a hidráulica, calidad, reacciones, tiempos,
energía e informe.
● Un editor de patrones gráficos para crear y editar patrones.
● Un editor de curvas gráficas para crear y editar curvas de volumen, bombeo, eficiencia y pérdida de carga.
● Un botón de utilidad para iniciar la simulación de EPANET (utiliza las bibliotecas estándar de EPANET).
● Una herramienta para analizar los resultados de la simulación, mediante gráficos que muestran los valores de las
variables simuladas a lo largo del tiempo y mediante mapas temáticos que muestran el estado de la red en un
paso dado de la simulación.

4.1. Opciones de EPANET no cubiertas por QEPANET

QEPANET no cubre todas las opciones disponibles en EPANET. En particular, la calidad del agua no está
implementada (aún).
5. Escenarios de uso
Para QEPANET, se pueden resumir estos escenarios de uso:
1. QEPANET utilizado para construir una nueva red y ejecutar una simulación: este es el escenario principal. El
usuario abre QGIS y, con las herramientas de QEPANET, construye una nueva red georreferenciada, inicia
la simulación y analiza los resultados.
2. QEPANET se utiliza para georreferenciar una red existente. El usuario importa un archivo INP existente y luego
utiliza las herramientas de QEPANET y QGIS para georreferenciarlo.
3. QEPANET se utiliza para analizar resultados de simulación existentes. El usuario importa un archivo de entrada existente
y utiliza el analizador de salida de QEPANET para abrir su archivo de salida asociado.

6. Estructura de datos
QEPANET necesita seis capas QGIS, una para cada uno de los seis tipos de elementos de red: uniones, reservorios,
tanques, tuberías, bombas y válvulas.
Dado que el complemento se basa únicamente en el archivo inp de EPANET para almacenar datos en el sistema de archivos, las
seis capas son “capas temporales” que se crean cuando se inicia un nuevo proyecto de QEPANET o se abre un archivo inp.

6.1. Algunas notas sobre el archivo .inp

QEPANET utiliza algunos datos (p. ej., el delta z de elevación) que no forman parte de la especificación estándar
del archivo .inp. Estos datos se guardan al final del archivo .inp, después de la etiqueta [END], en una serie de
secciones cuyos nombres empiezan con el prefijo «QEPANET» (p. ej.: [QEPANET-JUNCTIONS]).

EPANET ignora por completo esta parte del archivo .inp al ejecutar una simulación, y solo la utiliza el complemento
QEPANET para rellenar algunos campos de la tabla. Si esta parte del archivo no está presente (como en archivos
inp no creados por QEPANET), QEPANET establecerá los valores de esos campos a cero.

Si el archivo .inp con la información adicional se abre en un software como EPANET 2.0, se muestra un mensaje de error,
pero el archivo sigue siendo válido.

7. Interfaz gráfica de usuario

Todas las herramientas de QEPANET están organizadas en un panel de acoplamiento (fig. 2). El panel consta de varias
secciones:
● Un conjunto de controles para crear, abrir y guardar el proyecto.

● Un conjunto de herramientas de edición de red.

● Un panel plegable que contiene los controles utilizados para seleccionar las capas de QGIS en las que trabajará el
complemento.
● Seis paneles plegables que contienen los controles utilizados para establecer las propiedades de cada tipo de
elemento de red (uniones, depósitos, tanques, tuberías, bombas, válvulas).
● Un panel plegable de “Opciones” que contiene los controles utilizados para configurar las opciones generales de EPANET.
 ● Un panel plegable “Herramientas” que contiene los controles utilizados para acceder a las herramientas para administrar
patrones y curvas.
● Un panel plegable “EPANET” que contiene los controles utilizados para ejecutar la simulación y abrir el
analizador de salida.

Figura 2. El panel acoplable del complemento.

7.1. Controles para crear, abrir y guardar el proyecto

QEPANET almacena toda la información de la red en un archivo de entrada estándar de EPANET. Por lo tanto, en la parte
superior del panel de acoplamiento se encuentran cuatro botones que permiten (fig. 3):
● Cree un nuevo archivo inp vacío.
● Abra un archivo inp existente y reconstruya la red a partir de su contenido.
● Guarde el archivo inp actualmente abierto.

● Guarde el archivo inp actualmente abierto como un archivo nuevo.

Figura 3. Controles para crear, abrir, guardar y guardar como proyecto.

 7.2. Herramientas de edición en red

QEPANET proporciona un conjunto de herramientas para crear fácilmente los elementos de red: uniones,
depósitos, tanques, tuberías, bombas y válvulas (fig. 4). Además, incluye una herramienta para mover los
elementos de red y otra para seleccionarlos y eliminarlos.
Cuando se crea un elemento, se le asignan las propiedades predeterminadas establecidas en el panel de propiedades del elemento

correspondiente (ver más abajo).

Cuando se crea un nodo (unión, depósito o tanque), si se ha seleccionado un DEM en el panel

“Capas”, se le asigna la elevación del DEM en su ubicación.
Cuando se crea un enlace (tubería, bomba o válvula), y no comienza (o termina) con un nodo, se crea
una unión en su inicio (o final) para mantener la red en un estado consistente.
Las bombas y válvulas son enlaces, por tanto elementos bidimensionales, de acuerdo con el modelo de red
EPANET. Las bombas y válvulas tienen una longitud estándar de 1 m.

Figura 4. Herramientas de edición de red.

7.3. Propiedades de los elementos de red

Los seis paneles de propiedades de elementos de red se utilizan para configurar las propiedades predeterminadas
de los seis componentes de red. Las unidades utilizadas se definen al crear el proyecto QEPANET y dependen del
sistema de unidades seleccionado.

7.3.1. Uniones
El panel “Propiedades de la unión” (fig. 5) permite al usuario establecer las propiedades de unión predeterminadas
que se asignarán a cada unión recién creada:
● Demand
● Delta Z
● Patrón (si lo hay)
● Coeficiente de emisor

Figura 5. Panel de propiedades de unión.

 7.3.2. Embalses
El panel “Propiedades del yacimiento” (fig. 6) permite al usuario establecer las propiedades predeterminadas del
yacimiento, que se asignarán a cada yacimiento recién creado:
● Delta Z
● Cabezal de presión
● Patrón (si lo hay)

Figura 6. Panel de propiedades del yacimiento

7.3.3. Tanques
El panel “Propiedades de tanques” (fig. 7) permite al usuario establecer las propiedades predeterminadas del tanque, que se
asignarán a cada tanque recién creado:
● Delta Z
● Nivel inicial
● Nivel mínimo
● Nivel máximo
● Diámetro
● Volume
● Curva (si hay alguna)

Figura 7. Panel de propiedades del tanque.

7.3.4. Tuberías
El panel “Propiedades de tuberías” (fig. 8) permite al usuario establecer las propiedades de tubería predeterminadas que
se asignarán a cada tubería recién creada:
● Demand
● Diámetro
● Pérdida menor
 Rugosidad. Según el material de la tubería: para cada material se presenta un rango de valores
viables.
● Estado.
Distancia de vértice: esta opción se utiliza para crear vértices intermedios a lo largo de cada
tubería, considerando la longitud real de las tuberías. Si el valor es 0, la tubería no tendrá
vértices intermedios.

Figura 8. Panel de propiedades de tubería.

7.3.5. Bombas
El panel “Propiedades de las bombas” (fig. 9) permite al usuario configurar las propiedades de bomba predeterminadas que se
asignarán a cada bomba recién creada:
● Parámetro (potencia o carga).
● Cabezal (solo activo cuando se selecciona el parámetro cabezal)
● Potencia (solo está activo cuando se selecciona el parámetro de potencia)
● Velocidad
● Patrón de velocidad (si lo hay)
● Estado inicial (abierto o cerrado)

Figura 9. Panel de propiedades de la bomba.

 7.3.6. Válvulas
El panel “Propiedades de válvulas” (fig. 10) permite al usuario establecer las propiedades de válvula predeterminadas que
se asignarán a cada válvula recién creada:
● Tipo (PRV, PSV, PBV, FCV, TCV, GPV)
● Presión
● Curva de pérdida de carga (solo activa con válvulas GPV)
● Pérdida menor
● Estado (ninguno, abierto, cerrado)

Figura 10. Panel de propiedades de la válvula.

7.4. Panel de opciones

El panel de opciones (fig. 11) permite configurar las opciones generales de simulación de EPANET. Incluye seis botones para acceder a

seis cuadros de diálogo que permiten al usuario configurar propiedades relacionadas con:

● Hidráulica
● Calidad
● Reacciones
● Tiempos
● Energía
● Informe
Los paneles se detallan en las siguientes secciones.

Figura 11. Panel de opciones.

 7.4.1. Hidráulica
El panel de opciones "Hidráulica" (fig. 12) contiene las propiedades principales del proyecto. También se muestra al crear
un nuevo proyecto.
El sistema de unidades seleccionado (SI métrico o imperial) definirá las unidades utilizadas en todos los controles del
complemento.

Figura 12. Panel de opciones hidráulica.

7.4.2. Calidad
El panel de opciones “Calidad” contiene las propiedades relacionadas con la calidad del agua (fig. 13).
 Figura 13. Panel de opciones de calidad.

7.4.3. Reacciones
El panel de opciones “Reacciones” contiene las propiedades relacionadas con las reacciones (fig. 14).

Figura 14. Panel de opciones de reacciones.

7.4.4. Tiempos
El panel de opciones “Horarios” contiene las propiedades relacionadas con la configuración del tiempo (fig. 15).
 Figura 15. Panel de opciones de tiempos.

7.4.5. Energía
El panel de opciones “Energía” contiene las propiedades relacionadas con la energía (fig. 16).

Figura 16. Panel de opciones de energía.

7.4.6. Informe
El panel «Informe» contiene las propiedades relacionadas con los informes (fig. 17)
 Figura 17. Panel de opciones de informe.

7.5. Panel de herramientas

El panel de herramientas (fig. 18) recoge diversas herramientas. Estas incluyen:

Un botón para crear nuevas capas vacías para los seis tipos de elementos de red. Normalmente, estas
capas se crean automáticamente al crear un nuevo proyecto o al abrir uno existente, por lo que el
uso de esta herramienta es bastante limitado.
● Un cuadro de texto para establecer la tolerancia de ajuste utilizada por las herramientas de edición de red.

● Un botón para acceder al editor de patrones (ver más abajo).

● Un botón para acceder al editor de curvas (ver más abajo)

Figura 18. Panel Herramientas.

7.5.1. Editor de patrones

El editor de patrones se utiliza para crear y administrar patrones que se utilizarán como propiedades de
elementos de red.
El editor (fig. 19) muestra la lista de patrones existentes (si los hay) y un conjunto de botones para:
● Crea un nuevo patrón desde cero.
● Importar patrones desde un archivo inp.
● Guardar el patrón editado actualmente.
● Eliminar el patrón actualmente seleccionado.

El patrón se puede dibujar agregando filas a la tabla y configurando los valores multiplicadores deseados.
 Figura 19. Editor de patrones.

7.5.2. Editor de curvas

El editor de curvas se utiliza para crear y gestionar curvas que se usarán como propiedades de elementos de red. El
editor (fig. 20) muestra la lista de curvas existentes (si las hay) y un conjunto de botones para:
● Crea una nueva curva desde cero.
● Importar curvas desde un archivo inp .

● Guardar la curva editada actualmente.

● Eliminar la curva seleccionada actualmente.

La curva se puede dibujar agregando filas a la tabla y estableciendo los valores deseados en ambas columnas. Las
unidades de los valores dependen del tipo de curva seleccionado:
● Tipo “Volumen”: altura y volumen.
● Tipo “Bomba”: caudal y altura.
● Tipo “Eficiencia”: flujo y eficiencia.
● Tipo “Pérdida de carga”: caudal y pérdida de carga.
 Figura 20. Editor de curvas.

7.6. Panel de EPANET

El panel de EPANET (fig. 21) contiene solo dos botones:
El botón "Iluminación" permite ejecutar una simulación de EPANET. Al pulsarlo, se le solicita que seleccione un
archivo de entrada que se utilizará como entrada en EPANET. A continuación, se iniciará la simulación y la
salida de la consola de EPANET se mostrará en el cuadro de texto inferior.
● El botón “Analizador de salida” muestra la herramienta utilizada para analizar las salidas de la simulación (ver a
continuación).
 Figura 21. Panel EPANET.

7.6.1. Analizador de salida

El analizador de salida se utiliza para inspeccionar los resultados de la simulación. Utiliza como entrada el archivo de
salida generado por EPANET al final de la simulación y consta de dos secciones:
La sección "Gráficos" (fig. 22) muestra gráficamente los valores de las variables seleccionadas a lo largo
del tiempo para los elementos de red seleccionados por el usuario (por lo tanto, es posible
comparar los valores de varias variables para varios elementos). Las variables incluyen demanda,
carga, presión y calidad para los nodos, y caudal, velocidad, pérdida de carga y calidad para los
enlaces.
La sección "Mapas" (fig. 23) permite crear mapas temáticos de la red en un periodo de simulación
determinado. Los colores de los elementos de la red dependen del valor de la variable seleccionada.
Figura 22. Analizador de salida - Gráficos.
 Figura 23. Analizador de salida - Mapas.

8.2
9. 2
10. 2