View source for TDKLF

{{ProgramDescription
|name_de=TDKLF
|name=TDKLF
|version=8.x / September 2009 
|version_descr=September 2009
|catchwords=postprocessor <br />
analysis of numerically calculated results (2D/3D, profile-data as well as data at specific locations) <br />
tidal characteristic numbers of bed load transport (several sediment fractions) <br />
tidal characteristic numbers of eff. bed shear stress action <br />
estuaries <br />
static (alternative bathymetry) <br />
universal direct access data format for 2D/3D-data <br />
universal direct access data format for profile-data <br />
universal direct access format for data at specific locations 
|shortdescription=
The program TDKLF is a postprocessor for different numerical models (e.g. TRIM-2D, TRIM-3D, TELEMAC-2D, UNTRIM2007  etc.). TDKLF automatically computes some tidal characteristic numbers of bed load transport or eff. bed shear stress action for a given set of results (universal direct access data format). The results of TDKLF 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 bed load transport are calculated (some numbers are optionally calculated):

* Flood Current
:* bed load transport due to flood current 
* Ebb Current
:* bed load transport due to ebb current 
* Tidal Cycle
:* residual bed load transport during a tidal cycle
:* ratio bed load transport due to flood current : bed load transport due to ebb current 

Several fractions of sediment can be treated at the same time.

Within the period of data analysis the following tidal characteristic numbers of eff. bed shear stress action are calculated (some numbers are optionally calculated):

* Flood Current
:* action of eff. bed shear stress due to flood-current 
* Ebb Current
:* action of eff. bed shear stress due to ebb-current 
* Tidal Cycle
:* residual action of the eff. bed shear stress
:* ratio between flood- and ebb-current-induced action of the eff. bed shear stress 

Notice: the word action is used above synonymously for integration over time of the eff. bed shear stress.

For each characteristic number of bed load transport 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 [[TDKLF.DAT|tdklf.dat]])
# '''synoptic data''' which shall be analysed (files of type [[DIRZ.BIN.R|dirz.bin.r]], [[DIRZ.BIN.I|dirz.bin.i]] and [[DIRZ.BIN|dirz.bin]])
# '''grid''' for 2D/3D-data (filetype [[GITTER05.DAT and GITTER05.BIN|gitter05.dat/bin]] or filetype [[SELAFIN|selafin]] or filetype [[UNTRIM_GRID.DAT|untrim_grid.dat]])
::'''or''' profile-topography for profile-data (filetype [[PROFIL05.BIN|profil05.bin]])
::'''or''' system file for specific locations (filetype [[LOCATION_GRID.DAT|location_grid.dat]]) 
|outputfiles=
# '''results of data analyses''' (files of type [[DIRZ.BIN.R|dirz.bin.r]], [[DIRZ.BIN.I|dirz.bin.i]] and [[DIRZ.BIN|dirz.bin]])
# informative '''printer''' file (filetype Tdklf.sdr)
# (optional) '''trace''' of program execution (filetype Tdklf.trc) 
|methodology=
At first some extreme events (HW and LW) for the water level are determined together with the times for slack water (ebb slack and flood slack) 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. Thereafter the tidal characteristic numbers 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 a spline interpolation is used to interpolate between equidistant time series data (water level, current velocity and bed load transport rate or eff. bed shear stress) at each nodal point. Drying and wetting of tidal flats is taken into account by the algorithm. 
|preprocessor=[[DIDARENAME]], [[DIDASPLIT]], [[ZEITR]]
|postprocessor=[[ABDF]], [[DIDARENAME]], [[DIDASPLIT]], [[GVIEW2D]], [[HVIEW2D]], [[LQ2PRO]], [[VTDK]], [[VVIEW2D]], [[XTRDATA]]
|language=Fortran90 
|add_software=- 
|contact_original=[mailto:günther.lang@baw.de G. Lang]
|contact_maintenance=[mailto:günther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|documentation=please refer to $PROGHOME/examples/Tdklf/
}}