Tuflow

Flood Modeller to TUFLOW: Difference between revisions

Browse history interactively
← Older edit
Content deleted Content added
VisualWikitext
No edit summary
 
(6 intermediate revisions by 4 users not shown)
Line 1:
<font size = 18>Page Under Construction</font>
 
=Introduction=
Often, there is a requirement to convert aspects of a Flood Modeller model to a TUFLOW EstryESTRY model. It is possible to convert a Flood Modeller 1D model to a TUFLOW EstryESTRY format using either the fm_to_estry.exe or fm_to_estry.py utilities. The utilities are available for download from the <u>[https://gitlab.com/tuflow-user-group/tuflow/model-conversions/fm-to-estry TUFLOW Gitlab User Group]</u>. This Wiki page lists useful examples for using the fm_to_estry.exe and fm_to_estry.py utilities.<br><br>If you have any suggestions to be included in these pages, please email <font[mailto:support@tuflow.com color="blue"><u>support@tuflow.com</u></font>].
 
=Flood Modeller to ESTRY conversion utility using the fm_to_estry.exe=
The fm_to_estry.exe utility creates the relevant TUFLOW EstryESTRY network layers from a Flood Modeller <b>.dat</b> file. The utility converts:
* Flood Modeller units to EstryESTRY node/link inputs (1d_nwk)
* Flood Modeller section data to EstryESTRY cross-section GIS (1d_xs) and csv inputs
* Flood Modeller structures to EstryESTRY GIS and csv inputs
A number of structure units are supported but <u>not all</u>. <b>A list of currently supported structures is shown below:</b>
*<b>River</b>
Line 32 ⟶ 30:
*<b>QH Control</b>
 
If using the fm_to_estry.py pythonPython script, it is possible to add support for additional structures. See below for more details.
 
<br>''Note :The utility does not currently support the conversion of either boundary condition data or logical control rules. ''
 
=Utility Execution (.exe)=
In order to convert a Flood Modeller network to EstryESTRY using the fm_to_estyfm_to_estry executable follow the instructions below.
<ol>
<li>Download the followingcompiled file fm_to_estry.0.9.zipexecutable from the <u>[https://gitlab.com/tuflow-user-group/tuflow/model-conversions/fm-to-estry TUFLOW Gitlab User Group]</u> by visiting the <b>Compiled Library section</b> and unzip it to your preferred destination.
<li>Open the file. Then, bring in the relevant files from the Flood Modeller model that requires conversion, in this example the .<b>dat</b>, .<b>gxy</b> and projection files. The projection.<b>shp</b> file will help you to assign your model to the correct projection and can come from an existing TUFLOW model or shapefile in the correct projection. See figure below for the required files:<br>[[File:Fm2estry_1.png|300px|]]
<li>Create a new .bat file (To do that right click in an empty area in the file. A dialogue will open. Choose New and then Text document. Rename your new Text document by including the <b>.bat extension</b> at the end. For Example: fm_to_estry_example.<b>bat</b>).
<li>Open your batch file and insert the text to convert the Flood Modeller model network to an EstryESTRY one. Some examples are shown in the following lines, note that if the batch file is held in a different directory to the Flood Modeller files, you will need to the full file path or relative path to reference the files.
===Examples===
<ol>
<li><pre>fm_to_estry.exe flood_modeller.gxy flood_modeller.dat -crs projection.shp</pre>
Converts a Flood Modeller model
<li><pre>fm_to_estry.exe flood_modeller.gxy flood_modeller.dat -crs "EPSG:32760"</pre>
Uses an EPSG number (32760) for the projection
<li><pre>fm_to_estry.exe flood_modeller.gxy flood_modeller.dat -crs projection.shp -out .\output</pre>
Line 60 ⟶ 58:
<li>Save your preferences and close your batch file.
<li>Double click the batch file.
<li>The above steps will return structures from the <b>supported structures list</b> in <b>.shp</b> and <b>.csv</b> file formats to use them to further set up a 1D TUFLOW/EstryESTRY model. It is recommended that the connectivity is reviewed upstream to downstream to ensure full connectivity of the ESTRY network and generate a network which pass TUFLOW's pre-processing procedure prior to simulation.
The figure below illustrates Flood Modeler 1D model conversion to TUFLOW EstryESTRY.
<br> [[File:Fm2estry_2.jpg|700px|]]
<br>[[File:Fm2estry_3.jpg|700px|]]
Line 73 ⟶ 71:
 
=Other Information=
It is also possible to use the cross-sections from the Flood Modeller <b>.dat</b> file directly within a TUFLOW/EstryESTRY simulation. This means that for some simpler models, particularly those without structures, that conversion of the Flood Modeller model to an EstryESTRY format is not required with the cross-section data being used in a TUFLOW 1D /EstryESTRY model directly from the <b>.dat</b> file. Please, see the [https://docs.tuflow.com/classic-hpc/manual/2023-03/ECFCommands-1.html#ecfXSDatabase <font color="blue"><tt>XS Database</tt></font> <font color="red"><tt>==</tt></font> command] in the [https://docs.tuflow.com/classic-hpc/manual/latest/ TUFLOW user manual] for more information which can be downloaded from here: .
[https://downloads.tuflow.com/_archive/TUFLOW/Releases/2018-03/TUFLOW%20Manual.2018-03.pdf TUFLOW Official Website].
 
=Summary=
When there is a requirement to convert a Flood Modeller 1D network, or part of a network, to TUFLOW EstryESTRY format this can be time consuming. A set of tools have been provided for you to assist this process. Currently, the tools are restricted to network geometry but if there is user-demand, this can be extended to boundary conditions, logical rules and the production of TUFLOW control files. There are two approaches, using either an executable or a Python tool, both of which undertake the same conversion. The advantage of the Python tool is that it is possible to add user-specified support for additional structures which are not supported currently. Once the Flood Modeller network has been converted to a set of ESTRY layers, these should be checked for connectivity and brought together in the ESTRY Control File to read into a TUFLOW-ESTRY simulation.
<br>
{{Tips Navigation
|uplink=[[Main_Page| Back to Main Page]]
}}
Retrieved from "https://wiki.tuflow.com/Flood_Modeller_to_TUFLOW"