- 1 Introduction
- 2 Define New Boundary Conditions
- 3 Modify Simulation Control Files and Boundary Condition Database
- 4 Reviewing Check Files and Model Performance
- 5 Reviewing Results
- 6 Conclusion
- 7 Troubleshooting
This module focuses on adding a pump to the tutorial model to simulate pumping of water from one location in the model to another. The addition of pumps to a TUFLOW model is quick and easy, requiring the creation of a single additional GIS layer, a text file specifying the pumping rate and revision of a command in your model files.
This module builds upon Module 3. Module 3 is available from the Downloads section of the TUFLOW website. References will be made to various TUFLOW utilities that are similarly available from the TUFLOW website.
A pump constitutes an internal boundary condition to the model creating a transfer of flow, at a rate specified by the user, from one location in the 2D domain to another. The pump requires that a boundary condition be specified (2d_bc) of the flow versus head (SH) type. It is recommended that the user reads the relevant parts of section 4.10.7 of the 2010 TUFLOW manual (also available from the TUFLOW website).
Define New Boundary Conditions
At this stage we need to specify where the pump is located in the 2D domain and where the pumped flow is to be transferred to. The pump may be added as an additional boundary to a pre-existing 2d_bc boundary layer. For this tutorial a separate 2d_bc layer will be created for the pump.
Whilst grouping 2D boundaries into fewer 2d_bc layers will limit the number of GIS layers in your model, locating groups of boundary types into separate files will enable you to easily turn on and off particular boundaries in different simulations of your model without having to revert to editing your GIS layers.
For details on setting up the required GIS layer, please select your GIS package.
Modify Simulation Control Files and Boundary Condition Database
With the new GIS layer created it is time to update the control files and boundary condition database (bc_dbase). The files we need to change are the bc_dbase (.csv), TUFLOW boundary condition file (.tbc) and the TUFLOW control file (.tcf).
Boundary Condition Database
The bc_dbase contains an entry for each boundary condition and a new entry is required for the pump. The boundary condition for the pump will link to a text file (.csv) that specifies the pump rate (flow) controlled by the water level (head).
The process for adding these utilities to Excel, so that they open with Excel is detailed here: Excel Tips. To use these utilities without adding them to Excel simply open the TUFLOW_Tools_v2.0.xlam available in the Module_Data\Module_01\Excel folder.
This should add a new menu in Excel titled TUFLOW. Navigate to this menu and select Entire Worksheet to csv to export all the M14 bc_dbase worksheets as .csv files to the TUFLOW\model\bc_dbase folder.
The newly created 2d_bc_M14_pump_001 layer(s) need to be added to the TUFLOW boundary control file (.tbc).
For MapInfo users add:
Read GIS BC == mi\2d_bc_M14_pump_001.MIF
For ArcGIS or QGIS users add:
Read GIS BC == gis\2d_bc_M14_pump_001_L.shp | gis\2d_bc_M14_pump_001_P.shp
A new TUFLOW control file (.tcf) is required for Module 14 that includes reference to the new .tbc file and an updated filepath for saving model results.
- Note: There were no changes to the geometry for Module 14 and so the 2D geometry created in Module 3 is used.
You do not need to add the comments that follow exclamation marks. These commands are generally self explanatory. However for this tutorial model they are included.
Save your .tcf file. You're now (hopefully!) ready to try simulating the Module 14 TUFLOW model.
The simulation will take a few minutes to process (depending on the speed of you computer). This is a good time to complete your Modelling Log and keep a record of your work and TUFLOW simulations. Modelling logs are discussed here. A template modelling log is included in the TUFLOW Folders Template\TUFLOW\ folder supplied with this tutorial.
Reviewing Check Files and Model Performance
The 2D boundary condition check file shows the 2D model cell that the pump is linked to and from where flow is removed.
As we did with Module 1, it is highly recommended that you review the model's performance. Hydraulic models are able to do unexpected things even if the simulation completes successfully!
The TUFLOW model 2D results may be viewed in a number of software packages. Follow the method for your software package(s) described in Module 1 Viewing the Results to analyse the results and view the pump operation.
The image below has been taken from SMS and shows the pumped flow taken from the creek has been transferred to the dam to the west.
We have used the SH 2D boundary type to add a pump to the TUFLOW model. The addition of a pump to a TUFLOW model is easily done and allows the simulation of pumping from one location to another at a rate specified by the user, with the pump flow controlled by the water level at the location of the pump.
This section contains a link to some common problems that may occur when progressing through Module 14 of the TUFLOW tutorial model.discussion page.