Tuflow and estry manual Version 3

Read MI Table Links == <.mif/.mid_file> 50

Read Materials File == 51

Relative Resistance == [ {RELATIVE} | MATERIAL ] 51

S Channel Approach == [ PRE 2004-06-AA ] 51

Storage Above Structure Obvert == [ {CHANNEL WIDTH} | ] 51

Trim XZ Profiles == [ ON | {OFF} ] 52

XS Database == 52

[ BG | CS | NA | VG ].... ! Fixed Field Flags 60

BG Data == 60

CS Data == 60

NA Data == 61

VG Data == 61

Read MI IWL == <.mif/.mid_file> 69

Set IWL == 69

BC Database == <.csv_file> 77

BC Event Name == 77

BC Event Text == 78

EB Data == 78

Read MI BC == <.mif/.mid_file> 78

Cell Size == 9

Grid Size (N,M) == , 9

Grid Size (X,Y) == ,  9

Orientation == , 9

Orientation Angle == 10

Origin == , 10

Read MI Location == <.mif/.mid_file> 10

Read TGA == <.tga_file> 18

Read TGF == <.tgf_file> 18

External Bndy == , , , 27

Read MI [ MAT | IWL | CnM | FRIC | WrF | FLC ] == 28

Read MI Code [ {} | BC ] == 28

Read MID [ CODE | MAT | IWL | CnM | FRIC | WrF | FLC ] == 28

Read MID Grid == 29

Set [ CODE | MAT | IWL | CnM | FRIC | WrF ] == 29

Write MI Domain == <.mif/.mid_file> 29

Write MI Grid == <.mif/.mid_file> 29

Allow Dangling Z Lines == [ ON | {OFF} ] 38

Default Land Z == 38

Interpolate ZC [ {} | ALL ] [ {} | LOWER ] 38

Interpolate [ ZHC | ZUVC ] [ {} | ALL ] [ {} | AFTER ] 39

Pause When Polyline Does Not Find Zpt == [ ON | {OFF} ] 39

Read MI Z Line [ {} | RIDGE or MAX | GULLY or MIN | HX ] [ {} | CC ] [ {} | THICK ] [ {} | ADD ] == 40

Read MI Zpts [ {} | ADD | MAX | MIN ] == 41

Read MID Zpts [ {} | ADD | MAX | MIN ] == 41

Set Zpt == 42

Write MI Zpts == 42

ZC == MIN(ZU,ZV) 42

Read File == 51

Stop 51

BC Database == <.csv_file> 9

BC Event Name == 9

BC Event Text == 10

Global Rainfall Area Factor == [ {1.0} | ] 10

Global Rainfall BC == 10

Global Rainfall Continuing Loss == [ {0} | ] 10

Global Rainfall Initial Loss == [ {0} | ] 10

Read MI BC == <.mif/.mid_file> 10

Read MI SA [ {} | Rainfall ] == <.mif/.mid_file> 11

Unused HX and SX Connections == [ {ERROR} | WARNING ] 11

Calibration Points MI File == <.mif/.mid_file>

(Optional)

Assigns the peak water level calculated during the simulation as an extra attribute to the .mif/.mid file. Useful for obtaining peak flood levels at calibration points and other locations as direct output from TUFLOW. Up to a maximum of ten (10) files can be specified.

Display Water Level == ,

(Optional)

Displays the water level on the screen for cell located at X,Y where X and Y are the geographic coordinates in meters.

Map Output Data Types == [ d E F {h} q R SS t {V} Z1 Z2 Z3 ZH ]

(Optional)

Defines data types to be output in map (SMS) format. The letters stand for:

d water depth in m

E energy level in m (water level plus dynamic head) (Build 2002-10-AH)

F Froude Number (Build 2002-10-AH)

h heads (water levels) in m

q unit flow vectors or flood hazard (product of depth and velocity) in m²/s

R flow regime value: 0 (zero) for normal (sub-critical flow with momentum); greater than 1 for upstream controlled friction flow (eg. supercritical flow);  1.5 for broad-crested weir flow; and –1 for submerged flow through a flow constriction. (Build 2002-10-AH).

SS Sink/source flows in m³/s – values at centre of cells are output at top right corner of cells (may change in future version)

t eddy viscosity coefficient output (“e” prior to Build 2002-10-AH)

V velocity vectors (water speed vectors) in m/s

Z1 Flood Hazard based on the Australian NSW Floodplain Management Manual

Z2 Flood Hazard categories as developed for the Herbert River Flood Study, Australia

Z3 Flood Hazard categories as developed for the Tweed River Flood Study, Australia

Z4 Reserved for the Australian guidelines flood hazard categories.

ZH ZH elevations over time (primarily used for morphological modelling)

The letters can occur in any order or combination and are not case sensitive. Spaces between letters are optional. For example to output heads, velocities and unit flow enter the following line:

Map Output Data Types == h V q

The default is:

Map Output Data Types == hV

For further discussion on map output, see Section 6.3.1.

Map Output Format == [ {SMS} | SMS WITH LAND CELLS | RMA2 ]

(Optional)

Sets the format for TUFLOW map output. The default is SMS generic binary format excluding cells that were designated as “land”, ie. permanently inactive cells. The RMA2 format, which was developed before the SMS generic format, can be read by SMS – it is rarely used. The “SMS WITH LAND CELLS” option saves all cells – this will produce larger file sizes.

For further discussion on map output, see Section 6.3.1.

Map Output Interval ==

(Optional)

The output interval in seconds for map based output. If the command is omitted, output is at every computational timestep.

Mass Balance Output == [ ON | {OFF} ]

(Optional)

If set to ON, creates a _MB.csv file in the Output Folder containing mass balance calculations over time. This feature is still under development and subject to change. It is only applicable for the 2D domains (for 1D domains see Section 6.4.4), and does not yet include 2D Q or V boundaries (these are rarely if ever used).

Read MI GLO == <.mif/.mid_file >

(Optional)

Opens .mif and .mid files containing details on gauge level output (GLO) locations. GLO controls map output based on the height of the water at a specified location – this is useful for producing a series of output based on gauge heights for flood warning purposes. It can also be used to display the height of the water at the gauge location to the screen.

As at Build 2003-01-AI, GLO works correctly for levels specified in a text file or by using the start, end and increment attributes. At this build, a buffer was also incorporated so that GLO only repeats at a level once the water level has moved at least 0.1m from the gauge level (this stops repetitive output if the model is “hovering” or “bouncing” around a gauge level.

Only the last occurrence of this command is used.

Screen/Log Display Interval == [ {1} | ]

(Optional)

Sets the frequency for display of output to the computer screen and log file. If omitted, every timestep is shown. A value of zero is the treated the same as for a value of 1. A value of –2 suppresses the display except for any negative depth warnings. A value of –3 suppresses all timestep displays.

Start Map Output ==

(Optional)

The simulation time in hours when map output commences. If the command is omitted, the simulation start time is used.

Store Maximums and Minimums == [ ON | ON MAXIMUMS ONLY | {OFF} ]

(Optional)

If set to “ON”, the highest and lowest values of selected map output data are tracked during the simulation, and included in the map output. The maximum and minimum values are those of every timestep, not those just at the output data times.

The maximum values are given the time 99999.0 in SMS .dat files and minimum values -99999.0

The “ON MAXIMUMS ONLY” option will output the maximums and not the minimums (this is the preferred option for flood modelling).

Note that maximums and minimums for velocities and unit flows are those that occur at the maximum/minimum water level or depth. Maximums and minimums are not at an instant in time.

For water level output (_h.dat) the time of the maximum water level in hours is also included in the .dat file and is assigned a time of 99999.1.

Zero Negative Depths in SMS == [ {ON} | OFF ]

(Optional)

“ON” zeroes depths in SMS map output if negative. The negative depth arises from interpolating the water level at the cell corners from the surrounding cell centres (this is necessary to convert TUFLOW output into SMS compatible format. Occasionally, due to the ZH Zpt being higher than the interpolated water level, the depth appears as negative.

“OFF” disables this command.