View source for TR2REFRESH

{{ProgramDescription
|name_de=TR2REFRESH
|name=TR2REFRESH
|version=V4.x / January 1999 
|version_descr=April 2008 
|catchwords=
preprocessor<br />
finite difference method<br />
mathematical models [[Mathematical Model TRIM-2D|TRIM-2D]], [[Mathematical Model TRIM-3D|TRIM-3D]]<br />
manipulation of grid<br />
actualization of bathymetry<br />
deepening and refillment 
|shortdescription=
The program TR2REFRESH serves as a preprocessor for the numerical models [[Mathematical Model TRIM-2D|TRIM-2D]] and [[Mathematical Model TRIM-3D|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::
# uncoditional deepening/refillment: at all modification nodes the actual depth is modified with the modification value
# unconditioanl setting of the depth: at all modification nodes the actual depth is set to the modification value
# 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
# 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). 
|inputfiles=
# general input data (filetype [[TR2REFRESH.DAT|tr2refresh.dat]]).
# (optional) surrounding polygon (filetype [[POLY.DAT|poly.dat]]).
# (optional) protected nodes (filetype [[NODES.SAVE|nodes.save]]).
# computational grid and asis bathymetry (filetype [[TR2.TOPO.BIN|tr2.topo.bin]])
# (optional) bathymetry/dredger-bathymetry of the model area which shall be modified (filetype [[GITTER05.DAT and GITTER05.BIN|gitter05.dat/bin]]). 
|outputfiles=
# modified bathymetry (filetype [[TR2.TOPO.BIN|tr2.topo.bin]]).
# printer file (filetype tr2refresh.sdr).
# (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|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|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|nodes.save]] has been prescribed in the input data file. 
|preprocessor=[[FD2TRIM]], [[TC2TR2]], [[UPDA2D]]
|postprocessor=[[TR2VOR]], [[TRGITTER05]]
|language=Fortran90
|add_software=-
|contact_original=[mailto:guenther.lang@baw.de G. Lang]
|contact_maintenance=[mailto:guenther.lang@baw.de G. Lang]
|documentation=$PROGHOME/examples/tr2refresh/ 
}}