Contents

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 easily accessed from the "Toolbox" button, represented in Figure 1 in the upper left below menu bar.

MOHID Studio - User Guide v2 11.png
Figure 1 : Toolbox button.

On mouse over the "Toolbox" button, the "Toolbox" window appears that is represented in Figure 2.

MOHID Studio - User Guide v2 12.png
Figure 2 : Toolbox window.

In the next figure you can see all you have in MOHID Studio 2015 Toolbox.

For MOHID Studio 2016 it was added :

  1. the tool to build curvilinear grids,
  2. the tool to add bulk results from lagrangian layers with new outputs as plume envelope and plume center, not available directly from HDF.
  3. the tool to refine langrangian grid results horizontally and vertically, computing particle concentrations in refined nested grids.
  4. the tool to edit specific cross sections in MOHID Land drainage network..
  5. the set of tools to convert bathynetry and results between MOHID Water and SWAN models and vice versa (e.g. to allow model forcing both ways in offline mode) in SWAN tools .
Toolbox itens.png
Figure 3 : Toolbox itens.

The toolbox window allows the user to search for any text in the search box and the tools with the text are displayed providing a fast way to get the desired option. In Figure 4 is presented an example for searching "HDF" and all the HDF related tools appear.

MOHID Studio - User Guide v2 13.png
Figure 4 : Toolbox window search result for "HDF".


MOHID Studio tools are divided into: (i) geometry layers creation, (ii) grid creation, (iii) grid data tools, (iv) MOHID Land tools, (v) MOHID Water tools, (vi) time series tools, (vii) HDF tools and (vii) file conversion tools.

MOHID Studio tools work interactively over the map. Some tools require creating one or more temporary layers. These layers are automatically added to the map when the tool is started and automatically removed after the tool is closed. Since MOHID Studio tools work interactively over the map, MOHID Studio does not allow more than one tool to be used simultaneously.

MOHID Studio tools are explained, in detail, along the next subsections. All tools are provided with a help window, located on the bottom of the tool window. To display the help window click over the "Show help" text (presented in Figure 5).

MOHID Studio - User Guide 92.png
Figure 5 : Show help – To open the help window.

Action Server

In the Action Server tool you can download HDF files and time series from models running in Action Modulers (Action Server option with operational models) or in other servers where the product ActionServer is installed), and you can upload a demo file to Action Modulers server (e.g. news, result images, etc).

To use other server other than Action Modulers server in HDF and time series download, need to configure it in ribbon "Administation", group "MOHID Studio Settings" and in button "Server".

Action Server window.png
Figure 6 : Action Server window.


Download HDF Polygon

In panel 1 "1. Base filters"

First specify wich server with ActionServer product installed (by default is the one in Action Modulers headquarters Action Server) that has models results in data base (e.g. from operational runs or local simulations).

Then specify which model domain to use and which parameter (model property) to download HDF results to.

In panel "2. Time Filters"

Select the date interval and click on the magnifing glass icon to get al the HDF instants present for the time period specified in dates. This action will fill the below list if any results exists.

Select intansts by pressing on one line (HDF instant) and then selecting more instants by holding CTRL key while pressing other instants. The download will be limited to selecting 25 lines at each time to limit bandwith use and timeout problems.

In panel "3. Output Location"

Select where to save the HDF.

After clicking "OK" the process will start and instans will be downloaded to the defined file and the file will automatically open in Studio.


Download HDF Polygon window.png
Figure 7 :Download HDF Polygon window.

Download Time Series

In panel 1 "1. Base filters"

First specify wich server with ActionServer product installed (by default is the one in Action Modulers headquarters Action Server) that has models results in data base (e.g. from operational runs or local simulations).

Then specify which Monitoring Station to use (location) and wich time series (property recored and model that created it) to download time series results to.

In panel "2. Time Filters"

Select the date interval desired.

In panel "3. Output Location"

Select where to save the TimeSeries.

After clicking "OK" the process will start and instans will be downloaded to the defined file and the file will automatically open in Studio.

Download Time Series window.png
Figure 8 : Download Time Series window.

Upload Demo File

Here you can upload files to be available at start screen on the right side panel.

This section is for you if you have MOHID Studio or Action Modulers related material as news, MOHID Studio projects that are of interest for all users, images of new model implementations with MOHID Studio, etc.

The upload will not be available instantaneously to all users of MOHID Studio since it needs to be approved by administrators based on its content.

To upload a item, select file and image (the image that is shown at each item in startup right panel), file types, and a desription of wat are you sending and press OK.

Upload Demo File window.png
Figure 9 : Upload Demo File window.



Atmospheric Spreading

Atmospheric Spreading is a tool developed to run and process results from a Atmospheric particle simulation.

Tool instructions will be updated shortly. Contact us for more information.


Geometry Layer Tools

Geometry layers tools allow creating geometries interactively over the map. Normally, geometries created with this tools, are used afterwards by other tools (e.g. points can be used to create time series locations, polygons to define non compute areas and so on).

Construct Named Points

The Named Points tool allows creating XML Geometry file with points. This tool can be activated by clicking the "Construct Named Points" on Geometry Layer tool group from the "Tool Box" (see Figure 2). The tool window will appear docked on the right side of the main window as shown in Figure 10.

MOHID Studio - User Guide v2 14.png
Figure 10 : Creating Named Points.

With the use of this tool it is possible to create a list of points. Points can be added to the list by pressing the button "Draw" (this button will turn orange) and afterwards click on the map, to mark the points. When clicking on the map a new marker is added to the map and the list of points is updated, adding the new point. The point location and name can be edited by double clicking over the list shown under "Defined Points". It is possible to remove the current selected point, by pressing the "Remove" button, or to remove all points, by pressing the "Clear List" button. The current list can be saved, as an XML Geometry file, by clicking the "Save" button.

Construct Named Lines

The Named Lines tool allows creating XML Geometry file with lines. This tool can be activated by clicking the "Construct Named Lines" on Geometry Layer tool group from the "Tool Box" (see Figure 2). The tool window will appear docked on the right side of the main window as shown in Figure 11.

MOHID Studio - User Guide 94.png
Figure 11 : Creating Named Lines.

Using this tool it is possible to create a list of lines. Lines can be added to the list by pressing the button "Draw" (this button will turn orange) and afterwards click on the map, to add the vertices. Each click on the map adds a single 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". Lines can be removed from the list using the button "Remove", deleting the current line, or using the button "Clear List", deleting all the lines from the map. The current list can be saved, as a XML Geometry file, by selecting the "Save button".

Construct Named Polygons

The Named Polygons tool allows creating XML Geometry file with polygons. This tool can be activated by clicking the "Construct Named Polygons" on Geometry Layer tool group from the "Tool Box" (see Figure 2). The tool window appears docked on the right side of the main window as shown in Figure 12.

MOHID Studio - User Guide v2 15.png
Figure 12 : Creating Named Polygons.

Using this tool it is possible to create a list of polygons. Polygons can be added to the list by selecting the button "Draw" (this button will turn orange) and afterwards click on the map, drawing the polygons. Each click on the map 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". Polygons can be removed from the list using the button "Remove", deleting the current selected polygon, or using the button "Clear List", deleting all the polygons. The current list can be saved, as a XML Geometry file, by selecting the "Save" button.

Construct XYZ Points

The XYZ Points tool allows creating MOHID ASCII XYZ file with points. This tool can be activated by clicking the button "Construct XYZ Points" on Geometry Layer tool group from the "Tool Box"(see Figure 2).

The XYZ Points tool works very similarly as the "Named Points" tool described above.


Grid Tools

Grid tools allow creating grids interactively over the map and to refine existing grids for nested models.

Constant Grid

Constant grids can be created by clicking the "Constant Spaced Grid" on Grids tool group from the "Tool Box" (see Figure 2). The tool window appears docked on the right side of the main window as shown in Figure 13.

MOHID Studio - User Guide v2 17.png
Figure 13 : Creating Constant Grid.

In terms of coordinate types the grids can be created in:

  • geographic coordinates (WGS84) where distances are in degrees.
  • UTM (and defining the zone number without the reference to N or S) where distances are in meters.
  • grid based (for schematic cases or other projected coordinates - defined by map projection - where distances are in meters.

The constant grid can be defined on the "Grid Parameters". There are two ways to set the origin of the grid:

  • introducing manually the origin values of the X and Y coordinates;
  • press the button "Pick…" (the button will turn orange) and then click on the map to set the origin of the grid (lower left corner).

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.

After changing any options the grid can be visualized by selecting the "Refresh" button, under the "Preview". It is also possible to set the window to auto update mode (by checking the "Auto Update" box).

The Constant Grid created can be saved, as MOHID ASCII file, by pressing the "Save" button.

Variable Spaced Grid

Variable spaced grids can be created by selecting "Variable Spaced Grid" on Grids tool group from the "Tool Box" (see Figure 2). The tool window appears docked on the right side of the main window as shown in Figure 14.

MOHID Studio - User Guide v2 18.png
Figure 14 : Creating Variable Grid.

The variable spaced grid can be defined on the "Grid Parameters". There are two ways to set the origin of the grid:

  • introducing manually the origin values of the X and Y coordinates;
  • press the button "Pick…" (the button will turn orange) and then click on the map to set the origin of the grid (lower left corner).

The variable spaced is set in the XX and YY fields. There are two ways to set

  • introducing manually the XX distances to the origin for each grid line in x and y directions
  • the "Add Cells Tool" allows to fill automatically the fields with the number of cells to add ("nº cells") to each direction ("Axis") and the size of the cells ("Range") and where to add ("Position"). This allows to create in a straightforward way areas of different resolution and even changing resolution troughout one area (using the "Range" option).

The Angle is the grid angle around the origin.

After changing any options the grid can be visualized by selecting the "Refresh" button, under the "Preview". It is also possible to set the window to auto update mode (by checking the "Auto Update" box).

The Variable Spaced Grid created can be saved, as MOHID ASCII file, by pressing the "Save" button.

Nested Grid

Nested Grids[1] allow to create new subdomains grids or refine coarser grids. Nested grids can be created by clicking the "Nested Grid" on Grids tool group from the "Tool Box" (see Figure 2). The tool window appears docked on the right side of the main window as shown in Figure 15. The Nested Grid Tool it is only available when a Grid layer is loaded on the map.

MOHID Studio - User Guide v2 19.png
Figure 15 : Created Nested Grid.

To create a new Nested Grid, first select the main grid, from the drop down box "Grid" on the "Select Grid" box. Then select the position for the nested grid using the mouse, by pressing the button "Pick…." and then pressing the grid, or by supplying the lower and upper bound in the text boxes from "Select Area".

The reduction step is defined in the "Nested Grid Step" in x and y directions.

The Nested Grid created can be saved, as MOHID ASCII file, by pressing the "Save" button.

Curvilinear Grid

The tool to generate curvilinear grids in MOHID Studio is based on the open-source code gridgen, written by Pavel Sakov at CSIRO Marine and Atmospheric Research in Australia.

Curvilinear grids can be created by selecting "Curvilinear Grid" on Grids tool group from the "Tool Box" (see Figure 2). The tool window appears docked on the right side of the main window as shown in Figure 16.

MOHID Studio - User Guide v2 36.png
Figure 16 : Creating Curvilinear Grid.

Six steps are necessary to generate a curvilinear grid:

  • Selection of the polygon that defines the grid's boundary.
  • Definition of the grid's corners.
  • Selection of the grid coordinates system.
  • Selection of the grid parameters.
  • Generation of the grid.
  • Saving the grid into a file.

Creating a curvilinear grid requires a polygon that defines the grid's boundaries. This tool will not open if there is no polygon in "Layers".

To define the curvilinear grid, first select the associated polygon in "Select Polygon".

The polygon corners are defined in "Define Polygon Corners". This is useful in cases where the polygon includes channels. For each corner, the direction the polygon goes into, left or right, is chosen (left or right when going through the polygon in a given orientation. As long as it remains consistent it does not matter if that orientation is clockwise or counterclockwise). The difference between "right corners" and "left corners" must be 4[2][3]. In the simplest case, only four corners of the same "type" are defined, like shown in Figure 17.

MOHID Studio - User Guide v2 37.png
Figure 17 : Creating a simple Curvilinear Grid.

If the polygon corners are not correctly defined, the grid will be highly distorted and might not have a matching boundary with the polygon. In some cases, careful consideration must be given when choosing the corners, and different corner definitions might generate valid, but different, grids. Feel free to experiment.

In "Output Coordinate System" select one out of three coordinate systems:

  • geographic coordinates (WGS84) where distances are in degrees.
  • UTM (and defining the zone number without the reference to N or S) where distances are in meters.
  • grid based (for schematic cases or other projected coordinates - defined by map projection - where distances are in meters.

The grid parameters are set in "Grid Options". There are two ways of choosing the grid's refinement:

  • Specifying the number of columns and the number of rows.
  • Selecting a variable spaced grid - the curvilinear grid will copy the refinement of the variable spaced grid while ignoring its location and dimensions. With this method, it is possible to locally refine the grid as desired.

Independently of how the grid's refinement was chosen, the grid will also be more refined in thinner regions and less refined in wider regions if there are no corners defined between them.

If "Eliminate thin triangles" is checked, the program will pre-process the polygon and remove points that are too close, which will avoid the generation of cells that are too small.

If "Check polygon" is checked, the program will test if the selected polygon is simple (none of its lines intersect each other and so the polygon is a valid boundary). In extremely rare cases, it's possible that the program might consider a polygon complex when it is in fact simple. This is why the option to turn the test off is left. For most cases, it is advised to keep the parameter checked.

All the other parameters affect precision and computation time during the generation of the grid. Insufficient precision might affect the grid's orthogonality which in turn affects the validity of the results after a simulation. If unsure, these parameters can be safely left with their default values. They should only be tweaked in complex cases.

  • Precision - precision during iterative methods, defining when convergence is considered reached. Small values increase computation time.
  • NPPE - Number of points per internal edge of the triangulation. Small values decrease precision and computation time. It can be switched off by setting it to 0. In this case, coarser images of quadrilaterals will be used that are formed by straight lines connecting the quadrilateral vertex images.
  • Nodes - Number of nodes in the Gauss-Jacobi quadrature when solving integrals. If defined based on precision, it will be set to -log10(<precision>). Small values decrease precision and computation time.
  • Gauss-Newton solver with Broyden update - If checked, the program will use Gauss-Newton solver with Broyden update for solving a non-linear least squares problem. Otherwise, simple iterations are used. Checking this parameter off will increase precision and computation time.

After all the above steps, the grid can be generated in "Generate Curvilinear Grid". Finally, when a suitable grid is generated, it can be saved into a file in "Save Grid".

Grid Data Tools

Grid Data tools allow creating and modifying MOHID Grid Data files. MOHID Grid Data is used to provide MOHID data on a per grid cell basis (for example: bathymetry, topography, etc.).

Using MOHID Studio’s Grid Data Tools, grid data can be created from a set of points or from a set of polygons.

Creating Grid Data from Points

Grid Data can be created from a set of points by pressing the "Construct From Points" on Grid Data tool group from the "Tool Box" (see Figure 2). This tool is typically used to create the digital terrain model for the MOHID Water (bathymetry) and MOHID Land (topography) models.

Creating a Grid Data from points requires: (i) a grid on which the grid data will be based, (ii) base data (points) which will be used to fill the grid data and (iii) polygons which define non-compute areas (optional).

The tool window appears docked on the right side of the main window as shown in Figure 18.

In the "Select Grid" box the desired grid can be chosen. The non-compute areas can be defined by pressing the "Pick" button and then 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.

There are three methods for creating the cell values from the points:

  • Average - the cell value is the average of the points value inside the cell. Use it when there are more then one point inside each model cell. If some cell has no points inside the cell will be blank (no compute point).
  • IWD - Inverse Weighted Distance - the cell value is computed based on point neighbors giving a weight to each one related to their distance to the cell center. Use it when there are cells with no points inside.
  • Triangulation - uses triangulation between poitns to define cell value. Use it when there are cells with no points inside.

For large data sets or large grids, the interpolation process might take a while, be patient. Through the progress bar is possible to analyze the evolution of the process status.

MOHID Studio - User Guide v2 20.png
Figure 18 : Creating a Grid Data from Points.

Creating Grid Data from Raster

Hello GD from Raster

Creating Grid Data from Shapefiles

Grid Data can be created from a set of points by pressing the "Construct From Shape" on Grid Data tool group from the "Tool Box" (see Figure 2). This tool is typically used to create files which contain information about land use, vegetation or soil types for the MOHID Land model.

Creating a Grid Data from ESRI Shapefiles requires: (i) a Grid Data on which the grid data will be based (Non compute areas will remain the same as in the base grid data and (ii) a Shapefile with polygons data. The tool appears docked on the right side of the main window as shown in Figure 19.

After selecting the base Grid Data and the source Shapefile, it is necessary to select the feature (e.g. land covers code) on which the value mapping is to be performed. After selecting the desired feature, press the "Analyze" button in order to obtain a list of distinguish features (e.g. forest, urban areas, etc.) 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" and "Save" buttons, in the Value Mapping box.

MOHID Studio - User Guide v2 21.png
Figure 19 : Creating a Grid Data from Shapefile (Polygons).

After filling the Value Mapping, the Grid Data file can be created using the "Process" button.

Edit a Grid Data

Grid Data can be modified by pressing the "Edit Grid Data" button on Grid Data tool group from the "Tool Box" (see Figure 2). The tool to modify grid data appears docked on the right side of the main window as shown in Figure 20.

After selecting the Grid Data to modify under the "Select Grid Data" box, it is possible to select the grid cells to modify over the map, using the selection method:

  • the "Select by Mouse" allows to select areas using the "Pick" button.
  • or/and using the "Select by Geometry" allows to select cells that intersect, contain or are at a defined distance from the geometry.
  • or/and using the "Select by Value Filter" allows to select cells that have its value between a user defined range.

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 "Operations" box. The user can add (subtract) a value or multiply by a value or transform to opened or closed points.

The "Select by Geometry" option is very useful for instance to burn-in the DTM, where areas around river lines (see Figure 20) are selected and then digged.

MOHID Studio - User Guide v2 22.png
Figure 20 : Modifying a Grid Data.

After editing the Grid Data, changes can be saved or discarded in the "Persist Changes" box.

Grid Data Operator

Grid Data can be changed by pressing the "Operator" on Grid Data tool group from the "Tool Box" (see Figure 2). The tool to operate grid data appears docked on the right side of the main window as shown in Figure 21.

MOHID Studio - User Guide v2 23.png
Figure 21 : Operating a Grid Data.

To open Grid Data Operator tool a grid data file must be loaded to the map. This tool allows modifying grid data files. On the "Select Grid Data" box select the Grid Data 1, and if exist, the Grid Data 2. A selection of points can be created, on the "Select Grid Data Points" box, using the selection method:

  • the "Select by Mouse" allows to select areas using the "Pick" button.
  • or/and using the "Select by Geometry" allows to select cells that intersect, contain or are at a defined distance from the geometry.
  • or/and using the "Select by Value Filter" allows to select cells that have its value between a user defined range.

In Figure 21 is represented a new selection where the only selected points has the value filtered, between a minimum and maximum value defined.

The operations, between the grid data’s are displayed on a drop down box on the Operations box. In this box is possible to create the operation to apply to the all grid data, or only to the selection points.

After the operation is complete is possible to save or discharge all the changes in the "Persist Changes" box.

Create Boxes Tool

MOHID uses 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"

The create box tool allows creating 2D boxes from polygons. This tool can be easily accessed by pressing "Create Boxes" in the Grid Data tool group from the "Tool Box" (see Figure 2). The tool to operate grid data appears docked on the right side of the main window as shown in Figure 22.

Polygons can be selected from the available in the map. The boxes file can be saved be selecting the "Save" button, in the "Generate Boxes File".

MOHID Studio - User Guide v2 24.png
Figure 22 : Creating a boxes file from a set of polygons.

Process Flood Risk

The tool process flood risk (in Figure 23) is used to convert grid MOHID results to shapefile and compile in it the values for each cell of the maximum water column, maximum water level, the velocity on maximum water column, the maximum flood risk (the maximum value of (water column x (_parameter + velocity)).

In order to run the tool the simulation selected needs to have written all the grid outputs by using the following keyword:

OUTPUT_FLOOD_RISK : 1

or at least this one:

WRITE_MAX_WATER_COLUMN : 1

In the latter case, only the max water column will be available to compile to the shapefile.

In Layer Configuration

  1. select the simulation to process (go to "Explorer" tab and select one simulation of one opened project)
  2. Second select which layers to process (the grids need to exist in the simulation results as stated above or the tool will warn that the results are not available for processing).
  3. select the options where "minimum water column" defines where vaues below of max water column the cells will not be considered for processing, the "min adjacent cells" is the minimum number of cells with max water column > "minimum water column" around one cell so that the cell is considered (to remove isolated cells) and "refence water level" is only used by MOHID Water for computing water level.
  4. the output shapefile can be clipped by using any of the polygons on the map. Or by using the polygons to remove areas from the final result or to select those areas as the final extent.

In Layer Processing

Choose where to save the shape file and press button to start the processing.

Tools ProcessFloodRisk 1.png
Figure 23 : Processing flood risk.

River Burn-In

River Burn-In Tool was designed to "dig" digital terrain models around a given line (river) in a defined extension (river margin) to impose some geometry that the original terrain data has no definition to. It can be applied to MOHID Land DTM to dig rivers or to MOHID Water bathymetries to better define small channels.

The center line(s) of burning can be any line drawn on Studio (.lin, .xml, shapefile) and the defiition of the extent can be done by a buffer around line, or by a polygon (any one drawn on Studio as .xy, .xml, shapefile).

The method will go to every line segment, evaluate original terrain model values around line edges (in a distance given by the user), get the average or minimum (user choice) of original terrain values and will dig the amount specified by the user, mantaining the same slope as the original terrain (from line edge to line edge).

Hint: Since the method evaluates line per line segment and uses original terrain values on edges to mantain slope, the user should adapt the number of line segments used depending on the terrain varying slope. In areas with similar slopes it is not needed a dense network of line segments but in fast varying slope areas it will need line edges at least on breaking points in order to dig areas mantain same slope as original DTM. .

Then the remainder area of the river margin is filled by interpolation.

The tool is shown in Figure 24

In 1. Base Information

  1. Select the DTM to dig.
  2. Select the center river line geometries.
  3. Select the area for digging (from the line itself and a buffer distance or defined by polygon geometries)
  4. Is selected areas from polygons, select the polygon geometries to use

In 2. Options

  1. Define if using the Average or Minimum for computing line edges elevation from neighbor cells values and the distance around line edges to define which cells to consider for that computation.
  2. Define the digging height.
  3. Define the type of interpolation (if digging over an area)
  4. Define output DTM file.

In 3. Generate Grid Data

  1. Hit the button to start processing.
Tools BurnInRiver.png
Figure 24 : River Burn-In tool.

Smooth Tool

The tool Smooth tries to smooth digital evelation models (or bathymetries) by reducing slopes between cells computing a new elevation ased on neighbors average value. This can be usefull in MOHID Water to reduce instability problems associated to ouh bathymetry areas.

The tool is shown in Figure 25

In 1. Select DTM

  1. Select the DTM to smooth and the new file smoothed.

In 2. Options

  1. Selet the radius that is the number of neighbor levels around the cell to consider. If 1 will use 8 cells (2 neighbors in x, 2 in y and 4 in the corners), if 2, will use 16 cells that are the first 8 plus the direct neighbors of these, and so on.
  2. Define the factor that determines the weight given to the cell elevation (it will give (1-factor) to the neighbors average elevation).
  3. Define if want to apply the computation to entire grid or to a defined area.
  4. If computing in a defined area, select the polygons to use as selecting the area.

In 3. Persist changes

  1. Hit the button to start processing.
Tools Smooth.png
Figure 25 : Smooth tool.

MOHID Land Tools

MOHID Land tools allow preparing data files for MOHID Land. These tools include: (i) depression removal, (ii) watershed delineation, (iii) soil depth and (iv) cross section definition.

Depression Removal

MOHID Land requires a depression free digital terrain model in order to run[4]. After constructing a digital terrain model (topography), the depression removal tool can be used to remove depression from it. Depression can be removed by sink filling or by artifact removal.

The depression removal tool can be accessed by pressing the "Remove Depressions" on MOHID Land tool group from the "Tool Box" (see Figure 2). The tool to remove depressions appears docked on the right side of the main window as shown in see Figure 26.

MOHID Studio - User Guide v2 25.png
Figure 26 : Depression Removal Tool.

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" (an example is represented in Figure 26).

Depressions listed, in the "List of Depressions", can be individually removed by selecting the up (remove by sink filling) and down (remove by artifact removal) buttons. Since the removal of a single depression may create new depressions, the list of existing depressions is automatically updated as one individual depression has been removed.

Since the number of depressions can be very high, MOHID Studio includes an algorithm to remove depressions through an iterative process. To execute this, press the "Remove depressions by iterations" button. MOHID Studio will loop through all depressions for the value of "Max. Iteration" (by default the value is 50 times). Depressions containing less than value displayed on the "Max cell filling" (the default value is 5) will be removed by sink filling, others by artifact removal.

NOTE: For very narrow values or very flat areas the depression removal algorithm may not work very well. It may be required to preprocess the digital terrain model first (for instance with the Modify Grid Data tool).

When all depressions have been removed, the depression free Digital Terrain Model can be saved in the "Persist Changes" box.

Watershed Delineation

Watershed delineation has two proposes: (i) specifying which grid cells drain to the outlet (and as consequence distinguishing between compute points and non-compute points) and (ii) creates the drainage network.

The watershed delineation tool can be accessed by pressing the "Delineate Watershed" on MOHID Land tool group from the "Tool Box" (see Figure 2). The tool will appear docked on the right side of the main window as shown in see Figure 27. This tool, to be opened, requires a depression free Digital Terrain Model (from the previous step).

MOHID Studio - User Guide v2 26.png
Figure 27 : Watershed Delineation Tool.

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 Studio’s GIS engine, so it is the user that select the right (depression free) Digital Terrain Model.

The second step is to define the threshold area value, by default is 1000000 m2 (100 ha). This area indicates from which drained upstream area the river channel are formed.

To generate the river network in all area without delineating select drainage network and deselect all the rest options and run the tool and do not close it. This will generate the drainage network to all the DTM area and ease the process of chosing the outlet (since the drainage network is already present).

To delineate the watershed, check the "Delineate Basin" box and the outlet can be specified using the "pick" button selecting a point on top of the drainage network generated for all the area. Check the "Delineation" file and "Basin Geometry" and run the tool. The drainage network is now displayed only upstream to the outlet selected (see Figure 27).

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 the other outputs are not required, but may be useful for graphical visualization (namely the "Delineation" – polygon which defines the watershed).

Porous Media

The Porous Media tool allows creating additional files for MOHID Land: (i) soil depth, (ii) bottom digital terrain model, (iii) slope and (iv) initial ground water level. This tool can be accessed by pressing the "Porus Media" on MOHID Land tool group from the "Tool Box" (see Figure 2). The tool will appear docked on the right side of the main window as shown in see Figure 28.

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 that 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. In Figure 28 is shown the result of soil depth with higher values in valleys and lower in hillslopes.

MOHID Studio - User Guide v2 27.png
Figure 28 : Soil Depth Tool.

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 value of 100% indicates that the initial water table is closed to the top (fully saturated soil).

In the "Persist Changes" box the target files can be selected and saved by pressing the "Save" button.

Cross Section Definition

After watershed delineation, the nodes of the drainage network do not contain cross sections. MOHID Land needs to have the cross sections defined, in order to be executed. The Cross Section Definition tool allows defining cross sections for all nodes in a drainage network in a simple way. This tool can be accessed by pressing the "Cross Sections" on MOHID Land tool group from the "Tool Box" (see Figure 2). The tool to will appear docked on the right side of the main window, as represented in the Figure 29.

Cross section definition involves several steps. In first place it is necessary to define the drainage network, in the "Network" box, for which the cross section will be created. Then the typical cross sections must be defined for one of 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 the Strahler orders, of the drainage network, the drainage network file can be saved, by selecting the "Save" button.

MOHID Studio - User Guide v2 28.png
Figure 29 : Cross Section Definition Tool.

Cross Section Edition

In MOHID Studio 2016 version this tool was included that allows to edit specific cross section nodes dimensions by selecting them in map as seen in Figure 30.

In 1. Network

Select existing drainage network layer.

In 2. Default Cross Sections

  1. Select the desired cross sections to edit by clicking in "Area" icon
  2. The selected cross section nodes will be filled in the box below and appear selected in map in yellow.
  3. Select the desired cross section to edit dimensions (process one at a time).

In Cross Sections

Edit the section type and dimensions. The new section will bedrwan in the figure below

In 4. Save Network

Press save icon to save the changes.

Studio2016 14.png
Figure 30 : Cross Section Definition Tool.

MOHID Water Tools

The MOHID Water tool present here for now is the tide generator.

Generate Tide

One of the main drivers for water circulation in coastal areas is tide and in the first simulation that is the only forcing agent.

FES (finite element solution) tide model is the most common source of tidal components being available for the entire world which the most recent model version is FES2012 and previous version is FS2004. MOHID Studio incorporates a tool to obtain tidal component from FES2004 and in the future will have it updated for the most recent version.

Before start using the Tidal Tool, the user should load the bathymetry for instance if not already loaded.

Go to "Tool Box" and press "Generate Tidal File" inside "MOHID Water Tools" and the Tidal Tool window will appear (see Figure 31). This tool is divided under 3 sections: 1 – Define points on map; 2- Selected grid points; 3 – Config tide.

MOHID Studio - MOHID Water Quick Start Guide v1 18.png
Figure 31 : Tidal Tool window

The first step to use this tool, is to define the points on Map. Click on the "Draw" button (the button will turn orange) and then click on the map to draw the points (see Figure 32). The points should be drawn on the boundaries of the working layer in zig-zag, like the ones shown on the example on the Figure 33.

Each time the mouse is pressed a new blue marker will appear on the map and a new line is added to the table (see Figure 32). Each line represents a single point, with the coordinates of each point and name (by default the point number is incremented: Point_1, Point_2, and so on). The decimal places for the X and Y coordinate values can be changed on panel 1 (by default the decimal places are 4).

MOHID Studio - MOHID Water Quick Start Guide v1 19.png
Figure 32 : Tidal Tool plugin – Drawing points (start.


MOHID Studio - MOHID Water Quick Start Guide v1 20.png
Figure 33 : Tidal Tool plugin – Draw points (end.

The user can remove a single point, by selecting a single line and pressing the "Remove" button. The "Clear List" button will erase all points from the table.

The panel 3 is for the tide configurations (see Figure 34). First select the path to the "tide.nc" file[5]. Select the time reference value (Time Ref) and the reference level value (Ref Level). Select also the path and name for the output file. The path and name for XYZ file is optional. If the filename is empty, the XYZ file will not be saved.

The reference level is the mean sea level (measured from the origin of the bathymetry upwards) obtained from tidal gauges in the area (in Tagus the mean sea level is 2.08m above bathymetric zero). The FES tide solution is in Greenwich Meridian Time (GMT) so need to adapt to your area using time reference (e.g. Spain is 1 (+1) and will be negative trough the west).

MOHID Studio - MOHID Water Quick Start Guide v1 21.png
Figure 34 : Tidal Tool – Configurations.

To generate the tide file (the output file) just press the button "Process".


SWAN Tools

These set of tools were introduced in MOHID Studio version 2016 where SWAN model was included.

In order to easily implement SWAN model using constructed bathymetry in MOHID Studio or force the model with MOHID Water conditions (bottom, water level, currents, etc) or vice-versa (MOHID Water model forced with SWAN waves) a set of tools were created.

Convert MOHID Bathymetry to SWAN

This tool allows to convert a regular MOHID format bathymetry (e.g. grid data created from MOHID Studio) to SWAN format (by default using SWAN parameter idla = 1 meaning that starts on top left corner) - Figure 35

In Options

Choose one of the available bathymetries from map in "Bathymetry" field. This is usefull for the case where the bathymetry was created with MOHID Studio tools or just opened and sits in the "Map".

If the user checks "Update SWAN simulation..." than is invited to select a simulation from the "Explorer" tab to define which simulation will be updated (in terms of placing the final file in GD\DT folder and updating the SWAN data file with the coordinate system, computational grid, input grid and read grid for bathymetry, making it easier to implement the model in a straightforward way.

If the user does not check "Update SWAN simulation..." than is invited to provide the folder to place the converted file. However for using the batymetry to run SWAN it envolves a copy paste work that is avoided by checking the box (see above):

  1. The process will create a SWAN bathymetry file with 5 headers.
  2. In these headers exist all information about coordinate system, computational grid and bottom file definition that can be copied pasted to SWAN input file.
  3. Leave the headers in the file since one of the parameters copied is the number of headers lines that the file have (5).
  4. To run SWAN model place a copy of the file in GD\DT folder of the SWAN project. SWAN project folder name were shortened to e able to comply with SWAN short path length.

In Process

Hit the button to start conversion.

Studio2016 40.png
Figure 35 : SWAN tools - convert MOHID Bathymetry to SWAN.

Convert SWAN Bathymetry to MOHID

This tool allows to convert a regular SWAN format bathymetry to MOHID format (for now accepts only SWAN parameter idla = 1 or 3 meaning that starts on top left corner or bottom left corner) - Figure 36

Need to provide the path to the SWAN Bathymetry and the SWAN file (to read bathymetry parameters) and the output path of MOHID bathymetry (by default it will be the same folder as bathymetry input).

Studio2016 16.png
Figure 36 : SWAN tools - convert SWAN Bathymetry to MOHID.

Convert MOHID HDF Results to SWAN

This tool allows to convert MOHID HDF hydrodynamic (water level, currents), atmosphere (wind) and sediment (bathymetry evolution) to SWAN format in order for example to input it as a SWAN model forcing.

It saves HDF datasets in SWAN grid format and creates a list of files to be referenced in SWAN input file (see SWAN Project Examples availale in Studio start screen on the right panel).

The tool works with "Explorer" tab, being able to process one simulation at a time (Figure 37).

In Properties Configuration

  1. Select the simulation to process by pointing at it in "Explorer" window. It will only work with MOHID Water simulations and warn the user otherwise.
  2. The simulation name will appear on top and will fill the tables below with the properties found in the simulation, separated by atmoshpere, hydrodynamic and sediment.
  3. Check the simulations to use or use the buttons "Select All" or "Unselect All".

In Save

Choose the destination folder where to place the files and press icon to process.

Remark

  1. If use this to run SWAN place the output files in the GD\BC folder of SWAN project. SWAN project folder name were shortened to be able to comply with SWAN short path length.
Studio2016 17.png
Figure 37 : SWAN tools - convert MOHID HDF Results to SWAN.

Convert SWAN Table and Time Series Results to MOHID

This tool allows to convert SWAN table (computational grid results) and SWAN time series to MOHID format in order to visualize results and/or input it as a model forcing.

It saves computational grid results to HDF and time series to MOHID time series format that can be opened in MOHID Studio.

The tool works with "Explorer" window, being able to process one simulation at a time (Figure 38).

In Simulation

  1. Select the simulation to process by pointing at it in "Explorer" tab. It will only work with SWAN simulations and warn the user otherwise.
  2. The simulation name will appear on top.

In Save

Choose the destination folder where to place the HDF files and time series and press icon to process.

Studio2016 18.png
Figure 38 : SWAN tools - convert SWAN results to MOHID.

Oil Spill

Oil Spill is a tool developed to process results from Oil Spill simulations. Tool instructions will be updated shortly. Contact us for more information.


Online Data

Online data is a set of tools to download online data as topography, time series from national monitoring grid or meteorology and currents in HDF format (e.g. boundary conditions for model)

Download INAG

This tool downloads data from snirh.apambiente.pt/ the national grid of monitoring stations for inland (meteorology, hydrological and water quality). In the tool can be downloaded meteorology and hydrological data.

The tool is shown in Figure 39

In 1. Select Monitoring Stations

  1. Select the type of monitoring stations. This will add a new point layer on map with all the stations in the country of that type.
  2. Select the stations to download data from by picking on them in map.

In 2. Parameters

  1. Select the dates to fectch data from. Be aware that long periods of data can take long to download.

In 3. Dates and Values

  1. Selet the parameters to fectch data from. Can select several by holding CTRL ket while pressing on parameters.
  2. Select if want to convert values by specifing a multiplication and adding factor.

In 4. Download

  1. Hit the button to start processing.

The time series if any value found will be added to Studio Data base. This values can be accessed in ribbon "Environmental Monitoring" or by using the tool "Time Series" -> "Time Series from DB"

Tools SNIRH.png
Figure 39 : SNIRH download tool.

XYZ from ETOPO

This tool downloads elevation data from ETOPO and saves it in XYZ format.

The tool is shown in Figure 40

In 1. Select Area

  1. Select the area to download data by writting on envelope, by selecting from map or by selecting a layer on map.

In 2. Select ETOPO file

  1. Select the file that you need to download to your computer (follow the link in the tool). This file has all elevaton for all world.

In 3. Select Destination File

  1. Selet the xyz file to save data in to.

In 4. Generate file

  1. Hit the button to start processing.
Tools ETOPO.png
Figure 40 : ETOPO download tool.

XYZ From HGT

This tool downloads elevation data from NASA SRTM 3 arc sec (around 70-90m in 30-40º latotude) and saves it in XYZ format.

The tool is shown in Figure 41

In 1. Select Area

  1. Select the area to download data by writting on envelope, by selecting from map or by selecting a layer on map.

In 2. Select Destination File

  1. Selet the xyz file to save data in to.
  2. Select "Invert Z Axis" if using MOHID Water
  3. Select "Correction X" and "Correction Y" value if want to increase envelope in X and Y directions

In 3. Generate file

  1. Hit the button to start processing.
Tools HGT.png
Figure 41 : HGT download tool.

HDF from NCEP

This tool converts netcdf atmospheric results from NCEP models to HDF (so it can be used for instance as boundary condition for models).

The tool is shown in Figure 42

In Input Files

  1. Add the netcdf files to convert. They need to have same timing. Follow the link to download files.

In Output File

  1. Select the output HDF file to convert to.

In Process

  1. Hit the button to start processing.
Tools NCEP.png
Figure 42 : NCEP download tool.

HDF from MyOcean

This tool converts netcdf current and water quality results from MyOcean models to HDF (so it can be used for instance as boundary condition for models).

The tool is shown in Figure 43

In Input Files

  1. Add the netcdf files to convert. They need to have same timing. Follow the link to download files.

In Output File

  1. Select the output HDF file to convert to.

In Process

  1. Hit the button to start processing.
Tools MyOcean.png
Figure 43 : MyOCEAN download tool.

Time Series Tools

Time series tools have two functions: (i) create files which indicate to MOHID model the location of time series and (ii) create files which contain time series.

Grid Time Series Location

The Grid Time Series Location tool allows creating files which contains the grid location of time series points. This tool can be easily accessed by pressing "Grid Location" on Time Series tool group from the "Tool Box" (see Figure 2). The tool will appear docked on the right side of the main window, as represented in the Figure 44.

MOHID Studio - User Guide v2 29.png
Figure 44 : Grid Time Series Location Tool.

Creating a grid time series location file involves several steps. The first one is to select the grid data which will be used as base. The second one is to specify the locations of the grid points. This can either be done by adding data from a Named Points layer or by selecting the points interactively over the map. The grid data location is generated by clicking on the "Save" button. This tool allows saving, optionally, a XML Geometry file with the point locations. This is useful for display proposes and for later editing of the grid time series location.

Network Time Series Location

The Node Time Series Location tool allows creating files which contains the node location of time series points for outputing results in the river. This tool can be easily accessed by pressing "Network Location" on Time Series tool group from the "Tool Box" (see Figure 2). This tool works in a similar way as the Grid Time Series Location tool described above.

Time Series from Database

The Time Series from Database tool allows extracting time series from MOHID Studio’s database, in order to generate boundary conditions from MOHID models. This tool can be accessed by pressing "TimeSeries From DB" on Time Series tool group from the "Tool Box" (see Figure 2). The tool will appear docked on the right side of the main window, as represented in the Figure 45.

MOHID Studio - User Guide v2 30.png
Figure 45 : Creating a time series from the database.

This tool requires that there has been previously data imported into the database (there are several ways to import values to database, check Environmental Monitoring.

First select the monitoring station and the time series, from the "Select Source Data" box. The start and end date can be defined as well as the default value. After all the parameters are filled, MOHID Time Series ASCII file can be generated by clicking the "Save" button.

Time Series from HDF

The Time Series from HDF tool allows extracting time series from MOHID Studio’s HDF database, in order to generate boundary conditions from MOHID models. This tool can be accessed by pressing "Extract from Indexed HDF" on Time Series tool group from the "Tool Box" (see Figure 2). The tool will appear docked on the right side of the main window, as represented in the Figure 46.

MOHID Studio - User Guide v2 31.png
Figure 46 : Creating a time series from the database.

This tool requires that there has been previously data imported into the database (there are several ways to import values to database, check Import HDF files to database).

First select the model domain and time interval, from the "Select Model Domain" box. Pick the location of the timeserie and MOHID Time Series ASCII file can be generated by clicking the "Save" button.



HDF File Tools

HDF File tools are related to polygon based in HDF Files.

Interpolate HDF Files

The Interpolate HDF File tool allows interpolating one HDF file to a new grid. This tool can be accessed by pressing "Interpolate" on HDF Files tool group from the "Tool Box" (see Figure 26 1). The tool to will appear docked on the right side of the main window, as represented in the see Figure 47.

MOHID Studio - User Guide v2 32.png
Figure 47 : Interpolating a HDF File to a new grid.

The interpolation/extrapolation property is defined in "Select Data Sets" and the method is defined in the "Interpolation/Extrapolation Options". The file is being processed by clicking the "Process" button.

NOTE: This tool requires a Digital Terrain Model and a HDF File to be loaded ("Select DTM and Source HDF" box).

Import HDF Files to Database

The import HDF files to database allows to import HDF files to database that can be later used to export time series or to interpolate to other grids. This tool can be accessed by selecting "Import into Database" on HDF Files tool group from the "Tool Box" (see Figure 2). The tool will appear docked on the right side of the main window, as represented in the Figure 48.

The HDF file(s) have to be selected (browsing) and the domain selected (see Environmental Monitoring how to create a new domain) and clicking "Import" will add the file to database.

MOHID Studio - User Guide v2 33.png
Figure 48 : Importing a HDF File to database.

Export HDF Files from Database

The export HDF files from database allows to export HDF files for exploring results or for modelling forcing. This tool can be accessed by selecting "Export from Database" on HDF Files tool group from the "Tool Box" (see Figure 2). The tool will appear docked on the right side of the main window, as represented in the Figure 49.

The model domain and instants have to be selected and a new grid and interpolation type can be selected so that the output HDF can be used in other model grid. Selecting the output file and clicking "Export" will create the new HDF file.

MOHID Studio - User Guide v2 34.png
Figure 49 : Exporting HDF File from database.



Hello World

The Hello World tool is a shell to future developers to add tools to Studio.

Developer Sample Tool

This tool has the main processes of map interaction, run process and database connection to drive the developer to create new tools for Studio.


Visualization

Visualization tools were created to aid in opening and refining MOHID Water spill simulations results and to create generic profiles views (for color, vector and particles).

Vertical Cuts

The vertical cut tool allows creating vertical cuts from 3D polygon based HDF File layers. This tool can be accessed by selecting "Vertical Axis Cut" on HDF Files tool group from the "Tool Box" (see Figure 2). The tool will appear docked on the right side of the main window, as represented in the Figure 50.

This tool requires a HDF File to be loaded and is able to use color, vector and particle results from MOHID.

In 1. Select Layer Information

  1. Select the layers to use in the profile. Can choose to select vector layers and particle layers. The tool fills the vector layers and particle layers that are consistent with the color layer (in termos of hdf file dimensions and that have at least on instant in common)

In 2. Cut Parameters

  1. Select the cut direction (X or Y)
  2. Select the cut layer and the extension of cutting in X or Y and Z layers.
  3. Select the distortion. It is the factor to multiply by vertical axis so that the profile is readable (if length of cut is much bigger than vertical length). This can be adjusted by trial and error.

In 3. Create Window

  1. press button to process.

After the vertical cut is created it will be displayed in a new tab. The vertical cut will be represented with the same style that is used for the map. See Figure 51

Tools VerticalCutAxis.png
Figure 50 : Creating a vertical cut from 3D HDF File.


Tools VerticalCutAxis2.png
Figure 51 : The vertical cut window created with color, vector and particles.

Lagrangian Layers

The tool allows to open Lagrangian simulation HDF results in bulk and adds new outputs that need post-processing from HDF fields (plume envelope and plume center) and are not directly opened from the file.

Remark Plume envelope and plume center are only available to plot if in Lagrangian_X.dat the following optons exist:

OUTPUT_ORIGIN_ENVELOPE    : 1
COMPUTE_AVERAGE_POSITION  : 1

The tool works with "Explorer" window to perform actions on selected simulations ( Figure 52).

The user needs to define: - select the simulation in "Explorer" window (that will fill the available properties results in terms of particles and eulerian) - select the available propeties to load to map.

Studio2016 10.png
Figure 52 : Tool to load lagrangian particle and eulerian layers.

The result of particles, plume envelope (the extent of all particles) for each instant and plume center line (center coordinate of plume envelope) for all trajectory can be seen in Figure 53.

Studio2016 11.png
Figure 53 : Result from the tool to load lagrangian results..

Refine Lagrangian Results

It was also constructed a MOHID Studio post-processing tool to refine Lagrangian grid results. The tool creates a refined nested grid (based on user steps) and computes new cell concentrations based on particle mass inside new cell and new cell volume.

The tool works with "Explorer" window to load layers from previously run simulation or with "Map" to load available HDF layers ( Figure 54).

Studio2016 12.png
Figure 54 : Tool to refine lagrangian grid results.

1. in HDF Sources

- select if using "Current Simulation" (the "Explorer" window selected simulation) or "Map Layers" (the layers loaded on "Map" window. The tool will show the properties available for refinement.

- select the desired properties to refine.

2. In Select Area to Refine Grid

- press the Area icon and select a Area inside the grid in map that the tool loaded (the original grid).

- select refinement rations in horizontal and vertical and the grid will be updated in map (horizontally).

3. In Options

- select if want to compute the maximum concentration of a particle inside each new cell.

4. In Output

- select the output folder where the refined HDF will be placed.

The result of a grid property value in a vertical profile from previous example, without and with refinement, for a given instant can be seen in Figure 55. The grid results gain detail where particle concentrations in grid cell get less "diluted". The refined image has an increased horizontal and vertical resolution resolution step of 3 (3 times more cells in each direction then the original).

Studio2016 13.png
Figure 55 : Result from the tool to refine lagrangian grid results.

File Conversions Tools

Introduction

MOHID Studio contains a set of utilities which permit to convert (and/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 "File Conversion" tool group (represented in Figure 2).

The main Conversion Utilities are explained in detail next.

Google KML

Export to KML utility allows exporting data to KML format. Formats which are possible to export to KML, from MOHID Studio, are: HDF Polygon Files, MOHID ASCII Grid Data Files, MOHID ASCII Drainage Network Files and Named Geometry Files. Before exporting any data to KML, the data must be loaded as layer into MOHID Studio’s map engine. Exported KML files can be loaded into applications like Google Earth[6].

Export HDF Polygon to KML

To export data from an HDF Polygon based layer to KML file, press "HDF Polygon to KML" in "File Conversion" group tool. A window, like the one represented in Figure 56, will appear. On the upper left side of the window, the instants to be exported must be selected, on the "Fields to Export" box. On the upper right side of the window is possible to choose how the Z coordinate will be handled. On the bottom it is possible to choose where the exported files will be saved. Note that this tool will create one KML file for each instant which will be exported. The export process is started by clicking on the "Export" button.

MOHID Studio - User Guide 139.png
Figure 56 : Export HDF to KML.

Export Grid Data to KML

To export a Grid Data layer to a KML file, press "Grid Data to KML" in "File Conversion" group tool. A window like the one represented in Figure 57 will appear. After choosing the Layer to export and the destination of the exported file, click on "Export" button to generate the KML file.

MOHID Studio - User Guide 140.png
Figure 57 : Export Grid Data to KML.

Export Drainage Network to KML

To export a Drainage Network layer to a KML file, press the button "Drainage Network to KML" in "File Conversion" tool group. Then the "Export Drainage Network to KML" window will be opened, represented in Figure 58). After choosing the Layer to export and the destination of the exported file, click on "Export" button to generate the KML file.

MOHID Studio - User Guide 141.png
Figure 58 : Export Drainage Network to KML.

Export Named Geometry to KML

To export a Named Geometry layer to KML, press the button "XML Geometry to KML" in "File Conversion" tool group. The window "Export Named Geometry to KML" will be opened (represented in Figure 59). After choosing the Layer to export and the destination of the exported file, click on "Export" button to generate the KML file.

MOHID Studio - User Guide 142.png
Figure 59 : Export Named Geometry to KML.

ESRI Shapefile

Export to Shapefile utility allows exporting data to ESRI Shapefile format. Formats which are possible to export to ESRI Shapefiles are: HDF Polygon Files, MOHID ASCII Grid Data Files, MOHID ASCII Drainage Network Files and Named Geometry Files. Before exporting any data to ESRI Shapefiles, data must be loaded as layer into MOHID Studio’s map engine. Exported ESRI Shapefiles files can be loaded into applications like Arc GIS.

Export HDF Polygon to Shapefile

To export data from an HDF Polygon based layer to Shapefile, press the button "HDF Polygon to ESRI Shapefile" in "File Conversion" tool group. A window like the one represented in Figure 56 will appear. The process of exporting data is the same as exporting to KML, with the only difference that no Z coordinate can be set.

Export Grid Data to Shapefile

To export a Grid Data layer to Shapefile, press the button "Grid Data to ESRI Shapefile" in "File Conversion" tool group. A window like the one shown in Figure 57 will appear. The process of exporting data is the similar to process of exporting to KML.

Export Drainage Network to Shapefile

To export a Drainage Network layer to Shapefile, press the button "Drainage Network to ESRI Shapefile" in "File Conversion" tool group. A window like shown Figure 58 will appear. The process of exporting data is the similar to process of exporting to KML.

Export Named Geometry to Shapefile

To export a Named Geometry layer to Shapefile, press the button "XML Geometry to ESRI Shapefile" in "File Conversion" tool group. A window like shown Figure 59 will appear. The process of exporting data is the similar to process of exporting to KML.

XYZ Points to Shapefile

To export a XYZ Point to Shapefile, press the button "XYZ Points to ESRI Shapefile" in "File Conversion" tool group. The window "Export XYZ to Shapefile" will be opened (represented in Figure 60). After choosing the Layer to export and the destination of the exported file, click on "Export" button to generate the Shapefile with the exported layer.

MOHID Studio - User Guide 143.png
Figure 60 : Export XYZ to Shapefile window.


Convert MOHID ASCII Geometries to XML Geometries

Conversion of MOHID ASCII Geometries to XML Geometries can be done by pressing one of the three buttons (MOHID Points, MOHID Lines and MOHID Polygons) in "File Conversions" group tool. A window like the one represented in Figure 61 will appear. With this feature it is possible to convert "old" MOHID ASCII point, line and polygon files to the "new" MOHID XML Geometry files. The process of converting points, lines, and polygons is very simple. First select the file to import and then the destination path and filename. To start the file conversion, press the "Convert" button.

MOHID Studio - User Guide 144.png
Figure 61 : Convert MOHID ASCII to XML.


Convert XML Geometries to MOHID ASCII Geometries

Conversion of XML Geometries to MOHID ASCII Geometries can be done by pressing one of the three buttons (XML Points, XML Lines and XML Polygons) in "File Conversions" tool group. A window like the one represented in Figure 62 will appear. With this feature is possible to convert from the "new" MOHID XML Geometry files to "old" MOHID ASCII point, line and polygon files. The process of converting points, lines, and polygons is very simple. First select the file to import and then the destination path and filename. To start the file conversion, press the "Convert" button.

MOHID Studio - User Guide 145.png
Figure 62 : Convert XML to MOHID ASCII.


Other Conversions

Other conversions exist that can be useful as Grid Data to VTK (visualization toolkit [1]) or Grid Data to XYZ (convertion of cell center values to XYZ points) or Raster to XYZ (convertion of cell center values to XYZ points). These options can be done in "File Conversions" tool group and the input and output file need to be defined as the above examples. In the case of the conversion from raster also the conversion can be obtained in one area specified by any grid data (see "Select Region" in Figure 63).


MOHID Studio - User Guide v2 35.png
Figure 63 : Convert Raster to XYZ.

ESRI Shapefile to XYZ

To export a Shapefile to XYZ, press the button "ESRI Shapefile to XYZ Points" in "File Conversion" tool group. The window "Export Shapefile to XYZ" will be opened. After choosing the Layer to export and the destination of the exported file, click on "Export" button to generate the XYZ with the exported layer.

Grid Data to XYZ

To export a Grid Data to XYZ, press the button "Grid Data to XYZ Points" in "File Conversion" tool group. The window "Export Grid Data to XYZ" will be opened. After choosing the Layer to export and the destination of the exported file, click on "Export" button to generate the XYZ with the exported layer.

Raster to XYZ

To export a Raster to XYZ, press the button "Raster to XYZ Points" in "File Conversion" tool group. The window "Export Raster to XYZ" will be opened. After choosing the Layer to export and the destination of the exported file, click on "Export" button to generate the XYZ with the exported layer.

Notes

  1. This tool is only available in MOHID Studio Professional Version.
  2. The reason this constraint is in place is because the definition of the corners is actually an implicit definition of an "image polygon" where a regular grid will be generated and then "distorted" into the polygon defined within the tool. Each defined corner corresponds to an edge that forms a 90º angle in the image polygon. Unless the difference between each corner type is 4, the image polygon is not closed. Each time a grid is generated, the image polygon is stored at C:\ProgramData\Action Modulers\MOHID Studio\Temp\GridGen\rectangle.xy where it can be checked if desired.
  3. It is also possible to define an image polygon with edges that form angles other than 90º. To do so, first generate a curvilinear grid with the desired parameters (apart from the polygon corners which can be selected randomly) in MOHID Studio. Then, open the file C:\ProgramData\Action Modulers\MOHID Studio\Temp\GridGen\ConvertedPolygon.xy with a text editing tool. In the text file, locate each polygon corner that you wish to define and for each one of those corners edit the third column to a value between -2 and 2 given by the formula (1 - angle / pi) * 2 where angle is the associated angle of the polygon corner in the image polygon in radians. Every point that is not a corner in the image polygon must have this value set to 0. For the image polygon to be valid, the sum of all the third column values must be 4 or -4. After editing and saving the file, open Windows Start menu and type "command prompt" in the search box. Open the command prompt, type "cd C:\Program Files\Action Modulers\MOHID Studio 2015\GridGen" to change your directory (the address might be different, depending on where you installed MOHID Studio), then type "gridgen_new.exe "C:\ProgramData\Action Modulers\MOHID Studio\Temp\GridGen\prm.1"". When the task is finished the generated grid will be saved in C:\ProgramData\Action Modulers\MOHID Studio\Temp\GridGen\CurvilinearGrid.grd ready to be opened in MOHID Studio
  4. 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.
  5. The file should be downloaded here: ftp://ftp.legos.obs-mip.fr/pub/soa/maree/tide_model/global_solution/fes2004/tide/tide.fes2004.nc
  6. Download link: http://earth.google.com/download-earth.html

Links

Go back to MOHID Studio User Guide

User Guides