See discussions, stats, and author profiles for this publication at: https://www.researchgate.

net/publication/323275871

Compilación del Sistema de Modelado Numérico DELFT 3D Open Source para

Microsoft Windows

Presentation · February 2018

CITATIONS READS
0 90

Some of the authors of this publication are also working on these related projects:

piezoelectric sensor to quantify aeolian sand transport View project

CEMIE-Océano View project

All content following this page was uploaded by Gabriel Ruiz Martínez on 20 February 2018.

The user has requested enhancement of the downloaded file.

 Compilación

del Sistema de Modelado Numérico

DELFT 3D
para Microsoft Windows

Presentación para el Taller de modelación numérica costera

que imparte la Dr. Cecilia Enríquez, UNAM- Unidad Académica Sisal

Gabriel Ruiz Martínez

Cinvestav, Mérida 1
Qué software necesitamos?
Código fuente del sistema de modelado Delft 3d

Microsoft Visual Studio

Intel Fortran Compiler (Intel Parallel Studio)

Tortoise SVN

Python

Gabriel Ruiz Martínez 2

Que versiones requerimos?
Versión reciente más estable (para Febrero del 2018 la versión más
estable era la 7545, revisar: https://oss.deltares.nl/web/delft3d/release-notes)

Para esta presentación se utilizarán el código fuente de la versión 7545 y las siguientes
versiones:

Microsoft Visual Studio Community x86 2015

Intel Fortran Compiler: Intel Parallel Studio XE 2016, Update 4

Tortoise SVN (Versión más reciente)

Python 2.7

Gabriel Ruiz Martínez 3

 Que versiones requerimos?

Microsoft Visual Studio (VS) e Intel

Fortran Compiler (Fortran) son
Software Comercial Libre
versiones comerciales, lo más
recomendable es que se utilicen las
versiones profesionales (previamente
compradas); de lo contrario, se
pueden descargar y usar las versiones
“demo” (try free) para realizar la
compilación, sin embargo debe
considerarse que estas versiones
tienen funciones limitadas, que
pudieran generar errores durante la
compilación.

Gabriel Ruiz Martínez 4

Orden de instalación de software
Posibilidad de dificultad en el
Python proceso de instalación

No dificultades

Un poco de
dificultad

Posibilidad de
Tortoise SVN presentar
complicaciones

Visual Studio

Fortran

Gabriel Ruiz Martínez 5

Orden de uso de software

Tortoise SVN

Posibilidad de presentarse
conflictos durante el uso:

Sin conflictos

Python Posible conflicto

Alta posibilidad
De
conflictos

Visual Studio

Gabriel Ruiz Martínez 6

Paso 1. Registrarse en Deltares
Para descargar el código fuente de Delft 3d, es necesario registrarse en su página para
accesar al repositorio de Deltares. El registro se realiza desde la página web de Delft 3d
(https://oss.deltares.nl/web/delft3d/home)

Gabriel Ruiz Martínez 7

Paso 1. Registrarse en Deltares
Proporcionar los datos para el registro:

Gabriel Ruiz Martínez 8

Paso 2. Descargar el código fuente
Ingresamos al repositorio de Deltares con la siguiente dirección:
http://svn.oss.deltares.nl

Gabriel Ruiz Martínez 9

Paso 2. Descargar el código fuente
Ingresamos al vínculo de Delft 3d y proporcionamos nuestro nombre de usuario y
clave:

Hacer click sobre el vínculo para

que aparezca la ventana de
verificación de identidad

Gabriel Ruiz Martínez 10

Paso 2. Descargar el código fuente
Al ingresar al repositorio de Delft 3d, nos ubicamos en la carpeta trunk

Gabriel Ruiz Martínez 11

Paso 2. Descargar el código fuente
En la barra de direcciones del navegador de internet, vamos a editar la dirección url y
borramos trunk/ y lo sustituimos con tags/
Oprimir enter al finalizar la edición de la dirección y desplazarse al final de la página
web.

Ingresar al penúltimo vínculo de la página (donde se almacena la última versión

estable del código fuente). Copiar la dirección del vínculo de la barra de
direcciones del explorador.

Gabriel Ruiz Martínez 12

Paso 2. Descargar el código fuente
En el explorador de Windows, preferentemente nos ubicamos en el disco C, creamos
una carpeta nueva y le agregamos el nombre de delft3d_rev7545. En esta carpeta
descargaremos los archivos fuente.

Gabriel Ruiz Martínez 13

Paso 2. Descargar el código fuente
Ingresamos en la carpeta recién creada y dando un click derecho en el área de nombre
de archivos, desplegamos el menú contextual donde elegimos la instrucción Tortoise
SVN, se abre otro menú contextual, donde seleccionamos Export…

Click derecho en el mouse para desplegar

Gabriel Ruiz Martínez 14

Paso 2. Descargar el código fuente
Export… abre una ventana de Tortoise SVN donde deberemos pegar la dirección url
que contiene la versión de delft 3d que deseamos descargar, en este caso la ver. 7545.
Oprimir el botón ok para iniciar la descarga de los archivos.

Pegar la dirección url del repositorio de

deltares de la versión del código fuente
que deseamos descargar

Oprimr este botón para comenzar la

descarga de los archivos
Gabriel Ruiz Martínez 15
Paso 2. Descargar el código fuente
Al oprimir el botón de ok, los archivos comienzan a descargarse en nuestra
computadora. El tiempo de descarga varia según la velocidad del internet. Al terminar
la descarga Tortoise nos despliega un mensaje, debajo del cuadro de descarga,
indicando que la descarga ha finalizado.

Gabriel Ruiz Martínez 16

Paso 3. Generación de archivos *.sln
El siguiente paso a realizar es la creación de los archivos *.sln que VS requiere para
compilar el sistema de modelaje. Para ello, necesitaremos abrir una sesión de trabajo en
Python. Para la generación de los archivos del proyecto de VS, utilizaremos el IDLE de
Python(1)

(1) Python 2.7 de Ananconda

Gabriel Ruiz Martínez 17
Paso 3. Generación de archivos *.sln
Al abrir el IDLE de Python, el “workspace” se localiza en una carpeta distinta a la
carpeta donde se encuentra el archivo de Python que Deltares nos proporciona. Es por
esta razón que debemos cambiar la ubicación del “workspace” y ubicarnos en la carpeta
donde se localiza el archivo “prepare_sln.py” (el archivo “prepare_sln.py” se
encuentra en la carpeta src de los archivos que descargamos del repositorio de
Deltares).

En Python necesitamos las funciones de la librería o módulo OS que nos permitan

desplazarnos entre carpetas. Es por ello, que cargaremos la librería de la manera
siguiente:
import os

Para verificar en que carpeta nos encontramos, usaremos:

os.getcwd()

Para cambiarnos a la carpeta que nos interesa vamos a usar la función chdir:
os.chdir('C:\\delft3d_rev7545\\src')

Es importante que identifiques que la ruta de acceso se encuentra delimitada por

comilla simple y en la dirección de las carpetas se usa doble barra invertida.

Gabriel Ruiz Martínez 18

Paso 3. Generación de archivos *.sln
Verificamos que efectivamente nos encontremos en la carpeta src:
os.getcwd()

Se puede visualizar un listado de los archivos y carpetas que se ubican dentro de la

carpeta con la siguiente instrucción:
Os.listdir(os.getcwd())

Si el cambio de dirección de carpetas fue correcto, en la lista de archivos podemos ver

el archivo “prepare_sln.py”.

El siguiente paso es ejecutar el script de Python, para ello escribiremos el siguiente

comando:
execfile('prepare_sln.py')

Al ejecutarse el script te Python se abre una interfase gráfica de usuario donde debemos
especificar la versión de VS y Fortran que se encuentran instaladas en nuestra
computadora. Para el caso de esta presentación se eligió la opción VS 2015, Update 3.0
+ Net FrameWork 4.6 y IFORT16: Intel Parallel Studio XE2015 Update 4.

Al oprimir el botón de Apply, en el IDLE se visualizará la ejecución del script.

Gabriel Ruiz Martínez 19
Paso 3. Generación de archivos *.sln

Gabriel Ruiz Martínez 20

Paso 3. Generación de archivos *.sln

Gabriel Ruiz Martínez 21

Paso 3. Generación de archivos *.sln
Python al encontrar un error en el script detiene la ejecución del programa. En IDLE
aparece un mensaje descriptivo acerca del error, donde se nos indica cuál es el motivo
del error y nos proporciona la línea del archivo donde se presenta el conflicto.

Se nos indica que existe un error generado por

la línea 196 del archivo ‘prepare_sln.py’. El
nombre del archivo no se encuentra definido

Gabriel Ruiz Martínez 22

Paso 3. Generación de archivos *.sln
Si al ejecutar el script de Python nos aparece el error:
NameError: global name '__file__' is not defined

Realizamos los siguiente:

En la barra de menús del IDLE de Python, seleccionamos File - Open…
En la ventana Abrir, buscamos y seleccionamos el archivo “prepare_sln.py”. Oprimir
botón de abrir.
Usando las teclas de desplazamiento, nos ubicamos en la línea que se indica en el
mensaje de error.

Gabriel Ruiz Martínez 23

Paso 3. Generación de archivos *.sln
Sustituimos:
'__file__'
Por:
'prepare_sln.py'

Gabriel Ruiz Martínez 24

Paso 3. Generación de archivos *.sln
Guardamos la edición, para posteriormente oprimir la tecla F5 (RUN).
Vuelve a abrirse la ventana donde se nos solicita las versiones de VS y Fortran,
repetimos el proceso mencionado en la diapositiva 19. Si la ejecución se lleva a cabo sin
errores, en el IDLE visualizaremos una serie de mensajes donde se indica que los
procesamiento de los archivos ha finalizado. Cerrar la interfase gráfica de usuario de
Python y salir del IDLE.

Gabriel Ruiz Martínez 25

Paso 4. Compilación del Proyecto
Para compilar el sistema de modelaje Delft 3d, el único archivo *.sln que vamos a usar
es: delft3d_open.sln. Abrimos VS y desde la barra de menús seleccionamos:
File Open… Project/Solution...

Gabriel Ruiz Martínez 26

Paso 4. Compilación del Proyecto
En la ventana de Open Project seleccionamos el archivo delft3d_open.sln. Oprimir
el botón de abrir.

Gabriel Ruiz Martínez 27

Paso 4. Compilación del Proyecto
Esperamos a que concluya el proceso de carga de los archivos del proyecto en VS.

Gabriel Ruiz Martínez 28

Paso 4. Compilación del Proyecto
Antes de realizar la compilación del sistema de modelaje es necesario cambiar la
configuración de la compilación de Debug a Release, tal como se indica en la figura.

Gabriel Ruiz Martínez 29

Paso 4. Compilación del Proyecto
Posteriormente cambiamos la arquitectura de los archivos ejecutables que se obtendrán
de Win32 a x64 (para Windows 7, 8 y 10).

Gabriel Ruiz Martínez 30

Paso 4. Compilación del Proyecto
Finalmente, para compilar el sistema de modelado, elegimos de la barra de menús
Build Build Solution.
Y esperamos a que concluya el proceso de compilación.

Gabriel Ruiz Martínez 31

Paso 4. Compilación del Proyecto
Cuando concluye la compilación del sistema de modelaje, los archivos que fueron
generados se encuentran en la carpeta bin, dentro de la carpeta donde se almacenaron
los archivos que se descargaron del repositorio de Deltares.

Los archivos compilados se encuentran en la

carpeta bin, la cual a su vez contiene una
carpeta win64, donde se localizan los
diferentes módulos que componen el sistema
de modelaje Delft 3d.

Gabriel Ruiz Martínez 32

Paso 5. Agregar archivos compilados a la
GUI de Delft 3d
Como paso final, es necesario AGREGAR los archivos y carpetas que se generaron
durante el proceso de compilación a sus carpetas similares que se encuentran en la
carpeta con la GUI. Se recomienda no borrar los archivos que se encuentren en las
carpetas de la, en todo caso si existen archivos con el mismo nombre sobrescribirlos

Los archivos obtenidos de la

compilación, deberán agregarse a
su carpeta similar en la carpeta de
instalación de la GUI, por ejemplo,
Todo el contenido de la carpeta
flow2d3d (compilación) lo
agregamos a la carpeta flow2d3d
(GUI).

Gabriel Ruiz Martínez 33

 Esta presentación fue realizada siguiendo las indicaciones mencionadas en:

https://oss.deltares.nl/web/delft3d/source-code

Se recomienda consultar el sitio web de manera frecuente, ya que la secuencia de pasos y

el software que se requiere, tienden a cambiar debido a la evolución misma del sistema de
modelaje Delft 3d.

Gabriel Ruiz Martínez 34

View publication stats