TDKSF
From BAWiki
Basic Information
Name of Program
TDKSF
Version-Date
10.x / August 2012
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 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/3D-data
universal direct access data format for profile-data
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. TRIM-2D, TRIM-3D, TELEMAC-2D, 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/3D-data), LQ2PRO (for profile-data) 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
Input-Files
- 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/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
- 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 phase-correct ordering of the events for all nodes of the computational grid respectively profile-topography 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