RES to RES
| USEFUL LINKS | ||
| Wiki Links | Help | Downloads |
| TUFLOW FV Wiki Main Page | Products Support/Contact | TUFLOW FV Downloads |
| TUFLOW FV Tutorials | Requesting a Licence | Tutorial Module Data |
| TUFLOW Classic/HPC Wiki | TUFLOW FV Glossary | Manuals |
Introduction
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.
Operations
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.
Max
Input Switch: -max
Description
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
Examples
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.
Difference
Input Switch: -dif
Description
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).
Examples
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.
Duration
Input Switch: -dur<cut of value>
Description
Determines the duration in hours that the the results exceed the cut of value.
Examples
Extracts the duration in flooding above 0.1m deep.
Keep
Input Switch: -k<output time>
Description
Can be used to extract a single timestep from a results file. To keep a range of output times see the -range option below.
Examples
Creates a new results file containing just the results for t = 2 hours.
Range
Input Switch: -rangeA<start time> -rangeB<end time>
Description
Extracts all timestep between start time and end time (inclusive) into a separate results file.
Examples
Creates a new results file containing the outputs between 1.0 and 2.5 hours. Both 1 and 2.5 hour outputs are included.
Remove
Input Switch: -r<output time>
Description
Creates a new output file and removes the output time from this.
Examples
Creates a new output file which does not include the output at 3.
Trim Values
Input Switch: -trim<value>
Description
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).
Examples
Creates a new output of velocity with any outputs greater than 5.0 set to 5.0.
Times
Input Switch: -times
Description
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".
Examples
Creates an an output file "times.txt" which contains all timesteps that are contained in the results file.
Vector Angle
Input Switch: -va
Description
Outputs the vector direction in degrees relative to north (North = 0°, East = 90°, South = 180°/-180°, West = -90°).
Examples
Outputs the velocity direction for all timesteps in the results_V.dat file.
Concatenate
Input Switch: -con
Description
Concatenates (joins) two or more results files into one. Each results file must be from the same 2dm mesh.
Examples
Joins the three files into a single .dat file.
Convert
Input Switch: -conv
Description
Converts between .dat and .xmdf format results. Not to be confused with -con (concatenate option described above)!
Examples
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.
General Options
Batch Mode
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.
2dm Filename
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).
Output Filename
Input Switch: -out "output_filename"
Sets the output filename. This is not available for all outputs, particularly where multiple output files are required!