VTDK

Basic Information

Name of Program

VTDK

Version-Date

February 2020

Description-Date

September 2022

Catchwords

postprocessor
differences for simulation results
differences for data analysis results
synoptic data
tidal characteristic numbers
tide-independent characteristic numbers
estuaries
alternative bathymetry
universal direct access data format for 2D/3D-data
universal direct access data format for profile-data
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. TRIM-2D, TRIM-3D, TELEMAC-2D, 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/3D-data), LQ2PRO/VVIEW2D (for profile-data) or GVIEW2D (for location-oriented 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:

1. difference B - A for every tidal cycle
2. maximum difference B - A
3. minimum difference B - A
4. significance for the deviation of the mean values
5. difference of the mean values
6. difference of the maximum values
7. difference of the minimum values

For tide-independent characteristic numbers (same period of data analysis) the following quantities are calculated:

1. 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:

1. difference B - A for all dates of the synoptic data sets

Input-Files

1. general input data (filetype vtdk.dat)
2. (optional) data analyses for the systems A and B (files of type dirz.bin.r, dirz.bin.i, and dirz.bin)
3. (optional) synoptic data sets for the systems A and B (files of type dirz.bin.r, dirz.bin.i, and dirz.bin)
4. grid for 2D/3D-data (filetype gitter05.dat/bin or filetype selafin or filetype untrim_grid.dat)

   or profile-topography for profile-data (filetype profil05.bin)

   or system file for specific locations (filetype [LOCATION_GRID.DAT

Output-Files

1. (optional) difference between the data analyses results (files of type dirz.bin.r, dirz.bin.i, and dirz.bin)
2. (optional) difference between synoptic data sets (files of type dirz.bin.r, dirz.bin.i, and dirz.bin)
3. (optional) difference between topographies (bathymetries) (files of type dirz.bin.r, dirz.bin.i, and dirz.bin)
4. informative printer file (filetype vtdk.sdr)
5. (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, TELEMAC-2D, TM2DIDA, TR2DIDA, TR3DIDA, TDKLF, TDKSF, TDKVF, TDKWF, TR2APP, TRIM-2D, TRIM-3D, 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

Working group POS

Documentation/Literature

please refer to $PROGHOME/examples/Vtdk/

---

back to Program Descriptions

---

Overview