XPSWMM Conversion DTM Archive: Difference between revisions

== Digital Terrain Model (DTM) Data ==

Depending on which method is applied to your XPSWMM model, the steps required to convert the model to TUFLOW will vary.

Let's review whatwhich method is used:

<li> In the top dropdown menu options, navigatego to Configuration > Job controlControl > 2D Model Settings. This will open a dialog.

:* If 'Use Grid File for Topography' is selected and a 'Grid file' is specified:, the steps outlined in the 'XPSWMM DTM Preprocessing' section can be skipped. Go to the <u>[[XPSWMM_Conversion_TUFLOW_StructureXPSWMM_Conversion_TUFLOW_Structure_Archive | Convert XPSWMM Model to Recommended TUFLOW Structure]]</u> section. The steps outlined in the 'XPSWMM DTM Preprocessing' section can be skipped.

{{Video|name=Animation_XPtoTUFLOW_2D_model_01aAnimation_XPtoTUFLOW_2D_model_01d.mp4|width=1350}}

== XPSWMM DTM Preprocessing ==

If 'Use DTM' was selected, XPSWMM pre-processespreprocesses its Digital Terrain Model (DTM) into a binary XPTIN elevation dataset for inclusion in the TUFLOW model. XPTIN is a proprietybinary format that can't readily be used in GIS software. For this reason, the following options outline how to obtain a DTM dataset in a GIS friendly form. <br>

=== Option 1 (recommended) - Use Original Source Elevation Data Imported to XPSWMM ===

<li> If you personally built the XPSWMM model, you should know where the original source DTM dataset can be found. Locate the original 'Grid' file (.asc or .flt/.hdr format). Save it to the folder where XPSWMM writes the .tcf during its simulation preprocessing. By default, this is the '''2D\Data''' folder. <br>

By default, this is the '''2D\Data''' folder. If this folder does not exist, either:

:* Non-default output settings have been specified in XPSWMM. To determine the output location, in the top dropdown menu options, go to Configuration > Job Control > 2D Model Settings > Folder Options. Ensure the following 'Folder Locations' are selected:.

::[[File: XPSWMM_to_TUFLOW_2DJobControl_FolderOptions_Dialog_01cXPSWMM_to_TUFLOW_2DJobControl_FolderOptions_Dialog_01e.png]]<br><br>

<li> IfAfter completing these steps worked as expected, skip 'Option 2' below and continue to the <u>[[XPSWMM_Conversion_TUFLOW_StructureXPSWMM_Conversion_TUFLOW_Structure_Archive | Convert XPSWMM Model to Recommended TUFLOW Structure]]</u> section. Otherwise, proceed to <u>[[#Option 2 - Export DTM Data from XPSWMM |Option 2]]</u>.

=== Option 2 - Export DTM Data from XPSWMM ===

:* Cell Size Value: Choose a suitable DTM resolution. This resolution should be finer than the hydraulic model resolution. Typically, a DTM resolution is 1/10th5th (orto smaller)1/10th of the hydraulic model 2D cell size is common. <br>

::'''Note:''' XPSWMM requires an integer cell size value for this export step. For example, Cell Size Values of 1, 2, 3, 4, 5 ... are suitable. The XPSWMM export will not function if you specify a decimal cell size value (eg. 0.5, 2.5, etc.).''

<li> Save the file under an appropriate name (e.g. '''1D2D_Urban_Grid.asc''') to the folder where XPSWMM writes the .tcf during its simulation preprocessing. By default, this is the '''2D\Data''' folder. <br>

By default, this is the '''2D\Data''' folder. If this folder does not exist, either:

:* Non-default output settings have been specified in XPSWMM. To determine the output location, in the top dropdown menu options, go to Configuration > Job Control > 2D Model Settings > Folder Options. Ensure the following 'Folder Locations' shown in the image above are selected.

{{Video|name=Animation_XPtoTUFLOW_2D_model_02aAnimation_XPtoTUFLOW_2D_model_02d.mp4|width=1350}}