Difference between revisions of "DAT to DAT"
Line 1: | Line 1: | ||
<ol> | <ol> | ||
− | + | =Introduction= | |
− | + | This utility performs a variety of operations on the TUFLOW 2D outputs. Valid formats are .xmdf (as of utility version 2012-10-AC) and .dat files. 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 table of contents can be used to jump to a desired operation. | |
− | |||
− | |||
=Operations= | =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== | ==Max== | ||
Line 22: | Line 20: | ||
<u>Description</u><br> | <u>Description</u><br> | ||
This can be used to compare two datasets. If a third files 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.<br> | This can be used to compare two datasets. If a third files 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.<br> | ||
− | 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 | + | 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. |
<br> | <br> | ||
The -t option can be used to carry out the difference at a particular time (rather than all times). The most common time is to take the difference at the flood peak, ie. specify t99999.<br> | The -t option can be used to carry out the difference at a particular time (rather than all times). The most common time is to take the difference at the flood peak, ie. specify t99999.<br> | ||
Line 92: | Line 90: | ||
Creates an an output file with the specified filename "xmdf_info.txt", which contains information about the contents of the xmdf file. | Creates an an output file with the specified filename "xmdf_info.txt", which contains information about the contents of the xmdf file. | ||
− | == | + | ==Vector Angle== |
'''Input Switch: -va'''<br> | '''Input Switch: -va'''<br> | ||
<u>Description</u><br> | <u>Description</u><br> | ||
− | + | Outputs the vector direction in degrees relative to north (North = 0°, East = 90°, South = 180°/-180°, West = -90°). | |
<u>Examples</u><br> | <u>Examples</u><br> | ||
− | + | <li><tt>dat_to_dat.exe -va results_v.dat</tt></li> | |
+ | Outputs the velocity direction for all timesteps in the results_V.dat file. | ||
==Concatenate== | ==Concatenate== | ||
'''Input Switch: -con'''<br> | '''Input Switch: -con'''<br> | ||
<u>Description</u><br> | <u>Description</u><br> | ||
− | + | Concatenates (joins) two or more results files into one. Each results file must be from the same 1D/2D mesh. | |
<u>Examples</u><br> | <u>Examples</u><br> | ||
+ | <li><tt>dat_to_dat.exe -con results1_h.dat results2_h.dat results3_h.dat</tt></li> | ||
+ | Joins the three files into a single .dat file. | ||
+ | <li><tt>dat_to_dat.exe -con -typeH results1.xmdf results2.xmdf results3.xmdf</tt></li> | ||
+ | Joins the water level results contained in the .xmdf files into a single | ||
==Convert== | ==Convert== | ||
'''Input Switch: -conv'''<br> | '''Input Switch: -conv'''<br> | ||
<u>Description</u><br> | <u>Description</u><br> | ||
− | + | Converts between .dat and .xmdf format results. Not to be confused with -con (concatenate option described above)! | |
<u>Examples</u><br> | <u>Examples</u><br> | ||
+ | <li><tt>dat_to_dat.exe -conv -typeH -t99999 results1.xmdf</tt></li> | ||
+ | Converts the maximum water level results in the xmdf file into .dat file format. | ||
+ | <li><tt>dat_to_dat.exe -conv results1.xmdf</tt></li> | ||
+ | Converts all datasets and times in the .xmdf file into .dat file format. This will output a number of .dat files. | ||
+ | <li><tt>dat_to_dat.exe -conv results1_h.dat</tt></li> | ||
+ | Converts all times in the .dat file into xmdf file format. | ||
==Ensight (beta)== | ==Ensight (beta)== | ||
'''Input Switch: -ensight'''<br> | '''Input Switch: -ensight'''<br> | ||
<u>Description</u><br> | <u>Description</u><br> | ||
+ | Converts an .xmdf file (.dat not yet supported) into Ensight Gold format.<br> | ||
+ | If the input dataset is corner based (standard output) the Ensight results are output as scalar / vector '''per node''' (cell and triangle corners).<br> | ||
+ | If the result is high resolution (Map Output Format == xmdf high res) then the Ensight results are '''per element'''. For 2D cells this is based on the cell centre output, for triangles (1D water level lines) this is based on an interpolation of the triangle vertices. | ||
+ | The conversion produces the following output files:<br> | ||
+ | * Ensight case file; | ||
+ | * Ensight geometry file; | ||
+ | * Ensight results as either per node or per element depending on the input file. | ||
+ | '''This conversion is in beta stage and any feedback can be sent to support@tuflow.com.<br> | ||
+ | <u>Examples</u><br> | ||
+ | <li><tt>dat_to_dat.exe -ensight results1.xmdf</tt></li> | ||
+ | Converts all datasets in the xmdf file into Ensight format. | ||
− | |||
=General Options= | =General Options= | ||
− | + | ==Batch Mode== | |
+ | '''Input Switch: -b'''<br> | ||
+ | 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. | ||
+ | ==Output Filename== | ||
+ | '''Input Switch: -out "output_filename"'''<br> | ||
+ | Sets the output filename. | ||
+ | |||
{{Tips Navigation | {{Tips Navigation | ||
|uplink=[[TUFLOW_Utilities | Back to TUFLOW Utilities]] | |uplink=[[TUFLOW_Utilities | Back to TUFLOW Utilities]] |
Latest revision as of 05:47, 28 October 2012
- dat_to_dat.exe -max results_1_h.dat results_2_h.dat results_3_h.dat Extracts the maximum water level from the three .dat files.
- dat_to_dat.exe -max -typeH results_1.xmdf results_2.xmdf results_3.xmdf As above but for results stored in xmdf file format.
- dat_to_dat.exe -dif results_developed_h.dat results_existing_h.dat Extracts the difference in water level, the output is results_developed_h - results_existing_h for all timesteps.
- dat_to_dat.exe -dif -typeH -nowetdry results_developed.xmdf results_existing.xmdf Extracts the difference in water level for the maximum water level and suppresses the wet/dry check described above.
- dat_to_dat.exe -dur0.1 -typeD results.xmdf Extracts the duration in flooding above 0.1m deep.
- dat_to_dat.exe -k99999 results_h.dat Creates a new results file containing just the maximum from the water level results.
- dat_to_dat.exe -k2.5 -typeV results.xmdf Creates a new results file containing just velocity results for the 2.5 hour output.
- dat_to_dat.exe -rangeA1 -rangeB2.5 results_q.dat Creates a new results file containing the outputs between 1.0 and 2.5 hours. Both 1 and 2.5 hour outputs are included.
- dat_to_dat.exe -rangeA1 -rangeB2.5 results.xmdf As above but for xmdf input files.
- dat_to_dat.exe -r3 results_d.dat Creates a new output file which does not include the output at 3.
- dat_to_dat.exe -trim5 -typeV results.xmdf Creates a new output of velocity with any outputs greater than 5.0 set to 5.0.
- dat_to_dat.exe -times results_h.dat Creates an an output file "times.txt" which contains all timesteps that are contained in the results file.
- dat_to_dat.exe -xnfo -out xmdf_info.txt results.xmdf Creates an an output file with the specified filename "xmdf_info.txt", which contains information about the contents of the xmdf file.
- dat_to_dat.exe -va results_v.dat Outputs the velocity direction for all timesteps in the results_V.dat file.
- dat_to_dat.exe -con results1_h.dat results2_h.dat results3_h.dat Joins the three files into a single .dat file.
- dat_to_dat.exe -con -typeH results1.xmdf results2.xmdf results3.xmdf Joins the water level results contained in the .xmdf files into a single
- dat_to_dat.exe -conv -typeH -t99999 results1.xmdf Converts the maximum water level results in the xmdf file into .dat file format.
- dat_to_dat.exe -conv results1.xmdf Converts all datasets and times in the .xmdf file into .dat file format. This will output a number of .dat files.
- dat_to_dat.exe -conv results1_h.dat Converts all times in the .dat file into xmdf file format.
- Ensight case file;
- Ensight geometry file;
- Ensight results as either per node or per element depending on the input file.
- dat_to_dat.exe -ensight results1.xmdf Converts all datasets in the xmdf file into Ensight format.
Introduction
This utility performs a variety of operations on the TUFLOW 2D outputs. Valid formats are .xmdf (as of utility version 2012-10-AC) and .dat files. 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 table of contents can be used to jump to a desired operation.
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. If a maximum folder exists in an .xmdf file for the type specified, this dataset will be used, for dat files use -t99999 to use the maximum data in the .dat file.
Examples
Difference
Input Switch: -dif
Description
This can be used to compare two datasets. If a third files 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). The most common time is to take the difference at the flood peak, ie. specify t99999.
Examples
Duration
Input Switch: -dur<cut of value>
Description
Determines the duration in hours that the the results exceed the cut of value.
Note: A preferable approach is to use the .tcf file command: Time Output Cutoff Depths == <cut of value or values>. With this command specified TUFLOW tracks this on a timestep by timestep basis rather than post processing this at the map output interval.
Examples
Keep
Input Switch: -k<output time>
Description
Can be used to extract a single timestep from a results file. This is useful to extract the maximums to a separate file making it easier to transfer electronically. To keep a range of output times see the -range option below.
Examples
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
Remove
Input Switch: -r<output time>
Description
Creates a new output file and removes the output time from this.
Examples
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
Times
Input Switch: -times
Description
Creates a text file which contains the output times in the .dat or xmdf file. If no output filename is specified with the -out option the output file will be called "times.txt". For xmdf files see also the -xnfo option below.
Examples
XMDF Information
Input Switch: -xnfo
Description
Creates a text file which contains a list of the datasets contained within the .xmdf file. The number of output times and the output times are also exported to the text file.
Examples
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
Concatenate
Input Switch: -con
Description
Concatenates (joins) two or more results files into one. Each results file must be from the same 1D/2D mesh.
Examples
Convert
Input Switch: -conv
Description
Converts between .dat and .xmdf format results. Not to be confused with -con (concatenate option described above)!
Examples
Ensight (beta)
Input Switch: -ensight
Description
Converts an .xmdf file (.dat not yet supported) into Ensight Gold format.
If the input dataset is corner based (standard output) the Ensight results are output as scalar / vector per node (cell and triangle corners).
If the result is high resolution (Map Output Format == xmdf high res) then the Ensight results are per element. For 2D cells this is based on the cell centre output, for triangles (1D water level lines) this is based on an interpolation of the triangle vertices.
The conversion produces the following output files:
This conversion is in beta stage and any feedback can be sent to support@tuflow.com.
Examples
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.
Output Filename
Input Switch: -out "output_filename"
Sets the output filename.
Up |
---|
Back to TUFLOW Utilities |