Running linked Flood Modeller - TUFLOW Models

From Tuflow
Jump to navigation Jump to search

Introduction

There are several different ways to run a linked Flood Modeller-TUFLOW or ISIS-TUFLOW model.
This wiki page is intended to guide the user through the main methods of installing the link correctly and provide information on troubleshooting.
Other resources for installation help include:

Flood Modeller Free and TUFLOW Free permit the running of linked models. Both Flood Modeller and TUFLOW Free versions have limitations on model size and simulation run time.
Licensing considerations for running linked models have not been considered in this section. It was been assumed that the User has purchased the Flood Modeller-TUFLOW link module or is making use of the free versions.

Methods to Run Linked Flood Modeller-TUFLOW models

The three main methods for installing Flood Modeller and TUFLOW to run linked models are detailed below. It is assumed for all methods that Flood Modeller has already been installed and TUFLOW has been downloaded.

Set an Environment Variable

Setting TUFLOW as an environment variable allows for simple installation and minimised duplication of files.
This method is suitable if you expect to be running the same versions of Flood Modeller and TUFLOW consistently.
After setting up through this method, the model is run by double clicking on the .ied file and clicking Run or opening the .ied file in the Flood Modeller Interface and clicking Run

1) Click on the start button in windows and open the Control Panel. In the Control Panel, navigate to System.
Control panel.png
2)Click on Advanced Systems Settings. In the Advanced tab, click Environment Variables.
Adv Sys Set.png
3) Under System Variables, click on the Path Variable and select Edit...
In the dialog box, under Variable value, add a semi-colon after what is currently in the line and then the path to the Tuflow executable.
Env var.png


Direct Batch File

This method allows the user to easily select different Flood Modeller and TUFLOW versions to run.
After setting up through this method the model is run through a batch file. This allows for the running of multiple simulations.

1) Using a file explorer, navigate to the downloaded TUFLOW files. If you computer is 32 bit, select 32w, it your computer is 64 bit select 64w. Copy all of the TUFLOW files in this folder.
Tuflow download files.png
2) Navigate to the files installed by Flood Modeller.
In this case, it is C:\Program Files\Flood Modeller although your path may differ depending on your system and installation.
Paste the copied TUFLOW files into the bin folder.
If asked, copy and replace the files.

This method can be carried out for multiple versions of Flood Modeller and TUFLOW, allowing the User to select which version to run.
Simply copy and rename the Flood Modeller bin folder and paste in a different version of TUFLOW.
File:Diff TF versions.png

To run linked Flood Modeller-TUFLOW models with this method, create a batch file.
In a text editor, paste the path to the Flood Modeller executable file (ISISf32.exe), the flags '-b' and '-sd' and the name of the .ief. Refer to the example below.
400px


ISIS Batch File (IPF)

Ch2m to fill in!

Using TUFLOW Events and Scenarios

Getting the Correct Version (Single vs Double Precision, 32 vs 64 Bit)