QGIS TUFLOW Run TUFLOW Utilities

From Tuflow
Revision as of 22:34, 31 March 2022 by Ellis Symons (talk | contribs)
Jump to navigation Jump to search

This tool offers a basic graphical user interface for the TUFLOW Utilities. Users can choose to use the interface for common use cases or use the advanced tab to use batch file commands directly. The tool also has a convenient option to automatically download the latest version of each utility.

Running the Tool

The tool can be found in the TUFLOW Plugin toolbar, or via the QGIS menu Plugins >> TUFLOW >> TUFLOW Utilities.
TUFLOW Utilities ToolIcon.PNG

Common Functions

Prior to running any of the tools, the tool must have access to the TUFLOW Utilities. This is done via the Executables tab.

The available utilities for Common Functions can be selected via the "Utility" dropbox at the top of the dialog. All utilities have optional output options:

  • Output Directory - directory to write the tool outputs. This option will generally not have affect unless an output name is also specified.
  • Output Name - output name of tool outputs. This can be specified independently of an output directory. (Note: prior to version 3.3 of the TUFLOW Plugin, output name required an output directory as well)
  • Save as Batch File - Saves the next run function as a batch file. The batch file will be saved into the output directory if one is specified, otherwise it will be saved to the same location as the other outputs.


Asc_to_Asc
Asc_to_Asc supports ASC and FLT raster formats. The following functions are available for asc_to_asc (inputs must have the same cell size and extents):

  • Difference - Takes the difference between 2 grids. Must specify an input for "Grid 1" and "Grid 2". More information...
  • Maximum - Computes the maximum of all input grids for each grid cell. Must add at least one grid via "Add Grids To Function". More information...
  • Statistics - Computes a range of statistics of all input grids for each grid cell. Must add at least 2 grids via "Add Grids To Function". More information...
  • Convert - Converts all inputs grids between ASC and FLT (the output format is dependent on the input format). Must add at least one grid via "Add Grids To Function". More information...


TUFLOW_to_GIS
TUFLOW_to_GIS supports DAT or XMDF inputs and supports ASC and SHP as output formats. Users must specify an input XMDF or DAT file if running any of the functions. For XMDF inputs, the tool has the option to load XMDF information that will populate the available result types and timesteps. The following functions are available for TUFLOW_to_GIS:

  • Convert to Grid - Converts the DAT, or specified result type from an XMDF, at the chosen timestep to an ASC raster.
  • Convert to Point - Converts the DAT, or specified result type from an XMDF, at the chosen timestep to a Shape File vector point layer.
  • Convert to Vectors - Converts the DAT, or specified result type from an XMDF, at the chosen timestep to a Shape File vector polygon layer shaped as arrows. The arrow geometry is defined by the direction and magnitude of the input. The input must be of type vector (e.g. Velocity, Unit Flow).


Res_to_Res
Res_to_Res supports DAT or XMDF inputs and supports XMDF or DAT output formats. The following functions are available for Res_to_Res :

  • Info - Reads the XMDF header and outputs the information in an output window. Must specify an XMDF file in the "XMDF or DAT File" input. More information...
  • Convert - Converts between XMDF and DAT formats. The output format is dependent on the input format. Must specify an XMDF or DAT file in the "XMDF or DAT File" input. For XMDF, must also specify a type using the dropbox. Users can also manually enter text here if the desired result type isn't listed. More information...
  • Maximum - Calculates the maximum from a number of different inputs. Must specify at least one XMDF or DAT via "Add XMDF or DAT to Function". For XMDF inputs, must also specify a type using the dropbox. Users can also manually enter text here if the desired result type isn't listed. Input mesh layers mush have the same mesh (.2dm file). More information...
  • Concatenate - Joins separate output files together into a single XMDF file. Must specify at least one XMDF or DAT via "Add XMDF or DAT to Function". For XMDF inputs, must also specify a type using the dropbox. Users can also manually enter text here if the desired result type isn't listed. Input mesh layers mush have the same mesh (.2dm file). More information...


Advanced

todo

Executables

todo

Retrieved from "https://wiki.tuflow.com/w/index.php?title=QGIS_TUFLOW_Run_TUFLOW_Utilities&oldid=25985"