TUFLOW to GIS: Difference between revisions

Content deleted Content added
No edit summary
 
(5 intermediate revisions by 2 users not shown)
Line 19:
 
=Running TUFLOW_to_GIS=
Simply double clicking on the TUFLOW_to_GIS executable will bring up a DOSconsole promptwindow that that gives you some instructions on running the utility.<br>
The most common way to run the utility is from a batch file. This allows the user to process multiple outputs at once. A batch file is simply a plain text file containing one or more lines that execute a utility as per the example sections below.<br>
<br>
Line 53:
|"-shp"|| The output format will be the shapefile format. This can be opened directly in QGIS and ArcMap (and most GIS software)
|-
|"-vector" or "-arrows"|| The output will contain arrows as polygons to display vector data (ege.g. velocities and unit flows) in GIS. Must be used with the -mif or -shp option.
|-
|"-slant<slant factor>"|| Changes the arrow head slant in the vector GIS output above. The default is -slant12 which gives 30 degree arrow head according to the equation ((180/slant)*2)
Line 73:
|"-cd<depth>"|| Sets the cutoff depth for use with -mif or -shp output, this is used when processing the water level and depth outputs. The default is 0.01m (or 0.01ft if the results are in feet).
|-
|"-prec< u >.< d >"|| Sets the output precision for -asc, -mif and -shp options. For example -prec6.3 would output 6 units (or 5 units if number is negative) (iei.e. from -99,999 to 999,999) with 3 decimal places.
|-
|"-sec"|| Display and enter times in seconds (default = hours).
|-
|"-out<output file name, without file extension>"|| To specify the name of the output files. Extension added based on output format. Note: not applicable when converting multiple outputs (ege.g. multiple times).
|-
|"-sgs"|| Suppresses the grid size from the output file name. For example Run_h_g005_max.asc will become Run_h_max.asc
Line 84:
|-
|"-ttf<TT_Factor>" || Scales the thickness of arrow tails (default = 0). It will produce arrows suitable for ArcGIS if TT_factor is non-zero. <br>
+ve value (ege.g. -ttf.01): Thickness is TT_Factor times the arrow size.<br>
-ve value (ege.g. -ttf-.01): Thickness is TT_Factor times the cell size.
|-
|"-vmax<vmax>"|| The max vector magnitude for scaling vector arrow points.Default is no scaling except for _V.dat files which it is 10.
Line 97:
T - 1D Water Level Line triangles<br>
T - 1D Water Level Line triangles<br>
EgE.g: -ptsCT would output only 2D cell centres and 1D water level line points
|-
|"-region"||Outputs a region object, for each 2D cell the output value is the cell centre output. Note: only valid with -mif or -shp output.
|}
 
 
==XMDF Switches==
Line 119 ⟶ 120:
|"-typeAll"|| Converts all available output types in an xmdf file.
|-
|"-s<output id(integer)>"|| Converts the specified scalar dataset in an xmdf file. For example, <tt>-s1</tt> will convert the first scalar dataset. A summary of the available datasets is listed within the DOSconsole window when TUFLOW_to_GIS is preprocessing results. Check <u>[[TUFLOW_to_GIS#XMDF_Dataset_Example | XMDF Dataset Example]]</u>. To keep the DOSconsole window open write "pause" at the end of the processing batch file and remove -b switch.
|-
|"-v<output id(integer)>"|| Converts the specified vector dataset in an xmdf file. For example, <tt>-v1</tt> will convert the first vector dataset. A summary of the available datasets is listed within the DOSconsole window when TUFLOW_to_GIS is preprocessing results. Check <u>[[TUFLOW_to_GIS#XMDF_Dataset_Example | XMDF Dataset Example]]</u>. To keep the DOSconsole window open write "pause" at the end of the processing batch file and remove -b switch.
|-
|"-Folder<Folder Name>"|| Converts all datasets within a particular xmdf file. For example, <tt>-Folder"Maximums"</tt> will convert all datasets in the \Maximums\ folder.
Line 130 ⟶ 131:
|}
===XMDF Dataset Example===
For example, to convert the maximum Z1 output from “M01_5m_002_mult.xmdf” the DOSconsole window shows us that this is the fifth scalar dataset and the below command would be used:<br>
<tt>TUFLOW_to_GIS_w64.exe -asc -s5 -max M01_5m_002_mult.xmdf </tt><br>
Another way to extract the same dataset using the -path switch is:<br>
Line 232 ⟶ 233:
*<tt>TUFLOW_to_GIS.exe -cp "CP_File.mif" -typeH -max M03_5m_003.xmdf</tt><br>
 
The CP file inputs, flood model result and difference in peak flood level relative to the recorded level is output to a GIS file (ege.g. '<CP_filename>_<TUFLOW_model_filename>.shp') <br>
<br>
[[File: T2G_Longsection_001.PNG|300px]]<br>
<br>
 
 
<li>Compute longitudinal profiles of maximum flood level model results. Associate recorded high water marks (in shp or mif format) with the profile if the point location is within a defined radius of the longitudinal profile line.<br>