Professional Documents
Culture Documents
This document is the MOHID Studio User Guide. It contains explanation of all features and tools of MOHID Studio. This document makes part of the MOHID Studio Documentation.
Index
1
1.1 1.2 1.3
PREFACE
Copyright Warranty Further Information
1
1 1 1
2
2.1 2.2 2.3 2.4 2.5 2.6 2.7
INTRODUCTION
Features Backward compatibility MOHID in Action MOHID Studio Editions Concepts behind MOHID Studio Starting MOHID Studio Main Window Dockable Windows Main Menu
2
2 2 2 3 4 5 5 6 7 7 8 9 9 9 11
Home menu Getting Started with MOHID Studio Workspaces Introduction to Workspaces Working with Workspaces Managing Workspaces
3
3.1
PROJECT MANAGEMENT
Solution Creating or opening solutions Closing solutions
12
14 14 15
3.1.1 3.1.2
Domains Creating domains Domain properties Removing domains Managing domains Nested domains
Simulations Creating simulations Simulation properties Root and sequential simulation Removing simulations Files associated to simulation Copying simulation data files Cleaning simulation result files
Organizing data files Data files associated to simulations Data files associated to domains
Editing data files Executing Models Executing a single simulation Executing a set of simulations Simulation progress
3.7.1 3.7.2
4
4.1 4.2
33
33 35
ii
MOHID ASCII Layers XYZ Points layer Grid layer Grid Data layer Drainage Network layer Polygons layer
HDF Files Grid Map Vector (Arrow) Map Drainage Network Map Lagrangian Particle Map
Other Vector Layers ESRI Shapefiles Layers XML Geometry Layers HGT Layers
Monitoring Station Layers Label Layers Moving Layers Layer Styles Simple Vector Style Gradient Layer Style Transparency Layer Style Classified Layer Style Arrow Layer Style Style Templates
iii
GRAPH VISUALIZATION
Introduction Graph Windows Introduction Create from MOHID ASCII Time Series File Create from MOHID Studios database Closing a Graph Window Saving a graph window Open a saved graph Create from Explorer
65
65 66 66 67 67 67 67 67 68 68 68 69 69 69
5.4.1
6
6.1 6.2
70
70 70 70 72 74 76 78 79 83 86 87 88 89 90 91
Reports Report by Parameter Report by Time Series Report by Monitoring Station Report by Min/Max Values Report by Moving Time Series
iv
TOOLS
Introduction Geometry Layer Tools Introduction Named Points Named Lines Named Polygons XYZ Points
93
93 93 93 94 94 95 96 96 96 97 98 98 99 99 99 100 101 102 102 103 104 106 107 108 108 108 109 109 110 110 110 110
Grid Tools Introduction Constant Grid Variable Spaced Grid Refine Grid
Grid Data Tools Introduction Creating Grid Data from Points Creating Grid Data from Shapefiles Modifying a Grid Data
Watershed Tools Introduction Depression Removal Watershed Delineation Cross Section Definition Soil Depth
Time Series Tools Introduction Grid Time Series Location Node Time Series Location Time Series from Database
HDF File Tools Introduction Create from Time Series Interpolate HDF Files
7.8.1 7.8.2
8
8.1 8.2
113
113 113 113 114 115 115 116 116 116 116 116 117 117
Export to ESRI Shapefile Export HDF Polygon to Shapefile Export Grid Data to Shapefile Export Drainage Network to Shapefile Export Named Geometry to Shapefile
Convert MOHID ASCII Geometries to XML Geometries Convert XML Geometries to MOHID ASCII Geometries
9
9.1 9.2
ADMINISTRATION
Introduction License Management Introduction License Manager License Request License Emission License Validation
119
119 119 120 121 123 124 125
10
10.1
FILE FORMATS
Introduction
126
126
vi
XML Files Introduction XML Named Points Files XML Named Lines Files XML Named Polygon Files
10.4.1 10.4.2
vii
Index of Tables
TABLE 1 : MOHID STUDIO LICENSE OVERVIEW TABLE 2: EXAMPLES FOR ZOOM LEVELS (BLUE MARBLE IMAGE GALLERY) TABLE 3: DISPLAY NUMERICAL FORMATS EXAMPLES TABLE 4 : MOHID STUDIO LICENSE FEES (OCTOBER 2010) 4 38 72 121
viii
Index of Figures
FIGURE 2-1: EXECUTE MOHID STUDIO FIGURE 2-2: MOHID STUDIOS MAIN WINDOW FIGURE 2-3: MOHID STUDIOS MAIN WINDOW (SIDE BY SIDE DOCKING) FIGURE 2-4: EXAMPLE OF A RIBBON MENU (MAP) FIGURE 2-5: HOME MENU FIGURE 2-6: CREATE A NEW WORKSPACE OR LOAD AN EXISTING ONE FIGURE 2-7: SAVE WORKSPACE ON PROGRAM EXIT FIGURE 2-8: MANAGING WORKSPACES FIGURE 3-1: PROJECT MENU FIGURE 3-2: EXPLORER WINDOW FIGURE 3-3: ACCESSING PROJECT MANAGEMENT OPTIONS FROM THE CONTEXT MENU FIGURE 3-4: CREATING A NEW SOLUTION FIGURE 3-5: MANAGING SOLUTIONS FIGURE 3-6: EXPORTING SOLUTIONS FIGURE 3-7: IMPORTING SOLUTIONS FIGURE 3-8: CREATING A NEW DOMAIN FIGURE 3-9: DIRECTORY STRUCTURE FOR A DOMAIN FIGURE 3-10: MANAGING DOMAIN FIGURE 3-11: REMOVE DOMAIN FIGURE 3-12: PROJECT TREE SHOWING A DOMAIN WITH A NESTED DOMAIN FIGURE 3-13: CREATING A NEW SIMULATION FIGURE 3-14: PROJECT TREE SHOWING ROOT AND SEQUENTIAL SIMULATION AND THE USAGE OF BRANCHES FIGURE 3-15: FILES ASSOCIATED TO SIMULATIONS FIGURE 3-16: PROJECT TREE CONTEXT MENU TO PERFORM TASKS RELATED WITH THE GENERAL DATA DIRECTORY FIGURE 3-17: FILE EDITOR WITH TWO OPEN DATA FILES FIGURE 3-18: SCHEDULING A SET OF SIMULATIONS FIGURE 3-19: SCHEDULING NESTED DOMAINS FIGURE 3-20: MODEL CONTROLLER WINDOW FIGURE 3-21: MODEL SCREEN OUTPUT WINDOW FIGURE 3-22: HDF LIST VIEW WITH COMMANDS FIGURE 3-23: TIME SERIES LIST VIEW WITH COMMANDS FIGURE 4-1: MAP MENU FIGURE 4-2: MAP WINDOW FIGURE 4-5: ACCESSING MAP OPTIONS FROM THE CONTEXT MENU Action Modulers - www.actionmodulers.com 26 27 29 30 30 31 32 32 33 34 35 ix 23 24 5 6 7 7 8 10 10 11 12 13 14 14 15 16 17 18 19 20 20 21 22
xi
xii
Preface
1.1 Copyright
This document refers to MOHID Studio, priority software protected by copyright. All rights are reserved. Copying or other reproduction of this manual, or related documents, is prohibited without prior written consent of Action Modulers, Consultores de Segurana (Action Modulers). MOHID Water Modelling System is priority software of the Technical University of Lisbon.
1.2 Warranty
The warranty given by Action Modulers is limited as specified in your Software License Agreement. Please note that numerical modeling software programs are very complex system and may not be free of errors, so you are advised to validate your work. Action Modulers shall not be responsible for any damage arising out of the use of this document, MOHID Studio, MOHID Water Modelling System or any related program or document.
Introduction
MOHID Studio is a graphical user interface for the MOHID Water Modelling System. With MOHID Studio you can use MOHID Numerical Engines from inside a user friendly environment, managing all tasks required in order to prepare, execute and analyze results of numerical simulations done by MOHID Numerical Engines.
2.1 Features
MOHID Studio is an integrated system which permits to manage and edit data files, create and launch simulations and analyze model results. Map data can be displayed through an integrated GIS system and time series data can be displayed an integrated graph visualization engine. A set of tools allows the user to create and preprocess MOHID data files. A special module allows managing data from field campaigns and/or automatic stations. MOHID Studio features also offer the possibility to convert data among a set of common formats and MOHID internal formats. All features of MOHID Studio are described along this user guide.
Feature
Number of single machines where license can be installed Maximum number of layers which can be displayed in the GIS engine Maximum number of domains which can be created within a single workspace Maximum number of scenarios which can be configured within a single workspace Maximum number of nested domains which can be created Maximum number of simultaneously opened XY Graph windows Watermarks free images License Period (month) Price (Euros)
1 3
1 unlimited
1 unlimited
5 unlimited
unlimited
unlimited
unlimited
unlimited
unlimited
unlimited
unlimited
unlimited
unlimited
1 No 6 Free
unlimited Yes 12
During Beta Test license are distributed free of charge. Visit www.actionmodulers.com or contact
Beside the Explorer window and the Map window (that are always open) other windows may appear in the client area of the main window (for example: XY Graphs, Tools, Reports, etc.).
To change the dock state of a window, double click on the title bar (this turns the window floating). Then drag it to the desired position.
The group Getting Started with MOHID has some examples to introduce you to MOHID Studio application. These examples allow importing sample solutions and sample unit tests for a better understanding of MOHID Studio. These samples contain basic examples helping you to create your own solutions and projects (for more information read subsection 2.9). The Links group contains a variety of links where it is possible to find some help with the MOHID community.
2.10 Workspaces
2.10.1 Introduction to Workspaces
Workspaces allow storing the state of MOHID Studio between two consecutive work sessions. For this the workspace keeps track of the current open solution (see section 3.1) and loaded layers (see section 4).
When MOHID Studio exits it will always ask if the user wants to save the current workspace, as shown in Figure 2-7.
Workspaces can be changed or saved at any time during a session. To open a workspace (or create a new one) press Open in Workspace group from menu Home (see Figure
Action Modulers - www.actionmodulers.com 10
There are only two restrictions when managing Workspaces: Names of workspaces must be unique; The workspace currently opened cannot be removed.
11
Project Management
MOHID Studio organizes projects by dividing them into three major units: (i) solutions, (ii) domains and (iii) simulations.2 A solution is the topmost unit and groups together one or more domains. For each workspace, only one solution can be opened by MOHID Studio. A domain is characterized by a geographic region which is covered (through the Digital Terrain Model), the type of numerical model to use (MOHID Water, MOHID Land or MOHID River) and the physical path on the disk where files are stored. Each domain belongs to one or more solutions and contains a set of simulations. In the case of MOHID Water, nested domains can be created. A simulation is one execution of the numerical model over a given period of time. All files (input files and result files) related with the execution also belong to the simulation. Projects can be managed from the Project menu (see Figure 3-1).
Data associated with projects is displayed in the Explorer window (see Figure 3-2). This window is divided into three main areas: (i) the Project Tree on the left, (ii) the Modules window in the middle and (iii) the File Editor on the right.
MOHID GUI had a similar structure. The correspondence from MOHID GUI to MOHID Studio is:
12
The Project Tree shows the hierarchical structure of projects. In Figure 3-2 a solution called OpenMI Implementation is shown. This solution contains two domains: (i) Sample Estuary and (ii) Sample Catchment. The domain Sample Estuary shows two simulations, ReferenceRun and Sim#2. Some functions which can be accessed from the Project menu can also be accessed from the context menu (by clicking on the right mouse button) accessible from the Project Tree (see Figure 3-3).
13
3.1 Solution
3.1.1 Creating or opening solutions
A new solution can be created by selecting Solution -> New from the Project menu (see Figure 3-1) and an existing solution can be opened by selecting Solution -> Open. A window like shown in Figure 3-4 will be shown. When creating a new solution, a name of the solution must be provided.
When a new solution is created or opened, the current solution opened in MOHID Studio will be closed. Note that the solution of the current workspace will be replaced by the new solution opened or created. To prevent unwanted results, save the workspace before open or create the new solution.
14
To change the name of a solution, use the Rename button. Any new name can be given, with the exception that solution names must be unique. To remove a solution, use the Remove button. Any solution can be removed, except the currently opened solution. When a solution is removed, domains associated to the solution are NOT removed. All domains remain available in the Domain Manage (for more information read subsection 3.2.4).
15
The file name must be the ZIP archive to which the solution is exported. By default, the exported ZIP archive does not include the result files (since they can be very large). Result files are only included if the Include Result files options is checked. By clicking the Export button the export process begins. Depending on the number and size of files included in the solution, the process can take more or less time.
16
Importing solutions allows processing two types of solutions: (i) a previously exported solution or (ii) a project from MOHID GUI. To import a previously exported solution check the MOHID Studio option and browse for the ZIP archive which contains the solution. To import a MOHID GUI project check the MOHID GUI option and browse for the MOH file of the MOHID Project. By clicking the Import button the import process begins. Depending on the number and size of files included in the solution, the process can take more or less time. NOTE: If a solution with the same name of the solution to import already exists, the newly imported solution is automatically renamed.
3.2 Domains
Like mentioned previously domains are characterized by a geographic region which is covered (through the Digital Terrain Model), the type of numerical model to use (MOHID Water, MOHID Land or MOHID River) and the physical path on the disk where files will be stored. Each domain belongs to one or more solutions and contains a set of simulations. In the case of MOHID Water, nested domains can be created.
17
The information provided in the Creating a new domain window characterizes your domain. The following restrictions must be fulfilled: the domain name must be unique; the root directory must be empty (when the domain is created or imported).
The path to the Digital Terrain Model may not be specified during domain creation (if, for instance it hasnt been created yet or you want to import to the \General Data\Digital Terrain folder after the project has been created ISTO TEM SER EXPLICADO ALGURES). It is always possible to come back to the window shown in Figure 3-8 by accessing the domain properties. During domain creation, MOHID Studio creates four special folders to store general data files: (i) one root directory (General Data) and (ii) three subdirectories (Initial Conditions, Boundary Conditions and Digital Terrain). It also creates three folders specific for MOHID model runs: (i) data, (ii) exe and (iii) res. The directory structure for one specific folder, after domain creation, is shown in Figure 3-9.
18
NOTE: This approach is different the one used by MOHID GUI, since there is now one General Data folder for each domain (in MOHID GUI the General Data Folder was shared among projects).
19
Using this window is possible to create new domains, by selecting the Add button to edit existing domains by selecting the Edit button and remove a domain by selecting the Remove button. After removing a domain, MOHID Studio asks if the folders associated to the domain are also to be removed (Figure 3-11). By selecting Yes the entire directory will be permanently deleted from your hard disk, including the structure of the domains Root Directory and including all files inside that directory. Before press Yes, make sure that you do not have important files inside that directory or subdirectory.
20
3.3 Simulations
3.3.1 Creating simulations
To create a new simulation, the tree node where the simulation is to inserted must be selected first. This node can either be a domain node or a simulation node, depending of the option if the user wants to insert a first simulation into a domain or temporal sequence of a previous existing simulation. After selecting the desired node, a new simulation can be inserted by selecting Simulation -> New from the Project menu. A window like shown in Figure 3-13 will appear. This window can be used to specify the properties of the simulation: (i) name, (ii) description and (iii) modules to activate.
21
Each simulation receives automatically an ID (internal identification and cannot be changed). All files which belong to a given simulation will contain this ID at the end, before the extension of the file. For example, the input file for the hydrodynamic module of the simulation with ID 5 will be called Hydrodynamic_5.dat.
22
Figure 3-14: Project Tree showing root and sequential simulation and the usage of branches
In case of inserting a simulation which continues from a previous simulation MOHID Studio will automatically set the start date of the newly inserted simulation to the end date of the previous simulation and change the continues compute option in all module data files to true.
23
Data files can be easily modified and saved by MOHID Studio (for more information about this method read subsection 3.5).
24
25
Figure 3-16: Project Tree context menu to perform tasks related with the general data directory Action Modulers - www.actionmodulers.com 26
If a data files for a given module doesnt exist yet, MOHID Studio will create it automatically, using a template with the most common options for the selected module. Inside the File Editor data files have syntax highlighting based in the following rules: Keyword are red Keyword values are blue Block delimiter are purple Comment lines are green
(MOHID DATA FILES AN OVERVIEW reference from HERE???) In the upper right corner of the File Editor are available a set of commands which help to edit data files: Find Text / Replace Text to find / replace a specific text inside the data file Comment / Uncomment lines
27
28
First it is necessary to select the root domain and then all simulations which are to be executed. In the case of nested domains, simulations must be paired like shown in Figure 3-19.
29
30
The execution of the model can be interrupted by selected Kill from the model controller. When a simulation is finished, all screen output from the model is stored. It is possible to access this information by selecting View Last Log from the context menu of the Project Tree.
31
32
4.1 Introduction
MOHID Studio uses a customized Geographical Information System (GIS) to display dynamic maps. Information which can be displayed includes raster images and vector data. All data is presented in form of layers. Raster images are typically used to add a background to the image and can be added from local images and from Web Map Servers (WMS). MOHID Studio supports different kinds of Vector data sources. Special emphasis is given to data related to MOHID models: (i) special ASCII (and XML) files in MOHID format and (ii) model results stored in HDF Files. Other vector data sources can also be added, including ESRI Shapefiles and HGT files. Vector data can be displayed in several different ways, using simple styles or theme based styles. MOHID Studio also supports time animated vector data. Tasks related to the map visualization can be performed from the Map menu (see Figure 4-1).
Layers are displayed in the Map window (see Figure 3-2). This window is divided into two main areas: (i) the Layers List on the left and (ii) the Map Display on the right (see Figure 3-2).
33
The Layers List shows the currently loaded layers of the map. At the bottom of the Layers List is located a small tool box which allows to control the current display time (in the case time animations are loaded). The Date & Time control is detailed explained on subsection 4.2. The Map Display shows the maps based on the currently loaded layers. A small set of tools, located in the upper right corner of the Map Display, allows panning, zooming and querying the map. At the right side of the Map Display appears the legend of the currently loaded layers. Some functions which can be accessed from the Map menu can also be accessed from the context accessible from the Layers List (Figure 4-3).
34
The start time and end time can be changed as well as the step between displayed times. To change the settings press on the green clock (the button on the right of Date & Time control see Figure 4-4). The display time can be changed in the Current Time window as shown on the Figure 4-5.
35
Incomplete!?
36
37
http://www.unearthedoutdoors.net/global_data/true_marble/download
38
39
Figure 4-9 shows an example of the WMS layer for Europe (from DEMIS map) in MOHID Studio.
40
41
42
43
44
45
46
Figure 4-16: Adding a Grid Map vector layer Action Modulers - www.actionmodulers.com 47
48
49
50
51
52
MOHID Studio allows creating style templates to reuse predefined layer styles. Template styles can be applied by hitting the Apply button shown in Figure 4-20.
53
54
On Figure 4-22 it is possible to see two maps but with different simple vector styles. On the first one (top map), country borders are represented by yellow lines and cities are represented with white markers. On the second (bottom map), countries border are represented by black lines, the areas are filled with transparency and the cities are represented with green markers.
55
56
57
59
60
61
62
63
4.13 Images
MISSING Save images Set up images
64
Graph Visualization
5.1 Introduction
MOHID Studio uses a customized graph engine to display time series in from of XY Graphs. The series can be loaded directly from MOHID ASCII Time Series files or from MOHID Studios database. Tasks related with Graph Visualization can be performed from the XY Graph menu (Figure 5-1).
Time Series are displayed in XY Graph windows (Figure 5-2). XY Graph window is divided in two main areas: (i) the Series List on the left side and (ii) the Series Display on the right side.
The Series List shows the currently loaded series and the Graph Display the series graph. A small set of tools, located in the upper right corner of the Graph Display, allows zooming and querying the series graph.
Action Modulers - www.actionmodulers.com 65
66
MOHID Studio User Guide 5.2.2 Create from MOHID ASCII Time Series File
A new Graph Window, using a MOHID ASCII Time Series File as initial source, can be created by selecting Graph Window -> New (File) from the XY Graph menu (see Figure 5-1). After selecting a file containing one or more time series, the Time Series Selection Window will be shown (Figure 5-3). After selecting one or more series press ok button and the new graph window will be created.
67
Templates
5.3 Series
5.3.1 Adding Series
Series can be added, as mentioned previously, from MOHID ASCII Time Series Files or directly from MOHID Studios database. The processes of adding series to an existent Graph Window is the same as create a new window, the only change needed is to select the option Add to an existent graph on Series Selection window (see Figure 5-3).
68
Too short
69
6.1 Introduction
MOHID Studio contains a set of utilities that allow creating, managing and analyzing Time Series. All utilities related with Time Series (Monitoring Stations, Parameters, etc.) are in the Environmental Monitoring menu (see Figure 6-1) and in the Reports menu (see Figure 6-2).
6.2.1 Parameters
The Parameter Manager (Figure 6-3) displays the list of all existent parameters. In this window is possible to create new parameters, edit or remove existent parameters. The parameters that are associated to existent Time Series cannot be removed. To remove them, the Time Series must be removed first.
70
The Parameters properties window (Figure 6-4) allows create new parameters or editing existent parameters. The property Name is the complete name of the parameter and the Display name is the name that will be displayed in all the menus or reports. The Display name field cannot be empty. This is the name that will be always displayed in Time Series, all windows and Reports. The property Units refers to the units of parameter, and it can be blank and the numeric format of parameter value can be changed in the property Display numeric format.
71
Exponential notation
E
E2
Fixed-point
F
F3
General
G
G4
Number
N N3
Percentage
P1
Table 3: Display Numerical Formats Examples.
72
The Monitoring Station properties window (see Figure 6-6) allow to create or editing monitoring station details. The property Name refers to the monitoring station name. This name will be the displayed name for the station in all reports and menus from MOHID Studio. There are several station types available, such as: Air Quality, Hydrological, Meteorological, Tide, Water Quality, Waves and Others. The Longitude and Latitude refers to the monitoring station geographical location. It is also possible to add a photo of the monitoring station by clicking in the Change button. When the photo is empty, the button label will be Add. To remove the photo, press the remove button next to the photo.
73
Bellow the properties of monitoring station is the list of all time series that were measured or modeled in this monitoring station. It is possible to add more time series (read more about the Time series in the section 6.2.3) to this monitoring station and to modify or delete the existent time series.
74
To create or modify a Time Series use the Time Series properties window (see Figure 6-6) by pressing the Add or Edit button in the Time Series manager. The Time Series properties are: Parameter (to add new parameters check the section 6.2.1), Monitoring Station (to add new monitoring stations check the section 6.2.2) and monitoring location (ticket the check box to use the same location as the monitoring station), Modeled Domain and Time Series Type (surface, middle, bottom, composed, not defined or unknown). The Time Series Values are the values that are obtained (by a measured or a modeled result) for a specific instance of time. These values can be created, modified, removed or imported (for more information, see section 6.2.4). To edit any value from the time series value list (date or value) double click on the value to edit.
75
76
If the window before the Import Time Series window was the Time Series properties window (see Figure 6-8), when importing one MOHID ASCII Time Series Files only the first two steps above are requested, followed by pressing the import button. The Export Time Series (to ASCII) window (see Figure 6-10) displays all time series that belongs to MOHID Studio. To export one time series to MOHID ASCII Time Series Files, select that time series to export, choose the destination path and then press Export button. To learn more about MOHID ASCII Time Series Files check subsection 10.2.
77
The Moving Time Series properties window (see Figure 6-12) display all the information about a determine Moving Time Series. All the information may be added or changed in this window, just like in Time Series properties window (see Figure 6-8). In this window is also possible to add a description about the moving time series (for example: Demo Moving Time Series). It is also possible to add a short description to the values (for example: estimated value, average value, Error no value) helping to understand the values latter, if anything goes wrong. To edit the values double click on the value to edit.
Instead of filling the Moving Time Series properties window, is possible to import a batch of moving time series values, through an XLS File (for more information, please read section 6.2.7).
79
The Field Campaign properties window (see Figure 6-14) displays all information about one Field Campaign. The properties of a Field Campaign are the name, the dates where the campaign took place and some description about the campaign. It is possible to attach any type of file to this field campaign (for example: authorization sheets, the field campaigns schedule, itinerary, etc.). All the files attached can be viewed (opened by the system default application) or removed. The files are attached to the MOHID Studio database, so the path to file can be modified or the file can be removed from disk. The Field Campaign properties windows also include the list of all visited points in this field campaign. With this list is easier to keep the history of all visited points in every field campaigns.
80
The Visited Points can be created by clicking in button Add on the Field Campaign properties window (see Figure 6-14) and a new window will be open, Visited Point properties window (see Figure 6-15). In this window is possible do add some information about the weather conditions and some more useful information. The weather conditions are very important to analyze the results measured on a distant future. The Visited Point properties window also allows attach files to the visited points, such as sheets, photos and other documents. These documents are attached to each visited point and not to the field campaign, so is possible to have different files attach to each visited point. The files are also stored in the MOHID Studio database, so the file location is possible and do not interfere with MOHID Studio.
81
The Visited Points can also be created, editing or removing from Visited Point manager windows (see Figure 6-16). Visited Points are created or editing through the Visited Point properties window (Figure 6-15).
82
83
To import the time series values from XLS file to MOHID Studio use the Import Time Series window (see Figure 6-18) from Environmental Monitoring tab in the group Import. First choose the parameter, monitoring station and time series type fields for the time series that will be imported and browse for the source XLS file. After the file is selected MOHID Studio will display all time series values found on the imported file. This process may take a while, depending on the quantity of values to import. The press Import button to complete the importation process. This process also may take a while, depending on the quantity of values to import. If the file has some errors or does not follow the template file (Figure 6-17), MOHID Studio will display the error. If the message is No values found in file please check if the file is correct or if the template file is the correct type for the import window in use.
84
When the time series results from a profile measure, and the depth field is required, the right template to use is Import Profile.xlsx. This file is very similar with the time series import file (Figure 6-17) with an extra coordinate field: depth. The Import BoatCruise.xlsx file is used for boat cruise measures or measures that required
85
6.3 Reports
The Reports is one of the best ways to analyze and check all values from time series results. There are several reports available (see Figure 6-2), that are configured through the Report Window (see Figure 6-20) and are all fully described on the next subsections.
The Report Window is composed by two sections: the report settings content (on the left) and the generated report content (on the right) as showed on the Figure 6-20. The bottom of left window (see Figure 6-21) is always composed by three sections: Settings of selected report; Time Interval; Output.
86
The settings of selected report change in every report and will be described on the next subsections. The Time Interval (see Figure 6-21) allows the user to limit the results to a certain time interval (for example: one day, one month, etc). If the box apply filter is not checked, all values will be displayed. The Output (see Figure 6-21) is the way to configure how the report will be displayed. The report can be displayed on the right window of the Report window (as show on Figure 6-20), PDF format or XLS format. For the last two formats, a location file and name file are required. After pressing Generate button the report will be displayed on window or saved in a file. When a generated report is displaying on the Report window, the top bar of the generated report content allows several features, such as: navigate through the generated file report, print the report, save the report file as XLS format or/and PDF format, zoom it and setting the page layout.
87
88
89
90
91
The moving time series imported by XLS files from Profile import and Boat Cruise import may be displayed by the Moving Time Series Reports.
92
Tools
7.1 Introduction
MOHID Studio contains a set of tools. The majority of these tools works interactively over the Map Visualization and provides the possibility to generate MOHID specific data files. MOHID Studio Tools can be accessed from the Tool menu (see Figure 7-1).
MOHID Studio tools are divided into: (i) geometry layers creation, (ii) grid creation, (iii) grid data tools, (iv) watershed tools, (v) time series tools, (vi) HDF tools and (vii) boxes tools. Since tools work interactively over the map, some tools require creating one or more temporary layers. These layers are added when the tool is started and removed when the tool is closed. Since tools work interactively over the map, MOHID Studio does not allow more than one tool to be used simultaneously. All tools are explained in detail next.
93
Using this tool it is possible to create a list of points. Points can be added to the list by selecting the Draw button and afterwards click on the map. After clicking on the map, the list of points is updated. Point locations and names can be edited by double clicking over the list shown under Defined Points. The current list can be saved by selecting the Save button.
94
Using this tool it is possible to create a list of lines. Lines can be added to the list by selecting the Draw button and afterwards click on the map. Each click adds a vertex to the line. The line is ended by double clicking the last point. Line names can be edited by double clicking over the list shown under Defined Lines. The current list can be saved by selecting the Save button.
95
Using this tool it is possible to create a list of polygons. Polygons can be added to the list by selecting the Draw button and afterwards click on the map. Each click adds a vertex to the polygon. The polygon is closed by double clicking the last point. Polygon names can be edited by double clicking over the list shown under Defined Polygons. The current list can be saved by selecting the Save button.
96
It is possible to select the grid origin (lower left corner) using the pick button or by introducing manually the coordinates. The number of columns and rows can be set in the JUB and IUB fields, respectively. The horizontal and vertical grid step can be set in the dX and dY fields and the grid angle in the Angle field. The Coordinates box allows selecting the grid coordinates (MOHID internal format). Recommended options are: 4 for geographic coordinates 5 for metric (local) coordinates
After changing any options the grid can be visualized by selecting the Refresh button. The Grid is saved as MOHID ASCII file by selecting the Save button.
97
It is possible to select the grid origin (lower left corner) using the pick button or by introducing manually the coordinates. The variable spacing is set in the XX and YY fields. Here accumulated values (starting at zero), for the grid edges must be specified. Its recommended to use an application like Microsoft Office Excel to generate the XX and YY values. Other options work in the same way as for the constant spaced grid.
98
99
Under the Select Grid option the desired grid can be chosen. The non-compute areas can be defined by selecting the Pick button and click over the map on the polygon which defines a non-compute area. Several polygons can be selected. The base information can be either XYZ Data or HGT layers. Multiply sources can be selected. The interpolation option allows choosing the desired interpolation method. After selecting the filename for the final grid data, the process button activates the interpolation process. For large data sets or large grids, the interpolation process might take a while. Through the progress bar is possible to analyze the process status.
After selecting the base Grid Data and the source Shapefile, it is necessary to select the feature (e.g. land cover code) on which the value mapping is to be performed. After selecting the desired feature, the analyze button must be pressed, in order to obtain a list of distinguish features (e.g. forest, urban areas) in the shapefile. For each feature, a value which will be assigned to the corresponding grid cells must be provided. These values can be saved or loaded by using the Load / Save buttons. After filling the Value Mapping, the Grid Data file can be created using the process button.
101
After selecting the Grid Data to modify under the Select Grid Data option, it is possible to select the grid cells to modify over the map, using the Pick button. After selecting the grid cells on the map, the selected cells get highlighted and appear in the point list. After all points to modify have been selected, several operations can be performed, by choosing the appropriate options in the Math Operation box. Points can be transformed into Compute Points or Non Compute Points through the Open / Close non compute points box. After editing the Grid Data, changes can be persisted or discarded in the Persist Changes box.
102
The depressions removal process involves several steps. First, the digital terrain (Grid Data) from which the depressions are to be removed must be selected and the existing depressions must be found by using the Analyze button. If depressions are found, they are highlighted on the map and listed in the List of depressions.
This applies only if the river network is to be simulated. You can run MOHID Land also in a special
mode without drainage network. In this case, the DTM may contain depressions.
103
104
The watershed delineation process involves several steps. First the Digital Terrain Model must be selected from the Select DTM box. NOTE: In this box appear all Grid Data layer currently loaded into MOHID Studios GIS engine, so it is the user that select the right (depression free) Digital Terrain Model. The second step is to define the area threshold value, by default is 1 ha. This area indicates from which drained upstream area river channel are formed. The coordinates of the outlet must also be set. They can be obtained using picking on the map. NOTE: Watershed delineation is required in order to run MOHID Land, since MOHID Land can only run with one single outlet. This option is optional, because it can be useful, in a first step, to generate a drainage network for the entire digital terrain model and only in a second step delineate the watershed, since it is easier to locate the outlet over the entire drainage network. In the Output Options box, the desired output of the delineation process is specified. To run MOHID Land, only the drainage network is required. Information about options used during the delineation process should also be stored, since they are required for the Basin Geometry module (Basin Geometry check box). All other output is not required,
105
Cross section definition involves several steps. First the drainage network for which the cross sections are to be defined must by selecting from the Network box (SCREEN SHOT REVISION REQUIRED). Then the typical cross sections must be defined for, one for each Strahler order. Cross sections are defined as trapezoidal ones (top width, bottom width and high). It is possible to define triangular sections by setting the bottom width to zero. After defining cross sections for all Strahler orders of the drainage network, the drainage network file can be saved, by selecting the save button in the Persist Changes box. (SCREEN SHOT REVISION REQUIRED)
Action Modulers - www.actionmodulers.com 106
The Soil Depth tool requires a depression free Digital Terrain Model, which should be selected in the Select Digital Terrain box. The parameter to construct soil depth can be set in the Select Parameter box. The Min Depth and Max Depth parameter indicate the minimum and maximum soil depths, respectively. The Max Slope parameter indicates the maximum slope which the tool should consider. From these parameters the soil depth is linearly interpolated considering. Grid cells with zero slopes will have maximum soil depth and grid cell with slope greater or equal to the maximum slope will have minimum soil depth. The water table parameter indicates the percentage of the initial water depth, in function to the total soil depth. A value of 0% indicates that the initial water table is close to the bottom, a value of 50% indicates that the initial water table is at half soil depth and a
107
Creating a grid time series location file involves several steps. First the grid data which will be used as base must be selected. In a second step the locations of the grid points must be specified. This can either be done by adding data from a Named Points layer by
108
This tool requires that there has been previously data imported into the database (there are several ways to import values to database, check subsections: 6.2.3, 6.2.4 or/and
109
This tool requires a Digital Terrain Model and a HDF File to be loaded (Select DTM and Source HDF box). The interpolation/extrapolation method is defined in the second box. The file is being processed by clicking the Process button.
Action Modulers - www.actionmodulers.com 110
This tool requires a HDF File to be loaded. By using the Draw function the Cut line can be drawn. The vertical cut is generated by using the Create button. The instant displayed in the vertical cut, as well as the style used, is the same as in the map.
7.8 Boxes
7.8.1 Introduction
MOHID used the concept of boxes in several ways, for example: (i) to initialize properties, (ii) to monitor average concentrations over time or (iii) to release lagrangian particles. MOHID Studio integrates a tool to create boxes from Named Polygons
111
Polygons can be drawn directly over the map, using the Draw button. After all polygons have been drawn, the boxes file can be saved be selecting the Save button.
112
8.1 Introduction
MOHID Studio contains a set of utilities which permit to convert (or export) data from one format to another format. All utilities address the MOHID Specific Formats (ASCII Files, HDF Files and XML Geometries), ESRI Shapefiles and KML Files. MOHID Studio Export / Conversion Utilities can be accessed from the Export/Conversion menu (Figure 8-1).
113
114
115
116
117
118
Administration
9.1 Introduction
The Administration menu (see Figure 9-1) is the place where it is possible to change all types of MOHID Studio configurations. On the License Manager group it is possible to register, request and validate your MOHID Studio license (for more information read subsection 9.2).
The MOHID Studio Settings contains several buttons to configure the basic settings of your MOHID Studio. On the General setting is possible to change the paths of MOHID executables files, output directories and some MOHID interface options. The Reset Database button resets the MOHID Studio database. All the data will be erased from your MOHID Studio database (example: monitoring stations, time series, parameters, etc.). After reset the database, it is not possible to restore/recover the previous database and all the data will be lost. Through the MOHID Studio Help is possible to get information about your MOHID Studio version, get help from your MOHID Studio manual and it is also possible to request professional help for your MOHID Studio version. Help can be also found on the internet or in our site check Links group at the menu Home (Figure 2-5).
119
120
Feature
Number of single machines where license can be installed Maximum number of layers which can be displayed in the GIS engine Maximum number of domains which can be created within a single workspace Maximum number of scenarios which can be configured within a single workspace Maximum number of nested domains which can be created Maximum number of simultaneously opened XY Graph windows Watermarks free images License Period (month) Price (Euros)
1 3
1 unlimited
1 unlimited
5 unlimited
unlimited
unlimited
unlimited
unlimited
unlimited
unlimited
unlimited
unlimited
unlimited
1 No 6 Free
unlimited Yes 12
121
The License Manager window displays the type of license of your MOHID Studio version and, if there exists, the limitations that your version has (see Figure 9-3).
122
To register and request a MOHID Studio license check subsection 9.2.3. To validate your MOHID Studio license check subsection 0.
123
124
125
10 File Formats
10.1 Introduction
MOHID Studio have several file types and all this subsection is missing.
Action Modulers - www.actionmodulers.com 126
127
128
129
130
Note that in MOHID the i index refers to the YY axis and the j index to the XX axis. For example grid cell (5, 2) is the fifth grid cell in the YY axis and the second in the XX axis. The header section contains information related to the grid global definitions, such as the number of cells, the type of coordinate used, the origin coordinates of the grid, etc. Below are shown the keywords supported in the header section of a Grid file. ILB_IUB - Two integer numbers defining the minimum and maximum I values along the Y-axis of the grid. JLB_JUB - Two integer numbers defining the minimum and maximum J values along the X-axis of the grid. COORD_TIP - A flag which indicates the used coordinates type. ORIGIN - Two real values, which indicate the origin of the lower left corner of the grid. ZONE - Integer values defining the UTM Zone where the bathymetry is located. GRID_ANGLE - Counter-clock mesh rotation relative to the north. The base point is the origin of the grid. LATITUDE - Average latitude value used to compute Coriolis frequency and solar radiation when metric coordinates cannot be converted to WGS84 geographic coordinates. LONGITUDE - Average longitude value used to compute Coriolis frequency and solar radiation when metric coordinates cannot be converted to WGS84 geographic coordinates. CONSTANT_SPACING_X - Boolean defining if the spacing in the X axis is constant
Action Modulers - www.actionmodulers.com 131
If the spacing is not constant, the grid spacing section contains information about the grid spacing in the XX and YY axis namely through defining the grid cells corners coordinates. This information is stored in blocks, one for each direction. The data is stored inside a block defined by the following keywords: <BeginXX> and <EndXX> for the XX axis and <BeginYY> and <EndYY> for the YY axis. Note that the keywords of these block definition tags are case sensitive. Each value must be stored in a single line. The values are read from left to right corner in the XX axis and from bottom to top in the YY axis. The first value is always zero in both directions, being the following values cumulative. The Figure 10-6 shows an example of an MOHID ASCII Grid file.
132
NOTE: For more information about MOHID Grid files can be found here check the following link: http://www.mohid.com/wiki/index.php?title=Grid
133
134
Links between nodes are defined by blocks delimited by <BeginReach> and <EndReach> blocks.
Due to the complexity of these files, it is recommended to generate these files with MOHID Studios Watershed delineation tool. NOTE: More information about MOHID Drainage Network files can be found on the following link: http://www.mohid.com/wiki/index.php?title=Drainage_network
The data section is defined inside a block defined by the tags <BeginTimeSerie> and <EndTimeSerie>. Inside the block data is formatted into columns separated by blank spaces. The leftmost column defines the accumulated time, in the time units defined in the header section and starting from the time series initial date, also defined in the
135
136
137
MISSING IMAGE
Figure 10-12: A XML Named Line File
138
MISSING IMAGE
Figure 10-13: A XML Named Polygon File
MOHIDs modules produce HDF files which contain: (i) polygon (grid data) based data sets, (ii) drainage network based information and (iii) lagrangian (particle) based data sets.
139
140