In this module we add some breaklines to the model to ensure that the 5m cell size model correctly represents the key hydraulic controls. We will add break-lines to represent the following features:
- Road crests
- Creek centre line (thalweg)
The only new GIS layer that is introduced is the 2d_zshape (2d Z Shape), it is recommended that the user reads section 4.4.9 of the 2010 TUFLOW manual. The 2d_zsh layer is commonly used, and will be also used in later modules.
Note: As per module 2, instructions are given for the following four GIS platforms:
For this module you have been provided road crest and creek centreline (thalweg) survey in a text file format (.xyz). This will involve importing the data into a GIS package and then manipulating it into a format suitable for input into TUFLOW. To import the data and manipulate into a TUFLOW format, please select your GIS package from the list below.
Modify Simulation Control Files
With the new GIS layers created it is time to update the control files. The two files we need to change are the geometry control file (.tgc) and the TUFLOW control file (.tcf), the changes for each are described below.
- Note: There was no M02 (module 2) version of the geometry control file, there we no changes to the 2D geometry in this run so the latest version is the one we created in module 1.
For MapInfo users add:
Read GIS Z Shape == mi\2d_zsh_M03_Thalweg_001.MIF
Read GIS Z Shape == mi\2d_zsh_M03_Rd_Crest_001.MIF
For ArcGIS or QGIS users add:
Read GIS Z Shape == gis\2d_zsh_M03_Thalweg_001_L.shp | gis\2d_zsh_M03_Thalweg_001_P.shp
Read GIS Z Shape == gis\2d_zsh_M03_Rd_Crest_001_L.shp | gis\2d_zsh_M03_Rd_Crest_001_P.shp
As the points and lines are in separate shapefiles, we need to read both of these files in, the points (_P) and lines (_L) are part of the same breaklines so they need to be inputted on the same line. The vertical bar "|" operator tells TUFLOW that there is another input file.
For TUFLOW modelling the convention is that:
- Points are stored in a filename_P.shp file;
- Lines are stored in a filename_L.shp; and
- Regions or polygons in a filename_R.shp
For SMS users, you do not need to modify these files manually, it is automatically done when you export TUFLOW files from SMS. Follow the instructions on page "Export TUFLOW Simulation"
Change the output folder for the 2D results to:
Output Folder == ..\results\M03\2D\
The 1D output folder command occurs within the Start 1D Domain .... End 1D Domain block of commands. Change the output folder for the 1D results to:
Output Folder == ..\results\M03\1D\
Finally, update the geometry control file to the newly created M03_5m_001.tgc:
Geometry Control File == ..\model\M03_5m_001.tgc
For SMS users, you do not need to modify these files manually, it is automatically done when you export TUFLOW files from SMS. Follow the instructions on page "Export and Run TUFLOW Simulation"
Run the Simulation
Using your preferred method for starting TUFLOW, run the recently created M03_5m_001.tcf. Please refer to module 1 for a detailed description of the various methods for running a TUFLOW simulation.
If the model fails to start correctly please refer to the troubleshooting section at the end of this page.
Review Check Files
While the model is running, now is a good time to open the check files to review the changes to the topography caused by the breaklines. As the modifications are to the 2D topography, the check files are written to the TUFLOW\check\2d\ folder.
This layer contains the Zpts that have been modified by the 2d_zsh layers. The layer contains the following information:
- Elevation after modification;
- Change in elevation (dZ);
- Source layer.
In this image, the black squares are the TUFLOW cells, the red line the breakline and the purple triangles, the points that have been raised by the breakline.
The check files should show the changes shown above, if they do not please see the troubleshooting section at the bottom of this page.
Review the Results
The 1D and 2D results can be reviewed using the methods outlined in Module 1 and Module 2.
Some suggestions for things to check are:
- Does the flooding still overtop the roads?
- Tip: check the maximum 2D results.
- What is the difference in peak water level at the upstream of the roads compared to the previous run?
- Tip: the mmH layer (1D results) could be useful here.
Point data from survey was provided in text files as x,y,z format data. GIS software was used to import the data and manipulate into a 2d Z Shape format (2d_zsh), the model was simulate with breaklines to represent the creek centre line and road crests.
Check files were used to confirm the changes to the elevation points (Zpts). "Thin", "thick" and "gully" breaklines were described.
The 2D Z Shape can also be used for more complex modifications, using polygons and TIN lines, these will be introduced in later modules.
In Tutorial Module 4 the setup of 1D open channel will be introduced.
This section contains links to some possible issue that may occur when progressing through the second tutorial module. If you experience an issue that is not detailed please detail the issue on the discussion page.
If you are unsure of why the model has failed to start, check the TUFLOW Log File (this is in the TUFLOW\runs\log\ folder and has the name M02_5m_001.tlf. This can be opened in a text editor, the error is generally at the end of the file, however you can search for "Error" if you can not see the error.