Difference between revisions of "TDKWF"
From BAWiki
imported>Muellerhagedorn 
Günther Lang (talk  contribs) (version date changed) 

(10 intermediate revisions by 5 users not shown)  
Line 2:  Line 2:  
name_de=TDKWF  name_de=TDKWF  
name=TDKWF  name=TDKWF  
−  version=  +  version=February 2020 
−  version_descr=  +  version_descr=February 2014 
catchwords=postprocessor<br />  catchwords=postprocessor<br />  
analysis of numerically calculated results (2D/3D, profiledata as well as data at specific locations)<br />  analysis of numerically calculated results (2D/3D, profiledata as well as data at specific locations)<br />  
Line 12:  Line 12:  
universal direct access format for profiledata<br />  universal direct access format for profiledata<br />  
universal direct access format for data at specific locations<br />  universal direct access format for data at specific locations<br />  
−  +  parallelization using [http://openmp.org/wp/ OpenMP]<br />  
shortdescription=The program TDKWF is a postprocessor for different numerical models (e.g. TRIM2D, TRIM3D, TELEMAC2D, UNTRIM, UnTRIM2007, etc.). TDKWF automatically computes the tidal characteristic numbers of water level for a given set of results (universal direct access data format). Similarly the program can be used to compute the tidal characteristic numbers of morphodynamics (evolution of bottom bathymetry). The output of TDKWF may be visualized/displayed e.g. with the graphical postprocessors HVIEW2D (for 2D/3Ddata) or LQ2PRO (for profiledata).  shortdescription=The program TDKWF is a postprocessor for different numerical models (e.g. TRIM2D, TRIM3D, TELEMAC2D, UNTRIM, UnTRIM2007, etc.). TDKWF automatically computes the tidal characteristic numbers of water level for a given set of results (universal direct access data format). Similarly the program can be used to compute the tidal characteristic numbers of morphodynamics (evolution of bottom bathymetry). The output of TDKWF may be visualized/displayed e.g. with the graphical postprocessors HVIEW2D (for 2D/3Ddata) or LQ2PRO (for profiledata).  
Within the period of data analysis the following [[Tidal Characteristic Numbers of Water Leveltidal characteristic numbers of water level]] are calculated (some numbers are optionally calculated):  Within the period of data analysis the following [[Tidal Characteristic Numbers of Water Leveltidal characteristic numbers of water level]] are calculated (some numbers are optionally calculated):  
−  * High Water HW  +  * [[Tidal Characteristic Numbers of Water Level#High Water Level (HW)High Water Level (HW)]] 
−  * Low Water LW  +  * [[Tidal Characteristic Numbers of Water Level#Low Water Level (LW)Low Water Level (LW)]] 
−  * Tidal  +  * [[Tidal Characteristic Numbers of Water Level#Mean Tide LevelMean Tide Level]] 
−  *  +  * [[Tidal Characteristic Numbers of Water Level#Tidal RangeTidal Range]] 
−  * Flood Period  +  * [[Tidal Characteristic Numbers of Water Level#Flood PeriodFlood Period]] 
−  * Ebb Period  +  * [[Tidal Characteristic Numbers of Water Level#Ebb PeriodEbb Period]] 
−  *  +  * [[Tidal Characteristic Numbers of Water Level#Flood Period:Ebb PeriodFlood Period:Ebb Period]] 
−  +  * [[Tidal Characteristic Numbers of Water Level#High Water Time (T_HW)High Water Time (T_HW)]]  
−  *  +  * [[Tidal Characteristic Numbers of Water Level#Low Water Time (T_LW)Low Water Time (T_LW)]] 
−  *  +  * [[Tidal Characteristic Numbers of Water Level#Inundation PeriodInundation Period]] 
−  Additionally the following [[  +  Additionally the following [[Tidal Characteristic Numbers of Morphodynamics]] are calculated (some numbers are optionally calculated): 
−  * Maximum Tidal Depth  +  * [[Tidal Characteristic Numbers of Morphodynamics#Maximum Tidal DepthMaximum Tidal Depth]] 
−  * Minimum Tidal Depth  +  * [[Tidal Characteristic Numbers of Morphodynamics#Minimum Tidal DepthMinimum Tidal Depth]] 
−  * Mean Tidal Depth  +  * [[Tidal Characteristic Numbers of Morphodynamics#Mean Tidal DepthMean Tidal Depth]] 
−  * Tidal Depth Variation  +  * [[Tidal Characteristic Numbers of Morphodynamics#Tidal Depth VariationTidal Depth Variation]] 
−  * Tidal Depth Change  +  * [[Tidal Characteristic Numbers of Morphodynamics#Tidal Depth ChangeTidal Depth Change]] 
−  * Tidal Erosion  +  * [[Tidal Characteristic Numbers of Morphodynamics#Tidal ErosionTidal Erosion]] 
−  * Tidal Deposition  +  * [[Tidal Characteristic Numbers of Morphodynamics#Tidal DepositionTidal Deposition]] 
−  * Tidal Deposition/Tidal Erosion (dimensionless number)  +  * [[Tidal Characteristic Numbers of Morphodynamics#Tidal Deposition/Tidal ErosionTidal Deposition/Tidal Erosion (dimensionless number)]] 
For each characteristic number of water level as well as morphodynamics the following values are calculated for the period of data analysis:  For each characteristic number of water level as well as morphodynamics the following values are calculated for the period of data analysis:  
Line 47:  Line 47:  
# general '''timeseries input data''' (filetype [[TDKWF.DATtdkwf.dat]])  # general '''timeseries input data''' (filetype [[TDKWF.DATtdkwf.dat]])  
# '''synoptic data''' which shall be analysed (files of type [[DIRZ.BIN.Rdirz.bin.r]], [[DIRZ.BIN.Idirz.bin.i]], and [[DIRZ.BINdirz.bin]])  # '''synoptic data''' which shall be analysed (files of type [[DIRZ.BIN.Rdirz.bin.r]], [[DIRZ.BIN.Idirz.bin.i]], and [[DIRZ.BINdirz.bin]])  
−  # '''grid''' for 2D/3Ddata (filetype [[GITTER05.DAT  +  # '''grid''' for 2D/3Ddata (filetype [[GITTER05.DAT and GITTER05.BINgitter05.dat/bin]] or filetype [[UNTRIM_GRID.DATuntrim_grid.dat]]) 
: '''or''' profiletopography for profiledata (filetype [[PROFIL05.BINprofil05.bin]])  : '''or''' profiletopography for profiledata (filetype [[PROFIL05.BINprofil05.bin]])  
: '''or''' system file for specific locations (filetype [[LOCATION_GRID.DATlocation_grid.dat]])  : '''or''' system file for specific locations (filetype [[LOCATION_GRID.DATlocation_grid.dat]])  
Line 59:  Line 59:  
In all situations with actual depth different from depth given in the grid file, besides HW and LW also the values for maximum tidal depth as well as minimum tidal depth must be computed.  In all situations with actual depth different from depth given in the grid file, besides HW and LW also the values for maximum tidal depth as well as minimum tidal depth must be computed.  
−    +  preprocessor=[[DIDARENAME]], [[DIDASPLIT]], [[ZEITR]] 
−    +  postprocessor=[[ABDF]], [[DIDARENAME]], [[DIDASPLIT]], [[GVIEW2D]], [[HVIEW2D]], [[LQ2PRO]], [[VTDK]], [[VVIEW2D]], [[XTRDATA]] 
language=Fortran90  language=Fortran90  
add_software=   add_software=  
Revision as of 15:58, 17 February 2020
Basic Information
Name of Program
TDKWF
VersionDate
February 2020
DescriptionDate
February 2014
Catchwords
postprocessor
analysis of numerically calculated results (2D/3D, profiledata as well as data at specific locations)
tidal characteristic numbers of water level
tidal characteristic numbers of morphodynamics
estuary
universal direct access format for 2D/3Ddata
universal direct access format for profiledata
universal direct access format for data at specific locations
parallelization using OpenMP
Short Description of Functionality
The program TDKWF is a postprocessor for different numerical models (e.g. TRIM2D, TRIM3D, TELEMAC2D, UNTRIM, UnTRIM2007, etc.). TDKWF automatically computes the tidal characteristic numbers of water level for a given set of results (universal direct access data format). Similarly the program can be used to compute the tidal characteristic numbers of morphodynamics (evolution of bottom bathymetry). The output of TDKWF may be visualized/displayed e.g. with the graphical postprocessors HVIEW2D (for 2D/3Ddata) or LQ2PRO (for profiledata).
Within the period of data analysis the following tidal characteristic numbers of water level are calculated (some numbers are optionally calculated):
 High Water Level (HW)
 Low Water Level (LW)
 Mean Tide Level
 Tidal Range
 Flood Period
 Ebb Period
 Flood Period:Ebb Period
 High Water Time (T_HW)
 Low Water Time (T_LW)
 Inundation Period
Additionally the following Tidal Characteristic Numbers of Morphodynamics are calculated (some numbers are optionally calculated):
 Maximum Tidal Depth
 Minimum Tidal Depth
 Mean Tidal Depth
 Tidal Depth Variation
 Tidal Depth Change
 Tidal Erosion
 Tidal Deposition
 Tidal Deposition/Tidal Erosion (dimensionless number)
For each characteristic number of water level as well as morphodynamics the following values are 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
For some characteristic numbers the mean values are computed using the length of a period, e.g. tide duration as weight. Maximum and minimum values are computed differently in dependence on the meaning of the characteristic number. Example: maximum high water (HW) corresponds to the largest (highest rise of) water level, whereas maximum low water (LW) is given by the smallest (deepest fall of) water level.
InputFiles
 general timeseries input data (filetype tdkwf.dat)
 synoptic data 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 tdkwf.sdr)
 (optional) trace of program execution (filetype tdkwf.trc)
Methodology
At first the extreme events (HW and LW) are determined 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, profiletopography or individual locations respectively. To arrive at a more precise calculation of the times and values for all tidal characteristic numbers of water level 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.
In case of a time varying bathymetry (morphodynamics) the characteristic numbers of water level are evaluated using depth values corresponding to the minimum depth within the period of data analysis. This also holds true in case a so called alternative bathymetry is used, when the depth in the grid file is equivalent to the depth of the unerodible layer and the actual depth is constant in time but smaller than the depth specified in the grid file.
In all situations with actual depth different from depth given in the grid file, besides HW and LW also the values for maximum tidal depth as well as minimum tidal depth must be computed.
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
Maintenance
Documentation/Literature
please refer to $PROGHOME/examples/Tdkwf/
back to Program Descriptions