Actions

TR2REFRESH

From BAWiki

Basic Information

Name of Program

TR2REFRESH

Version-Date

V4.x / January 1999

Description-Date

April 2008

Catchwords

preprocessor
finite difference method
mathematical models TRIM-2D, TRIM-3D
manipulation of grid
actualization of bathymetry
deepening and refillment

Short Description of Functionality

The program TR2REFRESH serves as a preprocessor for the numerical models TRIM-2D and TRIM-3D. TR2REFRESH is able to modify bathymetry of a TRIM computational grid according to depth information stored on a finite element grid or along structural lines. The area where bathymetry shall be modified can be restricted to an area inside or outside an arbitrary polygon.

The actual nodal depth can be modified in the following different ways by means of different modification options::

  1. uncoditional deepening/refillment: at all modification nodes the actual depth is modified with the modification value
  2. unconditioanl setting of the depth: at all modification nodes the actual depth is set to the modification value
  3. conditional deepening: at all modification nodes where the actual depth is smaller than the modification value the depth will be set to the modification value. Areas which are already deeper than the depth given by the modification value remain unchanged
  4. conditional refillment: at all modification nodes where the actual depth is larger than the modification value the depth will be set to the modification value. Areas which are shallower than the depth given by the modification value remain unchanged.

The modification value follows from the actual location of a node within the grid (depths of the grid defining real bathymetry or the a so called dredger bathymetry).

Input-Files

  1. general input data (filetype tr2refresh.dat).
  2. (optional) surrounding polygon (filetype poly.dat).
  3. (optional) protected nodes (filetype nodes.save).
  4. computational grid and asis bathymetry (filetype tr2.topo.bin)
  5. (optional) bathymetry/dredger-bathymetry of the model area which shall be modified (filetype gitter05.dat/bin).

Output-Files

  1. modified bathymetry (filetype tr2.topo.bin).
  2. printer file (filetype tr2refresh.sdr).
  3. (optional) trace of program execution (filetype tr2refresh.trc).

Methodology

For all nodes of a TRIM computational grid which are lying in the area defined by a surrounding polygon new depth values are calculated first for the so called ZETA-locations of the grid cells from the the values defined by the bathymetry/dredger-bathymetry. From these results the values are interpolated onto the locations of the U- and V-nodes by means of one of the following approaches:

  • Depths at U- and V-points are mean values of the corresponding ZETA-points. Therefore the depths are approximated in the best possible way and the speed of the tidal wave can be calculated correctly. On the other hand side the volume of the system under investigation may be overestimated systematically.
  • Depths at U- and V-points are minimum values of the corresponding ZETA-points. This guarantees the best approximation of the volume, but depths at U- and V-points are underestimated systematically. Therefore computed wave speed may be also underestimated.

Furthermore depths at selected U- and/or V-positions (computational points of a TRIM-grid) may be optionally modified using one of the following methods:

  • mapping of depths along so called protection polygons (given in a file of type nodes.save) by means of interpolation;
  • direct setting of the depth values if the nodal locations (also prescribed in a file of type nodes.save) are identical with the locations of the U- and V- computational points.

These methods are activated if a file of type nodes.save has been prescribed in the input data file.

Program(s) to run before this Program

FD2TRIM, TC2TR2, UPDA2D

Program(s) to run after this Program

TR2VOR, TRGITTER05

Additional Information

Language

Fortran90

Additional software

-

Original Version

G. Lang

Maintenance

G. Lang

Documentation/Literature

$PROGHOME/examples/tr2refresh/


back to Program Descriptions


Overview