FM Tutorial M01 QGIS SHP 1D2D Links - Revision history

RussellGardner at 10:03, 7 October 2025

2025-10-07T10:03:58Z

← Older revision		Revision as of 20:03, 7 October 2025
Line 38:		Line 38:
	To digitise the CN lines, make the <b> 2d_bc_FMT_M01_HX_001_L.shp </b> layer editable and ensure snapping has been turned on. For each node in the <b>1d_x1d_FMT_M01_nodes_001_P.shp</b> layer, draw a line from the node to the HX line. The line must snap to both the node and the HX line, so it is recommended to use the snapping tool. Draw two lines for each node, one to the left bank and one to the right bank. In the 'Type' attribute of each line, type 'CN'. Assign the digitised CN lines an ‘f' attribute’ of ‘1’. This sets the weighting to be applied in distributing the water level from the 1D node to the 2D cell.<br>		To digitise the CN lines, make the <b> 2d_bc_FMT_M01_HX_001_L.shp </b> layer editable and ensure snapping has been turned on. For each node in the <b>1d_x1d_FMT_M01_nodes_001_P.shp</b> layer, draw a line from the node to the HX line. The line must snap to both the node and the HX line, so it is recommended to use the snapping tool. Draw two lines for each node, one to the left bank and one to the right bank. In the 'Type' attribute of each line, type 'CN'. Assign the digitised CN lines an ‘f' attribute’ of ‘1’. This sets the weighting to be applied in distributing the water level from the 1D node to the 2D cell.<br>
	<br>{{Video\|name=Define 1D 2D Bdy Links 02 SHP.mp4 \|width=1123}}<br>		<br>{{Video\|name=Define 1D 2D Bdy Links 02 SHP.mp4 \|width=1123}}<br>


	<br>The figure below shows how the nodes are connected at the confluence. Note that all Flood Modeller nodes at the junction are present within the 1d_x1D_nodes layer, and are connected to the 2D domain. The HX lines are broken around the junction. </li>		<br>The figure below shows how the nodes are connected at the confluence. Note that all Flood Modeller nodes at the junction are present within the 1d_x1D_nodes layer, and are connected to the 2D domain. The HX lines are broken around the junction. </li>
	<br>		<br>
	[[File:FMT 1D-2D Linking Junction QGIS.JPG\|900px]]		[[File:FMT 1D-2D Linking Junction QGIS.JPG\|900px]]

			</br>

	<br><li>Once all the CN and HX lines have been digitised along the tributary, save the file.</li>		<br><li>Once all the CN and HX lines have been digitised along the tributary, save the file.</li>

RussellGardner at 10:03, 7 October 2025

2025-10-07T10:03:11Z

← Older revision		Revision as of 20:03, 7 October 2025
Line 44:		Line 44:
	[[File:FMT 1D-2D Linking Junction QGIS.JPG\|900px]]		[[File:FMT 1D-2D Linking Junction QGIS.JPG\|900px]]

	<li>Once all the CN and HX lines have been digitised along the tributary, save the file.</li>		<br><li>Once all the CN and HX lines have been digitised along the tributary, save the file.</li>
		⚫	</br>

⚫	<br>

	{{Tips Navigation		{{Tips Navigation
	\|uplink=[[Flood_Modeller_Tutorial_Module01_Provisional#Define Bank Elevations \| Back to Tutorial Module 01 Main Page]]		\|uplink=[[Flood_Modeller_Tutorial_Module01_Provisional#Define Bank Elevations \| Back to Tutorial Module 01 Main Page]]
	}}		}}

	</ol>		</ol>

RussellGardner at 12:25, 3 October 2025

2025-10-03T12:25:48Z

← Older revision		Revision as of 22:25, 3 October 2025
Line 46:		Line 46:
	<li>Once all the CN and HX lines have been digitised along the tributary, save the file.</li>		<li>Once all the CN and HX lines have been digitised along the tributary, save the file.</li>

			<br>
	<br>Please return to the [[Flood_Modeller_Tutorial_Module01_Provisional#Define_Bank_Elevations\|Flood Modeller Tutorial Model]].<br>

	{{Tips Navigation		{{Tips Navigation
	\|uplink=[[Flood_Modeller_Tutorial_Module01_Provisional\| Back to Tutorial Module 01 Main Page]]		\|uplink=[[Flood_Modeller_Tutorial_Module01_Provisional#Define Bank Elevations \| Back to Tutorial Module 01 Main Page]]
	}}		}}
	</ol>		</ol>

Tuflowduncan: /* Method */

2025-09-25T18:02:59Z

Method

← Older revision		Revision as of 04:02, 26 September 2025
Line 48:		Line 48:
	<br>Please return to the [[Flood_Modeller_Tutorial_Module01_Provisional#Define_Bank_Elevations\|Flood Modeller Tutorial Model]].<br>		<br>Please return to the [[Flood_Modeller_Tutorial_Module01_Provisional#Define_Bank_Elevations\|Flood Modeller Tutorial Model]].<br>

			{{Tips Navigation
			\|uplink=[[Flood_Modeller_Tutorial_Module01_Provisional\| Back to Tutorial Module 01 Main Page]]
			}}
	</ol>		</ol>

Tuflowduncan: /* Introduction */

2025-09-25T18:02:49Z

Introduction

← Older revision		Revision as of 04:02, 26 September 2025
Line 16:		Line 16:
	<br>Where there are junctions within the Flood Modeller 1D model (i.e. at structures), both the nodes immediately upstream and downstream must be connected to TUFLOW. The HX lines must be broken between the junctions as this is a requirement of a linked Flood Modeller – TUFLOW model<br>.		<br>Where there are junctions within the Flood Modeller 1D model (i.e. at structures), both the nodes immediately upstream and downstream must be connected to TUFLOW. The HX lines must be broken between the junctions as this is a requirement of a linked Flood Modeller – TUFLOW model<br>.
	<br>The generation of the 1D-2D links for Flood Modeller – TUFLOW models can be partially automated through the use of the TUFLOW Link Line tool in Flood Modeller Pro. Guidance on how to use this tool can be found on the Flood Modeller Pro [https://help.floodmodeller.com/docs/how-to-use-the-tuflow-link-lines-generator-tool website ].<br>		<br>The generation of the 1D-2D links for Flood Modeller – TUFLOW models can be partially automated through the use of the TUFLOW Link Line tool in Flood Modeller Pro. Guidance on how to use this tool can be found on the Flood Modeller Pro [https://help.floodmodeller.com/docs/how-to-use-the-tuflow-link-lines-generator-tool website ].<br>

	{{Tips Navigation
	\|uplink=[[Flood_Modeller_Tutorial_Module01_Provisional\| Back to Tutorial Module 01 Main Page]]
	}}

	=Method=		=Method=

Tuflowduncan: /* Introduction */

2025-09-25T18:02:36Z

Introduction

← Older revision		Revision as of 04:02, 26 September 2025
Line 16:		Line 16:
	<br>Where there are junctions within the Flood Modeller 1D model (i.e. at structures), both the nodes immediately upstream and downstream must be connected to TUFLOW. The HX lines must be broken between the junctions as this is a requirement of a linked Flood Modeller – TUFLOW model<br>.		<br>Where there are junctions within the Flood Modeller 1D model (i.e. at structures), both the nodes immediately upstream and downstream must be connected to TUFLOW. The HX lines must be broken between the junctions as this is a requirement of a linked Flood Modeller – TUFLOW model<br>.
	<br>The generation of the 1D-2D links for Flood Modeller – TUFLOW models can be partially automated through the use of the TUFLOW Link Line tool in Flood Modeller Pro. Guidance on how to use this tool can be found on the Flood Modeller Pro [https://help.floodmodeller.com/docs/how-to-use-the-tuflow-link-lines-generator-tool website ].<br>		<br>The generation of the 1D-2D links for Flood Modeller – TUFLOW models can be partially automated through the use of the TUFLOW Link Line tool in Flood Modeller Pro. Guidance on how to use this tool can be found on the Flood Modeller Pro [https://help.floodmodeller.com/docs/how-to-use-the-tuflow-link-lines-generator-tool website ].<br>

			{{Tips Navigation
			\|uplink=[[Flood_Modeller_Tutorial_Module01_Provisional\| Back to Tutorial Module 01 Main Page]]
			}}

	=Method=		=Method=

Tuflowduncan at 09:06, 25 September 2025

2025-09-25T09:06:05Z

← Older revision		Revision as of 19:06, 25 September 2025
Line 36:		Line 36:

	<li>The CN and HX lines between nodes FC02.06 and FC02.01d along the tributary have not been digitised. Digitise these lines to connect the nodes to the 2D domain.<br>		<li>The CN and HX lines between nodes FC02.06 and FC02.01d along the tributary have not been digitised. Digitise these lines to connect the nodes to the 2D domain.<br>
	To digitise the CN lines, make the <b> 2d_bc_FMT_M01_HX_001_L.shp </b> layer editable and ensure snapping has been turned on. For each node in the <b>1d_x1d_FMT_M01_nodes_001_P.shp</b> layer, draw a line from the node to the HX line. The line must snap to both the node and the HX line. Draw two lines for each node, one to the left bank and one to the right bank. In the 'Type' attribute of each line, type 'CN'. Assign the digitised CN lines an ‘f' attribute’ of ‘1’. This sets the weighting to be applied in distributing the water level from the 1D node to the 2D cell.<br>		To digitise the CN lines, make the <b> 2d_bc_FMT_M01_HX_001_L.shp </b> layer editable and ensure snapping has been turned on. For each node in the <b>1d_x1d_FMT_M01_nodes_001_P.shp</b> layer, draw a line from the node to the HX line. The line must snap to both the node and the HX line, so it is recommended to use the snapping tool. Draw two lines for each node, one to the left bank and one to the right bank. In the 'Type' attribute of each line, type 'CN'. Assign the digitised CN lines an ‘f' attribute’ of ‘1’. This sets the weighting to be applied in distributing the water level from the 1D node to the 2D cell.<br>
	<br>{{Video\|name=Define 1D 2D Bdy Links 02 SHP.mp4 \|width=1123}}<br>		<br>{{Video\|name=Define 1D 2D Bdy Links 02 SHP.mp4 \|width=1123}}<br>

Tuflowduncan: /* Introduction */

2025-09-25T09:04:09Z

Introduction

← Older revision		Revision as of 19:04, 25 September 2025
Line 12:		Line 12:
	[[File:M04 1d2d 03.png\|300px]]		[[File:M04 1d2d 03.png\|300px]]
	[[File:M04 1d2d 04.png\|300px]]		[[File:M04 1d2d 04.png\|300px]]
	<br>The digitised direction of the HX and CN lines are not important. The CN lines however should be digitised approximately perpendicular to the direction of flow. Two CN lines are digitised for each node and connected to the HX boundary lines along the left and right banks. The HX boundary lines should be digitised along the top of each bank such that the width between the lines approximately correlates to the width of the 1D channel<br>.		<br>The digitised direction of the HX and CN lines are not important. The CN lines however should be digitised approximately perpendicular to the direction of flow. Two CN lines are digitised for each node and connected to the HX boundary lines along the left and right banks. The HX boundary lines should be digitised along the top of each bank such that the width between the lines approximately correlates to the width of the 1D channel.<br>.
	<br>Often HX lines are located along the top of a levee (natural or artificial) or flood defence running along the river bank. When carving a 1D channel through a 2D domain, the HX line must be either on the top of the levee or on the inside of the levee (closest to the channel). If the HX line is located on the other side of the levee away from the channel, the effect of the levee on water flow is <u>'''not'''</u> modelled. In the sections above, it can be seen that the boundary cell is along the levee and the interaction between the channel and the floodplain (1D and 2D) occurs at the correct elevation. <br>		<br>Often HX lines are located along the top of a levee (natural or artificial) or flood defence running along the river bank. When carving a 1D channel through a 2D domain, the HX line must be either on the top of the levee or on the inside of the levee (closest to the channel). If the HX line is located on the other side of the levee away from the channel, the effect of the levee on water flow is <u>'''not'''</u> modelled. In the sections above, it can be seen that the boundary cell is along the levee and the interaction between the channel and the floodplain (1D and 2D) occurs at the correct elevation. <br>
	<br>Where there are junctions within the Flood Modeller 1D model (i.e. at structures), both the nodes immediately upstream and downstream must be connected to TUFLOW. The HX lines must be broken between the junctions as this is a requirement of a linked Flood Modeller – TUFLOW model<br>.		<br>Where there are junctions within the Flood Modeller 1D model (i.e. at structures), both the nodes immediately upstream and downstream must be connected to TUFLOW. The HX lines must be broken between the junctions as this is a requirement of a linked Flood Modeller – TUFLOW model<br>.
Line 29:		Line 29:
	[[File:FMT 1D-2D Linking QGIS.JPG\|600px]]		[[File:FMT 1D-2D Linking QGIS.JPG\|600px]]
	<br>		<br>
	Note that where there are junctions within the Flood Modeller 1D model (i.e. at structures), both the nodes immediately upstream and downstream must be connected to TUFLOW. Refer to the below figure where the junctions are circled in blue and the upstream and downstream RIVER units are circled in yellow. The HX lines must be broken between the junctions as this is a requirement of a linked Flood Modeller – TUFLOW model. ~~<br>~~		Note that where there are junctions within the Flood Modeller 1D model (i.e. at structures), both the nodes immediately upstream and downstream must be connected to TUFLOW. Refer to the below figure where the junctions are circled in blue and the upstream and downstream RIVER units are circled in yellow. The HX lines must be broken between the junctions as this is a requirement of a linked Flood Modeller – TUFLOW model.
	In the example below, the HX lines are broken between FC01.35 and FC01.34 as a culvert is located between these nodes.		In the example below, the HX lines are broken between FC01.35 and FC01.34 as a culvert is located between these nodes.
	<br>		<br>
	[[File:FM_junction.jpg\|~~900px~~]]		[[File:FM_junction.jpg\|540x540px\|alt=]]
	[[File:FMT 1D-2D Broken HX Line.JPG\|~~900px~~]]		[[File:FMT 1D-2D Broken HX Line.JPG\|540x540px\|alt=]]

	<li>The CN and HX lines between nodes FC02.06 and FC02.01d along the tributary have not been digitised. Digitise these lines to connect the nodes to the 2D domain.<br>		<li>The CN and HX lines between nodes FC02.06 and FC02.01d along the tributary have not been digitised. Digitise these lines to connect the nodes to the 2D domain.<br>

RussellGardner: Created page with "
=Introduction= In this section we will set up the Flood Modeller-TUFLOW linkage to apply a water level boundary to the 2D cells along the 1D/2D interface. In the 2D bound..."

2025-06-27T12:46:55Z

Created page with "<ol> =Introduction= In this section we will set up the Flood Modeller-TUFLOW linkage to apply a water level boundary to the 2D cells along the 1D/2D interface. In the 2D bound..."

New page

<ol>
=Introduction=
In this section we will set up the Flood Modeller-TUFLOW linkage to apply a water level boundary to the 2D cells along the 1D/2D interface. In the 2D boundary condition (2d_bc) GIS layer, we define the location at which this link occurs. The 2D water level applied at the 2D boundary cells is calculated in the 1D Flood Modeller component. The terminology used in TUFLOW is a '''HX''' type boundary on the 2D cells, with the '''H''' indicating that a '''H'''ead (water level) boundary is used and the '''X''' indicating the value is coming from an e'''X'''ternal model (in this case Flood Modeller).
Depending on the water level in the surrounding 2D cells, flow can either enter or leave the HX cells. The volume of water entering or leaving the 2D boundary is added or subtracted from the 1D Flood Modeller model to preserve volume. We must connect the HX lines to the 1D Flood Modeller model. This is done using CN type lines in the 2d_bc layer, where a CN line is connected to the HX line, the water level from the 1D Flood Modeller nodes is transferred to the HX line. In between 1D nodes, a linear interpolation of water level is applied. This is shown in the figure below.
 
[[File:1d 2d FM link 01.jpg|800px]]
 
Once the water level in Flood Modeller exceeds the elevation in the boundary cell water can enter or leave the model. Similar to a Flood Modeller lateral spill or lateral inflow, the discharge is distributed laterally along the length of the HX line. Note that it is the elevation of the HX boundary cell centres that determines when the spill starts to occur and not the cross section within Flood Modeller. If there is a levee or flood defence, it is important that we use breaklines in the model to ensure that the elevations of the 2D cells are consistent with the levee crest. This will be described in the next section of the tutorial. The next four images show a section view of the 1D/2D link and how this may progress during a flood event. 
 
[[File:M04 1d2d 01.png|300px]]
[[File:M04 1d2d 02.png|300px]]
[[File:M04 1d2d 03.png|300px]]
[[File:M04 1d2d 04.png|300px]]
 The digitised direction of the HX and CN lines are not important. The CN lines however should be digitised approximately perpendicular to the direction of flow. Two CN lines are digitised for each node and connected to the HX boundary lines along the left and right banks. The HX boundary lines should be digitised along the top of each bank such that the width between the lines approximately correlates to the width of the 1D channel .
 Often HX lines are located along the top of a levee (natural or artificial) or flood defence running along the river bank. When carving a 1D channel through a 2D domain, the HX line must be either on the top of the levee or on the inside of the levee (closest to the channel). If the HX line is located on the other side of the levee away from the channel, the effect of the levee on water flow is '''not''' modelled. In the sections above, it can be seen that the boundary cell is along the levee and the interaction between the channel and the floodplain (1D and 2D) occurs at the correct elevation. 
 Where there are junctions within the Flood Modeller 1D model (i.e. at structures), both the nodes immediately upstream and downstream must be connected to TUFLOW. The HX lines must be broken between the junctions as this is a requirement of a linked Flood Modeller – TUFLOW model .
 The generation of the 1D-2D links for Flood Modeller – TUFLOW models can be partially automated through the use of the TUFLOW Link Line tool in Flood Modeller Pro. Guidance on how to use this tool can be found on the Flood Modeller Pro [https://help.floodmodeller.com/docs/how-to-use-the-tuflow-link-lines-generator-tool website ]. 

=Method=
<li>Import in an empty 2d_bc_empty_L.shp layer from within the '''FMT_tutorial\FMT_M01\TUFLOW\model\gis\empty''' folder. </li>
<li>Save the empty layer as 2d_bc_FMT_M01_HX_001_L.shp in the '''FMT_tutorial\FMT_M01\TUFLOW\model\gis''' folder.</li>
<li>Open the 1D_2D_HX_Links_L.shp GIS layer from '''Module_Data\Module_01\gis''' folder. Select all objects from within this layer, copy and paste into 2d_bc_FMT_M01_HX_001_L.shp.</li>
<li>Interrogate one of the lines running along the banks of the watercourse. These lines are the 1D/2D boundary links and have been assigned a type ‘HX’.</li>
<li>Interrogate one of the lines connecting the x1D node to the HX line. These are the connection or ‘CN’ lines that read the water level from Flood Modeller and transfers this to the HX line. </li>
 {{Video|name= Define 1D 2D Bdy Links 01 SHP.mp4 |width=1123}} 

In the figure below, the water level is calculated in Flood Modeller at the nodes FC01.16, FC01.15 and FC01.14. These water levels are linearly interpolated along the lengths of the HX line on each of the left and right banks of the watercourse. When the water level exceeds the ZC elevation of the boundary cell, water is able to flow out onto the TUFLOW 2D floodplain. 
 
[[File:FMT 1D-2D Linking QGIS.JPG|600px]]
 
Note that where there are junctions within the Flood Modeller 1D model (i.e. at structures), both the nodes immediately upstream and downstream must be connected to TUFLOW. Refer to the below figure where the junctions are circled in blue and the upstream and downstream RIVER units are circled in yellow. The HX lines must be broken between the junctions as this is a requirement of a linked Flood Modeller – TUFLOW model. 
In the example below, the HX lines are broken between FC01.35 and FC01.34 as a culvert is located between these nodes.
 
[[File:FM_junction.jpg|900px]]
[[File:FMT 1D-2D Broken HX Line.JPG|900px]]

<li>The CN and HX lines between nodes FC02.06 and FC02.01d along the tributary have not been digitised. Digitise these lines to connect the nodes to the 2D domain. 
To digitise the CN lines, make the 2d_bc_FMT_M01_HX_001_L.shp layer editable and ensure snapping has been turned on. For each node in the 1d_x1d_FMT_M01_nodes_001_P.shp layer, draw a line from the node to the HX line. The line must snap to both the node and the HX line. Draw two lines for each node, one to the left bank and one to the right bank. In the 'Type' attribute of each line, type 'CN'. Assign the digitised CN lines an ‘f' attribute’ of ‘1’. This sets the weighting to be applied in distributing the water level from the 1D node to the 2D cell. 
 {{Video|name=Define 1D 2D Bdy Links 02 SHP.mp4 |width=1123}} 

 The figure below shows how the nodes are connected at the confluence. Note that all Flood Modeller nodes at the junction are present within the 1d_x1D_nodes layer, and are connected to the 2D domain. The HX lines are broken around the junction. </li>
 
[[File:FMT 1D-2D Linking Junction QGIS.JPG|900px]]

<li>Once all the CN and HX lines have been digitised along the tributary, save the file.</li>

 Please return to the [[Flood_Modeller_Tutorial_Module01_Provisional#Define_Bank_Elevations|Flood Modeller Tutorial Model]]. 

</ol>

FM Tutorial M01 QGIS SHP 1D2D Links - Revision history

RussellGardner at 10:03, 7 October 2025

RussellGardner at 10:03, 7 October 2025

RussellGardner at 12:25, 3 October 2025

Tuflowduncan: /* Method */

Tuflowduncan: /* Introduction */

Tuflowduncan: /* Introduction */

Tuflowduncan at 09:06, 25 September 2025

Tuflowduncan: /* Introduction */

RussellGardner: Created page with " =Introduction= In this section we will set up the Flood Modeller-TUFLOW linkage to apply a water level boundary to the 2D cells along the 1D/2D interface. In the 2D bound..."

RussellGardner: Created page with "
=Introduction= In this section we will set up the Flood Modeller-TUFLOW linkage to apply a water level boundary to the 2D cells along the 1D/2D interface. In the 2D bound..."