RES to RES
|LINKS: Main page|
|Modelling Advice||Tutorial Models||Tips and Tricks|
|A Model Won't Start||Tutorial Module 1||SMS|
|A Model Crashes||Tutorial Module 2||UltraEdit|
|A Model Runs Slow||Tutorial Module 3||Notepad++|
|TUFLOW Products Support / Contact||Tutorial Module 4||Excel|
|Requesting a Licence||TUFLOW FV Utilities|
|Running TUFLOW FV|
The RES_to_RES.exe is a utility available on the the TUFLOW website (Download TUFLOW FV utilities).
This utility performs a variety of operations on the TUFLOW FV 2D dat outputs. This page is split into two section, utility operations (e.g. maximum, difference etc.) and general options. The general options can be used regardless of operation being performed.
The section below contains a list of the operations that the utility can perform. One of these operations must be specified or the utility will generate an error.
Input Switch: -max
This can be used to extract the maximum from a number of input datasets. Any number of input files can be specified. The maximum value is written to the timestamp 111111.0
Extracts the maximum water level from all timesteps from a single dat file. Note manual specification of 2dm filename.
Extracts the maximum water level from the three .dat files.
Input Switch: -dif
This can be used to compare two datasets. If a third file is specified, the third file is used as the output file. The output filename can also be specified with the -out option. The output is the first results minus the second result file.
A special wet/dry algorithm is used. If water level results are not specified (_h.dat or -typeH), the algorithm opens these files, as well as opens the .2dm file associated with the results files, and uses the water levels and ZH Zpt values (for 2D cells) and elevations at the WLL triangle corners to determine whether a node (corner of an mesh element) is wet or dry. This allows two special values to be output in the event that a node is dry in one results file and wet in the other or vice versa. A value of -99 is used to indicate that a node is dry in the first results file, but is flooded in the second results file, while +99 indicates that the node was wet in the first results file but is dry in the second results file. Specifying -nowetdry does not carry out a wet/dry check using the water level results.
The -t option can be used to carry out the difference at a particular time (rather than all times).
Extracts the difference in water level, the output is results_developed_h - results_existing_h for all timesteps.
Extracts the difference in water level for the maximum water level and suppresses the wet/dry check described above at time = 2 hours.
Input Switch: -dur<cut of value>
Determines the duration in hours that the the results exceed the cut of value.
Extracts the duration in flooding above 0.1m deep.
Input Switch: -k<output time>
Can be used to extract a single timestep from a results file. To keep a range of output times see the -range option below.
Creates a new results file containing just the results for t = 2 hours.
Input Switch: -rangeA<start time> -rangeB<end time>
Extracts all timestep between start time and end time (inclusive) into a separate results file.
Creates a new results file containing the outputs between 1.0 and 2.5 hours. Both 1 and 2.5 hour outputs are included.
Input Switch: -r<output time>
Creates a new output file and removes the output time from this.
Creates a new output file which does not include the output at 3.
Input Switch: -trim<value>
Creates a new output file which has any values above <value> set to <value>. If the input is a vector data, the vector magnitude is used to trim the value (direction is unchanged).
Creates a new output of velocity with any outputs greater than 5.0 set to 5.0.
Input Switch: -times
Creates a text file which contains the output times in the .dat. If no output filename is specified with the -out option the output file will be called "times.txt".
Creates an an output file "times.txt" which contains all timesteps that are contained in the results file.
Input Switch: -va
Outputs the vector direction in degrees relative to north (North = 0°, East = 90°, South = 180°/-180°, West = -90°).
Outputs the velocity direction for all timesteps in the results_V.dat file.
Input Switch: -con
Concatenates (joins) two or more results files into one. Each results file must be from the same 2dm mesh.
Joins the three files into a single .dat file.
Input Switch: -conv
Converts between .dat and .xmdf format results. Not to be confused with -con (concatenate option described above)!
Converts the maximum water level results in the xmdf file into .dat file format.
Converts all datasets and times in the .xmdf file into .dat file format. This will output a number of .dat files.
Converts all times in the .dat file into xmdf file format.
Input Switch: -b
Batch mode suppresses prompt to press Enter at end of processing. Used in .bat files where two or more files are to be processed in succession.
Input Switch: -2dm "2dm_filename"
Explicitly specifies a .2dm file. By default RES_to_RES assumes the .2dm file has the same name as the .dat file. This command allows the user to manually specify the 2dm filename. Note: There must be a single space between -2dm and “<2dm_file>”.
Time Search Tolerance
Input Switch: -dttol<value>
Manual specification of the timestamp search tolerance (hours).
Input Switch: -out "output_filename"
Sets the output filename. This is not available for all outputs, particularly where multiple output files are required!