TUFLOW to GIS - Revision history

Anne.Kolega: /* General Input Switches */ i.e.

2026-04-02T01:54:52Z

General Input Switches: i.e.

← Older revision		Revision as of 11:54, 2 April 2026
Line 73:		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).		\|"-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) (ie. from -99,999 to 999,999) with 3 decimal places.		\|"-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) (i.e. from -99,999 to 999,999) with 3 decimal places.
	\|-		\|-
	\|"-sec"\|\| Display and enter times in seconds (default = hours).		\|"-sec"\|\| Display and enter times in seconds (default = hours).

Anne.Kolega: /* Calibration Points and Longitudinal Profiles */ e.g.

2026-04-01T22:16:05Z

Calibration Points and Longitudinal Profiles: e.g.

← Older revision		Revision as of 08:16, 2 April 2026
Line 233:		Line 233:
	*<tt>TUFLOW_to_GIS.exe -cp "CP_File.mif" -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>

	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>		The CP file inputs, flood model result and difference in peak flood level relative to the recorded level is output to a GIS file (e.g. '<CP_filename>_<TUFLOW_model_filename>.shp') <br>
	<br>		<br>
	[[File: T2G_Longsection_001.PNG\|300px]]<br>		[[File: T2G_Longsection_001.PNG\|300px]]<br>
	<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>		<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>

Anne.Kolega: /* General Input Switches */ e.g.

2026-03-30T04:35:43Z

General Input Switches: e.g.

← Older revision		Revision as of 14:35, 30 March 2026
Line 84:		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>		\|"-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(eg. -ttf.01): Thickness is TT_Factor times the arrow size.<br>		+ve value (e.g. -ttf.01): Thickness is TT_Factor times the arrow size.<br>
	-ve value(eg. -ttf-.01): Thickness is TT_Factor times the cell size.		-ve value (e.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.		\|"-vmax<vmax>"\|\| The max vector magnitude for scaling vector arrow points.Default is no scaling except for _V.dat files which it is 10.

Anne.Kolega: /* General Input Switches */ e.g.

2026-03-30T04:27:56Z

General Input Switches: e.g.

← Older revision		Revision as of 14:27, 30 March 2026
Line 53:		Line 53:
	\|"-shp"\|\| The output format will be the shapefile format. This can be opened directly in QGIS and ArcMap (and most GIS software)		\|"-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 (eg. velocities and unit flows) in GIS. Must be used with the -mif or -shp option.		\|"-vector" or "-arrows"\|\| The output will contain arrows as polygons to display vector data (e.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)		\|"-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)

Anne.Kolega: /* General Input Switches */

2026-03-30T04:19:38Z

General Input Switches

← Older revision		Revision as of 14:19, 30 March 2026
Line 77:		Line 77:
	\|"-sec"\|\| Display and enter times in seconds (default = hours).		\|"-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 (eg. multiple times).		\|"-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 (e.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		\|"-sgs"\|\| Suppresses the grid size from the output file name. For example Run_h_g005_max.asc will become Run_h_max.asc
Line 97:		Line 97:
	T - 1D Water Level Line triangles<br>		T - 1D Water Level Line triangles<br>
	T - 1D Water Level Line triangles<br>		T - 1D Water Level Line triangles<br>
	Eg: -ptsCT would output only 2D cell centres and 1D water level line points		E.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.		\|"-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==		==XMDF Switches==

Pavlina Monhartova at 05:37, 18 April 2025

2025-04-18T05:37:06Z

Angelos Livogiannis at 10:16, 19 July 2024

2024-07-19T10:16:29Z

@@ Line 80: / Line 80: @@
 |-
 |"-sgs"|| Suppresses the grid size from the output file name. For example Run_h_g005_max.asc will become Run_h_max.asc
 |}

Emilie Nielsen: /* Examples */

2024-07-19T01:49:17Z

Examples

Show changes

Emilie Nielsen at 00:37, 18 July 2024

2024-07-18T00:37:26Z

← Older revision		Revision as of 10:37, 18 July 2024
Line 1:		Line 1:
	=Introduction=		=Introduction=
	The TUFLOW_to_GIS.exe is a utility available on the TUFLOW website <u>([https://www.tuflow.com/~~Tuflow%20Utilities.aspx~~ Download TUFLOW utilities])</u>.		The TUFLOW_to_GIS.exe is a utility available on the TUFLOW website <u>([https://www.tuflow.com/downloads/#utilities Download TUFLOW utilities])</u>.
	<br>		<br>
	The utility can be used to convert TUFLOW outputs (.xmdf and .dat) into formats that can be imported into GIS packages such as MapInfo, ArcGIS, and QGIS.		The utility can be used to convert TUFLOW outputs (.xmdf and .dat) into formats that can be imported into GIS packages such as MapInfo, ArcGIS, and QGIS.

Emilie Nielsen at 00:35, 18 July 2024

2024-07-18T00:35:10Z

← Older revision		Revision as of 10:35, 18 July 2024
Line 1:		Line 1:
	=Introduction=		=Introduction=
	The TUFLOW_to_GIS.exe is a utility available on the TUFLOW website <u>([~~http~~://www.tuflow.com/Tuflow%20Utilities.aspx Download TUFLOW utilities])</u>.		The TUFLOW_to_GIS.exe is a utility available on the TUFLOW website <u>([https://www.tuflow.com/Tuflow%20Utilities.aspx Download TUFLOW utilities])</u>.
	<br>		<br>
	The utility can be used to convert TUFLOW outputs (.xmdf and .dat) into formats that can be imported into GIS packages such as MapInfo, ArcGIS, and QGIS.		The utility can be used to convert TUFLOW outputs (.xmdf and .dat) into formats that can be imported into GIS packages such as MapInfo, ArcGIS, and QGIS.
	<br>		<br>
	'''Note''' That as per the 2013 version of TUFLOW, TUFLOW can now write directly to the gridded formats (.asc and .flt). This avoids the need for a separate conversion step. This is outlined in the <u>[~~http~~://www.tuflow.com/Download/TUFLOW/Releases/2013-12/Doc/TUFLOW%20Release%20Notes.2013-12.pdf release notes]</u>.<br>		'''Note''' That as per the 2013 version of TUFLOW, TUFLOW can now write directly to the gridded formats (.asc and .flt). This avoids the need for a separate conversion step. This is outlined in the <u>[https://www.tuflow.com/Download/TUFLOW/Releases/2013-12/Doc/TUFLOW%20Release%20Notes.2013-12.pdf release notes]</u>.<br>
	<br>		<br>
	The output frequency and data types can now be specified independently for each data output format. An example is given below:<br>		The output frequency and data types can now be specified independently for each data output format. An example is given below:<br>

← Older revision		Revision as of 15:37, 18 April 2025
Line 19:		Line 19:

	=Running TUFLOW_to_GIS=		=Running TUFLOW_to_GIS=
	Simply double clicking on the TUFLOW_to_GIS executable will bring up a ~~DOS~~ ~~prompt~~ that that gives you some instructions on running the utility.<br>		Simply double clicking on the TUFLOW_to_GIS executable will bring up a console window 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>		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>		<br>
Line 119:		Line 119:
	\|"-typeAll"\|\| Converts all available output types in an xmdf file.		\|"-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 ~~DOS~~ window when TUFLOW_to_GIS is preprocessing results. Check <u>[[TUFLOW_to_GIS#XMDF_Dataset_Example \| XMDF Dataset Example]]</u>. To keep the ~~DOS~~ window open write "pause" at the end of the processing batch file and remove -b switch.		\|"-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 console window when TUFLOW_to_GIS is preprocessing results. Check <u>[[TUFLOW_to_GIS#XMDF_Dataset_Example \| XMDF Dataset Example]]</u>. To keep the console 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 ~~DOS~~ window when TUFLOW_to_GIS is preprocessing results. Check <u>[[TUFLOW_to_GIS#XMDF_Dataset_Example \| XMDF Dataset Example]]</u>. To keep the ~~DOS~~ 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 console window when TUFLOW_to_GIS is preprocessing results. Check <u>[[TUFLOW_to_GIS#XMDF_Dataset_Example \| XMDF Dataset Example]]</u>. To keep the console 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.		\|"-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:		Line 130:
	\|}		\|}
	===XMDF Dataset Example===		===XMDF Dataset Example===
	For example, to convert the maximum Z1 output from “M01_5m_002_mult.xmdf” the ~~DOS~~ window shows us that this is the fifth scalar dataset and the below command would be used:<br>		For example, to convert the maximum Z1 output from “M01_5m_002_mult.xmdf” the console 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>		<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>		Another way to extract the same dataset using the -path switch is:<br>