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