Interactive grid editor for coupling FLOWwith WAQ models
User Manual
November, 2006
User Manual Delft3D-DIDO
Published and printed by:
WL | Delft Hydraulics
main officeRotterdamseweg 185p.o. box 1772600 MH DelftThe Netherlandstelephonefaxinternetwww
+31 15 285 85 85+31 15 285 85 82info@wldelft.nlhttp://www.wldelft.nl
For support contact:e-mail:www:telephone:fax:
delft3d.support@wldelft.nlhttp://www.wldelft.nl/d3d/+31 15 285 85 55+31 15 285 85 82
Copyright 2006 WL | Delft Hydraulics
All rights reserved. No part of this document may be reproduced in any form by print, photoprint, photo copy, microfilm or any other means, without written permission from thepublisher: WL | Delft Hydraulics.
Delft3D-DIDOUser Manual
Contents
November, 2006
Version 3.43
Contents
1Introduction.......................................................................................................1–11.11.21.31.41.5Functional description.............................................................................1–1Structure of the manual...........................................................................1–1Release history.......................................................................................1–2Implementation specific aspects..............................................................1–2Changes with respect to previous versions...............................................1–2
23Installation and set-up.......................................................................................2–1Getting started..................................................................................................3–13.13.23.33.43.53.6Starting Delft3D.....................................................................................3–1Getting into Delft3D-DIDO....................................................................3–2Exploring some menu options.................................................................3–7New application.....................................................................................3–7Resume suspended work on an existing application.................................3–8Save your work and quit.........................................................................3–84Tutorial..............................................................................................................4–14.14.24.34.4Introduction............................................................................................4–1Starting the Coupling module..................................................................4–1Starting Delft3D-DIDO..........................................................................4–2Editing the grid.......................................................................................4–34.4.14.4.24.5Introduction...............................................................................4–3Approach in aggregation............................................................4–4Ending your session and saving the results..............................................4–9WL | Delft Hydraulicsi
November, 2006Version 3.43
Contents
Delft3D-DIDOUser Manual
567Export files for DELWAQ.................................................................................5–1Edit a hydrodynamic grid.................................................................................6–1Available grid-edit actions................................................................................7–17.17.27.37.47.57.67.7Regular aggregate..................................................................................7–2Irregular aggregate.................................................................................7–3Point and click.......................................................................................7–4Break up a segment................................................................................7–4Roll back...............................................................................................7–4Information............................................................................................7–5Bottom depth values...............................................................................7–58Available other coupling actions.......................................................................8–18.18.2Layer editor...........................................................................................8–1Coupling editor......................................................................................8–1910Online help........................................................................................................9–1Command reference........................................................................................10–110.110.2Main window.......................................................................................10–1Grid window........................................................................................10–411References........................................................................................................11–1iiWL | Delft Hydraulics
Delft3D-DIDOUser Manual
Introduction
November, 2006Version 3.431
1
Introduction
Vergilius once wrote: \" The Tyrian princess Dido succeeded the father and became queen ofTyrus. Her brother Sichaeus had killed her husband, after which she fled via Cyprus toAfrica. There she asked a local king the favour to give her as much land as she could spanwith the hide of a bull. When the king granted the request, she cut the hide into long, thinstrips enabling to span a much larger area. On this area Carthage was founded.\"
Feel yourself in the position of Dido with the mouse and your computer screen, to fit the realworld to your needs.
1.1Functional description
Delft3D-DIDO is an interactive grid-editor and coupling tool for hydrodynamic models withthe DELWAQ model (WL | Delft Hydraulics, 2006a). It uses a fine rectilinear, curvilinear orFinite Element hydrodynamic grid layout as input. It produces all administration files andhydrodynamic inputs needed by the Delft3D Water quality model DELWAQ to condense thisfine grid to a coarser water quality grid. Each water quality grid cell consists of an integermultiple of the hydrodynamic grid cells. Using Delft3D-DIDO without aggregation willproduce DELWAQ hydrodynamic input on the original hydrodynamic grid spacing, althoughDELWAQ grid cells will be renumbered.
This means that Delft3D-DIDO does NOT make grids, but modifies existing hydrodynamicgrids for use in water quality- and ecological modelling. Delft3D-DIDO does so by defining apointer from each of the hydrodynamic grid cells to a water quality grid cell. This means thatafter operation of Delft3D-DIDO each hydrodynamic grid cell has:
world co-ordinates of its centre and corners
indices in a 1D, 2D or 3D matrix of its ordering in the hydrodynamic modela hydrodynamic grid cell number
a DELWAQ water quality/ecology grid cell number
The last item is produced by Delft3D-DIDO, the other items can be inspected interactivelythrough of Delft3D-DIDO.
1.2Structure of the manual
This manual has two parts. The first part indicates how to use Delft3D-DIDO from thefunctional point of view. The second part consists of a reference of all commands availableeither as menu items or as actions with the mouse following the selection of a menu item.Many parts of this manual are also available as online help topic. See the chapter on onlinehelp for the use of this feature.
WL | Delft Hydraulics1–1
November, 2006Version 3.43
Introduction
Delft3D-DIDOUser Manual
1.3Release history
Earlier releases of Delft3D-DIDO were DOS based graphical PC-products for gridaggregation only. They had limited functionality for interactive aggregation and used threetiled windows on a VGA screen. Release 3.0 is a product with equal functionality for MS-Windows 3.1 and higher on PC and OSF-MOTIF/X11 on Unix platforms. It uses overlappedmultiple windows. This manual is equally valid for the MS-Windows and the OSF-MOTIFversions. Platform specific items will be indicated as such where they appear in the manual.Release 3.2 adds the conversion of hydrodynamic input from hydrodynamic flow databases,at first for the RIKZ SIMONA modelling system, supporting the 2D depth averagedhydrodynamic model WAQUA and the 3D TRIWAQ model.
1.4Implementation specific aspects
Although Delft3D-DIDO can support a variety of hydrodynamic grid structures andhydrodynamic model result files, your version will generally be limited to operate in concertwith the hydrodynamic models available at your site. At the point where you are able toimport a hydrodynamic model result, you will generally only be confronted with a selectionscreen showing the hydrodynamic model result files supported by your implementation. Sincethis manual is general, certain sections will refer to options that are masked for someimplementations (e.g. a regular aggregation of every n x m grid cells is meaningless forirregularly linked grids and most finite element grids).
The output of Delft3D-DIDO for some of the supported hydrodynamic models is as suchinsufficient for DELWAQ simulations. It is input to a coupling program between thesupported hydrodynamic model and DELWAQ. This means that the Delft3D-DIDO -supportof a hydrodynamic model includes the Delft3D-DIDO-support of a coupling programbetween this hydrodynamic model and DELWAQ, by providing this program with adequateinformation. With release 3.2 the full support of hydrodynamic coupling is only provided forthe RIKZ SIMONA modelling system.
1.5
Version3.43Changes with respect to previous versions
DescriptionMENU and COUP-GUI screens updated.In filenames: com-f35 replaced by com-f35_waq.3.423.41Bookmarks added for PDF version.Operation ofChange working directory updated in Chapter 3.Extension of Delft3D-MENU with Delft3D-QUICKPLOT.3.40Reference version for these change notes.1–2WL | Delft Hydraulics
Delft3D-DIDOUser Manual
Installation and set-up
November, 2006
Version 3.43
2
Installation and set-up
The Delft3D-DIDO requirements are, see also (WL | Delft Hydraulics, 2006b):on UNIX systems:
a supported version of your UNIX operating system
a supported version of your OSF/MOTIF or Open Look X11 windowing systema graphical interactive terminal supporting your X11 windowing systema mouse
on MS-Windows systems:
Version 3.1 of MS-Windows or higher
a graphical interactive terminal supporting MS-Windowsa mouse
For the installation procedure itself you are referred to the instructions provided with themagnetic media of this product.
Delft3D-DIDO consists basically of four or five files, an executable file and several datafiles. These files are called:on UNIX systems:
didodido.cscdido.uidxvtprolg.psdido
the executable
context-sensitive helpwindow resources
Post-Script printer driveroptional DIDO start-up script
on MS-Windows systems:
dido.exedido.hlpdido.ico
XWMBA400.DLL _XWMHN400.DLL _XWMte400.DLL_
the executable
context-sensitive helpthe Delft3D-DIDO iconthese three files must be
located in the MS-WINDOWSsystem directory
When using Delft3D-DIDO on UNIX systems, you need to set the UIDPATH and theDIDOPATH environment variable, as otherwise the program will not be able to find the (uid)resources- and the (csc) context sensitive help file. This is done as follows:
WL | Delft Hydraulics2–1
November, 2006Version 3.43
Installation and set-up
Delft3D-DIDOUser Manual
in the Bourne or Korn shell:
export UIDPATH= in the C-shell: setenv UIDPATH if you already have this variable, otherwise: export UIDPATH= The only other environment variable that may need to be set is the DISPLAY variable, as isusually necessary for X Window applications. For users using the SIMONA system, also the SIMONADIR environment variable should beset to the location where the SIMONA system files are found. This variable is used in thescript file that also comes with the Delft3D-DIDO system, for SIMONA users only. For MS-Windows based applications, the same environment variables hold. They are set inthe SET UIDPATH= When the Delft3D-DIDO executable is not able to find the context sensitive help file itself, itprompts for such a file with a file selection dialogue. You then will have to search thedirectory tree of your implementation for this file. The best way to avoid this is to startDelft3D-DIDO from the directory where the executable and all help files can be found.DIDO has file selection menus for the import of hydrodynamic result files, the export ofDELWAQ files and the saving of pending work. These file selection menus start from thepresent working directory. This need not to be the directory where the wanted files are in. Bymanoeuvring through the directory tree, you may change the present working directory. Forall of these files, default file filters are provided. It is highly recommended to maintain thedefault file naming characteristics as provided by your implementation, for ease of use.Especially when saving work-files and DELWAQ files, you should take care that you savethem in the directory of your choice. The file selection dialogue is a system dialogue, provided by MS-Windows on PCs andprovided by OSF/MOTIF on UNIX platforms. The rules for selection and specification of file 2–2WL | Delft Hydraulics Delft3D-DIDOUser Manual Installation and set-up November, 2006 Version 3.43 names differ for these two platforms. E.g. on PCs the default file names and extensions arealready filled in for saving and/or exporting of files. You simply press OK and you write afile. On the UNIX platform you must explicitly write the filename plus extension in an editfield although the dialogue shows suggestions for default extensions. The Help dialogues used are dialogues as provided by the operating environment as well. Thismeans that there are differences between the MS-Windows and OSF/MOTIF functionality.The basic functions are equal however. WL | Delft Hydraulics2–3 November, 2006Installation and set-up Version 3.43 blank page 2–4Delft3D-DIDOUser Manual WL | Delft Hydraulics Delft3D-DIDOUser Manual Getting started November, 2006 Version 3.43 3 3.1 Getting started Starting Delft3D To start Delft3D: On an MS Windows platform: select Delft3D in the Applications menu or click onthe Delft3D icon on the desktop. On Linux and UNIX machines: typedelft3d-menu on the command line. Next the title window of Delft3D is displayed,:Figure 3-1:Figure 3-1 Title window of Delft3D After a short while the main window of the Delft3D-MENU appears, Figure 3-2.WL | Delft Hydraulics3–1 November, 2006Version 3.43 Getting started Delft3D-DIDOUser Manual Figure 3-2 Main window Delft3D-MENU Several menu options are shown. In Figure 3-2 all options are sensitive. If options areinsensitive this indicates that you are not authorised to use this option; check your license file( Click on theExitpush button. The window will be closed and you are back in the Windows Desk Top screen for PCs or onthe command line for Linux and UNIX workstations. Remark: In this and the following chapters several windows are shown to illustrate the presentationof Delft3D-MENU and Delft3D-DIDO. These windows are grabbed from the PC-platform. For Linux and UNIX workstations the content of the windows is the same, butthe colours may be different. On the PC-platform you can set your preferred colours byusing the Display Properties. 3.2Getting into Delft3D-DIDO To continue restart the menu program as indicated above. To access the interactivegrid-editor, you first have to access the coupling tool between hydrodynamic and waterquality models. The coupling tool can be accessed either from the far-field water qualitymodule or from the mid-field particle tracking module. Click theWater Qualitybutton. 3–2WL | Delft Hydraulics Delft3D-DIDOUser Manual Getting started November, 2006 Version 3.43 Next the selection window for Far-field water quality (all modules) is displayed, see Figure3-3.Figure 3-3 Selection window forFar-field water quality (all modules) The coupling and grid editing functionality is exactly the same for all four water qualitymodules, therefore: SelectGeneral. The selection window for Water quality (WAQ) is displayed (Figure 3-4), in which you canaggregate and convert hydrodynamic results, prepare a substance file using the ProcessLibrary Configuration Tool, prepare a water quality input file, run the pre-processor, executea computation in foreground, inspect the report files with information on the execution andvisualise the results. WL | Delft Hydraulics3–3 November, 2006Version 3.43 Getting started Delft3D-DIDOUser Manual Figure 3-4 Selection window forWater quality (WAQ) Before continuing with any of the selections of thisWater quality (WAQ)window, you mustselect the directory in which you are going to aggregate and convert hydrodynamic results: Click theSelect working directory button. Next theSelect working directory window, Figure 3-5, is displayed (your current directorymay differ, depending on the location of your Delft3D installation). Figure 3-5Select working directory window Browse to and enter the 3–4WL | Delft Hydraulics Delft3D-DIDOUser Manual Getting started November, 2006 Version 3.43 Enter the Next theWater quality (WAQ) window is re-displayed, but now the changed currentworking directory is displayed in the title bar, see Figure 3-7.Figure 3-7 Current working directory Now we are back in the mainWater quality (WAQ) menu, Figure 3-4, and you can convertand/or aggregate hydrodynamic results, hence: Click onCoupling. Next theHydrodynamic coupling menu is displayed (see Figure 3-8), in which you cancreate or edit the coupling input file, and start the hydrodynamic coupling. Figure 3-8 Selection window forHydrodynamic coupling SelectDefine input. The GUI for the coupling is started and the primary input screen is shown, Figure 3-9.WL | Delft Hydraulics3–5 November, 2006Version 3.43 Getting started Delft3D-DIDOUser Manual Figure 3-9Main window of the Coupling Graphical User Interface The purpose of this Coupling GUI is to define the conversion of the hydrodynamic results ofDelft3D-FLOW. Prior to this conversion, you can aggregate the hydrodynamic grid using theDelft3D-DIDO tool. To open hydrodynamic results (see Figure 3-10):Click onHydrodynamics. ClickCom file, and open Figure 3-10The Hydrodynamics selection window of the Coupling GUI 3–6WL | Delft Hydraulics Delft3D-DIDOUser Manual Getting started November, 2006 Version 3.43 To start Delft3D-DIDO: SelectTools - Grid editor (DIDO), see Figure 3-11.Figure 3-11Menu optionTools -Grid editor to start DIDO 3.3Exploring some menu options To guide you through some menu options please follow the example in Chapter 4, Tutorial.3.4New application You can also run Delft3D-DIDO without first having opened a hydrodynamic SelectTools - Grid Editor (DIDO) in the Couple GUI, the Grid Editor program willstart.SelectFile from the menu of the main screen.SelectNew from the drop-down itself. a dialogue opens, enabling to specify a name of 8 characters. Specify a meaningful name, torecognise this application later on. The name will appear in the title area of the main windowafter pressing theOK button. SelectImport/Export from the drop-down menu. Select the hydrodynamic communication file A file selection dialogue opens. It has a search filter that fits with default file namingconventions of the supported hydrodynamic model output. Select a hydrodynamic model result from the file dialogue.An hour glass may indicate the busy time for import of the data. The hydrodynamic model result is now imported and can be used for further processing. WL | Delft Hydraulics3–7 November, 2006Version 3.43 Getting started Delft3D-DIDOUser Manual Optionally it is now possible to import an earlier aggregation file <*.dwq> for thishydrodynamic grid. 3.5Resume suspended work on an existing application Start Delft3D-DIDO from the Couple GUI.SelectOpen from theFile drop-down menu. A file selection dialogue opens. It has a search filter that fits with default file namingconventions of the saved previous work. Select a previously saved application <*.did> from the file selection dialogue.An hour glass may indicate the busy time for import of the data. The name of the applicationappears in the title area of the Main Window. The previously saved application is imported now and can be used for further processing.This procedure completely restores all settings in memory of the previously saved application.It does NOT open all windows that were open at the time of saving however. It also doesNOT restore pending incomplete editing actions like incomplete polygons etc. Only the stateof completed edit actions is saved. Remark: You may load a previously saved file and select a new hydrodynamic file from theImport/Export drop-down. If the type of the hydrodynamic file, as just selected, matchesthat of the previously saved file, you are able to ADD the newly specified hydrodynamicfile to your session. This means that all previous coupling options, like grid- and layeraggregation, are applied to the new hydrodynamic model. This allows for repeatedcoupling in the same way. Always inspect the coupling settings using theEdit drop-downof the main menu.Warning: By loading a previously saved file, you also load its name as the session name. This sessionname is the default name for the exported DELWAQ files. Since Delft3D-DIDO presentlydoes not check their existence, they may be overwritten. You are always able to edit theDELWAQ file name just before coupling takes place. Take that opportunity. 3.6Save your work and quit You may save your work at any moment SelectSave orSave as from theFile drop-down menu of the main screen. ForSave as a file selection dialogue opens. When you specify an already existing file, you areprompted to confirm that you want to replace the contents of that file. 3–8WL | Delft Hydraulics Delft3D-DIDOUser Manual Getting started November, 2006 Version 3.43 An hour glass may indicate the busy time for writing the file. When you save your work, all data and settings are saved. This means that the originalhydrodynamic result file is not needed any more for editing of the grid. Only when the actualhydrodynamic data have to be converted for DELWAQ, the file is needed again. Remark: Take care that you save your files in your directory of choice. If not, you will have to lookfor them, which can be a tedious procedure. You may find them finally in the directoryfrom where you started the Delft3D-DIDO executable, in the directory of imported data oreven in the directory where you found the context sensitive Help file (typically thedirectory where the executable can be found.Suggestion Save your work often, to have a backup when damages occur. Start saving with theSave asoption to be sure to save in the right directory. Every subsequent time you can save withSave, when you do not mind overwriting earlier intermediate results.You may quit the Delft3D-DIDO application SelectExit form theFile drop-down menu of the main screen. When unsaved actions are pending, you are prompted to confirm that you really want to exitthe application without saving the pending actions. You may select theClose option from themain-window-top-left-title-bar-drop-down as well. Those commands have equal effect. WL | Delft Hydraulics3–9 November, 2006Getting started Version 3.43 Blank page 3–10Delft3D-DIDOUser Manual WL | Delft Hydraulics Delft3D-DIDOUser Manual Tutorial November, 2006 Version 3.43 4 4.1 Tutorial Introduction In this tutorial some functionality of Delft3D-DIDO will be demonstrated. On the basis of the\"Friesian Tidal Inlet\" example (f35) a Delft3D-DIDO session is explained. In advance, boththe starting situation and the final situation are shown below in Figure 4-1.This tutorial describes in detail how to proceed from the starting situation towards the finalsituation. The grey boxes in between the explanations can be followed as well. These boxesonly describe the required GUI actions. Figure 4-1 Starting and final situation of the clarified Delft3D-DIDO session 4.2Starting the Coupling module Start the Graphical User Interface (GUI) of Delft3D as explained in Section 3.1.Follow the instruction in Section 3.2 to enter the GUI of the Couple module.Once you are in the Couple GUI, please Click theHydrodynamicsdata group. SelectCom file and browse to the WL | Delft Hydraulics4–1 November, 2006Version 3.43 Tutorial Delft3D-DIDOUser Manual The hydrodynamical database including the grid information will be loaded into the GUI. 1. STARTING THE COUPLING MODULE Start Delft3D-MENU by using the desktop icon/Start button (Windows) or the desktopicon/start button (LINUX). Click theWater Qualitybutton. Click theSelect working directorybutton, and browse to the 4.3Starting Delft3D-DIDO By choosingTools - Grid Editor (DIDO), the Grid Editor will start. First two message windows will appear. Take notice of their content and close both of themby clickingOK (twice), see Figure 4-2 and Figure 4-3.Figure 4-2 Delft3D-DIDO message (close by clickingOK) Figure 4-3 WAQ message (close by clickingOK) The relatively small starting window of Delft3D-DIDO appears. It is possible that it is partlyhidden behind the Coupling GUI. Make the Delft3D-DIDO window active. See Figure 4-4.4–2WL | Delft Hydraulics Delft3D-DIDOUser Manual Tutorial November, 2006 Version 3.43 Figure 4-4 Delft3D-DIDO main window 2. STARTING DIDO Choose menu-itemTools - Grid Editor (DIDO). ClickOK when Delft3D-DIDO message window appears. ClickOK when WAQ message window appears. Make the Delft3D-DIDO window active. 4.4 4.4.1 Editing the grid Introduction The main purpose of Delft3D-DIDO is to create a horizontal aggregation of the grid.Therefore you are going to indicate where and how to aggregate. To visualise the grid, Choose menu-itemEdit - Grid.The window displayed in Figure 4-5 will appear.Figure 4-5 Grid window WL | Delft Hydraulics4–3 November, 2006Version 3.43 Tutorial Delft3D-DIDOUser Manual 4.4.2Approach in aggregation In order to reach the final aggregation displayed in Figure 4-1, we aggregate this grid in thefollowing way: 1.Apply a regular 2x2 aggregation for the whole area. 2.Create a Subset by defining aCutout of the central part (the actual \"Tidal Inlet\") betweenthe two islands. 3.Apply a regular 1x1 aggregation for this area (=restoring the old aggregation).4.Saving the new aggregation. Apply a 2x2 aggregation for the whole area First, open theOptions for a regular aggregation by choosing the menu-itemAggreg. -Regular - Options.The window displayed in Figure 4-6 will appear. Tick off the following radio buttons: In theExtend of the operationframe, select \"Whole model area\".In theOverride regular aggregations frame, select \"Not overriding\".In theOverriding irregular aggregates frame, select \"Not overriding\". In theOpen Boundary cells frame, select \"No expansion over open boundary\". Figure 4-6 Options for a regular aggregation ClickOK when finished. The next step is to select the corners of the cells to aggregate. In this way you indicate whichneighbouring cells will aggregate. 4–4WL | Delft Hydraulics Delft3D-DIDOUser Manual Tutorial November, 2006 Version 3.43 After choosing the menu-itemAggreg. - Regular - Select cornercells,you can click the two(corner) cells which form the 'outline' of the new cell. Please first click in cell indicating \"1\" in Figure 4-7. It will become red.Then click in the cell indicating \"2\". Immediately the new aggregation will appear, see Figure 4-8.Figure 4-7 Select corner cells for a 2x2 aggregation Figure 4-8 Result of the 2x2 aggregation WL | Delft Hydraulics4–5 November, 2006Version 3.43 Tutorial Delft3D-DIDOUser Manual 3. A 2X2 AGGREGATION FOR THE WHOLE AREA Choose menu-itemAggreg. - Regular - Optionsin the Grid Editor GUI.In theExtend of the operationFrame, select\"Whole model area\".In theOverride regular aggregations Frame, select\"Not overriding\".In theOverriding irregular aggregates Frame, select\"Not overriding\".In theOpen Boundary cells Frame, select\"No expansion over open boundary\".Choose menu-itemAggreg. - Regular - Select cornercells.Click in cell \"1\" and in cell \"2\" (Figure 4-7).Create a Subset for the \"Tidal Inlet\" Choose menu-itemSubset - Cutout - Next point - by Mouse and click on the location wherethe cursor is located in Figure 4-9. Now you can start drawing. By aleft-mouse click youstart to draw. On every next left mouse-click the segment you are drawing ends. You canchange direction now. By several left mouse-clicks, your ellips should look like in Figure 4-9.End your ellips by aright-mouse click (note: the red line in Figure 4-9 is exaggerated).Figure 4-9 Create a subset After finishing the ellips, Choose menu-itemSubset - Cutout - Last point. Now the outside area of the grid will disappear and your window will look as in Figure 4-10.4–6WL | Delft Hydraulics Delft3D-DIDOUser Manual Tutorial November, 2006 Version 3.43 Figure 4-10 Finishing the cutout area 4. CREATE A SUBSET(CUTOUT AREA) Choose menu-itemSubset - Cutout - Next point - by Mouse in the Grid Editor GUI. Left mouse-click on cursor location (Figure 4-9) and create ellips by several left mouse-clicks. End your ellips by a right mouse-click. Choose menu-itemSubset - Cutout - Last point.Restoring the 1x1 aggregation for the subset Again, open theOptions for a regular aggregation by choosing the menu-itemAggreg. -Regular - Options.Check the following radio buttons:1.2.3.4. In theExtend of the operationFrame, select \"Cutout area only\".In theOverride regular aggregations Frame, select \"Overriding\". In theOverriding irregular aggregates Frame, select \"Not overriding\". In theOpen Boundary cells Frame, select \"No expansion over open boundary\". Choose menu-itemAggreg. - Regular - Select cornercells and click twice in the cell which ismarked in Figure 4-11 (by clicking the same cell twice you restore the original 1x1aggregation).Choose menu-itemSubset - Whole area to see the whole area again. This should look likeFigure 4-12.5. RESTORE THE 1X1 AGGREGATION FOR THE SUBSET Choose menu-itemAggreg. - Regular - Optionsin the Grid Editor GUI. WL | Delft Hydraulics4–7 November, 2006Tutorial Version 3.43 5. RESTORE THE 1X1 AGGREGATION FOR THE SUBSET In theExtend of the operationFrame, select\"Cutout area only\". In theOverride regular aggregations Frame, select\"Overriding\". In theOverriding irregular aggregates Frame, select\"Not overriding\". In theOpen Boundary cells Frame, select\"No expansion over open boundary\". Choose menu-itemAggreg. - Regular - Select cornercells. Click twice in the marked cell (Figure 4-11). Choose menu-itemSubset - Whole area.Figure 4-11 Restoring the 1x1 aggregation of the subset Figure 4-12 Final Situation of the aggregation 4–8Delft3D-DIDOUser Manual WL | Delft Hydraulics Delft3D-DIDOUser Manual Tutorial November, 2006 Version 3.43 4.5Ending your session and saving the results End your grid editing session by choosing menu-itemWindow - Exit.You have to save your session twice: as a <*.did> file (for storing your results in Delft3D-DIDO format) and as an aggregation file <*.dwq> (for importing into the Couple module).Save as <*.did> file Choose menu-itemFile - Save as to store your results into <*.did> format. You can use/re-open this file again in Delft3D-DIDO. Name your file Save as <*.dwq> file Choose menu-itemImport/Export - Delft3D-WAQ to export the results to a <*.dwq> file.Name your file Exiting DIDO Choose menu-itemFile - Exit to exit the Delft3D-DIDO GUI. The Couple GUI appearsagain. 6. ENDING GRID EDITING AND SAVING THE RESULTS Choose menu-itemWindow - Exitin the Grid Editor GUI In the DIDO GUI, choose menu-itemFile - Save as. Name your file mport/Export - Delft3D-WAQ. Name your file To convert the hydrodynamic results from the original grid to the aggregated grid:Set the type of Horizontal aggregation toUse aggregation file (DIDO), see Figure 4-13.Figure 4-13 Use the DIDO aggregation file PressSelect and open the To save the input for the Couple module, selectFile – Save as and specify the filename as To exit the Couple GUI, selectFile – Exit. In theHydrodynamic coupling selection window:selectStart, next the Couple module starts. WL | Delft Hydraulics4–9 November, 2006Tutorial Version 3.43 blank page 4–10Delft3D-DIDOUser Manual WL | Delft Hydraulics Delft3D-DIDOUser Manual Export files for DELWAQ November, 2006 Version 3.43 5 Export files forDELWAQ You can export files for input in the coupling program with DELWAQ SelectImport/Export from the menu of the main window.SelectDELWAQ below the separation line of the drop-down. A file selection dialogue opens. When you specify an already existing file, you are promptedto confirm that you want to replace the contents of that file. If a full coupling takes place youare also invited to specify if you want to produce UNIX or PC files. The default is always setfor the platform you are working on. You can also produce ASCII files, but it is advised tolimit this option to configurations with a relatively small amount of DELWAQ computationalelements. An hour glass may indicate the busy time for writing the file. At full coupling you see a timestep counter following the coupling process. Using SIMONA input files, the DELWAQ option performs the actual coupling of thehydrodynamic flow field. This coupling can proceed using defaults (no aggregation, onehydrodynamics time step becomes one DELWAQ file record etc.). You may edit these defaultsusing the \"Grid\of theEdit drop-down of the main menu. You may export files for use by GIS packages as well. The files BNA (standard Arc-Infoformat) and SIMGIS (GIS format used by Dutch Rijkswaterstaat) are implemented. Suggestion You are advised to always inspect the default coupling options before actually performing thecoupling. With the menu items of theEdit drop-down of the main menu, you not only edit thehydrodynamic input, but you also inspect what Delft3D-DIDO has read from thehydrodynamic input files. You may leave these edit options always without changing theircontent, using theCancel button or theClose menu item. Remark: Presently Delft3D-DIDO does not yet check the existence of DELWAQ input files withequal name. This means that you may overwrite existing files if using the same name. WL | Delft Hydraulics5–1 November, 2006Export files for DELWAQ Version 3.43 blank page 5–2Delft3D-DIDOUser Manual WL | Delft Hydraulics Delft3D-DIDOUser Manual Edit a hydrodynamic grid November, 2006 Version 3.43 6 Edit a hydrodynamic grid You may edit the computational grid from the imported hydrodynamic simulation SelectEdit from the menu of the Main Window.SelectGrid from the drop-down of this menu item. A 'Grid' window opens, showing the complete grid used for the hydrodynamic simulation.Every time you do this, a new 'Grid' window opens. You can have as many 'Grid' windowsopen as your computer system allows you to. These 'Grid' windows are your working place. All 'Grid' windows work on the same data set,so they can be seen as different views on the same data. Changes in the grid are however onlyapplied to the active 'Grid' window and to those 'Grid' windows that are forced to update witha redraw of the grid. This is done because on slower systems (or with larger number of gridcells) a redraw may take several seconds and when several 'Grid' windows are open this mayslow down the interactive performance considerably. You can force an update of any 'Grid'window by the 'Update' command from the 'Window' drop-down of that window. You canclose 'Grid' windows with the 'Close' command from this 'Window' drop-down.You may zoom in into an area of interest SelectZoom from the menu of theGrid window.SelectIn from the drop-down that opens. Move the mouse pointer to one of the corners of your area of interest and press the leftbutton. Now a rubber-band square opens from that point to the current mouse position. You may depress the left mouse button at any time. When you press it again however, youhave fixed the opposite corner of the area of interest. When you regret your zoom action, or your first point, dragging the rubber band with yourmouse, you can just leave the graphical area, re-open the drop-down and selectCancel tofinish zooming in. SelectIn again to reselect the first point. When leaving the graphical area with an unfinished rubber-band square behind you does notappeal to you, you may cancel zooming by pressing the right mouse button. As soon as you have finished selecting the area of interest, a new 'Grid' window is createdwith horizontal and vertical proportions that match your area of interest.This newly opened 'Grid' window is active and available for editing actions.You may zoom out to the complete model area SelectOut from theZoom drop-down menu of theGrid window. WL | Delft Hydraulics6–1 November, 2006Version 3.43 Edit a hydrodynamic grid Delft3D-DIDOUser Manual The window is erased and the complete model area is fitted in the same window. This isfunctionally equivalent to closing the 'Grid' window you wanted to zoom out and opening anew 'Grid' window from the 'Main' menu. Important difference however is that the size of theexisting 'Grid' window is used at Zoom-out. Furthermore opening a 'Grid' window from the'Main' menu brings the 'Main' menu on top first, with all associated re-drawings afterwards touncover existing 'Grid' windows. Remarks: All 'Grid' windows are logically 'children' of the 'main' window. This means that only whenthe 'Main' window closes (at the end of your application), all children close automatically.The only other way to close a 'Grid' window is by issuing a close command using theoptions of the window itself. This means that 'Grid' windows resulting from zooming ininto an existing 'Grid' window are from that time on independent of the window fromwhich they were created. Graphically all grid windows are 'children' of the entire screen. This means that they canbe scaled and moved within the whole screen area. They remain visible when the MainWindow is minimised.Suggestion When the number of open 'Grid' windows, that are not used any more, becomes larger, thesystem may force (partial) redraws at any time these windows are (partly) becoming visiblee.g. after rearranging of windows on the screen. When you do not like this, you can eitherclose or minimise these (temporally) obsolete 'Grid' windows. On some systems it is moreefficient to minimise the not-used 'Grid' windows before closing, since closing the open 'Grid'window brings it on top first and forces a redraw. Minimising is done by pressing the'minimise' button on the window frame when visible and does not activate the window first.You may restore previous states after unsuccessful editing actions SelectManagement from the menu of the 'Grid' window.SelectBack one step from the drop-down of this menu item. The backward step feature is a circular buffer in memory. This means that after having setback several steps, the state where you started stepping back is restored. You can also stepforward in this buffer. Every action you take after one or more operations on the circular buffer, acts on the situationdisplayed at that time in the active 'Grid' window. These actions overwrite the contents of thecircular buffer locations following the one you started editing again from. The number of entries available in the circular buffer can be adjusted at any time during yourwork usingHistory from theSetting drop-down of the main window. When you increase thebuffer capacity, more entries become available. When you decrease the buffer capacity, theoldest entries are lost. You may restore a previously saved state of your work 6–2WL | Delft Hydraulics Delft3D-DIDOUser Manual Edit a hydrodynamic grid November, 2006 Version 3.43 You follow the instructions for starting your work by resuming a previously saved state. Now however you are prompted to confirm that you want to overwrite the present content ofyour application if you have not saved this present content immediately before your You may even restore a previously saved state of a fully different application, on the fly. Youthen are strongly advised however to close all open 'Grid' windows, since they are essentiallymeaningless and unable to display the newly imported grid. When you resume a previously saved state, all settings of that state are restored. This meansthat also the circular buffer at the moment the state was saved, will be available. Suggestion It may be useful to display the local bottom depth values together with the edited grid. Thisallows for aggregation of channels and tidal flats. To do so you invoke theBottom menu itemfrom theManagement drop-down of the Grid window you are working in. The menu item isonly selectable if bottom depth values were available in the hydrodynamic input file. Since itmay take time to paint the bottom, you can selectively reserve this option for specific gridwindows (e.g. one that zooms in on an area of interest). You can switch it off by reselectingtheBottom menu item. WL | Delft Hydraulics6–3 November, 2006Edit a hydrodynamic grid Version 3.43 blank page 6–4Delft3D-DIDOUser Manual WL | Delft Hydraulics Delft3D-DIDOUser Manual Available grid-edit actions November, 2006 Version 3.43 7 Available grid-edit actions The following edit actions are available Regular aggregation of every n x m hydrodynamic grid cell Irregular aggregation of all hydrodynamic grid cells enclosed by a polygonAggregation by pointing at a cell and pointing at the target group to add it toBreaking up previously aggregated cells Making a cut-out of the model area (e.g. to model a sub-area)Adding individual cells to the inactive area These actions are discussed in more detail separately. It is important to notice that actions a) and b) have options that can be set: The action can be limited to the An aggregation can expand over the open boundary, joining boundary cells as well,or not. (This option is not yet supported for FLOW at the time of release 3.0.) The options for the edit actions a) and b) are found as sub-menu item of the menu-itemassociated with the action. When invoked, a small floating Window opens on the screen. Thiswindow allows you to change preferences. The options are stored and remain in effect until changed again.The initial setting of the options is very conservative.There are separate options for actions a) and b)! Common way of working You will generally follow the next groups of sequences of actions in any order convenient foryour aim: Regular aggregation make a cut-out of the model area to aggregate regularlyzoom in into an important area for regular aggregationdefine here the two corner cells for regular aggregationstep back one step when the result is not wanted and retry (generally you will not override earlier irregular aggregations since they wereintentionally done)fine tune the result with point-and-click assignments WL | Delft Hydraulics7–1 November, 2006Version 3.43 Available grid-edit actions Delft3D-DIDOUser Manual eventually break up some aggregated segments and re-aggregate irregularlyreset the cut-out to the full model area again, to focus in on the next area Irregular aggregation zoom in into the area you want to form elements in set options to override earlier regular and/or irregular aggregations if wanteddraw the polygon to enclose the newly aggregated celldo some point-and-click fine tuning at the edges Warning When a cut-out is active during the export to DELWAQ, this cut-out is assumed to be amodel cut-out aiming at modelling a sub-area. When you only wanted to use the cut-out tolimit the actions of (ir)regular aggregations, you will have to restore the cut-out to thecomplete model area before exporting to DELWAQ. Remark: Both during cut-out and irregular aggregate, you may want to expand the polygon outsidethe zoom area. This is especially so when working on a very fine hydrodynamic grid,where you need detailed zooming to act accurately. You may suspend the polygon with theright mouse button. You can then expand the border of your grid window to cover a largerarea. You can also open a new 'Grid' window by zooming in on an adjacent model area. Byresuming the creation of the polygon with 'Next point' you will see the rubber bandpolygon line entering the second 'Grid' window when this is active.Suggestion Save your work in a file after a major step has been completed. Use the 'Save-as' option with a filename ending with e.g. an increasing 2 digit number. This guarantees that when you dislike more steps than supported by your circular buffer, youstill have control over the situation and do not have to redo major work. At the end, when you are fully satisfied you can always erase the saved intermediate filesusing operating system commands (Delft3D-DIDO never erases files, it overwrites files onlyafter explicit user permission). Option In drawing the polygon for irregular aggregates or for cut-outs, you can at any momentswitch from mouse input to input of the co-ordinate pair (x,y) to specify the next point. Youdo so by suspending (right mouse button) the polygon and selecting the next point 'ByKeyboard'. The reverse action is to suspend keyboard input by pushing theCancel button ofthe 'By Keyboard' window and select the 'Next point' 'By Mouse'. 7.1Regular aggregate Make a cut-out of the area you want to aggregate regularly (every n x m cells). 7–2WL | Delft Hydraulics Delft3D-DIDOUser Manual Available grid-edit actions November, 2006 Version 3.43 Zoom in to that part of the area where the careful selection if the start cells for regularaggregation is important for the usefulness of the final result. SelectRegular from theAggregate drop-down of the Grid Window menu.SelectOptions to set/reset the span of control of your aggregation. SelectSelect corner cells to enter the mode where you can point to the two oppositeouter corner cells for the 'seed-cell' of your regular aggregation.When you want to reselect the first corner cell, pressSelect corner cells again. Selecting thesecond corner cell immediately starts processing of the selection. You may quit this aggregation without any effect by selectingCancel before selection of thesecond point. All commands mentioned are part of theAggregate - Regular drop-down of the Grid WindowMenu. 7.2Irregular aggregate Zoom in into your area of interest. SelectIrregular from theAggregate drop-down. SelectOptions to set/reset the span of control of your aggregation. SelectNext point to start forming a polygon to indicate the newly DELWAQcomputational element.Delft3D-DIDO considers all grid cells of which the mid-point is within the polygon, asenclosed by the polygon. You add points to the polygon by clicking the left mouse button.Either suspend working with the right mouse button, or just drag the rubber-band line behindyou, and selectBack one point from the 'Irregular' drop-down to undo the last point of thepolygon. You may step backwards along the whole polygon when you like, but in that casetheCancel option of the 'Irregular' drop-down may be quicker. SelectLast point to close the polygon and perform irregular aggregation. Remarks: You may, after suspending work on the polygon, continue in any other Grid Window byselectingNext point in theIrregular drop-down of that window. There is a limited possibility to leave a polygon suspended and perform other actions inthe mean time. You are however advised, if possible, to complete the polygon and thusyour aggregation action, before invoking other actions.Warning The procedure for this irregular aggregation is almost equal to the procedure for a cut-out.Which action will be performed depends on the drop-down in which you selectLast point. WL | Delft Hydraulics7–3 November, 2006Version 3.43 Available grid-edit actions Delft3D-DIDOUser Manual When you started with aggregation, but finishes in theCut out drop-down, the action that istaken is a cut-out. (You may correct this by drawing a polygon around the cut-out andaggregate irregularly with options set to 'cut-out-only'. After return to the display of the'Whole area' you have performed the wanted aggregation.) 7.3Point and click SelectPoint and click from theAggregate drop-down. SelectSelect from thePoint and click drop-down and indicate with the mouse and theleft button the cell to assign to a different area. (If mistaken, just selectSelect againand point more accurately.)SelectTarget from thePoint and click drop-down and indicate with the mouse and theleft button the area to assign the selected cell to. (If mistaken, the 'One step back' inthe circular buffer is the easiest way to correct.)SelectInactivate to assign the selected cell to the Cut-out area (which is not visible asa target area).SelectCancel to end this command without consequences. Warning The 'Point and click' feature enables fine tuning, but it also enables joining computationalelements that do not have a common border. This may result in the formation of isolated partsof a DELWAQ segment, within an area covered by other DELWAQ segments. Presently thereis no warning message issued if this happens. You must prevent this from happening bycareful operation. 7.4Break up a segment SelectBreak up from theAggregate drop-down. Select the bigger DELWAQ segment to break up in its constituting hydrodynamic gridcells with the left mouse button.SelectCancel to end this command without action. 7.5Roll back SelectManagement from the menu of the Grid Window. SelectBack one step orForward one step to move in a circular memory buffer. 7–4WL | Delft Hydraulics Delft3D-DIDOUser Manual Available grid-edit actions November, 2006 Version 3.43 The buffer generally contains one previous state, so you generally are able to undo the lastoperation with one mouse click. In the Main Window the 'Settings' menu item enables theexpansion of the circular buffer to a higher number of situations. You can do this 'on the fly'.The last action is always available in the buffer. This means that if 'Back one step' shows thatthe action 'Rolled back' was nevertheless a useful action, it is retrieved again with 'Forwardone step'. 7.6Information There are two ways to get information, finding one or more cells from their characteristicsand pointing at a cell and getting its characteristics. SelectCell from theInfo drop-down of the Grid Window When you point a cell with the left mouse button, a window opens displaying thecharacteristics of this cell. You may continue pointing with the window open, to scan the area.It is then generally most efficient to locate the window besides the Grid window you areworking in, in a non-overlapping way. You may switch to other Grid windows during yourscanning. This mode stops by pressingOK in the pop-up window. SelectFind cell from theInfo drop-down of the Grid Window This opens a window to enter one of the identifiers of the cell you want to find. After pressingOK the wanted cells are coloured red on the grid. These cells may be located outside of the'zoom window' that was used to create the Grid Window. Select 'Zoom out' to get the wholearea when needed. When specifying a DELWAQ computational element number, Delft3D-DIDO also returns thenumber of hydrodynamic grid cells that form the selected DELWAQ computational element. 7.7Bottom depth values For each 'Grid Window' you can select to display the bottom depth values in coloured contourlines. This option is only possible for those hydrodynamic model files that contain thatinformation. You can select this option through theManagement drop-down of the 'GridWindow'. Since drawing of the bottom takes time, you will like to use this option only ifneeded. For very dense grids, you may not be able to distinguish grid cells on screen, just becausealso the mid-points in the grid are drawn. One of the menu items of the 'Management' drop-down is the 'No Midpoints' option. This switches the drawing off for that 'Grid Window' only.The same could be the case for the drawing of the bottom depth contours. If the grid is dense,the grid itself may hide much of the coloured contours. You can switch the drawing of the gridoff by the 'No Grid' option. WL | Delft Hydraulics7–5 November, 2006Available grid-edit actions Version 3.43 blank page 7–6Delft3D-DIDOUser Manual WL | Delft Hydraulics Delft3D-DIDOUser Manual Available other coupling actions November, 2006 Version 3.43 8 8.1 Available other coupling actions Layer editor If your hydrodynamic input file has a vertical axis, you can select the \"Layer\" menu itemfrom theEdit drop-down of the main menu. Then you enter a layer editor. It allows you tospecify for each DELWAQ layer, how many hydrodynamic layers should be used. The editorworks from the top of the water column to the bottom. It is initialised with a one-to-onesetting. Once you specify more hydrodynamic layers than one for a DELWAQ layer, you willnote that the number of DELWAQ layers decreases and all settings underneath of thespecified layer are shifted upwards. The layer editor tries to attach as many hydrodynamiclayers as specified using the layers from that location on. If the amount of availablehydrodynamic layers is insufficient, a message is produced and the amount of layers istruncated. In a similar way the editor expands the amount of layers if you specify lesshydrodynamic layers than were originally contained for this DELWAQ layer. 8.2Coupling editor If your hydrodynamic input is supported by the full coupling feature, you may select the\"Couple\" menu item from theEdit drop-down of the main menu. This opens a compoundwindow. Remark If you do NOT confirm the setting in the coupling window, NO coupling will take place.This means that even for coupling using the default settings, you have to open the couplingeditor window and press the OK button in this window.Hydrodynamic model timers The top left part of the compound window displays the model timers as contained in thehydrodynamic model file. These timers are obviously not editable by the user.Coupling timers The DELWAQ file timers can be entered either by 'time' fields or be 'step' fields. The 'time'fields are relative to the model base-time as displayed. The 'step' fields are in units ofhydrodynamic model file steps. You may notice that when you select one input option, theinput field of the other input option changes accordingly upon leaving the edit field. Basicconsistency checks are performed during input.Additional files WL | Delft Hydraulics8–1 November, 2006Version 3.43 Available other coupling actions Delft3D-DIDOUser Manual In the top right most part of the compound window you see some information items selectableor hidden (like Salinity, Chezy, Wind and others). These items are only selectable if sufficientinformation is available in the hydrodynamic input file to produce additional DELWAQ fileson the selected item. The default setting of all selectable switches is You may want to monitor mass balance errors during the coupling procedure. These massbalance errors may originate from incomplete iteration of numerical schemes or just fromerrors in the files or in the Delft3D-DIDO processing that will make the results meaningless.You specify your mass-balance-error-threshold value either in mm water column (this is anabsolute value) or in a fraction of the element volume (this is a relative value). These checks are performed on the DELWAQ segments that may contain multiplehydrodynamic grid cells. Negative volumes and cross-sections You may want Delft3D-DIDO to check the positiveness of volumes and cross-sections. Thesechecks are done on the original hydrodynamic grid cells.Prompt on error If you do not select this option, errors are corrected where possible (by setting the volume on1 m3 and the surface of 1 m2 where needed) and coupling continues. The errors are reported inthe output-log-file of the coupling. If selected, a prompt screen is opened and execution ishalted. You now must specify if you want processing to continue or stopped.Maximum time step size You may monitor the maximum time step size in seconds that can be set by the explicitschemes in the DELWAQ model. The horizontal and vertical dispersion coefficients play arole in this time step size. You may prescribe an estimate of the values that you will use insimulations.Total file size At the bottom right part of the compound coupling window you see the estimated file size.You must yourself check if sufficient disk space is available. It is safe to add at least some 20% to the value as given. This value is an estimate because the value is adjusted after everychange in the coupling specification and precise computation would take too muchcomputation time for an interactive system. 8–2WL | Delft Hydraulics Delft3D-DIDOUser Manual Online help November, 2006 Version 3.43 9 Online help An online help is provided. This system uses the Help facilities of the hardware-operatingsystem platform you are working on. You are referred to the documentation of the online Helpfacilities of your platform for more details. Most common facilities are however:Running through the Help file using its table of contents You invoke the Help system either through the Help drop-downs in the window-menus or bypressing On some systems a question mark appears and you may click the window you want to getHelp on. If no help is available for that window, you enter the general help file contents.The most powerful context sensitive help is the Unfortunately this feature does not work on all platforms either.Display help on keywords On some systems a list of available keywords opens and clicking on a keyword gives help onthe keyword. On some systems you may add keywords to the list yourself. On some systemsyou may start typing a keyword and the system automatically skips to the fist keyword thathas the same initial letters as you just typed. WL | Delft Hydraulics9–1 November, 2006Online help Version 3.43 blank page 9–2Delft3D-DIDOUser Manual WL | Delft Hydraulics Delft3D-DIDOUser Manual Command reference November, 2006 Version 3.43 10 Command reference This command reference is organised per menu and subsequent sub-menus. 10.1Main window Title bar top left button (system dependent) Opens a drop-down with system commands to move, scale, minimise, maximise and/or closethe application. TheClose option performs identical to theExit option of the Main WindowFile drop-down menu. Title area Displays (after the Delft3D-DIDO identifier) the application name after initialisation.top right button(s) (system dependent)Button to iconise the window.Borders The Main Window is fixed size and has thus a single line border.Menu File Manages the Delft3D-DIDO system files. It is NOT used to import and export applicationdata. New Opens an edit window to enter an 8 character identification string ('appname') for this newapplication. The identification string is displayed in the Main Window title area and is usedas default file name for system files and for export files to DELWAQ. Open Opens a file selection window with the default extension (.did) for Delft3D-DIDO systemfiles as file filter. You are referred to your system manual for the operation of the fileselection window since it is the standard file selection window for your system. Afterselection, the system file (a previously saved Delft3D-DIDO application) is loaded and workcan be resumed. Save Saves the current work in a system file 'appname.did' with 'appname' the 8 characterapplication identifier. If a system file with the same name exists, you are prompted for WL | Delft Hydraulics10–1 November, 2006Version 3.43 Command reference Delft3D-DIDOUser Manual confirmation. All current work is saved up to the last fully completed action. The system filecontains all settings, inclusive of the circular memory buffer. Save as Opens a file selection window with the default file name 'appname.did' to save the system file.User may enter any file name to save the system file. It is strongly recommended to use thedefault extension of '.did'. You are referred to your system manual for the details of theoperation of this dialogue since it is the standard file dialogue as used on your system. Whenthe supplied file name exists, you are prompted for confirmation. Exit Ends the application and prompts for confirmation if there is unsaved information available inthe application. Import/Export Manages all data entering Delft3D-DIDO as result of hydrodynamic simulations and all dataleaving Delft3D-DIDO for water quality simulations. Above the separation line allhydrodynamic models supported by your implementation are displayed, below the separationline all water quality models supported by your implementation are displayed. (Hydrodynamic model name) Opens a file selection dialogue with the default filename filter for the hydrodynamic modelresult files coming from the indicated hydrodynamic model. After selection an hour glass mayindicate that reading of data is in progress. If already information is available within Delft3D-DIDO with respect of the same type ofsupported hydrodynamic input file, you are able to 'Add' the new file to the Delft3D-DIDOsession. This means that the aggregated grid and coupling options are maintained and areused for the newly specified file. This procedure is especially useful for repeatedly couplingof hydrodynamic input files in the same way. Delft3D-DIDO checks is the grid layout itcontained is compatible with the newly selected file. The alternative to \"Add\" is to 'Overwrite'the available application with the newly imported data. From release 3.24 on the Delft3D-FLOW, the SIMONA and the SCALDIS hydrodynamicmodel files are supported. Aggregation This import facility becomes selectable as soon as a hydrodynamic model file is importedsuccessfully. The option allows for the import of an aggregation file that was previouslysaved using the Delft3D-WAQ export option. The meaning of this facility is to allow the userto save an aggregation on one platform and to import it on another platform. The Save andSave-as options of the File menu produce a platform dependent file that can only be reloadedwith the same operating system. Delft3D-WAQ Opens a file selection dialogue with the 'appname' as file name and the default extension forthe supported water quality model as filter. You may position the dialogue in a way to savethe file in the preferred directory. You may change the filename as well. You are advised notto change the extension. 10–2WL | Delft Hydraulics Delft3D-DIDOUser Manual Command reference November, 2006 Version 3.43 If your version supports direct coupling computations (like with SIMONA files), thencoupling takes place only after the coupling settings have been confirmed in the Couplingmenu by pressing the OK button. If not, then only an ASCII aggregation file is produced thatcan serve as input to an external coupling program (like with Delft3D-FLOW). This ASCIIfile can be migrated to another platform and imported using the Aggregation option of theImport/Export drop-down. BNA file Produces an ARC-INFO/ARC-VIEW type file to define the grid cells by their corners. Thegrid cell ID contains the Delft3D-WAQ segment number. This number is zero for inactivecomputational elements. If aggregation is applied, more computational elements will have thesame ID. SIMGIS file Produces a file that can be used by the SIMONA to GIS coupling system SIMGIS.Edit Contains all edit facilities supported by Delft3D-DIDO. Grid Opens a grid window with the complete hydrodynamic grid as processed at the moment ofopening. This means that all cut-outs and aggregations up to the moment of opening areapplied. Even an incomplete polygon may show. Layers Only opens if a vertical axis is available in the hydrodynamic input. It opens the layer editorin the state that it is left with. Couple Only selectable for hydrodynamic models with a fully supported coupling option. It opens acoupling editor window allowing to specify coupling time step sizes, additional files to beproduced and switches for other coupling options with their associated input. Also anestimate of the output file sizes is produced. Actual coupling will only take place if this window has been opened and its contents has beenconfirmed using theOK button. Settings Contains all environment setting supported by Delft3D-DIDO. History Opens a dialogue to adjust the current setting of circular history buffers. One level (one undo)is the system default. Zero levels (no undo possible) and over 1 level are options to decreaseor increase the circular buffer in core. Help System dependent online Help system. Consult your system manual for detail explanation.MS-Windows WL | Delft Hydraulics10–3 November, 2006Version 3.43 Command reference Delft3D-DIDOUser Manual * Contents Gives Help through a hypertext system of links along a tree of text windows, with green textstrings indicating a hypertext link.* Search for help on Gives a list of keywords to provide help on.* How to use help MS-Windows own hypertext system to explain the Help-viewer.* About Delft3D-DIDO version number about box. * Click with left mouse button on a menu item and press You may also enter the file manager and double click the UNIX/OSF-MOTIF* On context Displays a question mark, provides context sensitive help by clicking on a window.* On help Gives information on the use of the Help feature.* On Window Opens the help information associated with this window.* On Keys Not implemented.* Contents Provides the OSF/MOTIF online hypertext help system filled with the Delft3D-DIDO treestructured help information.* Index Gives an alphabetical index of all help items contained in the Help system.* On version Provides the Delft3D-DIDO version information. * Click with left mouse button on a menu item and press 10.2Grid window Title bar ·top left button (system dependent) Opens a drop-down with system commands to move, scale, minimise, maximise and/or closethe application. TheClose option performs identical to theExit option of the Grid Window'Window' drop-down menu.Title area Displays the application name. 10–4WL | Delft Hydraulics Delft3D-DIDOUser Manual Command reference November, 2006 Version 3.43 Top right button(s) (system dependent) Button to iconise the window and button to maximise the Grid window.Borders The Grid Window has double borders, indicating that it can be sized by the user. After(re)sizing the (zoomed in) area of the original Grid Window is scaled to fit within the newGrid Window sizes. The aspect ratio is maintained, so no distortion takes place. Whenzoomed in, this may lead to a display of a larger area than was covered by the original size ofthe Grid Window when the width-height ratio differs.Menu Window Manages the behaviour of your Grid window. Refresh Refreshes the Grid window content, using the last aggregation table. Save-zoom Saves the co-ordinates of the 'Grid Window' in an ASCII file. This file is used by the Delftanimation post processor to generated animations on the zoom-area. Print Prints the grid. Use thePrint setup item of theFile drop-down of the main window first, tospecify printer settings. For MS-Windows the system printer is used. For OSF-MOTIF aPost-Script file is generated that should be printed by the normal procedure for printing Post-Script files on your system.Exit Closes the Grid window. Zoom Manages all zooming in and out in the Grid window. In Enters the zooming mode. With a click of the left mouse button, you mark one of the corner points of the area to bezoomed in on. From that time on your mouse drags a rubber band window. A new click with the left mouse button marks the opposite corner of the zooming window. Anew Grid window opens with the correct width to height ratio to contain the zoom area. Youmay close the original Grid window without affecting the Grid windows derived from it.A click with the right mouse button ends an unfinished zoom operation. Out Within the Grid window itself, the inner area is erased and the complete model area is scaledto fit in this Grid window and is drawn. So no new Grid window is opened. WL | Delft Hydraulics10–5 November, 2006Version 3.43 Command reference Delft3D-DIDOUser Manual Cancel Both before the first corner of the zoom area is marked and after it is marked, it is possible toend the unfinished zoom operation by choosingCancel.Aggreg.(ate) Manages all (dis)aggregation actions. Regular Manages the aggregation of n x m grid cells of a regular grid, starting from indicatedlocations. Options Opens an Options window for regular aggregation. The options are toggle buttons for:1) limiting aggregation to the cut-out area only or the whole area2) overriding of earlier regular aggregations or not3) overriding of earlier irregular aggregations or not4) expand aggregation to the open boundary cells or not The options are specific for regular aggregations. The option settings are saved for allsubsequent work within this application until explicitly changed. For a new application theoptions are set as conservative as possible (Cut-out area only, no over-ridings and noexpansion). The new option settings become effective only after pushing theOK button! Select corner cells Starts a mode where you click two opposite corner cells with the left mouse button to markone of the newly formed water quality segments. The aggregation expands from this cell in alldirections, aggregating every n x m hydrodynamic grid cells. A completed aggregation can only be rolled back using the 'Back one step' option of the'Management' drop-down. You may exit this mode without finishing aggregation by selectingCancel from theRegularsub drop-down. You may also click the right mouse button to end the regular aggregationunfinished. To reselect a first corner for aggregation, pressSelect corner cells again. The first selectiondisappears. All selected hydrodynamic grid cells are marked red.Cancel Ends an unfinished regular aggregation procedure. Irregular Manages the aggregation of an arbitrarily shaped configuration of hydrodynamic grid cells,specified by providing a polygon. All grid cells that have their centre within the polygon, areassumed to be selected. Options Opens an Options window for irregular aggregation. The options are toggle buttons for:1) limiting aggregation to the cut-out area only or the whole area 10–6WL | Delft Hydraulics Delft3D-DIDOUser Manual Command reference November, 2006 Version 3.43 2) overriding of earlier regular aggregations or not3) overriding of earlier irregular aggregations or not4) expand aggregation to the open boundary cells or not The options are specific for irregular aggregations. The option settings are saved for allsubsequent work within this application until explicitly changed. For a new application theoptions are set as conservative as possible (Cut-out area only, no over-ridings and noexpansion). The new option settings become effective only after pushing theOK button! Back one point Indicates that the last point of the polygon must be deleted. Repeated operation of this buttoncauses the whole selected polygon to be eliminated from the last point on. This option is onlyeffective if there are still selected points left. Next point Starts selection mode for the polygon. You can select to specify the polygon using thekeyboard and typing (x,y) pairs of co-ordinates or by mouse clicks on the map. Both modescan be used interchangeably. This mode can be suspended either by clicking the right mousebutton or byCancel from the 'By Keyboard' window, or by selecting 'Suspend' from the'Irregular' sub-drop-down. If suspended, selection of the 'Next point' command resumes thecreation of the polygon, even when used in a different Grid window! To change fromKeyboard to Mouse option and the reverse, you must suspend first. Suspend Suspends polygon selection, keeping the current points in memory. You may zoom in or zoomout, open new Grid windows or perform any other act that may be useful for further polygoncreation and then resume polygon selection by pressing 'Next point', even in a different Gridwindow. Last point This command closes the polygon and performs the aggregation. The newly formed waterquality grid cell is showed in the active Grid window only. The other Grid windows areupdated only when the user issues explicitly a 'Refresh' command from the 'Window' drop-down, or when a Grid window is (partially) redrawn due to scaling and rearranging windowson your desk top. A completed aggregation action can only be rolled back using the 'Back one step' option ofthe 'Management' drop-down. Cancel Ends an unfinished irregular aggregation. Point and click Manages all actions aimed at fine tuning of aggregations by assigning single hydrodynamicgrid cells by marking them and clicking on the water quality segments where they should beadded to. This procedure also allows for adding single hydrodynamic grid cells to the cut-outarea (which itself is not displayed). This selection mode overrides all other aggregations ! WL | Delft Hydraulics10–7 November, 2006Version 3.43 Command reference Delft3D-DIDOUser Manual Select Enters a selection mode, where the hydrodynamic grid cell to be assigned, can be selected bypointing and clicking with the left mouse button. Reselection is possible by pressing 'Select'again. Target Indicates that now the water quality segment will be indicated where the selectedhydrodynamic grid cell will be assigned to. Inactivate Assigns the selected hydrodynamic grid cell to the cut-out area. When no cut-out area isformed yet, one is created, containing this very cell. Cancel Ends an unfinished Point and Click assignment. Finished assignments can only be rolled backusing the 'Back one step' command of the 'Management' sub drop-down. Break up Manages all actions to break up aggregated water quality segments in their individualhydrodynamic grid cells. Select Enters the selection mode. By pointing and clicking the left mouse button the water qualitysegment is selected and split up. After a break-up is performed, this mode remains in effect. It can only be ended by selectingCancel. This enables you to break up multiple segments just by repeated pointing andclicking. Cancel Ends the selection mode for break-up. Subset Manages all actions to mark a subset of the hydrodynamic grid for further operation. Thissubset is called a 'cut-out'. The function of the cut-out for regular and irregular aggregationsis determined by the corresponding options settings. When a cut-out is active during the export of a water quality aggregation pointer, it isassumed that the cut-out area is the only area to be used for water quality modelling.Cutout Manages the selection of an arbitrarily shaped configuration of hydrodynamic grid cells, forfurther processing, by providing a polygon. All grid cells that have their centre within thepolygon, are assumed to be selected. Back one point Indicates that the last point of the polygon must be deleted. Repeated operation of this buttoncauses the whole selected polygon to be eliminated from the last point on. This option is onlyeffective if there are still selected points left. 10–8WL | Delft Hydraulics Delft3D-DIDOUser Manual Command reference November, 2006 Version 3.43 Next point Starts selection mode for the polygon. You can select to specify the polygon using thekeyboard and typing (x,y) pairs of co-ordinates or by mouse clicks on the map. Both modescan be used interchangeably. This mode can be suspended either by clicking the right mousebutton or by 'Cancel' from the 'By Keyboard' window, or by selecting 'Suspend' from the 'Cut-out' sub-drop-down. If suspended, selection of the 'Next point' command resumes the creationof the polygon, even when used in a different Grid window! To change from Keyboard toMouse option and the reverse, you must suspend first. Suspend Suspends polygon selection, keeping the current points in memory. You may zoom in or zoomout, open new Grid windows or perform any other act that may be useful for further polygoncreation and then resume polygon selection by pressing 'Next point', even in a different Gridwindow. Last point This command closes the polygon and performs the definition of the cut-out. The area outsideof the cut-out is no longer displayed. Update occurs in the active Grid window only. Theother Grid windows are updated only when the user issues explicitly a 'Refresh' commandfrom the 'Window' drop-down, or when a Grid window is (partially) redrawn due to scalingand rearranging windows on your desktop. A completed cut-out action can be rolled back using the 'Back one step' option of the'Management' drop-down. It can be also cancelled by selection of 'Whole Area'.Cancel Ends an unfinished cut-out selection. Whole area This commands disables a cut-out and uses the whole model area again for subsequentactions. Only the active Grid window is updated. The other Grid windows are updated asresult of an explicit 'Refresh' command from the 'Window' drop-down or when a Grid windowis (partially) redrawn due to scaling and rearranging windows on your desk top. Info Manages all options that provide information on hydrodynamic grid cells and water qualitysegments. Cell Enters a selection mode. By pointing and clicking the left mouse button, cells are selected. Apop-up window appears giving: 1) the n and m co-ordinates of the cell, 2) the x and y-value of the centre of the cell 3) the hydrodynamic sequential LGRID number of the cell4) the DELWAQ (aggregated) segment number The selection mode remains effective until theOK push button in the pop-up is pressed. Thisenables repeated selecting of cells for information. When you want to select repeatedly, it ismost effective to move the pop-up to the desk-top area outside of the active Grid window. WL | Delft Hydraulics10–9 November, 2006Version 3.43 Command reference Delft3D-DIDOUser Manual Find cell Opens a dialogue box with a selection field, one or two edit fields and anOK andCancelbutton. The possible options of the selection field are:1) Specify the LGRID number of the wanted cell 2) Specify the DELWAQ segment number of the wanted segment3) Specify the n and m co-ordinates of the wanted cell 4) Specify the x and y-value you want the closest match with. For option 3) and 4), two edit windows are opened since two entries are required. Wherepossible, the Delft3D-DIDO system indicates the valid range for your input. After pushing the OK button the required grid cell or water quality segment is coloured red inyour grid. For the water quality segment all contained hydrodynamic grid cells are colouredand the number of hydrodynamic grid cells aggregated in this segment is displayed. Management Manages the circular buffer of previous states. The size of the buffer (specified as number ofstates that can be remembered) is set in the 'Settings' drop-down of the menu of the MainWindow. Only operations on the grid configuration (commands from the aggregation and cut-out drop-downs of the Grid menu) are remembered. When the circular buffer is set to 0, onlyone state is available, which is the present state. When the circular buffer is set to 2, threestates are available: the present state and 2 saved states. Back one step Takes the previous entry of the circular memory buffer as the present state. The state asbefore this action is not lost. With 'Forward one step' it is retrieved again. If more previousentries exist (circular buffer set to 2 or larger), using 'Back one step' again restores the stateof 2 actions back. If not, then the circle is around and the state before the action is restoredagain. The next action, aggregation or cut-out, that is initiated, starts from the current state,as displayed in the active Grid window. Every action overwrites the oldest state available inthe circular buffer. Foreward one step Sets one step forward in the circular buffer. This restores the oldest state available in thebuffer, the state that had been overwritten first, had an action been applied instead offorwarding the buffer pointer. Bottom If bottom depth values were contained in the hydrodynamic input, you can select the displayof bottom values. They are colour contour pictures, bi-linearly interpolated. Also a colourindex window opens with threshold values and associated colours. This index window iseditable in several ways. You may change the threshold values and refresh your 'Grid'window to adapt to the new threshold values. You may also click on one of the colour blocks.Then a colour editor opens, allowing you to change the Red-Green-Blue setting of this colour.No Midpoints The 'No-Midpoints' switch suppresses the painting of midpoints. This is useful for very densegrids.No Grid 10–10WL | Delft Hydraulics Delft3D-DIDOUser Manual Command reference November, 2006 Version 3.43 The 'No-Grid' switch suppresses the painting of the grid. This is useful for very dense gridstogether with e.g. the painting of the bottom. Help System dependent online Help system. Consult your system manual for detail explanation.MS-Windows* Contents Gives Help through a hypertext system of links along a tree of text windows, with green textstrings indicating a hypertext link.* Search for help on Gives a list of keywords to provide help on.* How to use help MS-Windows own hypertext system to explain the Help-viewer.* About DIDO version number about box. * Click with left mouse button on a menu item and press You may also enter the file manager and double click the UNIX/OSF-MOTIF* On context Displays a question mark, provides context sensitive help by clicking on a window.* On help Gives information on the use of the Help feature.* On Window Opens the help information associated with this window.* On Keys Not implemented.* Contents Provides the OSF/MOTIF online hypertext help system filled with the Delft3D-DIDO treestructured help information.* Index Gives an alphabetical index of all help items contained in the Help system.* On version Provides the Delft3D-DIDO version information. * Click with left mouse button on a menu item and press WL | Delft Hydraulics10–11 November, 2006Command reference Version 3.43 blank page Delft3D-DIDOUser Manual WL | Delft Hydraulics 10–12Delft3D-DIDOReferences User Manual 11 References WL | Delft Hydraulics., 2006a. Delft3D-WAQ User Manual, version 4.02.WL | Delft Hydraulics., 2006b. Delft3D Installation Manual, version 4.01.WL | Delft Hydraulics., 2006c. Delft3D-FLOW User Manual, version 3.13. WL | Delft HydraulicsNovember, 2006 Version 3.43 11–1 November, 2006Command reference Version 3.43 Blank page Delft3D-DIDOUser Manual WL | Delft Hydraulics 11–2 因篇幅问题不能全部显示，请点此查看更多更全内容