Tutorial Model Introduction

Revision as of 15:27, 8 April 2014 by Admin (Talk | contribs) (Introduction)

Jump to: navigation, search


This online TUFLOW FV tutorial model replaces the previous version, which was included within the TUFLOW FV manual. The online wiki is designed to be more flexible and easily updated so that the tutorial model are more responsive to enhancements within the software and also based on feedback. Please use the feedback interface at the bottom of each page or alternatively contact support@tuflow.com.


TUFLOW FV has relatively modest system requirements for small models such as the tutorial model. However, larger and more complex models may have higher hardware requirements - in particular memory (RAM). TUFLOW FV is available in both 32 and 64 bit versions.


The tutorial models are designed to be small, to allow for quick simulation and load times. The tutorial model should run on any modern PC or laptop that is capable of running Windows XP or later.



TUFLOW FV build 20144-05-AA (May 2014 release) or later is required for this tutorial model. This can be obtained from the downloads section of the TUFLOW website. It is recommended that you use the latest release version of TUFLOW FV, both 32 bit and 64 bit versions are available.
This tutorial model does require a TUFLOW FV licence in order to be simulated. Please email sales@tuflow.com. for a trial licence
If you encounter the message "This application has failed to start because the application configuration is incorrect. Reinstalling the application may fix the problem." please see the following post on the TUFLOW forum:

GIS Software

Surface-water Modeling Software (SMS): This tutorial was developed with SMS 11.0. Many of the tutorial tasks (such as editing/creating input files) require SMS as the front-end interface for the mesh development tasks. May result processing tasks also require SMS. Please email sales@tuflow.com or support@aquaveo.com for a trial licence

Text Editor

A text editor is required for creation of the TUFLOW FV input files. Any text editor can be used for this purpose. However, it is recommended that a more advanced text editor such as one of those listed below be used. Ideally a text editor should be able to:

  • Colour code the TUFLOW control files;
  • Open other files from the active control file; and
  • Launch a TUFLOW simulation.
  1. UltraEdit
  2. UltraEdit is recommended and can be downloaded for a trial period from www.ultraedit.com. See also UltraEdit Tips.

  3. TextPad
  4. TextPad is another commercial text editor and may be downloaded from www.textpad.com/. A trial version is also available.
    Please see this page for details on setting up colour coding: TextPad_Tips.

  5. NotePad ++
  6. NotePad++ is a free text editor. It is available from http://notepad-plus-plus.org/.
    TUFLOW runfile colour coding can be enabled using the Notepad++ Syntax File on the TUFLOW FVdownloads] page. For instructions on configure Notepad++ for TUFLOW modelling, please see the Notepad++ tips page on the wiki.

Microsoft Excel

This is required for editing and working with tabular data and .csv files.

Results Viewer

    TUFLOW results can be exported into GIS format and this is detailed in the tutorial model. However, none of the GIS packages handle time-varying results particularly well. Therefore, it is recommended (but optional) that a results viewer be used.
  1. SMS(Surface-water Modelling System)
  2. SMS is available from www.aquaveo.com/sms. Once installed a 30 day trial licence can be requested. See also this page of SMS Tips.

    Module Data

    Some data is required in order to build and run the models. This includes a digital elevation model (DEM) and aerial photography. The required background model data for the tutorial model is available for download on the TUFLOW [ http://www.tuflow.com/FV%20TutorialModel.aspx website].
    The download package also contains a working version of the tutorial model for you to refer to. The folder only contains the input files to keep the size of the download file manageable.

    Recommended Reading

    Whilst the online tutorial is designed to cover as much material as possible, it is recommended that the TUFLOW FV manual be downloaded from the [ http://www.tuflow.com/FV%20Documentation.aspx TUFLOW website].


    The tutorial models are presented in a number of modules. The modules have been developed to be undertaken as steps, with each module offering the opportunity to run the model and review the results. New users are advised to undertake the modules in sequence, whilst more experienced users can skip to modules containing specific features of interest.

    Module 1: Simple Trapezoidal Channel

    The first tutorial module introduces the user the TUFLOW FV software. The tutorial works through the steps required to develop a simple mesh model.

    Tutorial Module 1.

    Module 2: Simple River Bend

    The second module builds a simple river bend model using the TUFLOW FV SMS interface. To access this module of the tutorial please see this page: Tutorial Module 2.

    Module 3: Floodplain Application

    In the third module a real-world floodplain model example is used demonstrate the following: • Mesh optimisation • Geometry commands (eg breakline commands, region commands) • Hydraulic structure commands (weirs, bridges, culverts) • Advection dispersion modelling options (salinity, heat, temperature, tracer) • Various output processing option To access this module of the tutorial please see this page: Tutorial Module 3.

    Module 4: Coastal Application

    In the fourth module is a real-world coastal model example is used demonstrate the following: • Application of a sloping water level boundary • Cyclone/hurricane modelling using an internal holland wind/pressure model • Cyclone/hurricane modelling using an external wind/pressure and wave model To access this module of the tutorial please see this page: Tutorial Module 4.

    Addition Modules

    Additional modules planned include:

    • Module 5 (Three Dimensional Modelling)
    • Module 6 (Sediment Transport Modelling)
    • Module 7 (Water Quality Modelling)