SMS:TUFLOW

From XMS Wiki
Jump to navigationJump to search
TUFLOW
Model Info
Model type One-dimensional (1D) and two-dimensional (2D) flood and tide simulation software. It simulates the complex hydrodynamics of floods and tides using the full 1D St Venant equations and the full 2D free-surface shallow water equations.
Developer Bill Syme BMT WBM (Australia)
Web site TUFLOW web site
Tutorials

Models Section

  • TUFLOW 2D
  • TUFLOW 1D

TUFLOW is a one-dimensional (1D) and two-dimensional (2D) flood and tide simulation software. It simulates the complex hydrodynamics of floods and tides using the full 1D St Venant equations and the full 2D free-surface shallow water equations.

SMS Interface

The TUFLOW interface in SMS can be used to construct TUFLOW models and view and analyze the results.

Some of the features of the interface include:

  • Create 2D domains from bathymetry data
  • Extract 1D cross-section domains from TIN data
  • Define 1D pipe domains including links to the surface
  • Import data from ArcGIS or MapInfo GIS formats
  • Define boundary conditions at 1D nodes, 2D lines, or 2D polygons
  • Create 2D geometry modifications to model objects such as levees
  • Set material properties such as Manning n values and hydrologic losses
  • Define simulations from building blocks above
  • Simulations share common data to prevent data duplication errors and make it easy to update project with new data

The interface consists of the Cartesian grid tools, the TUFLOW menu and the TUFLOW coverages.

Using the Model / Practical Notes

For the past several years, TUFLOW required the horizontal and vertical coordinates used for input files to be in meters. Starting with the release of TUFLOW 2012, the numeric engine now supports an option for customary units. It's recommended that a user set the units to be the desired units at the beginning of a project. SMS will allow a user to switch units, but since this feature is so new, the responsibility to verify model parameters and boundary conditions are in the correct units remains with the user. Geographic Coordinates cannot be used since it is a latitude/longitude system defined in decimal degrees.

How to use TUFLOW?

The SMS tutorials are a good place to start learning to use SMS and associated models. The following tutorials will help with getting started using TUFLOW.

  • Models – TUFLOW 2D
  • Models – TUFLOW 1D
  • General – Data Visualization
  • General – Observations

General Steps to Build a TUFLOW Model

  1. Define the domain or domains
  2. Setup boundary conditions
  3. Create the simulation
  4. Define material sets
  5. Set Model Parameters
  6. Run TUFLOW
  7. Find problems and verify model setup using check files
  8. View and analyze the results
  9. Repeat above steps to generate new simulations

Optional Steps

Saving TUFLOW

When completing the File | Save As... menu command, the following files get saved in the *.sms:

  • *.mat referenced to new save location
  • _grds.h5 referenced to new save location
  • *.mat_h5 referenced to new save location
  • Geomcomps.h5 referenced to new save location
  • scatter.h5 referenced to new save location
  • tuflow files don't get saved to new location unless exported again

Running TUFLOW

Before running TUFLOW, the TUFLOW files must be generated from SMS. These files are separate from the files SMS uses to store its TUFLOW information.

The options to export the TUFLOW files and run TUFLOW are in the right-click menu of the simulation.

  • Export TUFLOW files – This will export the TUFLOW model files into the run directory (by default a directory named TUFLOW under the project directory).
  • Launch TUFLOW – This will launch TUFLOW under the assumption that the files have already been exported as above.
  • Save Project, Export TUFLOW files, and Launch TUFLOW – This option will save the current SMS project file, export the TUFLOW files, and launch TUFLOW on these files.

Viewing Results

TUFLOW results are written in SMS mesh format in the \TUFLOW\results folder. The mesh module tools and menus are used to visualize the solution.

The solution files all start with the name of the simulation. The extension identifies the type of data in the result file.

  • *.2dm – two-dimensional output mesh in SMS format.
  • *.dat – The dataset files associated with the mesh solution (d for depth, h for water surface, etc.)
  • *.mat – The output materials from TUFLOW. Most of the element materials come from the *.tmf file. TUFLOW also uses the materials to identify boundary cells.
  • *.ALL.sup – A file that opens the *.2dm file, all the *.dat files, and the *.mat file.
  • *.hV.sup – A file that opens the *.2dm file, the water surface and velocity datasets, and the *.mat file.

Related Topics