View source for TDKSF

{{ProgramDescription
|name_de=TDKSF
|name=TDKSF
|version=10.x / August 2012 
|version_descr=September 2022 
|catchwords=postprocessor<br />
analysis of numerically calculated results (2D/3D, profile-data as well as data at specific locations)<br />
tidal characteristic numbers of salinity<br />
tidal characteristic numbers of suspended sediment<br />
tidal characteristic numbers of tracer load<br />
tidal characteristic numbers of temperature<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<br />   
|shortdescription=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
:* [[Tidal Characteristic Numbers of Salinity#Flood Current|Advective Salt Transport due to Flood Current]] 
* Ebb Current
:* [[Tidal Characteristic Numbers of Salinity#Ebb Current|Advective Salt Transport due to Ebb Current]] 
* Tidal Cycle
:* [[Tidal Characteristic Numbers of Salinity#Tidal Cycle|Maximum Salinity during a Tidal Cycle]]
:* [[Tidal Characteristic Numbers of Salinity#Tidal Cycle|Minimum Salinity during a Tidal Cycle]]
:* [[Tidal Characteristic Numbers of Salinity#Tidal Cycle|Mean Salinity during a Tidal Cycle]]
:* [[Tidal Characteristic Numbers of Salinity#Tidal Cycle|Variation of Salinity during a Tidal Cycle]]
:* [[Tidal Characteristic Numbers of Salinity#Tidal Cycle|Residual Advective Salt Transport during a Tidal Cycle]]
:* [[Tidal Characteristic Numbers of Salinity#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
:* [[Tidal Characteristic Numbers of Suspended Sediment Transport#Flood Current|Advective Suspended Sediment Transport due to Flood Current]] 
* Ebb Current
:* [[Tidal Characteristic Numbers of Suspended Sediment Transport#Ebb Current|Advective Suspended Sediment Transport due to Ebb Current]] 
* Tidal Cycle
:* [[Tidal Characteristic Numbers of Suspended Sediment Transport#Tidal Cycle|Maximum Suspended Sediment Concentration during a Tidal Cycle]]
:* [[Tidal Characteristic Numbers of Suspended Sediment Transport#Tidal Cycle|Minimum Suspended Sediment Concentration during a Tidal Cycle]]
:* [[Tidal Characteristic Numbers of Suspended Sediment Transport#Tidal Cycle|Mean Suspended Sediment Concentration during a Tidal Cycle]]
:* [[Tidal Characteristic Numbers of Suspended Sediment Transport#Tidal Cycle|Variation of Suspended Sediment Concentration during a Tidal Cycle]]
:* [[Tidal Characteristic Numbers of Suspended Sediment Transport#Tidal Cycle|Residual Advective Suspended Sediment Transport during a Tidal Cycle]]
:* [[Tidal Characteristic Numbers of Suspended Sediment Transport#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
:* [[Tidal Characteristic Numbers of Tracer Load#Flood Current|Advective Tracer Transport due to Flood Current]] 
* Ebb Current
:* [[Tidal Characteristic Numbers of Tracer Load#Ebb Current|Advective Tracer Transport due to Ebb Current]] 
* Tidal Cycle
:* [[Tidal Characteristic Numbers of Tracer Load#Tidal Cycle|Maximum Tracer Concentration during a Tidal Cycle]]
:* [[Tidal Characteristic Numbers of Tracer Load#Tidal Cycle|Minimum Tracer Concentration during a Tidal Cycle]]
:* [[Tidal Characteristic Numbers of Tracer Load#Tidal Cycle|Mean Tracer Concentration during a Tidal Cycle]]
:* [[Tidal Characteristic Numbers of Tracer Load#Tidal Cycle|Variation of Tracer Concentration during a Tidal Cycle]]
:* [[Tidal Characteristic Numbers of Tracer Load#Tidal Cycle|Residual Advective Tracer Transport during a Tidal Cycle]]
:* [[Tidal Characteristic Numbers of Tracer Load#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
:* [[Tidal Characteristic Numbers of Temperature#Flood Current|Advective Heat Transport due to Flood Current]] 
* Ebb Current
:* [[Tidal Characteristic Numbers of Temperature#Ebb Current|Advective Heat Transport due to Ebb Current]] 
* Tidal Cycle
:* [[Tidal Characteristic Numbers of Temperature#Tidal Cycle|Maximum Temperature during a Tidal Cycle]]
:* [[Tidal Characteristic Numbers of Temperature#Tidal Cycle|Minimum Temperature during a Tidal Cycle]]
:* [[Tidal Characteristic Numbers of Temperature#Tidal Cycle|Mean Temperature during a Tidal Cycle]]
:* [[Tidal Characteristic Numbers of Temperature#Tidal Cycle|Variation of Temperature during a Tidal Cycle]]
:* [[Tidal Characteristic Numbers of Temperature#Tidal Cycle|Residual Advective Heat Transport during a Tidal Cycle]]
:* [[Tidal Characteristic Numbers of Temperature#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|tdksf.dat]])
# synoptic results 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 [[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 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. 
|preprocessor=[[DIDARENAME]], [[DIDASPLIT]], [[ZEITR]]
|postprocessor=[[ABDF]], [[DIDARENAME]], [[DIDASPLIT]], [[GVIEW2D]], [[HVIEW2D]], [[LQ2PRO]], [[VTDK]], [[VVIEW2D]], [[XTRDATA]]
|language=Fortran90 
|add_software=- 
|contact_original=G. Lang
|contact_maintenance=[mailto:pos.proghome@baw.de Working group POS]
|documentation=please refer to $PROGHOME/examples/Tdksf/
}}