TDKWF
From BAWiki
Basic Information
Name of Program
TDKWF
VersionDate
February 2020
DescriptionDate
September 2022
Catchwords
postprocessor
analysis of numerically calculated results (2D/3D, profiledata as well as data at specific locations)
tidal characteristic numbers of water level
tidal characteristic numbers of morphodynamics
estuary
universal direct access format for 2D/3Ddata
universal direct access format for profiledata
universal direct access format for data at specific locations
parallelization using OpenMP
Short Description of Functionality
The program TDKWF is a postprocessor for different numerical models (e.g. TRIM2D, TRIM3D, TELEMAC2D, UNTRIM, UnTRIM2007, etc.). TDKWF automatically computes the tidal characteristic numbers of water level for a given set of results (universal direct access data format). Similarly the program can be used to compute the tidal characteristic numbers of morphodynamics (evolution of bottom bathymetry). The output of TDKWF may be visualized/displayed e.g. with the graphical postprocessors HVIEW2D (for 2D/3Ddata) or LQ2PRO (for profiledata).
Within the period of data analysis the following tidal characteristic numbers of water level are calculated (some numbers are optionally calculated):
 High Water Level (HW)
 Low Water Level (LW)
 Mean Tide Level
 Tidal Range
 Flood Period
 Ebb Period
 Flood Period:Ebb Period
 High Water Time (T_HW)
 Low Water Time (T_LW)
 Inundation Period
Additionally the following Tidal Characteristic Numbers of Morphodynamics are calculated (some numbers are optionally calculated):
 Maximum Tidal Depth
 Minimum Tidal Depth
 Mean Tidal Depth
 Tidal Depth Variation
 Tidal Depth Change
 Tidal Erosion
 Tidal Deposition
 Tidal Deposition/Tidal Erosion (dimensionless number)
For each characteristic number of water level as well as morphodynamics the following values are 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
For some characteristic numbers the mean values are computed using the length of a period, e.g. tide duration as weight. Maximum and minimum values are computed differently in dependence on the meaning of the characteristic number. Example: maximum high water (HW) corresponds to the largest (highest rise of) water level, whereas maximum low water (LW) is given by the smallest (deepest fall of) water level.
InputFiles
 general timeseries input data (filetype tdkwf.dat)
 synoptic data which shall be analysed (files of type dirz.bin.r, dirz.bin.i, and 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.i, and dirz.bin)
 informative printer file (filetype tdkwf.sdr)
 (optional) trace of program execution (filetype tdkwf.trc)
Methodology
At first the extreme events (HW and LW) 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, profiletopography or individual locations respectively. To arrive at 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.
In case of a time varying bathymetry (morphodynamics) the characteristic numbers of water level are evaluated using depth values corresponding to the minimum depth within the period of data analysis. This also holds true in case a so called alternative bathymetry is used, when the depth in the grid file is equivalent to the depth of the unerodible layer and the actual depth is constant in time but smaller than the depth specified in the grid file.
In all situations with actual depth different from depth given in the grid file, besides HW and LW also the values for maximum tidal depth as well as minimum tidal depth must be computed.
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/Tdkwf/
back to Program Descriptions