3D/2D modelling suite for integral water solutions. Delft3D DRAFT. GISView. User Manual

Transcription

1 3D/2D modelling suite for integral water solutions Delft3D GISView User Manual

2

3 GISVIEW Presentation of results in a GIS User Manual Hydro-Morphodynamics Version: 1.04 SVN Revision: April 27, 2018

4 GISVIEW, User Manual Published and printed by: Deltares Boussinesqweg HV Delft P.O MH Delft The Netherlands For sales contact: telephone: fax: software@deltares.nl www: telephone: fax: info@deltares.nl www: For support contact: telephone: fax: software.support@deltares.nl www: 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.

5 Contents Contents List of Figures v 1 A guide to this manual Introduction Typographical conventions Introduction to GISVIEW Short description of the program functionality Installing the program Getting started Starting GISVIEW/ArcMap Quitting the program Describing the user interface Introduction Get results View results View vectors Remarks Listing References 15 Deltares iii

6 GISVIEW, User Manual iv Deltares

7 List of Figures List of Figures 2.1 System architecture of Delft3D User interface of ArcMap GISVIEW toolbar File selection window to open Delft3D result files Selection window for parameter, time and layer Vector properties window Grid and vector view Deltares v

8 GISVIEW, User Manual vi Deltares

9 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. 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 Module Project Save <\tutorial\wave\swan-curvi> <siu.mdw> Description Title of a window or a sub-window are in given in bold. 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. 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. 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 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. Deltares 1 of 18

10 GISVIEW, User Manual Example delft3d-menu Description 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. 2 of 18 Deltares

11 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 into maps 1. 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. 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. 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. 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 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

12 GISVIEW, User Manual drop down menu. Remark: Delft3D should be installed after ArcMap. 4 of 18 Deltares

13 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. So first you start to select GISVIEW. 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 access to the program GISVIEW. Deltares 5 of 18

14 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. 6 of 18 Deltares

15 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 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. 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.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 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. 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

16 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 of 18 Deltares

17 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 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 of 18

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 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 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. 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 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

19 Describing the user interface Figure 4.4: Vector properties window 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

20 GISVIEW, User Manual 12 of 18 Deltares

21 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 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. Deltares 13 of 18

22 GISVIEW, User Manual 14 of 18 Deltares

23 References Delft3D-FLOW UM, Delft3D-FLOW User Manual. Deltares, 3.14 ed. WAVE UM, Delft3D-WAVE User Manual. Deltares, 3.03 ed. Deltares 15 of 18

24 GISVIEW, User Manual 16 of 18 Deltares

25

26 PO Box MH Delft Rotterdamseweg HD Delft The Netherlands +31 (0)