TDKVF
From BAWiki
Basic Information
Name of Program
TDKVF
VersionDate
9.x / July 2009
DescriptionDate
September 2022
Catchwords
postprocessor
analysis of numerically calculated results (2D/3D, profiledata as well as data at specific locations)
tidal characteristic numbers of current
estuaries
static (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
parallelization using OpenMP
Short Description of Functionality
The program TDKVF is a postprocessor for different numerical models (e.g. TRIM2D, TRIM3D, TELEMAC2D, UNTRIM, UnTRIM2007 etc.). TDKVF automatically computes the tidal characteristic numbers of current for a given set of results (universal direct access data format). Data analyses can only be performed for static (constant in time) bathymetry. Bathymetry data must be either present in the grid file or given as alternative bathymetry in the data file containing also the computational results for water level. The results of TDKVF analyses may be visualized/displayed with the graphical postprocessors HVIEW2D (for 2D/3Ddata) or LQ2PRO (for profiledata).
Within the period of data analysis the following tidal characteristic numbers of current are calculated (some numbers are optionally calculated):
 Flood Current
 Maximum Flood Current Velocity
 Mean Flood Current Velocity
 Flood Volume
 Flood Current Duration
 Slack Water Time of Flood Current
 Slack Water Duration around Slack Water Time of Flood Current
 Slack Water Dislocation of Flood Current
 Differences of Time of Maximum Flood Current between Different Locations
 Flood Path
 Tidal Cycle
 Residual Current
 Eulerian Residual Path
 Residual Flow
 Tide Volume
 Ratio Flood Current Duration : Ebb Current Duration
 Ratio Max. Flood Current Velocity : Max. Ebb Current Velocity
 Ratio Mean Flood Current Velocity : Mean Ebb Current Velocity
 Ratio Flood Path : Ebb Path
 Ratio Flood Volume : Ebb Volume
For each characteristic number of current the following values are being calculated for the period of data analysis:
 Characteristic value for each tide within the period of data analysis
 Mean value for the period of data analysis
 Maximum value for the period of data analysis
 Minimum value for the period of data analysis
InputFiles
 general input data (filetype tdkvf.dat)
 synoptic data which shall be analysed (files of type dirz.bin.r, dirz.bin.iand dirz.bin)
 grid for 2D/3Ddata (filetype gitter05.dat/bin or filetype untrim_grid.dat) or profiletopography for profiledata (filetype profil05.bin) or system file for specific locations (filetype location_grid.dat)
OutputFiles
 results of data analyses (files of type dirz.bin.r, dirz.bin.iand dirz.bin)
 informative printer file (filetype Tdkvf.sdr)
 (optional) trace of program execution (filetype Tdkvf.trc)
Methodology
At first some extreme events (HW and LW) for the water level are determined for a network of reference locations for each tidal cycle. This ensures the phasecorrect ordering of the events for all nodes of the computational grid respectively profiletopography. This first step is followed by a calculation of the times of slack water (ebb slack and flood slack). Thereafter the tidal characteristic numbers for the current are calculated at all nodal points, using the formerly calculated results at the reference locations. To obtain a more precise calculation of the times and values for all tidal characteristic numbers of water level a spline interpolation is used to interpolate between equidistant time series data at each nodal point. Drying and wetting of tidal flats is taken into account by the algorithm.
Program(s) to run before this Program
Program(s) to run after this Program
ABDF, DIDARENAME, DIDASPLIT, GVIEW2D, HVIEW2D, LQ2PRO, VTDK, VVIEW2D, XTRDATA
Additional Information
Language
Fortran90
Additional software

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