TUFLOW to GIS: Difference between revisions

Content deleted Content added
No edit summary
Line 141:
 
=Examples=
<ol>
== Converting to 3D grids==
Probably the most common use of the TUFLOW_to_GIS utility is to convert the maximum results to a 3D surface. A number of examples are given below:<br>
<ol>
* Convert water level maximums to a 3D grid:<br>
<li>Convert water level maximums to a 3D grid:<br>
<li><tt>TUFLOW_to_GIS.exe -b -asc -max -typeH M01_5m_001.xmdf</tt></li>
*<tt>TUFLOW_to_GIS.exe -b -asc -max -typeH M01_5m_001.xmdf</tt><br>
<u>Description:</u> Using batch mode (-b), convert to a 3D grid (-asc), converting the maximums (-max) for the water level results (-typeH).<br>
*<u>Description:</u> Using batch mode (-b), convert to a 3D grid (-asc), converting the maximums (-max) for the water level results (-typeH).<br>
 
<br>
* Convert to a 3D grid at a specific time:<br>
<li>Convert to a 3D grid at a specific time:<br>
<li><tt>TUFLOW_to_GIS.exe -b -asc -t3 -typeH M01_5m_001.xmdf</tt></li>
*<tt>TUFLOW_to_GIS.exe -b -asc -t3 -typeH M01_5m_001.xmdf</tt><br>
<u>Description:</u> As per example 1, except conversion at time 3 hours (-t3) instead of the maximums.<br>
*<u>Description:</u> As per example 1, except conversion at time 3 hours (-t3) instead of the maximums.<br>
 
<br>
* Convert to a 3D grid of specified grid cell size:<br>
<li>Convert to a 3D grid of specified grid cell size:<br>
<li><tt>TUFLOW_to_GIS.exe -b -asc -max -grid1 -typeH M01_5m_001.xmdf</tt></li>
*<tt>TUFLOW_to_GIS.exe -b -asc -max -grid1 -typeH M01_5m_001.xmdf</tt><br>
<u>Description:</u> As per example 1, except the raster cell size is specified at 1m instead of being half the 2D cell size.<br>
*<u>Description:</u> As per example 1, except the raster cell size is specified at 1m instead of being half the 2D cell size.<br>
 
<br>
* Convert velocity maximums to a 3D grid:<br>
<li>Convert velocity maximums to a 3D grid:<br>
<li><tt>TUFLOW_to_GIS.exe -b -asc -max -typeV M01_5m_001.xmdf</tt></li>
*<tt>TUFLOW_to_GIS.exe -b -asc -max -typeV M01_5m_001.xmdf</tt><br>
<u>Description:</u> As per example 1, except the velocity results (-typeV) are processed instead of water level (-typeH).
*<u>Description:</u> As per example 1, except the velocity results (-typeV) are processed instead of water level (-typeH).<br>
 
<br>
* Convert Z1 hazard maximums to a 3D grid:<br>
<li>Convert Z1 hazard maximums to a 3D grid:<br>
<li><tt>TUFLOW_to_GIS.exe -b -asc -max -s5 M01_5m_001.xmdf</tt></li>
*<tt>TUFLOW_to_GIS.exe -b -asc -max -s5 M01_5m_001.xmdf</tt><br>
<u>Description:</u> As per example 1, except the Z1 hazard (-s5 based on the <u>[[TUFLOW_to_GIS#XMDF_Dataset_Example | XMDF Dataset Example]]</u>) are processed instead of water level (-typeH).
*<u>Description:</u> As per example 1, except the Z1 hazard (-s5 based on the <u>[[TUFLOW_to_GIS#XMDF_Dataset_Example | XMDF Dataset Example]]</u>) are processed instead of water level (-typeH).<br>
</ol>
 
== Converting to Points ==
To output to a points file specify either a shapefiles output with the "-shp" switch or MapInfo output with the "-mif" output. To output at cell corners only:
<ol start="6">
* Convert maximums to a shapefile points file at cell corners:<br>
<li>Convert maximums to a shapefile points file at cell corners:<br>
<li><tt>TUFLOW_to_GIS.exe -b -shp -max -typeH M01_5m_001.xmdf</tt></li>
*<tt>TUFLOW_to_GIS.exe -b -shp -max -typeH M01_5m_001.xmdf</tt><br>
<u>Description:</u> Using batch mode (-b), convert to a shapefile format (-shp), converting the maximums (-max) for the water level results (-typeH).<br>
*<u>Description:</u> Using batch mode (-b), convert to a shapefile format (-shp), converting the maximums (-max) for the water level results (-typeH).<br>
 
<br>
* Convert maximums to a shapefile points file on a regular grid:<br>
<li>Convert maximums to a shapefile points file on a regular grid:<br>
<li><tt>TUFLOW_to_GIS.exe -b -shp -max -grid2 -typeH M01_5m_001.xmdf</tt></li>
*<tt>TUFLOW_to_GIS.exe -b -shp -max -grid2 -typeH M01_5m_001.xmdf</tt><br>
<u>Description:</u> Using batch mode (-b), convert to a shapefile format (-shp), converting the maximums (-max), on a regular 2m grid (-grid2) for the water level results (-typeH).<br>
*<u>Description:</u> Using batch mode (-b), convert to a shapefile format (-shp), converting the maximums (-max), on a regular 2m grid (-grid2) for the water level results (-typeH).<br>
 
<br>
* Convert velocity at time 2 hours to shapefile points file:<br>
<li>Convert velocity at time 2 hours to shapefile points file:<br>
<li><tt>TUFLOW_to_GIS.exe -b -shp -t2 -typeV M01_5m_001.xmdf</tt></li>
*<tt>TUFLOW_to_GIS.exe -b -shp -t2 -typeV M01_5m_001.xmdf</tt><br>
<u>Description:</u> Using batch mode (-b), convert to a shapefile format (-shp), at time of 2 hours (-t2), converting the velocity output (-typeV).<br>
*<u>Description:</u> Using batch mode (-b), convert to a shapefile format (-shp), at time of 2 hours (-t2), converting the velocity output (-typeV).<br>
 
<br>
* Convert the model topography to shapefile points file format:<br>
<li>Convert the model topography to shapefile points file format:<br>
<li><tt>TUFLOW_to_GIS.exe -b -shp M01_5m_001.2dm</tt></li>
*<tt>TUFLOW_to_GIS.exe -b -shp M01_5m_001.2dm</tt><br>
<u>Description:</u> Using batch mode (-b), convert to a shapefile format (-shp), converting the model topography.<br>
*<u>Description:</u> Using batch mode (-b), convert to a shapefile format (-shp), converting the model topography.<br>
</ol>
 
== Converting to Arrows ==
Line 186 ⟶ 189:
The size of the vectors can be controlled with the scale factor ("-sf") switch.<br>
'''NOTE:''' If using input .dat file the dataset type must be a vector dataset, such as velocity or unit flow.<br>
<ol start="10">
 
* <li>Convert output time 2 to a shapefile at cell corners:<br>
<li>*<tt>TUFLOW_to_GIS.exe -b -shp -vector -t2 -typeV M01_5m_001.xmdf</tt></libr>
*<u>Description:</u> Using batch mode (-b), convert to a shapefile format (-shp), using vector outputs (-vector), and converting at time 2 hours (-t2) for the velocity results (-typeV).<br>
<br>
 
* <li>Convert output time 2 to a shapefile at cell corners:<br>
<li>*<tt>TUFLOW_to_GIS.exe -b -shp -vector -t2 -sf0.5 -typeV M01_5m_001.xmdf</tt></libr>
*<u>Description:</u> As above with a scale factor of 0.5, so that the arrows will be half the length.<br>
<br>
 
* <li>Convert output time 2 to a shapefile on a regular grid of 2m spacing for unit flow:<br>
<li>*<tt>TUFLOW_to_GIS.exe -b -shp -vector -t2 -sf0.5 -grid2 -typeq M01_5m_001.xmdf</tt></libr>
*<u>Description:</u> As above on a regular 2 metre grid (-grid2) for the unit flow results (-typeq).<br>
<br>
 
<u>Note:</u> When using processed maxmax xmdf from RES_to_RES utility the -typeV switch needs to be replaced with -v1 switch. -v1 switch calls for the first vector dataset.<br>
</ol>
 
== Calibration Points and Longitudinal Profiles ==
These command options are used to extract longitudinal profile information from model results. Input format requirements for the CP and LP files are provided in the calibration point and longitudinal profile commands table within the 'Input Flags' section of this page. <br>
<ol start="13">
<li>Compute difference between recorded high water mark (in shp or mif format) and modelled maximum flood level:<br>
*<tt>TUFLOW_to_GIS.exe -cp "CP_File.shp" -typeH -max M03_5m_003.xmdf</tt><br>
*<tt>TUFLOW_to_GIS.exe -cp "CP_File.mif" -typeH -max M03_5m_003.xmdf</tt><br>
 
*Compute difference between recorded high water mark (in shp or mif format) and modelled maximum flood level:
<li><tt>TUFLOW_to_GIS.exe -cp "CP_File.shp" -typeH -max M03_5m_003.xmdf</tt></li>
<li><tt>TUFLOW_to_GIS.exe -cp "CP_File.mif" -typeH -max M03_5m_003.xmdf</tt></li>
The CP file inputs, flood model result and difference in peak flood level relative to the recorded level is output to a GIS file (eg. '<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>
[[File: T2G_Longsection_001.PNG|300px]]
*<tt>TUFLOW_to_GIS.exe -cp "CP_File.shp" -lp "LP_File.shp" -cpsd100 -lpmd2500 -typeH -max M03_5m_003.xmdf</tt><br>
*<tt>TUFLOW_to_GIS.exe -cp "CP_File.mif" -lp "LP_File.mif" -cpsd100 -lpmd2500 -typeH -max M03_5m_003.xmdf</tt><br>
 
*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.
<li><tt>TUFLOW_to_GIS.exe -cp "CP_File.shp" -lp "LP_File.shp" -cpsd100 -lpmd2500 -typeH -max M03_5m_003.xmdf</tt></li>
<li><tt>TUFLOW_to_GIS.exe -cp "CP_File.mif" -lp "LP_File.mif" -cpsd100 -lpmd2500 -typeH -max M03_5m_003.xmdf</tt></li>
The longitude profile results are output to a csv file. The output increment matches the resolution of vertices along the longitudinal profile line. The GIS dataset defines the longitudinal profile chainage at a regular (specified) increment.<br>
<br>
[[File: T2G_Longsection_005.PNG|950px]]
[[File: T2G_Longsection_004.PNG|500px]]
<br>
</ol>
<br>