GUÍA PARA COMPILAR LA LIBRERÍA E INTERFAZ

GRÁFICA DE EPANET 2.2

Autor:
Oscar Vegas Niño

Agosto, 2020
 Compilar librería e interfaz gráfica de Epanet 2.2
__________________________________________________________

INTRODUCCIÓN

Desde la OWA1 (Open Water Analytics), conformada por una comunidad de voluntarios
investigadores y desarrolladores de software de código libre de EPANET y SWMM, vienen
trabajando en la implementación de nuevas funciones a la librería y en una nueva Interfaz
Gráfica de Epanet totalmente programada en Python.
Asimismo, desde la página web de la Agencia de Protección Medioambiental de los Estados
Unidos de Norte América (USEPA2) han actualizado el manual de usuario de Epanet, el código
fuente de la interfaz gráfica (para ser compilada con Delphi 10.x), y la toolkit. Todos hasta la
versión 2.2.
El código fuente de la librería como de la interfaz gráfica de Epanet es de libre acceso, lo cual,
permite a otros investigadores y/o programadores personalizar sus propios desarrollos.
Esta guía pretende ayudar a compilar la librería e interfaz gráfica a través de una secuencia de
pasos que a continuación se describen.

COMPILAR LA LIBRERÍA DE EPANET 2.2

1. Descargar la carpeta comprimida “EPANET-dev”

Ir al siguiente enlace: https://github.com/OpenWaterAnalytics/EPANET
Nota: No es necesario tener una cuenta en el repositorio GitHub.

1
http://wateranalytics.org/
2
https://www.epa.gov/water-research/epanet
_________________________
Oscar Vegas Niño
 Compilar librería e interfaz gráfica de Epanet 2.2
__________________________________________________________

2. Descomprimir la carpeta “EPANET-dev”

La figura siguiente muestra el contenido de la carpeta descomprimida.

3. Instalar Visual Studio Community 2019

Podrás descargar la aplicación desde el siguiente enlace:
https://visualstudio.microsoft.com/es/thank-you-downloading-visual-
studio/?sku=Community&rel=16
En el proceso de instalación, seleccionar las opciones marcadas en rectángulo en el
orden indicado (ver figura). También verás en la imagen otras opciones marcadas como
Desarrollo de Python, Desarrollo de escritorio de .NET, y Desarrollo de la plataforma
universal de Windows (Es opcional).
Si tienes dudas en el proceso de instalación de Visual Studio Community 2019, puedes
mirar el siguiente video a través de este enlace:
https://www.youtube.com/watch?v=S5IUGQJdTdc

_________________________
Oscar Vegas Niño
 Compilar librería e interfaz gráfica de Epanet 2.2
__________________________________________________________

4. Descargar la aplicación “CMake”

Dirigirse al siguiente enlace: https://cmake.org/download/
Dentro de la página web, vamos a descargar el fichero que se muestra marcado por el
rectángulo de color rojo de la siguiente figura

En el proceso de instalación, marcar la opción resaltada por el rectángulo de color rojo.

5. Abrir la aplicación CMake

Antes de utilizar la herramienta CMake, debemos crear una nueva carpeta llamada
“build” dentro de la carpeta descomprimida “EPANET-dev” (ver figura)

_________________________
Oscar Vegas Niño
 Compilar librería e interfaz gráfica de Epanet 2.2
__________________________________________________________

Ahora, abrimos la herramienta CMake y seleccionamos la carpeta “EPANET-dev” desde

el botón “Browse Source…”. Lo mismo hacemos con la carpeta “build” con el botón
“Browse build” (ver figura).

El siguiente paso, es dar al botón “Configure” y seleccionamos lo que está encerrado de

color rojo. La primera opción nos pide que elijamos la versión de Visual Studio que
tenemos instalado en nuestro ordenador, y la segunda opción nos pide que
seleccionemos la plataforma en que se va a utilizar la librería. Está la opción de x64 y
Win32.

_________________________
Oscar Vegas Niño
 Compilar librería e interfaz gráfica de Epanet 2.2
__________________________________________________________

Después de configurar las opciones, hacemos clic en el botón “Finish” y regresamos al

formulario principal (ver figura).

Finalmente, hacemos clic en el botón “Generate”

_________________________
Oscar Vegas Niño
 Compilar librería e interfaz gráfica de Epanet 2.2
__________________________________________________________

Si revisamos nuestra carpeta “build,” deberá tener las siguientes carpetas y ficheros
creados (ver figura)

6. Abrir el fichero EPANET.sln

En la carpeta “build” buscamos el fichero EPANET.sln, le damos doble clic y se abrirá
Visual Studio 2019. Para obtener la librería de Epanet, debemos de configurar el tipo de
plataforma para la que será compilada (x86, x64). En esta guía se hará para Win32(x86).
Desde la opción “Compilar”, ubicado en la barra de Menú, podemos acceder al
formulario administrador de configuración (ver figura).

Dentro del formulario de Administrador de configuración vamos a seleccionar las

siguientes opciones (ver figura):
▪ Configuración de soluciones activas: Release
▪ Plataforma de soluciones activas: Win32
▪ Compilación: podemos marcar todas las opciones de proyectos o sólo epanet2,
que será la librería que queremos compilar.

_________________________
Oscar Vegas Niño
 Compilar librería e interfaz gráfica de Epanet 2.2
__________________________________________________________

Para compilar los cinco proyectos posicionamos el cursor en el apartado que dice
Solución “EPANET” (5 de 5 proyectos), hacemos clic derecho y luego clic izquierdo en
compilar solución (ver figura)

Una vez compilado, en la ventana de salida de Visual Studio nos debe mostrar un
mensaje como el siguiente. Esto indica que todo a salido bien.
===== Compilar: 0 correctos, 0 incorrectos, 5 actualizados, 0 omitidos ======

_________________________
Oscar Vegas Niño
 Compilar librería e interfaz gráfica de Epanet 2.2
__________________________________________________________

Finalmente, dentro de la carpeta “Release” podemos ubicar la librería epanet2.ll

compilada. La figura siguiente, muestra la ruta de la máquina donde se guardó la librería
compilada (C:\Users\Redhisp2020\Downloads\EPANET-dev\build\bin\Release).

Compilar la Interfaz Gráfica de Epanet 2.2

1. Descargar código fuente GUI de Epanet

Desde la página de la USEPA descargaremos el código fuente de la Interfaz Gráfica de

Epanet y descomprimiremos la carpeta (https://www.epa.gov/water-research/epanet)

2. Descargar e instalar Delphi Community

Desde el siguiente enlace, podemos registrarnos y poder descargar la aplicación.

https://www.embarcadero.com/es/products/delphi/starter

Si necesitas ayuda, puedes mirar este video en YouTube:

https://www.youtube.com/watch?v=qRIwsNWeCpA

_________________________
Oscar Vegas Niño
 Compilar librería e interfaz gráfica de Epanet 2.2
__________________________________________________________

3. Descargar la componente TeeChart

Ir al siguiente enlace: https://www.steema.com/product/vcl y hacemos clic izquierdo en

el botón de color naranja que dice “Get Free Trial”.
De las opciones que se nos muestra, elegiremos la que está marcada en un rectángulo
de color rojo (ver figura).

El proceso de instalación es sencillo. En una de las etapas hay que seleccionar la versión
de Delphi instalado en nuestro ordenador. En mi caso, tengo instalado la versión Delphi
10.3 Rio (ver figura).

_________________________
Oscar Vegas Niño
 Compilar librería e interfaz gráfica de Epanet 2.2
__________________________________________________________

4. Copiar epanet2.dll en carpeta epanet2w

Al descomprimir la carpeta “epanet2.2-2.2.0” encontraremos cuatro subcarpetas. La

carpeta con la que vamos a trabajar para compilar el ejecutable de Epanet se llama
Delphi_GUI. Dentro de esta carpeta hay otras dos carpetas más: components y
epanet2w.
En la carpeta epanet2w dejaremos una copia de la librería de Epanet anteriormente
compilada (ver figura).

5. Generar paquete EPA

Dentro de la carpeta “components” hacemos doble clic izquierdo sobre el fichero Epa.
Se nos abrirá la aplicación Delphi.

En la ventana de proyectos, debemos ejecutar los siguientes pasos (ver figura):

_________________________
Oscar Vegas Niño
 Compilar librería e interfaz gráfica de Epanet 2.2
__________________________________________________________

Paso1: Posicionamos el cursor sobre Epa.bpl y hacemos clic derecho y nos aparece un
menú contextual flotante.
Paso2: Compilamos (clic sobre Compile)
Paso3: Construir el paquete (clic sobre build)
Paso4: Instalamos paquete (clic sobre Install)

Dentro de la carpeta “components”, se ha creado una carpeta de nombre Win32 (ver

figura) donde se encuentran almacenados unos ficheros que vamos a necesitar para
compilar el ejecutable de Epanet.

_________________________
Oscar Vegas Niño
 Compilar librería e interfaz gráfica de Epanet 2.2
__________________________________________________________

Ahora sólo queda guardar los cambios, y cerrar la aplicación

6. Abrir Epanet2w.dproj

Dentro de la carpeta epanet2w hay un fichero con el mismo nombre “Epanet2w”, al cual
le daremos doble clic izquierdo para abrirlo (ver figura).

El siguiente paso es configurar algunos directorios para poder generar el fichero

ejecutable de Epanet. Para ello, nos iremos al Menú Tools y haremos clic izquierdo en la
opción Options (ver figura).

_________________________
Oscar Vegas Niño
 Compilar librería e interfaz gráfica de Epanet 2.2
__________________________________________________________

En la ventana que se nos abrirá, iremos al apartado Delphi y seleccionaremos la opción

Library. Lo que haremos, es añadir a una lista los directorios epanet2w y components y
el directorio de los ficheros .dcu generados del paquete EPA (ver figura)

_________________________
Oscar Vegas Niño
 Compilar librería e interfaz gráfica de Epanet 2.2
__________________________________________________________

Primero, añadiremos los directorios que se encuentran enmarcados de color rojo de la

figura de abajo.

En segundo lugar, los directorios donde tengamos ficheros con extensión .dcu
Aquí también debemos añadir a la lista de directorios la ruta de la carpeta “epanet2w”,
que es donde se almacenaran los ficheros .dcu que se van a generar en el momento de
la compilación (ver figura).

Finalmente, salvamos todos los cambios y ya podemos generar nuestro ejecutable de

Epanet. Para ello, hacemos clic sobre el botón de color verde (ver figura)

Después de darle al botón verde, se mostrará Epanet (ver figura). Su aspecto no es del
todo correcto, para ello, tenemos que hacer un par de cambios sobre las barras de
botones.

_________________________
Oscar Vegas Niño
 Compilar librería e interfaz gráfica de Epanet 2.2
__________________________________________________________

Desde la ventana Structure de Delphi, seleccionaremos el objeto MapToolBar y

cambiaremos en la propiedad AutoSize a False. Del mismo modo para StdToolBar (ver
figura).

Con estos cambios, el aspecto final de nuestro ejecutable de Epanet será el siguiente:

_________________________
Oscar Vegas Niño