VTDK
From BAWiki
Basic Information
Name of Program
VTDK
VersionDate
February 2020
DescriptionDate
September 2022
Catchwords
postprocessor
differences for simulation results
differences for data analysis results
synoptic data
tidal characteristic numbers
tideindependent characteristic numbers
estuaries
alternative bathymetry
universal direct access data format for 2D/3Ddata
universal direct access data format for profiledata
universal direct access format for data at specific locations
Short Description of Functionality
The program VTDK is a postprocessor for different numerical models (e.g. TRIM2D, TRIM3D, TELEMAC2D, UNTRIM, UNTRIM2007 etc.). VTDK automatically computes either differences between synoptic data sets or differences between (tidal) characteristic numbers which were evaluated for different scenarious or calculated by different numerical models. 2D/3D data, profile data as well as location oriented data can be equivalently processed. For 2D/3D data the grids do not to need to coincide (e.g. number of nodes or location of nodes). The results of VTDK difference analyses may be visualized/displayed with the graphical postprocessors HVIEW2D (for 2D/3Ddata), LQ2PRO/VVIEW2D (for profiledata) or GVIEW2D (for locationoriented data).
If there exist for the same period of data analysis different analyses results A and B, the following quantities will be calculated for every tidal characteristic number:
 difference B  A for every tidal cycle
 maximum difference B  A
 minimum difference B  A
 significance for the deviation of the mean values
 difference of the mean values
 difference of the maximum values
 difference of the minimum values
For tideindependent characteristic numbers (same period of data analysis) the following quantities are calculated:
 difference B  A for the period of data analysis
For synoptic data sets (the data sets must cover the same period of time) the following differences are calculated:
 difference B  A for all dates of the synoptic data sets
InputFiles
 general input data (filetype vtdk.dat)
 (optional) data analyses for the systems A and B (files of type dirz.bin.r, dirz.bin.i, and dirz.bin)
 (optional) synoptic data sets for the systems A and B (files of type dirz.bin.r, dirz.bin.i, and dirz.bin)
 grid for 2D/3Ddata (filetype gitter05.dat/bin or filetype selafin or filetype untrim_grid.dat)
 or profiletopography for profiledata (filetype profil05.bin)
 or system file for specific locations (filetype [LOCATION_GRID.DAT
OutputFiles
 (optional) difference between the data analyses results (files of type dirz.bin.r, dirz.bin.i, and dirz.bin)
 (optional) difference between synoptic data sets (files of type dirz.bin.r, dirz.bin.i, and dirz.bin)
 (optional) difference between topographies (bathymetries) (files of type dirz.bin.r, dirz.bin.i, and dirz.bin)
 informative printer file (filetype vtdk.sdr)
 (optional) trace of program execution (filetype vtdk.trc)
Methodology
At the beginning the geometric differences are evaluated for the systems A and B (if there are any). These informations are needed to map the A results onto the B grid. Thereafter all results for the analysed events are read. The differences are calculated for each event as well as the maximum/minimum difference and also the statistical significance for the deviation of the means. Finally the differences for the mean, maximum and minimum values are evaluated. For synoptic data sets at the moment only differences for identical dates ar evaluated.
Program(s) to run before this Program
DATACONVERT, DIDAMERGE, DIDARENAME, DIDASPLIT, ENERF, LZKMF, LZKSF, LZKVF, LZKWF, PGCALC, TELEMAC2D, TM2DIDA, TR2DIDA, TR3DIDA, TDKLF, TDKSF, TDKVF, TDKWF, TR2APP, TRIM2D, TRIM3D, UNTRIM, UNTRIM2007
Program(s) to run after this Program
ABDF, DIDAMERGE, DIDARENAME, DIDASPLIT, ENERF, GVIEW2D, HVIEW2D, LQ2PRO, VVIEW2D, XTRDATA
Additional Information
Language
Fortran90
Additional software

Original Version
G. Lang
Maintenance
Documentation/Literature
please refer to $PROGHOME/examples/Vtdk/
back to Program Descriptions