MIKE SHE TOOLBOX

User Guide

MIKE by DHI 2014

2
Please Note
Copyright
This document refers to proprietary computer software which is protected
by copyright. All rights are reserved. Copying or other reproduction of
this manual or the related programs is prohibited without prior written
consent of DHI. For details please refer to your 'DHI Software Licence
Agreement'.

Limited Liability
The liability of DHI is limited as specified in Section III of your 'DHI
Software Licence Agreement':
'IN NO EVENT SHALL DHI OR ITS REPRESENTATIVES (AGENTS
AND SUPPLIERS) BE LIABLE FOR ANY DAMAGES WHATSO-
EVER INCLUDING, WITHOUT LIMITATION, SPECIAL, INDIRECT,
INCIDENTAL OR CONSEQUENTIAL DAMAGES OR DAMAGES
FOR LOSS OF BUSINESS PROFITS OR SAVINGS, BUSINESS
INTERRUPTION, LOSS OF BUSINESS INFORMATION OR OTHER
PECUNIARY LOSS ARISING OUT OF THE USE OF OR THE INA-
BILITY TO USE THIS DHI SOFTWARE PRODUCT, EVEN IF DHI
HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
THIS LIMITATION SHALL APPLY TO CLAIMS OF PERSONAL
INJURY TO THE EXTENT PERMITTED BY LAW. SOME COUN-
TRIES OR STATES DO NOT ALLOW THE EXCLUSION OR LIMITA-
TION OF LIABILITY FOR CONSEQUENTIAL, SPECIAL, INDIRECT,
INCIDENTAL DAMAGES AND, ACCORDINGLY, SOME PORTIONS
OF THESE LIMITATIONS MAY NOT APPLY TO YOU. BY YOUR
OPENING OF THIS SEALED PACKAGE OR INSTALLING OR
USING THE SOFTWARE, YOU HAVE ACCEPTED THAT THE
ABOVE LIMITATIONS OR THE MAXIMUM LEGALLY APPLICA-
BLE SUBSET OF THESE LIMITATIONS APPLY TO YOUR PUR-
CHASE OF THIS SOFTWARE.'

Printing History
January 2009
December 2009
July 2010
July 2012
August 2014

3
4 MIKE SHE Toolbox
CONTENTS

5
MSHE Tools: DATA ANALYSIS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1 PROBABILITY CURVES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.1 Setup Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.2 Time series file selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.3 Output Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.4 Output file selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.5 Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

MSHE Tools: FILE CONVERTER . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

2 DFS2+DFS0 TO DFS2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
2.1 Setup Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
2.2 Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
2.3 Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

MSHE Tools: UTIL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

3 GRID CALCULATOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
3.1 Setup Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
3.2 Calculation Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
3.3 Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

6 MIKE SHE Toolbox

M S H E TO O L S : D ATA A N A LY S I S

7
 The Data Analysis Tools in the MSHE Toolbox include the facility

z Probability Curves

8 MIKE SHE Toolbox

Setup Name

1 PROBABILITY CURVES
The MIKE SHE Probability Curves Tool calculates the mean value, as
well as the probablity and duration curves for the specified period in a
dfs0 file.

1.1 Setup Name

Specify a name for the setup. This allows you to save and retrieve the
setup, either later, or from a batch file.

1.2 Time series file selection

Select the dfs0 file for which you want the probablity and duration curves.

1.3 Output Settings

The output settings dialog allows you to define the period and interval for
the statistic calculation. If you select Specified for the Interval, then you
can define the number of periods and the start and end months.

9
 Probability Curves

The sub-sets option allows you to further refine the statistical breakdown.

1.4 Output file selection

Type in the name of the ASCII file where want the probablity and duration
curves written to.

1.5 Status
The Status page presents you with a summary of all the input parameters
you have specified. Check that the parameters are correct. If not go back
and change them.

Log/pfs file location

This is the directory where the output will be sent. A subdirectory will be
created here based on the name of the setup.

Running the Tool

Finally, on the Status page, you can

Execute the setup, which will run the Tool with the current parameters, or

Finish the setup, which will save your setup definition in the current tool-
box file.

The tool runs silently. If there are any errors, then the tool will simply not
run.

10 MIKE SHE Toolbox

MSHE TOOLS: FILE CONVERTER

11
 The File Converter Tools in the MSHE Toolbox include the facility:

z dfs2+dfs0 to dfs2

12 MIKE SHE Toolbox

Setup Name

2 DFS2+DFS0 TO DFS2
This tool is used to build a time varying dfs2 file from a dfs2 grid code file
and one or more dfs0 time series files. The time varying dfs2 file can be
used for time varying gridded data items, including Precipitation Rate and
Evapotranspiration.

2.1 Setup Name

Specify a name for the setup. This allows you to save and retrieve the
setup, either later, or from a batch file.

2.2 Files
This dialog contains the file name for the two input files and the output
file.

The input file is a dfs0 file, usually with multiple data items. All the data
items are expected to have the same units, but this is not checked.

The input dfs2 file is a grid file with grid codes corresponding to the item
numbers in the dfs0 file. The dfs2 file must have an EUM type of Grid
Codes with a unit of Integers.

If you are creating a distributed precipitation rate file, then the dfs0 items
must be of type “Mean Step Accumulated”, with a EUM Type of Precipi-
tation Rate and any valid unit, such as [inches/hour] or [mm/day].

The output file will be a dfs2 file with one grid for each time step in the
dfs0 file. and the values in each grid point equal to the value in the dfs0
file at that time step.

2.3 Status
The Status page presents you with a summary of all the input parameters
you have specified. Check that the parameters are correct. If not go back
and change them.

Log/pfs file location

This is the directory where the output will be sent. A subdirectory will be
created here based on the name of the setup.

13
 dfs2+dfs0 to dfs2

Running the Tool

Finally, on the Status page, you can

Execute the setup, which will run the Tool with the current parameters, or

Finish the setup, which will save your setup definition in the current tool-
box file.

The tool runs silently. If there are any errors, then the tool will simply not
run.

14 MIKE SHE Toolbox

MSHE TOOLS: UTIL

15
 The Util Tools in the MSHE Toolbox include the facility

z Grid calculator

16 MIKE SHE Toolbox

Setup Name

3 GRID CALCULATOR
The MIKE SHE Grid Calculator tool allows you to perform complex
operations on .dfs2 grid files. However, the grid files must have the same
grid dimensions and they may not have multiple time steps or multiple
items. Thus, this tool is much more restrictive than the grid operations
available in the Grid Editor. However, you can make complex chains of
operations and save the setup, which can save you a lot of time if you are
doing the same operation many times or after each simulation.

3.1 Setup Name

Specify a name for the setup. This allows you to save and retrieve the
setup, either later, or from a batch file.

3.2 Calculation Setup

In the first part of this dialogue, you need to specify the files and variable
names used in the mathematical operation. These will be the variables
used in the subsequent operation. The variable names are case sensitive.

17
 Grid calculator

Output Specification
In the second part, you must specify the output file name (including the
.dfs2 file extension), as well as the EUM unit type and units for the result-
ing file. Although the EUM list is alphabetical, the list of EUM data types
is very long, as it includes all of the available EUM types for all of the
MIKE Zero products. If you are trying to create a particular input type for
MIKE SHE, then you should look in the MIKE SHE Setup dialogue, to
find out first what EUM data type is required and then find this type in the
list.

Expression
The last part of the dialogue is the mathematical expression you wish to
evaluate. Many common mathematical operations are available, including
LOG and LOG10. If the operation is not recognized, then an error will be
generated when you try to run the expression. The standard order of oper-
ations is followed, including the use of nested brackets.

Note all fields must be filled in.

3.3 Status
The Status page presents you with a summary of all the input parameters
you have specified. Check that the parameters are correct. If not go back
and change them.

Log/pfs file location

This is the directory where the output will be sent. A subdirectory will be
created here based on the name of the setup.

Running the Tool

Finally, on the Status page, you can

Execute the setup, which will run the Tool with the current parameters, or

Finish the setup, which will save your setup definition in the current tool-
box file.

The tool runs silently. If there are any errors, then the tool will simply not
run.

18 MIKE SHE Toolbox

INDEX

19
 Index

20 MIKE SHE Toolbox