Actions

TDKLF: Difference between revisions

From BAWiki

imported>BAWiki 3
mNo edit summary
(working group POS)
 
(3 intermediate revisions by one other user not shown)
Line 3: Line 3:
|name=TDKLF
|name=TDKLF
|version=8.x / September 2009  
|version=8.x / September 2009  
|version_descr=September 2009
|version_descr=September 2022
|catchwords=postprocessor <br />
|catchwords=postprocessor <br />
analysis of numerically calculated results (2D/3D, profile-data as well as data at specific locations) <br />
analysis of numerically calculated results (2D/3D, profile-data as well as data at specific locations) <br />
Line 16: Line 16:
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).
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):
Within the period of data analysis the following [[Tidal Characteristic Numbers of Bed Load Transport|tidal characteristic numbers of bed load transport]] are calculated (some numbers are optionally calculated):


* Flood Current
* Flood Current
:* bed load transport due to flood current  
:* [[Tidal Characteristic Numbers of Bed Load Transport|bed load transport due to flood current]]
* Ebb Current
* Ebb Current
:* bed load transport due to ebb current  
:* [[Tidal Characteristic Numbers of Bed Load Transport|bed load transport due to ebb current]]
* Tidal Cycle
* Tidal Cycle
:* residual bed load transport during a tidal cycle
:* [[Tidal Characteristic Numbers of Bed Load Transport|residual bed load transport during a tidal cycle]]
:* ratio bed load transport due to flood current : bed load transport due to ebb current  
:* [[Tidal Characteristic Numbers of Bed Load Transport|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.
Several fractions of sediment can be treated at the same time.
Line 31: Line 31:


* Flood Current
* Flood Current
:* action of eff. bed shear stress due to flood-current  
:* [[Tidal Characteristic Numbers of Eff. Bed Shear Stress Action#Flood Current|action of eff. bed shear stress due to flood-current]]
* Ebb Current
* Ebb Current
:* action of eff. bed shear stress due to ebb-current  
:* [[Tidal Characteristic Numbers of Eff. Bed Shear Stress Action#Flood Current|action of eff. bed shear stress due to ebb-current]]
* Tidal Cycle
* Tidal Cycle
:* residual action of the eff. bed shear stress
:* [[Tidal Characteristic Numbers of Eff. Bed Shear Stress Action#Flood Current|residual action of the eff. bed shear stress]]
:* ratio between flood- and ebb-current-induced action of the eff. bed shear stress  
:* [[Tidal Characteristic Numbers of Eff. Bed Shear Stress Action#Flood Current|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.
Notice: the word action is used above synonymously for integration over time of the eff. bed shear stress.
Line 48: Line 48:
|inputfiles=
|inputfiles=
# general '''input data''' (filetype [[TDKLF.DAT|tdklf.dat]])
# 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]] und [[DIRZ.BIN|dirz.bin]])
# '''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]])
# '''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''' profile-topography for profile-data (filetype [[PROFIL05.BIN|profil05.bin]])
::'''or''' system file for specific locations (filetype [[LOCATION_GRID.DAT|location_grid.dat]])  
::'''or''' system file for specific locations (filetype [[LOCATION_GRID.DAT|location_grid.dat]])  
|outputfiles=
|outputfiles=
# '''results of data analyses''' (files of type [[DIRZ.BIN.R|dirz.bin.r]], [[DIRZ.BIN.I|dirz.bin.i]] und [[DIRZ.BIN|dirz.bin]])
# '''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)
# informative '''printer''' file (filetype Tdklf.sdr)
# (optional) '''trace''' of program execution (filetype Tdklf.trc)  
# (optional) '''trace''' of program execution (filetype Tdklf.trc)  
Line 62: Line 62:
|language=Fortran90  
|language=Fortran90  
|add_software=-  
|add_software=-  
|contact_original=[mailto:günther.lang@baw.de G. Lang]
|contact_original=G. Lang
|contact_maintenance=[mailto:günther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|contact_maintenance=[mailto:pos.proghome@baw.de Working group POS]
|documentation=please refer to $PROGHOME/examples/Tdklf/
|documentation=please refer to $PROGHOME/examples/Tdklf/
}}
}}

Latest revision as of 11:16, 6 September 2022

Basic Information

Name of Program

TDKLF

Version-Date

8.x / September 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 bed load transport (several sediment fractions)
tidal characteristic numbers of eff. bed shear stress action
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 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
  • Ebb Current
  • Tidal Cycle

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
  • Ebb Current
  • Tidal Cycle

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:

  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 tdklf.dat)
  2. synoptic data which shall be analysed (files of type dirz.bin.r, dirz.bin.i and dirz.bin)
  3. grid for 2D/3D-data (filetype gitter05.dat/bin or filetype selafin 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.i and dirz.bin)
  2. informative printer file (filetype Tdklf.sdr)
  3. (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.

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


back to Program Descriptions


Overview