3D/2D modelling suite for integral water solutions

Delft3D

T
AF
DR

GISView

User Manual
DR
AF
T
 T
GISVIEW
AF
Presentation of results in a GIS

User Manual
DR

Hydro-Morphodynamics

Version: 1.04
SVN Revision: 52614

June 8, 2018
GISVIEW, User Manual

T
AF
DR

Published and printed by:

Deltares telephone: +31 88 335 82 73
Boussinesqweg 1 fax: +31 88 335 85 82
2629 HV Delft e-mail: info@deltares.nl
P.O. 177 www: https://www.deltares.nl
2600 MH Delft
The Netherlands

For sales contact: For support contact:

telephone: +31 88 335 81 88 telephone: +31 88 335 81 00
fax: +31 88 335 81 11 fax: +31 88 335 81 11
e-mail: software@deltares.nl e-mail: software.support@deltares.nl
www: https://www.deltares.nl/software www: https://www.deltares.nl/software

Copyright © 2018 Deltares

All rights reserved. No part of this document may be reproduced in any form by print, photo
print, photo copy, microfilm or any other means, without written permission from the publisher:
Deltares.
 Contents

Contents
List of Figures v

1 A guide to this manual 1

1.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.2 Typographical conventions . . . . . . . . . . . . . . . . . . . . . . . . . . 1

2 Introduction to GISVIEW 3
2.1 Short description of the program functionality . . . . . . . . . . . . . . . . . 3
2.2 Installing the program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

3 Getting started 5
3.1 Starting GISVIEW/ArcMap . . . . . . . . . . . . . . . . . . . . . . . . . . 5
3.2 Quitting the program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

T
4 Describing the user interface 7
4.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
4.2 Get results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
4.3 View results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4.4 View vectors . . . . . .
AF . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

5 Remarks 13
5.1 Listing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

References 15
DR

Deltares iii
GISVIEW, User Manual

T
AF
DR

iv Deltares
 List of Figures

List of Figures
2.1 System architecture of Delft3D . . . . . . . . . . . . . . . . . . . . . . . . 3

3.1 User interface of ArcMap . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

4.1 GISVIEW toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

4.2 File selection window to open Delft3D result files . . . . . . . . . . . . . . . 8
4.3 Selection window for parameter, time and layer . . . . . . . . . . . . . . . . 8
4.4 Vector properties window . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
4.5 Grid and vector view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

T
AF
DR

Deltares v
GISVIEW, User Manual

T
AF
DR

vi Deltares
 1 A guide to this manual

1.1 Introduction
In order to make this manual more accessible, a brief description of the contents of each of
the chapters will be given here.

This manual describes the operation of GISVIEW.

Chapter 2: Introduction to GISVIEW, a short overview of the program and the general
functionality is given.

Chapter 3: Getting started, it is described how to start and quit the program, together with
the first steps using the program.

T
Chapter 4: Describing the user interface, provides a detailed description of the User Inter-
face.

Chapter 5: Remarks, gives some remarks about this application.

1.2
AF
Typographical conventions
Throughout this manual, the following conventions in text formats help you to distinguish be-
tween different types of text elements.

Example Description

Module Title of a window or a sub-window are in given in bold.

Project Sub-windows are displayed in the Module window and
cannot be moved.
DR
Windows can be moved independently from the Mod-
ule window, such as the Visualisation Area window.

Save Item from a menu, title of a push button or the name of

a user interface input field.
Upon selecting this item (click or in some cases double
click with the left mouse button on it) a related action
will be executed; in most cases it will result in displaying
some other (sub-)window.
In case of an input field you are supposed to enter input
data of the required format and in the required domain.

<\tutorial\wave\swan-curvi> Directory names, filenames, and path names are ex-

<siu.mdw> pressed between angle brackets, <>. For the Linux
and UNIX environment a forward slash (/) is used in-
stead of the backward slash (\) for PCs.

“27 08 1999” Data to be typed by you into the input fields are dis-
played between double quotes.
Selections of menu items, option boxes etc. are de-
scribed as such: for instance ‘select Save and go to
the next window’.

Deltares 1 of 18
GISVIEW, User Manual

Example Description

delft3d-menu Commands to be typed by you are given in the font

Courier New, 10 points.

In this User manual, user actions are indicated with this

arrow.

[m s−1 ] [−] Units are given between square brackets when used
next to the formulae. Leaving them out might result in
misinterpretation.

T
AF
DR

2 of 18 Deltares
 2 Introduction to GISVIEW

2.1 Short description of the program functionality

The program GISVIEW makes it possible to show results from Delft3D programs in the GIS
environment of ArcMap
R
(a product of ESRI
R
ArcGIS
R
suite). So Delft3D results are shown
1
into maps .

The program is a so-called extension of ArcMap and thus is used within ArcMap (and not as
a stand-alone program).

GISVIEW is a postprocessing program of Delft3D and is part of the visualisation tools. Fig-
ure 2.1 shows the suite of Delft3D programs.

It is supposed that you are familiar with the ArcMap program as well with the calculation results

T
(e.g. parameters) of the Delft3D programs.

Till now, files of the type Communication file, Hydrodynamic map file, Waves map file, Sedi-
ment transport map file can be used.
AF
From these files you can select parameters, times and layers, which is done in the same way
as in the program GPP. After this selection a dataset is composed and shown in the GIS.
The underlying result data is transformed into GIS data (a shape file) and is presented and
available as a layer in ArcMap.

So you have all possibilities of ArcMap to classify the results, to print resulting maps, etc.

2.2 Installing the program

Installing the program is part of the installation of the Delft3D program suite. It is described in
DR
the manual that is supplied with these software.

As a result of the installation, the program becomes a known extension of ArcMap. Its toolbar
(the user interface) is available and active in the user interface of ArcMap. The toolbar is
named ”Delft3D-GISPlugins”. The program uses environment variables, which are set by the
Delft3D installation.

This new toolbar is used by each Delft3D program, which can be run in the ArcMap environ-
ment. In the left part of the toolbar you can choose the program you want to work with from a
1
ArcMap, ESRI, ArcGis, ArcMap are trade marks of ESRI Inc., Redlands, California, USA. They are used in
the manual because of the close relation of the program GISVIEW and the ESRI program ArcMap.

Overall Menu

Flow/Mor Wave Water Quality Ecology Particles/Oil

Tools

Figure 2.1: System architecture of Delft3D

Deltares 3 of 18
GISVIEW, User Manual

drop down menu.

Remark:
 Delft3D should be installed after ArcMap.

T
AF
DR

4 of 18 Deltares
 3 Getting started

3.1 Starting GISVIEW/ArcMap

Because of GISVIEW is an ArcMap extension you start ArcMap from an icon on your desktop,
or via the Start menu. Then GISVIEW can be used by a specific toolbar. The toolbar is named
”Delft3D-GISPlugins”. In order to work with GISVIEW, the result files of a Delft3D calculation
should be available.

It is supposed you have the knowledge to activate or de-activate toolbars. As you know,
ArcMap stores the latest user interface including the visible toolbars. So the next time it
comes up with this user interface, you have composed.

Figure 3.1 shows a user interface of ArcMap. You see the toolbar containing the text “GISVIEW.
This is a drop-down list to choose the Delft3D plugin you want to work with in ArcMap.

T
 So first you start to select GISVIEW.

AF
DR

Figure 3.1: User interface of ArcMap

 Then the next step is to read a result file, by clicking on the menu Get results.
 Then click on item Add layer from Delft3D result files. A file selection box will come up.

Navigate to a directory and choose a result file. A new window pops up and

 choose a parameter, a time and a layer.

 use the button Add to add your selection to the attribute list.
 click the OK button, and as a result you will see a new layer in the map.

Now the results can be classified in the map.

At the right side of the menus in the toolbar you find some bottons to get quick access for
some commands. Move the mouse cursor slowly over the button, to see which command it is.

This is just a short description, and chapter 4 describes detailed the user interface.

Remarks:
 When you are clicking commands or buttons of the toolbar of GISVIEW, you have ac-
cess to the program GISVIEW.

Deltares 5 of 18
 GISVIEW, User Manual

 When clicking on the menus and tools of the ArcMap user interface, you are using
ArcMap.

3.2 Quitting the program

Just quit the ArcMap program to quit also GISVIEW.

You can leave the program by selecting another Delft3D program (if available) in the drop
down list of the toolbar. In this way you can get back to GISVIEW by selecting it again.

T
AF
DR

6 of 18 Deltares
 4 Describing the user interface

4.1 Introduction
The user interface of GISVIEW is the toolbar as shown in Figure 4.1.

The program GISVIEW has been selected from the drop down menu at the left side in this
toolbar, as already mentioned in previous chapters.

The toolbar has the menu Get results to read a result file of Delft3D. After all actions a layer
(based on a shape file) is added to the layers of the map. In this way you can add more layers
from one ore more result files of Delft3D to the map.

The second menu Vectors can be used to view vectors from an already existing layer contain-
ing Delft3D results. This menu has two other items to change the size of the drawn vectors

T
and to draw yes/no the vector field.

For your convenience some often used menu items (commands) are also available as a button
(the three buttons at the right side). When moving the mouse cursor slowly over these buttons
you see the underlying command.
AF
4.2 Get results
The menu Get results has the menu item Add layer from Delft3D result files. Using this
command a file selection window comes up. In this file window you can navigate to a directory
with result files. Till now the file types Communication file, Hydrodynamic map file, Waves map
file, Sediment transport map file can be used (Delft3D-FLOW UM, 2013; WAVE UM, 2013).
The file window looks like Figure 4.2.

As you can see all known file types (<∗.dat>) can be shown and selected, or a specific
DR
known type can be shown and selected via the drop down list.

After a file has been selected the following window comes up, see Figure 4.3. With this
window you make the selection of parameter, time and layer from Delft3D. Each selection can
be added to a list and becomes an attribute of the layer in the map.

Using your mouse cursor you can make a selection for parameter, time and layer, independent
of each other. Selecting a parameter updates the list of available times and layers for that
parameter.

The Add button adds your selection to the list of attributes. You can remove one or all mem-
bers of these list by the buttons Remove and Remove All.

The attributes in the above window get a generated name, which is at the left side in the
“Attribute” part. As you will see the names become PXX_TXX_LXX and a description after it.
These names become the attribute names of the layer in the map.

Note that these attribute names must be different in one layer (shape file), so they must
different here in the “Attribute” part. This is especially important when you select both current

Figure 4.1: GISVIEW toolbar

Deltares 7 of 18
GISVIEW, User Manual

T
AF Figure 4.2: File selection window to open Delft3D result files
DR

Figure 4.3: Selection window for parameter, time and layer

8 of 18 Deltares
 Describing the user interface

magnitude and current direction to draw flow vectors.

You can change this name by double clicking on it, type a new attribute name and confirm
with the Enter key.

You can use the F2 key for the same purpose after selecting a row in the list of attributes.

It is possible to compose a list of attributes for the layer (shape file) in different ways.

You can select a parameter at one layer and select several time steps. The attribute names
are different (PXX_TXX_LXX).

Using the OK button the result file is read to compose a dataset and this dataset is trans-
formed into GIS data (a shape file). The results now become a layer in ArcMap. These layers
get names like D3D_results. . . in the table of contents (TOC) of ArcMap. From this moment,

T
you have all the tools and possibilities of ArcMap to classify, colour, print etc. the attributes of
this GIS-data. You can ask for attribute values by using the I-tool of ArcMap.

The above actions including the OK button, can be performed several times and each time a
new layer of the composed dataset is added to the map in ArcMap.
AF
Therefore it is also possible to put results of different result files from Delft3D into separate
layers (shape files) to the map.

Using the QUIT button nothing happens and you go back to the map in ArcMap.

Each selection of parameter, layer and time in the above window becomes an attribute value
of the GIS data. The geometry of the Delft3D grid of course is added to the GIS data. For
GISVIEW the curvilinear grid of the model is transformed into polygons in the GIS. Each
polygon (cell) has attribute value(s).
DR

So you have the concept of the well-known shape file, which has one geometry (shape) col-
umn and one ore more attribute columns.

4.3 View results

As described in section 4.2 results become layers in ArcMap. These layers have a name like
D3D_results. . .. From then on, you can use all the possibilities of ArcMap to classify (colour)
the results, to see the attribute table, to see attribute values of a polygon (=cell) by using the
I-tool etc. Even you can save these layers into your own shape file by exporting the data.

The geometry of the Delft3D results consist of polygons for each cell of the curvilinear grid.
Each polygon has attribute values.

To show the grid only, choose the “Hollow” colour and a value for the outline width.

Deltares 9 of 18
 GISVIEW, User Manual

4.4 View vectors

Vector values like current velocity are drawn by GISVIEW as arrows on the map. In order to
be able to do this the following actions have to be done.

 Vector values are also attribute values of the GIS data. So add these data to the com-
posed dataset. Read the actions in section 4.1 and see the figure in this paragraph. There
you will see the parameters current mag (horiz) and current dir. (horiz) are added to the
attributes list. Change their attribute names into convenient names if you add more veloc-
ities to this list. As mentioned in section 4.2 each attribute name must be unique.
 Use the OK button to add the composed dataset as a layer to the map. The layer (the
dataset) may contain vector values as well as scalair values.
 Use from the Vector menu the command Draw vectors from the results layer or use the
button. When using this command a result layer (named as D3D_result. . .) must be
the active layer.

T
 Now you get the following window to select the attribute name for magnitude and direction
of the vector value. Eventually use I-tool or attribute table of ArcMap to know the attribute
names.

AF
 Use OK button and the vectors will be drawn. When using the Cancel button the state of
the map does not change. It means when there are no vectors, you will see no vectors.
When there are vectors drawn, these vectors are drawn again.
DR

Drawing yes or no vectors, if their values are selected as mentioned above, can be done by
using the button or the command Draw yes/no the vectors from the Vector menu.

Note: each time just one vector belonging to a time and a Delft3D layer will be drawn. Of
course you can select new attribute values for the vector, belonging to another time and/or
Delft3D layer.

When using the command Change vector scale of the menu Vectors, you get a property
window about the vectors. See Figure 4.4. You will see the map layer and the attribute fields
of the currently drawn vectors.

Vectors will be drawn bij the program in such a way that the vector length is related to the size
of the Delft3D grid cell. This makes the map has no overlapping vectors (arrows).

However you can change the size of the arrows and the number of drawn arrows by clicking
the command Change vector scale of the menu Vectors. See Figure 4.4.

You see several properties related tot the vectors. You can fill in the last 2 properties.
Vector scale in GIS A factor for the vector scale. The length of the vectors in the map
becomes the factor multipied by the mininum cell diameter of the
Delft3D grid and multiplied by their value. Using this vector scale
you can draw the most suitable vector field in the map.

10 of 18 Deltares
 Describing the user interface

T
Figure 4.4: Vector properties window

AF
DR

Figure 4.5: Grid and vector view

Min. gap between vector points Give the minimum gap (in pixels) on the screen between
the start points of the vectors and this gap will be in all directions. So
the number of drawn arrows can be reduced. The value 0 means
that all vectors will be drawn. The gap is related to the screen and
not to the map scale. So when zooming in you will see more arrows
and when zooming out, less vectors.

Note: that the maximum size (value) of the vectors of all grid cells is given too.

See Figure 4.5 for an example.

If you want to know the size (value) of the vector use the I-tool of ArcMap, which shows you
the attribute values of a polygon (cell).

Deltares 11 of 18
GISVIEW, User Manual

T
AF
DR

12 of 18 Deltares
 5 Remarks

5.1 Listing
1 Till now, files of the type Communication file, Hydrodynamic map file, Waves map file,
Sediment transport map file can be used.
2 This version of GISVIEW uses an executable for file selection and selecting parameters,
times and layers from Delft3D calculations. All things go smoothly. However, if you move
the windows, the screen of ArcMap will not be refreshed. This will be improved in upcom-
ing releases.
3 Do not use the parameter “Model grid” from the window as shown in section 4.2 (Get
results). The program will crash. Instead use an attribute of the layer and the choose the
“Hollow” colour and a value for the outline width.
4 You see the attribute m and n which are grid indices of the curvilinear grid used internally
by Delft3D-FLOW.

T
AF
DR

Deltares 13 of 18
GISVIEW, User Manual

T
AF
DR

14 of 18 Deltares
References
Delft3D-FLOW UM, 2013. Delft3D-FLOW User Manual. Deltares, 3.14 ed.

WAVE UM, 2013. Delft3D-WAVE User Manual. Deltares, 3.03 ed.

T
AF
DR

Deltares 15 of 18
GISVIEW, User Manual

T
AF
DR

16 of 18 Deltares
DR
AF
T
 T
AF
DR

PO Box 177 +31 (0)88 335 81 88

2600 MH Delft sales@deltaressystems.nl
Rotterdamseweg 185 www.deltaressystems.nl
2629 HD Delft
The Netherlands