GISVIEW User Manual

3D/2D modelling suite for integral water solutions
DR
AF
T
Delft3D
GISView
User Manual
DR
AF
T
T
DR
AF
GISVIEW
Presentation of results in a GIS
User Manual
Hydro-Morphodynamics
Version: 1.04
Revision: 30932
25 December 2014
DR
AF
T
GISVIEW, User Manual
Published and printed by:
Deltares
Boussinesqweg 1
2629 HV Delft
P.O. 177
2600 MH Delft
The Netherlands
For sales contact:
telephone: +31 88 335 81 88
fax:
+31 88 335 81 11
e-mail:
[email protected]
www:
http://www.deltaressystems.nl
telephone:
fax:
e-mail:
www:
+31 88 335 82 73
+31 88 335 85 82
[email protected]
http://www.deltares.nl
For support contact:
telephone: +31 88 335 81 00
fax:
+31 88 335 81 11
e-mail:
[email protected]
www:
http://www.deltaressystems.nl
Copyright © 2014 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
1
1
1
2 Introduction to GISVIEW
2.1 Short description of the program functionality . . . . . . . . . . . . . . . . .
2.2 Installing the program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3
3
3
3 Getting started
3.1 Starting GISVIEW/ArcMap . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.2 Quitting the program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5
5
6
.
.
.
.
7
7
7
9
10
5 Remarks
5.1 Listing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
13
13
References
15
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
DR
AF
4 Describing the user interface
4.1 Introduction . . . . . . .
4.2 Get results . . . . . . . .
4.3 View results . . . . . . .
4.4 View vectors . . . . . . .
T
1 A guide to this manual
1.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.2 Typographical conventions . . . . . . . . . . . . . . . . . . . . . . . . . . .
Deltares
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
iii
DR
AF
T
GISVIEW, User Manual
iv
Deltares
List of Figures
List of Figures
2.1
System architecture of Delft3D . . . . . . . . . . . . . . . . . . . . . . . . .
3
3.1
User interface of ArcMap . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5
4.1
4.2
4.3
4.4
4.5
GISVIEW toolbar . . . . . . . . . . . . . . . . .
File selection window to open Delft3D result files
Selection window for parameter, time and layer .
Vector properties window . . . . . . . . . . . . .
Grid and vector view . . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
7
8
8
11
12
DR
AF
T
.
.
.
.
.
Deltares
v
DR
AF
T
GISVIEW, User Manual
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.
T
Chapter 3: Getting started, it is described how to start and quit the program, together with
the first steps using the program.
DR
AF
Chapter 4: Describing the user interface, provides a detailed description of the User Interface.
Chapter 5: Remarks, gives some remarks about this application.
1.2
Typographical conventions
Throughout this manual, the following conventions in text formats help you to distinguish between different types of text elements.
Example
Description
Waves
Boundaries
Title of a window or sub-window.
Sub-windows are displayed in the Module window and
cannot be moved.
Windows can be moved independently from the Module 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>
<siu.mdw>
Directory names, filenames, and path names are expressed between angle brackets, <>. For the Linux
and UNIX environment a forward slash (/) is used instead of the backward slash (\) for PCs.
Deltares
1
GISVIEW, User Manual
Example
Description
“27 08 1999”
Data to be typed by you into the input fields are displayed between double quotes.
Selections of menu items, option boxes etc. are described as such: for instance ‘select Save and go to
the next window’.
delft3d-menu
Commands to be typed by you are given in the font
Courier New, 10 points.
Units are given between square brackets when used
next to the formulae. Leaving them out might result in
misinterpretation.
DR
AF
[m/s] [-]
T
User actions are indicated with this arrow.
2
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
R
R
R
environment of ArcMap
(a product of ESRI
ArcGIS
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).
T
GISVIEW is a postprocessing program of Delft3D and is part of the visualisation tools. Figure 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
(e.g. parameters) of the Delft3D programs.
DR
AF
Till now, files of the type Communication file, Hydrodynamic map file, Waves map file, Sediment transport map file can be used.
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
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.
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
GISVIEW, User Manual
This new toolbar is used by each Delft3D program, which can be run in the ArcMap environment. In the left part of the toolbar you can choose the program you want to work with from a
drop down menu.
DR
AF
T
Remark:
Delft3D should be installed after ArcMap.
4
Deltares
3 Getting started
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.
T
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.
So first you start to select GISVIEW.
DR
AF
3.1
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:
Deltares
5
GISVIEW, User Manual
When you are clicking commands or buttons of the toolbar of GISVIEW, you have access to the program GISVIEW.
When clicking on the menus and tools of the ArcMap user interface, you are using
ArcMap.
Quitting the program
Just quit the ArcMap program to quit also GISVIEW.
T
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.
DR
AF
3.2
6
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.
T
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 containing Delft3D results. This menu has two other items to change the size of the drawn vectors
and to draw yes/no the vector field.
4.2
DR
AF
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.
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, 2013; WAVE, 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 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 members 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.
Figure 4.1: GISVIEW toolbar
Deltares
7
DR
AF
T
GISVIEW, User Manual
Figure 4.2: File selection window to open Delft3D result files
Figure 4.3: Selection window for parameter, time and layer
8
Deltares
Describing the user interface
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
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.
T
You can select a parameter at one layer and select several time steps. The attribute names
are different (PXX_TXX_LXX).
DR
AF
Using the OK button the result file is read to compose a dataset and this dataset is transformed 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,
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.
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).
So you have the concept of the well-known shape file, which has one geometry (shape) column 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
GISVIEW, User Manual
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 composed 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 velocities 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
T
button. When using this command a result layer (named as D3D_result. . .) must be
the active layer.
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.
DR
AF
4.4
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.
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
10
Deltares
T
Describing the user interface
Figure 4.4: Vector properties window
DR
AF
Delft3D grid and multiplied by their value. Using this vector scale
you can draw the most suitable vector field in the map.
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
DR
AF
T
GISVIEW, User Manual
Figure 4.5: Grid and vector view
12
Deltares
5 Remarks
T
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 upcoming 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.
DR
AF
5.1
Deltares
13
DR
AF
T
GISVIEW, User Manual
14
Deltares
References
Delft3D-FLOW, 2013. Delft3D-FLOW User Manual. Deltares, 3.14 ed.
DR
AF
T
WAVE, 2013. Delft3D-WAVE User Manual. Deltares, 3.03 ed.
Deltares
15
DR
AF
T
GISVIEW, User Manual
16
Deltares
DR
AF
T
T
DR
AF
PO Box 177
2600 MH Delft
Rotterdamseweg 185
2629 HD Delft
The Netherlands
+31 (0)88 335 81 88
[email protected]
www.deltaressystems.nl