Tutorial Module09 Archive - Revision history

Abigail.lillo: /* Multiple 2D Domain Modelling Using HPC */

2024-10-10T01:55:56Z

Multiple 2D Domain Modelling Using HPC

← Older revision		Revision as of 11:55, 10 October 2024
Line 217:		Line 217:

	=Multiple 2D Domain Modelling Using HPC=		=Multiple 2D Domain Modelling Using HPC=
			Refer to the current [[Tutorial_M07 \| Tutorial M07]] for instructions on how to run Quadtree nesting with HPC.
	TUFLOW HPC and its GPU Module currently don't support multiple 2D domain functionality. Quadtree nesting is currently being developed and is expected to be released in late 2018.

Emilie Nielsen at 03:19, 5 April 2024

2024-04-05T03:19:23Z

← Older revision		Revision as of 13:19, 5 April 2024
Line 188:		Line 188:

	=Run Simulation and Review Results=		=Run Simulation and Review Results=
	Run '''M09_2D2D_001.tcf''' using your preferred method, as described[[Tutorial_Module01_Archive#~~Running_TUFLOW~~ \| ~~here~~]].<br>		Run '''M09_2D2D_001.tcf''' using your preferred method, as described in <u>[[Tutorial_Module01_Archive#Run_Simulation \| Module 1]]</u>.<br>

	''Note: release 2016-03-AD or newer is required to run this tutorial without a physical TUFLOW license.		''Note: release 2016-03-AD or newer is required to run this tutorial without a physical TUFLOW license.

Pavlina Monhartova: /* Additional Information */

2023-04-12T23:28:11Z

Additional Information

← Older revision		Revision as of 09:28, 13 April 2023
Line 213:		Line 213:

	=Additional Information=		=Additional Information=
	*Further multiple domain ~~modeling~~ advice can be found <u>[[TUFLOW_2D2D_BC_Advice \| here]]</u>. The modelling guidance page discusses appropriate hidden 1D node spacing, 2D2D boundary line orientation and storage multiplier options.		*Further multiple domain modelling advice can be found <u>[[TUFLOW_2D2D_BC_Advice \| here]]</u>. The modelling guidance page discusses appropriate hidden 1D node spacing, 2D2D boundary line orientation and storage multiplier options.
	*There is also a webinar hosted by Bill Syme covering multiple 2D domains in more detail. You can find that presentation "Modelling with Difference Cell Sizes" [[~~TUFLOW_Modelling_Webinars~~#Modelling_with_Different_Cell_Sizes \| here]].<br>		*There is also a webinar hosted by Bill Syme covering multiple 2D domains in more detail. You can find that presentation "Modelling with Difference Cell Sizes" [[TUFLOW_Modelling_Webinars_Archive#Modelling_with_Different_Cell_Sizes \| here]].<br>

	=Multiple 2D Domain Modelling Using HPC=		=Multiple 2D Domain Modelling Using HPC=

ElizaCollison at 00:56, 9 January 2023

2023-01-09T00:56:05Z

← Older revision		Revision as of 10:56, 9 January 2023
Line 1:		Line 1:
	<ol>		<ol>
	=Introduction=		=Introduction=
	In this module we will further develop the model from [[~~Tutorial_Module01~~\|Module 01]]. Please complete Module 01 before attempting this tutorial, it is the starting point for the model updates documented below. We will be developing a multiple domain model that incorporates two different grid size within different portions of the model domain: a 2.5m 'FINE' grid and a 5m 'COARSE' grid. This module assumes that you have a good understanding of the different TUFLOW control files and are confident in navigating the TUFLOW file structure.		In this module we will further develop the model from [[Tutorial_Module01_Archive\|Module 01]]. Please complete Module 01 before attempting this tutorial, it is the starting point for the model updates documented below. We will be developing a multiple domain model that incorporates two different grid size within different portions of the model domain: a 2.5m 'FINE' grid and a 5m 'COARSE' grid. This module assumes that you have a good understanding of the different TUFLOW control files and are confident in navigating the TUFLOW file structure.
	<br>		<br>
	''Note: Running a multiple domain model without a valid multiple domain licence (i.e. in Tutorial Mode) can only be achieved using TUFLOW Build 2016-03-AD or newer.''		''Note: Running a multiple domain model without a valid multiple domain licence (i.e. in Tutorial Mode) can only be achieved using TUFLOW Build 2016-03-AD or newer.''
Line 8:		Line 8:
	=GIS Inputs=		=GIS Inputs=
	Download the Tutorial Model dataset relevant to your GIS environment (ArcGIS, MapInfo or QGIS) from the <u>[http://www.tuflow.com/Tuflow%20Tutorial%20Models.aspx TUFLOW website]</u>. For this module you have been provided 2d location lines, a code polygon for the fine resolution domain, boundary condition lines datasets for the model inflow, outflow and the 2D2D boundary link. To import these datasets for this tutorial, please select your GIS package from the list below.		Download the Tutorial Model dataset relevant to your GIS environment (ArcGIS, MapInfo or QGIS) from the <u>[http://www.tuflow.com/Tuflow%20Tutorial%20Models.aspx TUFLOW website]</u>. For this module you have been provided 2d location lines, a code polygon for the fine resolution domain, boundary condition lines datasets for the model inflow, outflow and the 2D2D boundary link. To import these datasets for this tutorial, please select your GIS package from the list below.
	*[[~~Tute_M09_MI_2D2D_domain~~\| MapInfo]]		*[[Tute_M09_MI_2D2D_domain_Archive\| MapInfo]]
	*[[~~Tute_M09_ArcQGIS_2D2D_domain~~ \| ArcGIS or QGIS]]		*[[Tute_M09_ArcQGIS_2D2D_domain_Archive \| ArcGIS or QGIS]]
	[[File:Tute_M09_2d2d_domain_areas_2.5m5m2.JPG\|600px]]		[[File:Tute_M09_2d2d_domain_areas_2.5m5m2.JPG\|600px]]
	<br>		<br>
Line 188:		Line 188:

	=Run Simulation and Review Results=		=Run Simulation and Review Results=
	Run '''M09_2D2D_001.tcf''' using your preferred method, as described[[~~Tutorial_Module01~~#Running_TUFLOW \| here]].<br>		Run '''M09_2D2D_001.tcf''' using your preferred method, as described[[Tutorial_Module01_Archive#Running_TUFLOW \| here]].<br>

	''Note: release 2016-03-AD or newer is required to run this tutorial without a physical TUFLOW license.		''Note: release 2016-03-AD or newer is required to run this tutorial without a physical TUFLOW license.

Pavlina Monhartova: Created page with "
=Introduction= In this module we will further develop the model from Module 01. Please complete Module 01 before attempting this tutorial, it is the..."

2022-06-02T04:09:26Z

Created page with "<ol> =Introduction= In this module we will further develop the model from Module 01. Please complete Module 01 before attempting this tutorial, it is the..."

New page

<ol>
=Introduction=
In this module we will further develop the model from [[Tutorial_Module01|Module 01]]. Please complete Module 01 before attempting this tutorial, it is the starting point for the model updates documented below. We will be developing a multiple domain model that incorporates two different grid size within different portions of the model domain: a 2.5m 'FINE' grid and a 5m 'COARSE' grid. This module assumes that you have a good understanding of the different TUFLOW control files and are confident in navigating the TUFLOW file structure.
 
''Note: Running a multiple domain model without a valid multiple domain licence (i.e. in Tutorial Mode) can only be achieved using TUFLOW Build 2016-03-AD or newer.''
 

=GIS Inputs=
Download the Tutorial Model dataset relevant to your GIS environment (ArcGIS, MapInfo or QGIS) from the [http://www.tuflow.com/Tuflow%20Tutorial%20Models.aspx TUFLOW website]. For this module you have been provided 2d location lines, a code polygon for the fine resolution domain, boundary condition lines datasets for the model inflow, outflow and the 2D2D boundary link. To import these datasets for this tutorial, please select your GIS package from the list below.
*[[Tute_M09_MI_2D2D_domain| MapInfo]]
*[[Tute_M09_ArcQGIS_2D2D_domain | ArcGIS or QGIS]]
[[File:Tute_M09_2d2d_domain_areas_2.5m5m2.JPG|600px]]
 

=Modify Simulation Control Files =
Having completed all the necessary GIS file updates, we now need to update our TUFLOW control files. 

==TUFLOW Control File (TCF) ==
Multiple domain models are defined in TUFLOW using 2D domain blocks within the TUFLOW Control File (TCF). Each domain block is defined using <tt>Start 2D Domain</tt> <tt>==</tt> <tt><name></tt> and <tt>End 2D Domain</tt> commands. Unique TUFLOW Geometry Control (TGC) file, Boundary Condition Control (TBC) file, initial water level, plot output and time step commands are defined within each domain block. All other commands (such as the boundary condition database, material file references, ESTRY control file and simulation time and map output commands) are defined outside the above mentioned 2D domain blocks. 
 
We will create a new TCF based on Tutorial M01: '''M01_5m_002.tcf''' from your working '''TUFLOW\runs''' folder.: 
<ol>
</li>
<li>Open '''M01_5m_002.tcf''' in your text editor and save as '''M09_2D2D_001.tcf'''.
<li> Within the 'MODEL INPUTS' section, comment out (or delete) the "Geometry Control File" and "BC Control File" lines, using a comment character (! or #)
:<tt>! Geometry Control File == ..\model\M01_5m_002.tgc</tt></li>
:<tt>! BC Control File == ..\model\M01_5m_002.tbc</tt></li> 

<li>Within the 'MODEL INPUTS' section, include the following commands: 
:<tt>Start 2D Domain</tt> <tt>==</tt> <tt>COARSE</tt> 
::<tt>Geometry Control File</tt> <tt>==</tt> <tt>..\model\M09_2D2D_5m_001.tgc</tt> 
::<tt>BC Control File</tt> <tt>==</tt> <tt>..\model\M09_2D2D_5m_001.tbc</tt> 
::<tt>Set IWL</tt> <tt>==</tt> <tt>36.5</tt> 
::<tt>Timestep</tt> <tt>==</tt> <tt>1.5</tt> 
:<tt>End 2D Domain</tt> 
 

:<tt>Start 2D Domain</tt> <tt>==</tt> <tt>FINE</tt> 
::<tt>Geometry Control File</tt> <tt>==</tt> <tt>..\model\M09_2D2D_2.5m_001.tgc</tt> 
::<tt>BC Control File</tt> <tt>==</tt> <tt>..\model\M09_2D2D_2.5m_001.tbc</tt> 
::<tt>Set IWL</tt> <tt>==</tt> <tt>36.5</tt> 
::<tt>Timestep</tt> <tt>==</tt> <tt>0.5</tt> 
:<tt>End 2D Domain</tt> 

:''Tip 1: Indenting commands within your Domain block makes your code more legible.'' 
:''Tip 2: The material and bc_dbase files can be read outside of the domain blocks as per a typical TUFLOW model.'' 
<li>Add the command <tt>Reveal 1D Nodes</tt> <tt>==</tt> <tt>ON</tt> 
This command will include the location of 2D2D link boundary hidden 1D nodes within the nwk_N_check layer. refer for [[TUFLOW_2D2D_BC_Advice| Multiple Domain 2D/2D Boundary Condition Guidance]] for more details about hidden 1D nodes.

<li>Comment out (or delete) the 'INITIAL WATER LEVELS' section and "Timestep" line, using a comment character (! or #).
:<tt>! Set IWL == 36.5</tt> </li>
:<tt>! Timestep == 1.5</tt> </li>
The initial water level and timestep for each individual domain has been given within the <tt>Start 2D Domain</tt> and <tt>End 2D Domain</tt> blocks.

<li>We will also update the log, output and check folder locations for this tutorial: 

:<tt>Log Folder</tt> <tt>==</tt> <tt>log</tt> 
:<tt>Output Folder</tt> <tt>==</tt> <tt>..\results\M09\2d</tt> 
:<tt>Write Check Files</tt> <tt>==</tt> <tt>..\check\2d\ </tt> 
:<tt>Time Series Output Interval</tt> <tt>==</tt> <tt>300</tt> 

<li>Adding the <tt>Time Series Output Interval</tt> command to the 'OUTPUT CONTROL AND FORMAT COMMANDS' section is required because of the <tt>Reveal 1D Nodes</tt> command. Excluding this output command will result in [[TUFLOW_Message_0046|<tt>Error 0046 - 1D Output Interval not specified</tt>]]. 

<li>Save the TCF file.</li>
</ol>

==TUFLOW Geometry Control (TGC) ==
TUFLOW Geometry Control (TGC) files are required for the COARSE and FINE domains.

===Coarse Resolution Domain===
<ol>
<li>Open '''M01_5m_002.tgc''' in your text editor. Save the file as '''M09_2D2D_5m_001.tgc'''.
<li> Within the '2D DOMAIN EXTENT AND RESOLUTION COMMANDS' section, comment out (or delete) the "Origin" and "Orientation" lines using a comment character (! or #)
:<tt>! Origin == 292725, 6177615</tt> </li>
:<tt>! Orientation == 293580, 6177415</tt> </li>
The 'Origin' and 'Orientation' method can be used in multiple domain models, however for this tutorial we will be using a 2d location line (2d_loc) to specify the grid origin and orientation.
<li>Include the following command to replace the 'Origin' and 'Orientation' commands that were removed above: 
:'''MapInfo Users''' 
:<tt>Read GIS Location</tt> <tt>==</tt> <tt>mi\2d_loc_M09_5m_001.MIF</tt> 

:'''QGIS or ArcGIS Users''' 
:<tt>Read GIS Location</tt> <tt>==</tt> <tt>gis\2d_loc_M09_5m_001_L.shp</tt> 

<li>Update the grid size for the COARSE domain. 
:<tt>Grid Size (X,Y)</tt> <tt>==</tt> <tt>850, 575</tt> 

[[File:Tute_M09_COARSE_domain_dimensions2.JPG|600px]] 

<li>Within the 'MODEL GRID COMMANDS' section, replace the Tutorial M01 referenced code boundary '''2d_code_M01_002''' with: 

:'''MapInfo Users''' 
:<tt>Read GIS Code</tt> <tt>==</tt> <tt>mi\2d_code_M09_5m_001.MIF</tt> 
:<tt>Read GIS Code Invert</tt> <tt>==</tt> <tt>mi\2d_code_M09_2.5m_001.MIF</tt> 

:'''QGIS or ArcGIS Users''' 
:<tt>Read GIS Code</tt> <tt>==</tt> <tt>gis\2d_code_M09_5m_001_R.shp</tt> 
:<tt>Read GIS Code Invert</tt> <tt>==</tt> <tt>gis\2d_code_M09_2.5m_001_R.shp</tt> 

If the extents of the 2D domains overlap, it is necessary to deactivate the overlapping cells in the other domain. <tt>Read GIS Code Invert</tt> is useful for this purpose. It allows any areas within the COARSE domain that overlap with the FINE domain to be deactivated (inverting the active code status of the FINE domain GIS feature).
 
[[File:Tute_M09_active_null_areas2.JPG|600px]] 

<li>Save the file.
</ol>

===Fine Resolution Domain===
<ol>
<li>Open '''M09_2D2D_5m_001.tgc''' in your text editor. Save the file as '''M09_2D2D_2.5m_001.tgc'''.
<li>Update the 2d location line reference. Replace '''2d_loc_M09_5m_001_L''' with '''2d_loc_M09_2.5m_001_L''':
:'''MapInfo Users''' 
:<tt>Read GIS Location</tt> <tt>==</tt> <tt>mi\2d_loc_M09_2.5m_001.MIF</tt> 

:'''QGIS or ArcGIS Users''' 
:<tt>Read GIS Location</tt> <tt>==</tt> <tt>gis\2d_loc_M09_2.5m_001_L.shp</tt> 
<li>Within the '2D DOMAIN EXTENT AND RESOLUTION COMMANDS' section, update the cell size value and domain grid dimensions: 
:<tt>Cell Size</tt> <tt>==</tt> <tt>2.5</tt> 
:<tt>Grid Size (X,Y)</tt> <tt>==</tt> <tt>725, 500</tt> 
The new domain dimensions are to account for the new 2d location line (2d_loc) for the FINE domain. The purpose of including a 2d location line for each domain is to ensure that the computational grid for each 2D area has as little redundant area as possible. Redundant area influences RAM allocation used to simulate the model. The inclusion of a smaller domain that has an inefficient domain shape can prolong model run times. 

[[File:Tute_M09_FINE_domain_dimensions2.JPG|600px]] 

<li>Within the 'MODEL GRID COMMANDS' section, update the following commands: 
:'''MapInfo Users''' 
:<tt>Read GIS Code</tt> <tt>==</tt> <tt>mi\2d_code_M09_2.5m_001.MIF</tt> 

:'''QGIS or ArcGIS Users''' 
:<tt>Read GIS Code</tt> <tt>==</tt> <tt>gis\2d_code_M09_2.5m_001_R.shp</tt> 
There is no need to deactivate cells in the FINE resolution domain using the <tt>Read GIS Code Invert</tt> option since the 2.5m code polygon aligns exactly with the 2D2D boundary line ('''2d_bc_M09_2D2D_001''') (i.e. the line is snapped to the polygon vertices) 
<li>Existing elevation and material commands should remain unchanged in this example. 
''Note: Different datasets in each TGC file can be specified if desired, though the elevations along the 2D2D interface must match to achieve a stable exchange of flow between both domains.''
<li>Save the file.
</ol>

==TUFLOW Boundary Control (TBC) ==
TUFLOW Boundary Control (TBC) files are required for the COARSE and FINE domains.

===Coarse Resolution Domain===
<ol>
<li>Open '''M01_5m_002.tbc''' in your text editor. Save the file as '''M09_2D2D_5m_001.tbc'''.
<li> Comment out (or delete) the "Read GIS BC" command, using a comment character (! or #)
:'''MapInfo Users''' 
:<tt>! Read GIS BC == mi\2d_bc_M01_002.mif</tt>
:'''QGIS or ArcGIS Users''' 
:<tt>! Read GIS BC == mi\2d_bc_M01_002</tt> 
<li> Do not comment out the '''Read GIS SA == 2d_sa_M01_002''' inflow boundary command. The 2d_sa feature is situated in the COARSE domain and should remain.
<li> Include reference to the new file containing the upstream inflow location.
:'''MapInfo Users''' 
:<tt>Read GIS BC</tt> <tt>==</tt> <tt>mi\2d_bc_M09_5m_001.MIF</tt> 

:'''QGIS or ArcGIS Users''' 
:<tt>Read GIS BC</tt> <tt>==</tt> <tt>gis\2d_bc_M09_5m_001_L.shp</tt> 

<li> Add reference to the 2D2D boundary line used to transfer flow between the COARSE and FINE domains. 

:'''MapInfo Users''' 
:<tt>Read GIS BC</tt> <tt>==</tt> <tt>mi\2d_bc_M09_2D2D_001.MIF</tt> 

:'''QGIS or ArcGIS Users''' 
:<tt>Read GIS BC</tt> <tt>==</tt> <tt>gis\2d_bc_M09_2D2D_001_L.shp</tt> 

<li>Save the file. 
</ol>

===Fine Resolution Domain===
<ol>
<li> Open '''M09_2D2D_5m_001.tbc''' in your text editor. Save the file as '''M09_2D2D_2.5m_001.tbc'''.
<li> As the '''2d_sa_M01_002''' inflow boundary is situated outside the FINE domain comment out or delete this layer from '''M09_2D2D_2.5m_001.tbc'''.
<li> Comment out the reference to the upstream inflow location (as it is not associated with the FINE resolution domain). Replace it with reference to the downstream outflow location:
:'''MapInfo Users''' 
:<tt>! Read GIS BC == mi\2d_bc_M09_5m_001_L.MIF</tt>
:<tt>Read GIS BC</tt> <tt>==</tt> <tt> mi\2d_bc_M09_2.5m_001.MIF</tt> 

:'''QGIS or ArcGIS Users''' 
:<tt>! Read GIS BC == gis\2d_bc_M09_5m_001_L.shp</tt>
:<tt>Read GIS BC</tt> <tt>==</tt> <tt> gis\2d_bc_M09_2.5m_001_L.shp</tt> 

<li> Add reference to the 2D2D boundary line. This command is replicated in both the COARSE and FINE domain TBC files. 

:'''MapInfo Users''' 
:<tt>Read GIS BC</tt> <tt>==</tt> <tt>mi\2d_bc_M09_2D2D_001.MIF</tt> 

:'''QGIS or ArcGIS Users''' 
:<tt>Read GIS BC</tt> <tt>==</tt> <tt>gis\2d_bc_M09_2D2D_001_L.shp</tt> 
<li>Save the file. The TUFLOW simulation is now ready to run.
</ol>

=Run Simulation and Review Results=
Run '''M09_2D2D_001.tcf''' using your preferred method, as described[[Tutorial_Module01#Running_TUFLOW | here]]. 

''Note: release 2016-03-AD or newer is required to run this tutorial without a physical TUFLOW license.
Earlier TUFLOW releases will not run the tutorial model, and will generate the error shown below. ''
[[File:Tute_M09_licence_error.JPG|thumb|none|800px]] 
Review the model Map Output results in your preferred result viewing program (i.e. SMS, WaterRIDE, QGIS, Blue Kenue). Flood depth results are shown below. Notice the smooth transition in result across the 2D2D link. 
[[File:2D2D_Module_Depth_Results.JPG|700px]] 

=Review Check Files=
Review the model check files after the simulation is completed. The following sections outline how the check files can be used to review each of the key changes we have made to the model.

==1D Nodes==
Flow is transferred between both domains via a series of hidden 1D nodes. The hidden 1D nodes act as storage for the passing of mass from one 2D domain to the other. Strange flow patterns can occur if the water profile is not close to linear between vertices, which can in turn lead to instabilities. As such, appropriate resolution of the hidden 1D nodes is an important feature of multiple 2D domain models. The location of hidden 1D nodes can be viewed in the '''M09_2D2D_001_nwk_N_check''' file.

[[File:Tute_M09_2d2d_vector_results_2.JPG|600px]] 
Advice on appropriate hidden 1D node spacing is available [[TUFLOW_2D2D_BC_Advice|here]]. More information concerning the nwk_N_check check file can also be found [[Check_Files_1d_nwk_N| here]]. 

==Multiple Domains==
The grd_check file is useful for confirming whether overlapping domains have been correctly deactivated. Import '''M09_2D2D_001_grd_check'''. Refer to Item 1 in [[TUFLOW_2D2D_BC_Advice| Multiple Domain 2D/2D Boundary Condition Guidance]]. 
The 2d_to_2d_check file is useful to review the location of the 2D2D boundary condition cells. Import '''M09_2D2D_2.5m5m_001_2d_to_2d_check'''. The coloured grid cells highlight the boundary cells that are selected for each hidden 1D node that was previously specified using the "d" attribute. More information concerning the 2d_to_2d check file can be found [[Check_Files_2d_to_2d_bc | here]]. 

[[File:Tute_M09_2d2d_check_files2.JPG|600px]] 
[[File:Tute_M09_2d_to_2d_check_info.JPG |400px]] 

=Additional Information=
*Further multiple domain modeling advice can be found [[TUFLOW_2D2D_BC_Advice | here]]. The modelling guidance page discusses appropriate hidden 1D node spacing, 2D2D boundary line orientation and storage multiplier options.
*There is also a webinar hosted by Bill Syme covering multiple 2D domains in more detail. You can find that presentation "Modelling with Difference Cell Sizes" [[TUFLOW_Modelling_Webinars#Modelling_with_Different_Cell_Sizes | here]]. 

=Multiple 2D Domain Modelling Using HPC=
TUFLOW HPC and its GPU Module currently don't support multiple 2D domain functionality. Quadtree nesting is currently being developed and is expected to be released in late 2018.

Tutorial Module09 Archive - Revision history

Abigail.lillo: /* Multiple 2D Domain Modelling Using HPC */

Emilie Nielsen at 03:19, 5 April 2024

Pavlina Monhartova: /* Additional Information */

ElizaCollison at 00:56, 9 January 2023

Pavlina Monhartova: Created page with " =Introduction= In this module we will further develop the model from Module 01. Please complete Module 01 before attempting this tutorial, it is the..."

Pavlina Monhartova: Created page with "
=Introduction= In this module we will further develop the model from Module 01. Please complete Module 01 before attempting this tutorial, it is the..."