View source for Tutorial M02 001 GIS Inputs QGIS

= Introduction =
QGIS is used to create, import and view input data.<br>
<br>

= TUFLOW Project Re-Configuration =
Re-configure the TUFLOW project to use and save empty files to the correct folder:<br>
<ol>
<li>Go to Plugins > TUFLOW > Editing > Configure / Create TUFLOW Project.
<li>Change the folder which contains TUFLOW to the '''Module_02''' folder. This is the only change required, the model folder structure and template empty files are supplied from previous model.<br>
Note: The 'results' and 'check' folder get automatically created when the TUFLOW model is run. <br>
<li>Click 'OK' and save the QGIS workspace by selecting Project > Save As.<br>
<br>
[[File:M02_SHP_ConfigureProject.PNG]]<br><br>
<li>Set the QGIS workspace projection to EPSG:32760, see <u>[https://wiki.tuflow.com/index.php?title=Tutorial_Site_Familiarisation_QGIS#Set_the_Projection Set the Projection]</u>.
</ol>
<br>

= Method =
Navigate to the '''Module_02\Tutorial_Data''' folder. Copy the below GIS files into the '''Module_02\TUFLOW\model\gis''' folder:
:*'''2d_zsh_M02_rd_crest_001_L'''
:*'''2d_zsh_M02_rd_crest_001_P'''

Investigate the supplied files:
<ol>
<li>Open the files, either:<br>
:*Drag and drop all .shp files into the QGIS workspace, or 
:*Select Layer > Add layer > Add Vector Layer and navigate to the '''Module_02\TUFLOW\model\gis''' folder. <br>
<li>The 2d_zsh line layer represents the breaklines:
:*No ‘Z’ attribute is specified, the elevations are taken from the 2d_zsh point layer.
:*The breakline on the north side has the same Shape_Width as the cell size, this is a thick breakline modifying whole cells. The other two breaklines don't have the attribute specified, these are thin breaklines modifying only the cell sides and cell corners.
:*The Shape_Option of 'MAX' is specified for all breaklines. The Zpt elevations only changes when the Z shape elevation at the Zpt is higher. The purpose of the Z shape is to enforce the highest elevations along the road crest.
<br>
{{Video|name=Animation_M02_GIS_001_01_.mp4|width=1279}}<br>
<br>
<li>The 2d_zsh point layer is used to apply elevation to the breaklines:
:*The values in the 'Z' attribute are elevations above datum assigned to each point. The elevations are being interpolated along the breakline. 
:*The points must be snapped to the vertices of the 2d_zsh line to instruct TUFLOW that these layers are linked. If no points are in the layer, the elevation on the line object is used, i.e. the elevation along the line does not vary. For more information, refer to the <u>[https://docs.tuflow.com/classic-hpc/manual/latest/ TUFLOW Manual]</u>.
<br>
{{Video|name=Animation_M02_GIS_001_02.mp4|width=1279}}<br>
</ol>
<br>

=Creating Breaklines (Optional)=
Breaklines are provided for this tutorial, however, these could be made using the breakline flag with the <u>[https://wiki.tuflow.com/index.php?title=ASC_to_ASC#Extract_Breaklines_from_DEM asc_to_asc]</u> utility which extracts elevations from a DEM for breaklines in the 2d_zsh format. The utility is provided in the '''exe/asc_to_asc''' folder. It can also be downloaded from the <u>[https://www.tuflow.com/downloads/ TUFLOW website]</u> and saved into a folder with other utilities.
<ol>
<li>Create a new folder called '''Data_Processing''' in the '''Module_02''' folder.
<li>Use the 'Import Empty File' tool to create a new 2d_zsh layer called ‘breaklines’ as a ‘line’ type.
<li>Digitise a line using the ‘Add Line Feature’ button following the road crest. This could match the provided breaklines or be an section of road not covered by the original breakline. 
<li>Enter the following attributes and save the file:
*Z: Null
*dZ: 30
*Shape_Width: 5
*Shape_Option: Max
<li>Close the layer in QGIS (right click on it from the Layers panel and select 'Remove Layer'). Cut and paste all of the '''2d_zsh_breaklines_L''' files from the '''Module_02\TUFLOW\model\gis''' folder into the '''Module_02\Data_Processing''' folder.
<li>Create a new batch file '''_run_M02_asc_to_asc_Breaklines.bat''' in the '''Module_02\Data_Processing''' folder and open it in a text editor.
<li>Input the following (Note: Utility location may differ): <br> 
<font color="blue"><tt>'''set''' </tt></font> <font color="black"><tt>asc_to_asc</tt></font><font color="red"><tt>=</tt></font><font color="black"><tt>"..\..\exe\asc_to_asc.2023-03-AA\asc_to_asc_w64.exe"</tt></font> <br>
<li>Use the -brkline flag to call the breakline function. The utility then expects the 2d_zsh_breaklines layer and the DEM.<br>
<font color="orange"><tt>%asc_to_asc% </tt></font> <font color="black"><tt>-brkline 2d_zsh_breaklines_L.shp ..\TUFLOW\model\grid\DEM.tif</tt></font> <br>
<li>Save the batch file and double click it in file explorer to run the utility.
<li>The utility creates a points layer and updates the lines layer. These layers can be copied into the '''Module_02\TUFLOW\model\gis''' folder and read into the TGC.
</ol>
<br>

= Conclusion = 
:*Two 2d_zsh layers were inspected to enforce the breaklines in the model.
<br>
{{Tips Navigation
|uplink=[[Tutorial_M02#GIS_Inputs| Back to Module 2 Main Page]]
}}