TDKVF

Basic Information

Name of Program

TDKVF

Version-Date

9.x / July 2009

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 current
estuaries
static (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
parallelization using OpenMP

Short Description of Functionality

The program TDKVF is a postprocessor for different numerical models (e.g. TRIM-2D, TRIM-3D, TELEMAC-2D, 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/3D-data) or LQ2PRO (for profile-data).

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

• Ebb Current
  • Maximum Ebb Current Velocity
  • Mean Ebb Current Velocity
  • Ebb Volume
  • Ebb Current Duration
  • Slack Water Time of Ebb Current
  • Slack Water Duration around Slack Water Time of Ebb Current
  • Slack Water Dislocation of Ebb Current
  • Differences of Time of Maximum Ebb Current between Different Locations
  • Ebb 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:

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

Input-Files

1. general input data (filetype tdkvf.dat)
2. synoptic data which shall be analysed (files of type dirz.bin.r, dirz.bin.iand 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.iand dirz.bin)
2. informative printer file (filetype Tdkvf.sdr)
3. (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 phase-correct ordering of the events for all nodes of the computational grid respectively profile-topography. 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

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/Tdkvf/

---

back to Program Descriptions

---

Overview