Actions

Difference between revisions of "TDKWF"

From BAWiki

imported>Mueller-hagedorn
(version date changed)
 
(7 intermediate revisions by 5 users not shown)
Line 2: Line 2:
 
|name_de=TDKWF
 
|name_de=TDKWF
 
|name=TDKWF
 
|name=TDKWF
|version=8.x / August 2009
+
|version=February 2020
|version_descr=June 2009
+
|version_descr=February 2014
 
|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 12: Line 12:
 
universal direct access format for profile-data<br />
 
universal direct access format for profile-data<br />
 
universal direct access format for data at specific locations<br />
 
universal direct access format for data at specific locations<br />
portable OpenMP multithreading<br />
+
parallelization using [http://openmp.org/wp/ OpenMP]<br />
 
|shortdescription=The program TDKWF is a postprocessor for different numerical models (e.g. TRIM-2D, TRIM-3D, TELEMAC-2D, 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/3D-data) or LQ2PRO (for profile-data).  
 
|shortdescription=The program TDKWF is a postprocessor for different numerical models (e.g. TRIM-2D, TRIM-3D, TELEMAC-2D, 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/3D-data) or LQ2PRO (for profile-data).  
  
Line 22: Line 22:
 
* [[Tidal Characteristic Numbers of Water Level#Flood Period|Flood Period]]
 
* [[Tidal Characteristic Numbers of Water Level#Flood Period|Flood Period]]
 
* [[Tidal Characteristic Numbers of Water Level#Ebb Period|Ebb Period]]
 
* [[Tidal Characteristic Numbers of Water Level#Ebb Period|Ebb Period]]
* [[Tidal Characteristic Numbers of Water Level#Flood Period:Ebb Period|Ratio Flood Period:Ebb Period (dimensionless number)]]
+
* [[Tidal Characteristic Numbers of Water Level#Flood Period:Ebb Period|Flood 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 Period|Inundation Period]]
 
* [[Tidal Characteristic Numbers of Water Level#Inundation Period|Inundation Period]]
* [[Tidal Characteristic Numbers of Water Level#|Difference of High Water Time T_HW]]
 
* [[Tidal Characteristic Numbers of Water Level#|Difference of Low Water Time T_LW]]
 
  
Additionally the following [[tidal characteristic numbers of morphodynamics]] are calculated (some numbers are optionally calculated):
+
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 Depth|Maximum Tidal Depth]]
* Minimum Tidal Depth
+
* [[Tidal Characteristic Numbers of Morphodynamics#Minimum Tidal Depth|Minimum Tidal Depth]]
* Mean Tidal Depth
+
* [[Tidal Characteristic Numbers of Morphodynamics#Mean Tidal Depth|Mean Tidal Depth]]
* Tidal Depth Variation
+
* [[Tidal Characteristic Numbers of Morphodynamics#Tidal Depth Variation|Tidal Depth Variation]]
* Tidal Depth Change
+
* [[Tidal Characteristic Numbers of Morphodynamics#Tidal Depth Change|Tidal Depth Change]]
* Tidal Erosion
+
* [[Tidal Characteristic Numbers of Morphodynamics#Tidal Erosion|Tidal Erosion]]
* Tidal Deposition
+
* [[Tidal Characteristic Numbers of Morphodynamics#Tidal Deposition|Tidal Deposition]]
* Tidal Deposition/Tidal Erosion (dimensionless number)  
+
* [[Tidal Characteristic Numbers of Morphodynamics#Tidal Deposition/Tidal Erosion|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:
 
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 '''time-series input data''' (filetype [[TDKWF.DAT|tdkwf.dat]])
 
# general '''time-series input data''' (filetype [[TDKWF.DAT|tdkwf.dat]])
 
# '''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]])
 
# '''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 or GITTER05.BIN|gitter05.dat/bin]] or filetype [[UNTRIM_GRID.DAT|untrim_grid.dat]])
+
# '''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''' 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]])
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.  
|vorlaufprogramme=[[DIDARENAME]], [[DIDASPLIT]], [[ZEITR]]
+
|preprocessor=[[DIDARENAME]], [[DIDASPLIT]], [[ZEITR]]
|nachlaufprogramme=[[ABDF]], [[DIDARENAME]], [[DIDASPLIT]], [[GVIEW2D]], [[HVIEW2D]], [[LQ2PRO]], [[VTDK]], [[VVIEW2D]], [[XTRDATA]]
+
|postprocessor=[[ABDF]], [[DIDARENAME]], [[DIDASPLIT]], [[GVIEW2D]], [[HVIEW2D]], [[LQ2PRO]], [[VTDK]], [[VVIEW2D]], [[XTRDATA]]
 
|language=Fortran90
 
|language=Fortran90
 
|add_software= -
 
|add_software= -

Latest revision as of 15:58, 17 February 2020

Basic Information

Name of Program

TDKWF

Version-Date

February 2020

Description-Date

February 2014

Catchwords

postprocessor
analysis of numerically calculated results (2D/3D, profile-data 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/3D-data
universal direct access format for profile-data
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. TRIM-2D, TRIM-3D, TELEMAC-2D, 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/3D-data) or LQ2PRO (for profile-data).

Within the period of data analysis the following tidal characteristic numbers of water level are calculated (some numbers are optionally calculated):

Additionally the following Tidal Characteristic Numbers of Morphodynamics are calculated (some numbers are optionally calculated):

For each characteristic number of water level as well as morphodynamics the following values are 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

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.

Input-Files

  1. general time-series input data (filetype tdkwf.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 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 tdkwf.sdr)
  3. (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 phase-correct ordering of the events for all nodes of the computational grid, profile-topography 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

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

G. Lang, A. Sehili, S. Spohr

Documentation/Literature

please refer to $PROGHOME/examples/Tdkwf/


back to Program Descriptions


Overview