TDKSF
From BAWiki
Basic Information
Name of Program
TDKSF
VersionDate
10.x / August 2012
DescriptionDate
September 2022
Catchwords
postprocessor
analysis of numerically calculated results (2D/3D, profiledata as well as data at specific locations)
tidal characteristic numbers of salinity
tidal characteristic numbers of suspended sediment
tidal characteristic numbers of tracer load
tidal characteristic numbers of temperature
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
Short Description of Functionality
The program TDKSF is a postprocessor for different numerical models (e.g. TRIM2D, TRIM3D, TELEMAC2D, UNTRIM, UNTRIM2007, etc.). TDKSF automatically computes the
 tidal characteristic numbers of salinity,
 tidal characteristic numbers of suspended sediment,
 tidal characteristic numbers of tracer load, or the
 tidal characteristic numbers of temperature.
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 TDKSF analyses may be visualized/displayed with the graphical postprocessors HVIEW2D (for 2D/3Ddata), LQ2PRO (for profiledata) or GVIEW2D (for specific locations).
Within the period of data analysis the following tidal characteristic numbers of salinity are calculated (some numbers are optionally calculated):
 Flood Current
 Ebb Current
 Tidal Cycle
 Maximum Salinity during a Tidal Cycle
 Minimum Salinity during a Tidal Cycle
 Mean Salinity during a Tidal Cycle
 Variation of Salinity during a Tidal Cycle
 Residual Advective Salt Transport during a Tidal Cycle
 Ratio Advective Salt Transport due to Flood Current : Advective Salt Transport due to Ebb Current
Within the period of data analysis the following tidal characteristic numbers of suspended sediment transport are calculated (some numbers are optionally calculated):
 Flood Current
 Ebb Current
 Tidal Cycle
 Maximum Suspended Sediment Concentration during a Tidal Cycle
 Minimum Suspended Sediment Concentration during a Tidal Cycle
 Mean Suspended Sediment Concentration during a Tidal Cycle
 Variation of Suspended Sediment Concentration during a Tidal Cycle
 Residual Advective Suspended Sediment Transport during a Tidal Cycle
 Ratio Advective Suspended Sediment Transport due to Flood Current : Advective Suspended Sediment Transport due to Ebb Current
Within the period of data analysis the following tidal characteristic numbers of tracer transport are calculated (some numbers are optionally calculated):
 Flood Current
 Ebb Current
 Tidal Cycle
 Maximum Tracer Concentration during a Tidal Cycle
 Minimum Tracer Concentration during a Tidal Cycle
 Mean Tracer Concentration during a Tidal Cycle
 Variation of Tracer Concentration during a Tidal Cycle
 Residual Advective Tracer Transport during a Tidal Cycle
 Ratio Advective Tracer Transport due to Flood Current : Advective Tracer Transport due to Ebb Current
Within the period of data analysis the following tidal characteristic numbers of temperature (heat) transport are calculated (some numbers are optionally calculated):
 Flood Current
 Ebb Current
 Tidal Cycle
 Maximum Temperature during a Tidal Cycle
 Minimum Temperature during a Tidal Cycle
 Mean Temperature during a Tidal Cycle
 Variation of Temperature during a Tidal Cycle
 Residual Advective Heat Transport during a Tidal Cycle
 Ratio Advective Heat Transport due to Flood Current : Advective Heat Transport due to Ebb Current
For each characteristic number of salinity, suspended sediment concentration, tracer concentration or temperature 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 tdksf.dat)
 synoptic results 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 Tdksf.sdr)
 (optional) trace of program execution (filetype Tdksf.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 phasecorrect ordering of the events for all nodes of the computational grid respectively profiletopography or specific locations. 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 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/Tdksf/
back to Program Descriptions