TDKWF

Basic Information

Name of Program

TDKWF

Version-Date

February 2020

Description-Date

September 2022

Catchwords

postprocessor
analysis of numerically calculated results (2D/3D, profile-data 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/3D-data
universal direct access format for profile-data
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. TRIM-2D, TRIM-3D, TELEMAC-2D, 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/3D-data) or LQ2PRO (for profile-data).

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:

1. Characteristic value for each tide within the period of data analysis
2. Mean value for the period of data analysis
3. Maximum value for the period of data analysis
4. 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.

Input-Files

1. general time-series input data (filetype tdkwf.dat)
2. synoptic data which shall be analysed (files of type dirz.bin.r, dirz.bin.i, and dirz.bin)
3. grid for 2D/3D-data (filetype gitter05.dat/bin 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. results of data analyses (files of type dirz.bin.r, dirz.bin.i, and dirz.bin)
2. informative printer file (filetype tdkwf.sdr)
3. (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 phase-correct ordering of the events for all nodes of the computational grid, profile-topography 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

DIDARENAME, DIDASPLIT, ZEITR

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

Working group POS

Documentation/Literature

please refer to $PROGHOME/examples/Tdkwf/

---

back to Program Descriptions

---

Overview