Delft3D-GISVIEW Presentation of results in a GIS User Manual
Part of Hydro-Morphodynamics Version:1.04
Revision:15423
18May2011
User Manual Delft3D-GISVIEW
Published and printed by:
Deltares
Rotterdamseweg185
p.o.box177
2600MH Delft
The Netherlands
telephone:+31883358273
fax:+31883358582
e-mail:info@deltares.nl
www:http://www.deltares.nl
For support contact:
telephone:+31883358555
fax:+31883358111
e-mail:delft3d.support@deltares.nl
www:https://www.doczj.com/doc/b719061381.html,
The screen pictures shown in this manual were produced during the development stages and may di?er from the actual product
Copyright?2011Deltares
All rights reserved.No part of this document may be reproduced in any form by print, photo print,photo copy,micro?lm or any other means,without written permission from the publisher:Deltares.
Delft3D-GISVIEW User Manual Contents May2011
1.04.15423
Contents
1A guide to this manual1
1.1Introduction (1)
1.2Typographical conventions (1)
2Introduction to Delft3D-GISVIEW3
2.1Short description of the program functionality (3)
2.2Installing the program (4)
3Getting started5
3.1Starting Delft3D-GISVIEW/ArcMap (5)
3.2Quitting the program (6)
4Describing the user interface7
4.1Introduction (7)
4.2Get results (7)
4.3View results (9)
4.4View vectors (10)
5Remarks13 References15
Deltares iii
May2011 1.04.15423Contents Delft3D-GISVIEW
User Manual
iv Deltares
Delft3D-GISVIEW User Manual A guide to this manual May2011
1.04.15423
Chapter1
A guide to this manual
1.1Introduction
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 Delft3D-GISVIEW.
Chapter2:Introduction to Delft3D-GISVIEW,a short overview of the program and the general functionality is given.
Chapter3:Getting started,it is described how to start and quit the program,together with the?rst steps using the program.
Chapter4:Describing the user interface,provides a detailed description of the User Interface.
Chapter5:Remarks,gives some remarks about this application.
1.2Typographical conventions
Throughout this manual,the following conventions in text formats help you to distinguish between di?erent 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.
Deltares1
May2011 1.04.15423A guide to this manual Delft3D-GISVIEW
User Manual
Example Description
Save Item from a menu,title of a push button or the name of
a user interface input?eld.
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?eld you are supposed to enter input
data of the required format and in the required domain.
<\tutorial\wave\swan-curvi>
“27081999”Data to be typed by you into the input?elds 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,10points.
[m/s][-]Units are given between square brackets when used next
to the formulae.Leaving them out might result in
misinterpretation.
2Deltares
Delft3D-GISVIEW User Manual Introduction to Delft3D-GISVIEW May2011
1.04.15423
Chapter2
Introduction to Delft3D-GISVIEW
2.1Short description of the program functionality
The program Delft3D-GISVIEW makes it possible to show results from Delft3D programs in the GIS environment of ArcMap R O(a product of ESRI R O ArcGIS R O suite).So Delft3D results are shown into maps1.
The program is a so-called extension of ArcMap and thus is used within ArcMap(and not as a stand-alone program).
Delft3D-GISVIEW is a postprocessing program of Delft3D and belongs to the visualisation tools.Figure2.1shows the suite of Delft3D programs.
It is supposed that you are familiar with the ArcMap program as well with the calculation results(e.g.paramters)of the Delft3D programs.
Till now,?les of the type Communication?le,Hydrodynamic map?le,Waves map?le, Sediment transport map?le can be used.
From these?les you can select parameters,times and layers,which is done in the same way as in the program Delft3D-GPP.After this selection a dataset is composed and shown in the GIS.The underlying result data is transformed into GIS data(a shape?le)and is presented and available as a layer in ArcMap.
1ArcMap,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 Delft3D-GISVIEW and the ESRI program ArcMap.
Figure2.1:System architecture of Delft3D
Deltares3
May2011 1.04.15423Introduction to Delft3D-GISVIEW Delft3D-GISVIEW
User Manual
So you have all possibilities of ArcMap to classify the results,to print resulting maps,etc.
2.2Installing 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”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 envi-ronment.In the left part of the toolbar you can choose the program you want to work with from a drop down menu.
Remark:
?Delft3D should be installed after ArcMap.
4Deltares
Delft3D-GISVIEW User Manual Getting started May2011
1.04.15423
Chapter3
Getting started
3.1Starting Delft3D-GISVIEW/ArcMap
Because of Delft3D-GISVIEW is an ArcMap extension you start ArcMap from an icon on your desktop,or via the Start menu.Then Delft3D-GISVIEW can be used by a speci?c toolbar.The toolbar is named”GISPlugins”.In order to work with Delft3D-GISVIEW,the result?les 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.
Figure3.1shows a user interface of ArcMap.You see the toolbar containing the text “Delft3D-GISVIEW4.01.01.This is a drop-down list to choose the Delft3D program you want to work with in ArcMap.
So?rst you start to select Delft3D-GISVIEW.
Then the next step is to read a result?le,by clicking on the menu Get results.
Then click on item Add layer from Delft3D result?les.A?le selection box will come up.
Navigate to a directory and choose a result?le.A new window pops up and
choose a parameter,a time and a layer.
use the button Add to add your selection to the atribute list.
click the OK button,and as a result you will see a new layer in the map.
Now the results can be classi?ed in the map.
At the right side of the menus in the toolbar you?nd 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 Chapter4describes detailed the user interface. Remarks:
Deltares5
May2011 1.04.15423
Getting started Delft3D-GISVIEW
User Manual
Figure3.1:User interface of ArcMap
?When you are clicking commands or buttons of the toolbar of Delft3D-GISVIEW,you have access to the program Delft3D-GISVIEW.
?When clicking on the menus and tools of the ArcMap user interface,you are using ArcMap.
3.2Quitting the program
Just quit the ArcMap program to quit also Delft3D-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 Delft3D-GISVIEW by selecting it again.
6Deltares
Delft3D-GISVIEW User Manual Describing the user interface May2011
1.04.15423
Chapter4
Describing the user interface
4.1Introduction
The user interface of Delft3D-GISVIEW is the toolbar as shown in Figure4.1.
The program Delft3D-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?le of Delft3D.After all actions a layer (based on a shape?le)is added to the layers of the map.In this way you can add more layers from one ore more result?les 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?eld.
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.
4.2Get results
The menu Get results has the menu item Add layer from Delft3D result?https://www.doczj.com/doc/b719061381.html,ing this command a?le selection window comes up.In this?le window you can navigate to a directory with result?les.Till now the?le types Communication?le,Hydrodynamic map?le,Waves map?le,Sediment transport map?le can be used(Deltares,2010,2008).The?le window looks like Figure4.2.
As you can see all known?le types()can be shown and selected,or a speci?c known type can be shown and selected via the drop down list.
After a?le has been selected the following window comes up,see Figure4.3.With this window you make the selection of parameter,time and layer from Delft3D.Each selection
Figure4.1:Delft3D-GISVIEW toolbar
Deltares7
May2011 1.04.15423
Describing the user interface Delft3D-GISVIEW
User Manual
Figure4.2:File selection window to open Delft3D result?les
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.
You can select more times by using the Shift or Control key.
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 the timestep Txxx and a description after it.These names become the attribute names of the layer in the map.
Note that these attribute names must be di?erent in one layer(shape?le),so they must di?erent here in the“Attribute”part.This is especiallay important when you select both current magnitude and current direction to draw?ow vectors.
You can change this name by double clicking on it,type a new attribute name and con?rm with the Enter key.
You can use the F2key 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?le)in di?erent ways.
You can select a parameter at one layer and select several time steps.The attribute names are di?erent(Txxx).
You can select some parameters at di?erent timesteps and at one ore more layers.Be aware that in this case attribute names at the left side may have the same name.Change this names into more meaningfull names.
Using the OK button the result?le is read to compose a dataset and this dataset is trans-formed into GIS data(a shape?le).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 8Deltares
Delft3D-GISVIEW User Manual Describing the user interface May2011
1.04.15423
Figure4.3:Selection window for parameter,time and layer
atrtributes 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.
Therefor it is also possible to put results of di?erent result?les from Delft3D into separate layers(shape?les)to the map.
Using the Cancel button nothing happens and you go back to the map in ArcMap.
Each selection of parameter,time and layer 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 Delft3D-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?le,which has one geometry(shape)column and one ore more attribute columns.
4.3View results
As described in Section4.2results 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?le 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.
Deltares9
May2011 1.04.15423Describing the user interface Delft3D-GISVIEW
User Manual
To show the grid only,choose the“Hollow”colour and a value for the outline width.
4.4View vectors
Vector values like current velocity are drawn by Delft3D-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 Section4.1and see the?gure 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 section4.2each 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.
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 atribute names.
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 that 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 Figure4.4.You will see the map layer and the attribute?elds 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).
10Deltares
Delft3D-GISVIEW User Manual
Describing the user interface May2011
1.04.15423
Figure4.4:Vector properties window
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.The following window pops up.
You see several properties related tot the vectors.You can?ll in the last2properties.
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 https://www.doczj.com/doc/b719061381.html,ing this vector scale you can draw the most suitable vector?eld 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 value0means 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.
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).
Deltares11
May2011 1.04.15423Describing the user interface Delft3D-GISVIEW
User Manual
12Deltares
Delft3D-GISVIEW User Manual Remarks May2011
1.04.15423
Chapter5
Remarks
Remarks:
?This version of Delft3D-GISVIEW uses an executable for?le selection and selecting parameters,times and layers from Delft3D calculations.All things go smoothly.How-ever,if you move the windows,the screen of ArcMap will not be refreshed.This will be improved in upcomming releases.
?Do not use the parameter“Model grid”from the window as shown in paragraph4.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.
?You see the attribute m and n which are grid indices of the curvilinear grid used internally by Delft3D-FLOW.
Deltares13
May2011 1.04.15423Remarks Delft3D-GISVIEW
User Manual
14Deltares
Delft3D-GISVIEW User Manual References May2011
1.04.15423
References
Deltares,2008.Delft3D-WAVE User Manual.WL|Delft Hydraulics,Delft,The Netherlands, 3.03ed.7
—,2010.Delft3D-FLOW User Manual.WL|Delft Hydraulics,Delft,The Netherlands,3.14 ed.7
Deltares15
May2011 1.04.15423References Delft3D-GISVIEW
User Manual
16Deltares