UNTRIM2007: Difference between revisions

Latest revision as of 10:20, 12 December 2022

Basic Information

Name of Program

untrim2007

Version-Date

February 2020

Description-Date

January 2022

Catchwords

numerical simulation
finite difference method
finite volume method
unstructured orthogonal grid
two-dimensional, three-dimensional
unsteady, non-linear
hydrostatic, non-hydrostatic
reynoldsaveraged Navier Stokes equations (RANS)
tidal dynamics (long waves)
transport of conservative substances (salt, temperature, suspended sediments, tracers)
two-equation turbulence modelling
numerical method UNTRIM2007
sub-model for water density EQS
sub-model for mixing length turbulence modelling MIX
sub-model for settling velocity modelling SV
sub-model for morphodynamics SEDIMORPH
sub-model for dredging and disposal DredgeSim
sub-model for short waves K-Model
portable SMP-programming using OpenMP
storage of the content of the ASCII input control files in netcdf.nc (as a variable)
storage of MD5 hash values of input files in netcdf.nc (as a variable)

Acknowledgment: This project took advantage of netCDF software developed by UCAR/Unidata (www.unidata.ucar.edu/software/netcdf/).

Short Description of Functionality

Method

The three-dimensional finite difference / finite volume numerical model UNTRIM2007 can be used to simulate flow and transport processes in different free-surface flow problems. In contrast to conventional finite difference methods UNTRIM2007 is able to operate on an unstructured orthogonal grid.

Physical Processes

The following physical processes are currently taken into account by UnTRIM2007:

reynoldsaveraged Navier-Stokes equations (RANS)
- local acceleration (inertia)
- advective acceleration
- Coriolis acceleration
- barotropic pressure gradient
- baroclinic pressure gradient
- hydrostatic or non-hydrostatic pressure
- horizontal turbulent viscosity
- vertical turbulent viscosity influenced by density stratification
- bottom friction
- wind friction
- sources and sinks
- bottom evolution
- horizontal acceleration due to wave effects (by means of radiation stress)
- morphodynamic bathymetry
- body forces due to short waves
transport of substances
- local rate of change of concentration
- advective rate of change of concentration
- optional flux limiter : Minmod, van Leer or Superbee
- horizontal turbulent diffusivity
- vertical turbulent diffusivity influenced by density stratification
- settling of particles, deposition and erosion (for suspended sediments)
- sources and sinks
- sinks with immediate return inflow at a different location, with optional modification of inflow-temperature as well as -salinity
turbulence modelling
- constant
- mixing length (various parametrizations)
- two-equation model (turbulent kinetic energy, generic length scale)

Primary Computational Results

free surface elevation
bottom bathymetry and bed evolution rate
current velocity
concentration of substances (salinity, temperature, suspended load, tracers)
turbulent kinetic energy and turbulent length scale
hydrodynamic pressure

Input-Files

general input data (filetype untrim2007.dat)
all other input data are described in the aforementioned input file as well as in the further used steering files listed there.
(optional) DMQS metadata can be set in the batch script of the simulation and in the central project script, see http://wiki.baw.de/en/index.php/Metadata_of_Model_results_in_Coastal_Engineering .
(optional) If DMQS metadata has not been set global metadata stored in files of type nc_meta.dat) can be an alternative. In case file nc_meta.dat is present in the current working directory, this file will be read by the application. Otherwise the respective file from $PROGHOME/cfg will be read.

Output-Files

all output data files are either described with filteype untrim2007.dat or with all other filteypes used in the aforementioned master input file.
CF-NETCDF.NC files can be generated optionally.
printer file with informations on program execution (filetype untrim2007.master.sdr).
(optional) trace file (filetype untrim2007.trc).

Methodology

-

Program(s) to run before this Program

NCDVAR, NCMERGE, UTRPRE, UTRRND

Program(s) to run after this Program

ABDF, DATACONVERT, DAVIT, DIDAMINTQ, GVIEW2D, HVIEW2D, NCAGGREGATE, NCANALYSE, NCAUTO, NCCHUNKIE, NCCUTOUT, NCDELTA, NCDVAR, NCMERGE, NCPLOT, NC2TABLE, UNTRIM2007MONITOR, VTDK, VVIEW2D, XTRLQ2, ZEITR

Additional Information

Language

Fortran90

Additional software

-

Original Version

V. Casulli, G. Lang

Maintenance

Working Group SIM

Documentation/Literature

please refer to $PROGHOME/examples/untrim2007/

back to Program Descriptions

Overview

@@ Line 2: / Line 2: @@
 |name_de=UNTRIM2007
 |name=untrim2007
-|version=May 2015
+|version=February 2020
-|version_descr=November 2015
+|version_descr=January 2022
 |catchwords=
 numerical simulation<br />
@@ Line 24: / Line 24: @@
 sub-model for short waves K-Model<br />
 portable SMP-programming using [http://openmp.org/wp/ OpenMP]<br />
+storage of the content of the ASCII input control files in [[CF-NETCDF.NC|netcdf.nc]] (as a variable)<br />
+storage of [https://en.wikipedia.org/wiki/MD5 MD5 hash values] of input files in [[CF-NETCDF.NC|netcdf.nc]] (as a variable)<br />
   Acknowledgment: ''This project took advantage of netCDF software developed by UCAR/Unidata ([http://www.unidata.ucar.edu/software/netcdf/ www.unidata.ucar.edu/software/netcdf/]).''
@@ Line 78: / Line 80: @@
 # general '''input data''' (filetype  [[UNTRIM_2007.DAT|untrim2007.dat]])
 # all other input data are described in the aforementioned input file as well as in the further used steering files listed there.
-# (optional) '''global metadata''' (filteype [[NC_META.DAT|nc_meta.dat]]). In case file ''nc_meta.dat'' is present in the current working directory, this file will be read by the application. Otherwise the respective file from $PROGHOME/cfg will be read.
+# (optional) DMQS metadata can be set in the batch script of the simulation and in the central project script, see http://wiki.baw.de/en/index.php/Metadata_of_Model_results_in_Coastal_Engineering .
+# (optional) If DMQS metadata has not been set '''global metadata''' stored in files of type [[NC_META.DAT|nc_meta.dat]]) can be an alternative. In case file ''nc_meta.dat'' is present in the current working directory, this file will be read by the application. Otherwise the respective file from $PROGHOME/cfg will be read.
 |outputfiles=
 # all output data files are either described with filteype [[UNTRIM_2007.DAT|untrim2007.dat]] or with all other filteypes used in the aforementioned master input file.
@@ Line 87: / Line 90: @@
   -
 |preprocessor=
-[[UTRPRE]], [[UTRRND]]
+[[NCDVAR]], [[NCMERGE]], [[UTRPRE]], [[UTRRND]]
 |postprocessor=
-[[ABDF]], [[DATACONVERT]], [[DIDAMINTQ]], [[GVIEW2D]], [[HVIEW2D]], [[NCAGGREGATE]], [[NCANALYSE]], [[NCAUTO]], [[NCDELTA]], [[NCPLOT]], [[UNTRIM2007MONITOR]], [[VTDK]], [[VVIEW2D]], [[XTRLQ2]], [[ZEITR]]
+[[ABDF]], [[DATACONVERT]], [[DAVIT]], [[DIDAMINTQ]], [[GVIEW2D]], [[HVIEW2D]], [[NCAGGREGATE]], [[NCANALYSE]], [[NCAUTO]], [[NCCHUNKIE]], [[NCCUTOUT]], [[NCDELTA]], [[NCDVAR]], [[NCMERGE]], [[NCPLOT]], [[NC2TABLE]], [[UNTRIM2007MONITOR]], [[VTDK]], [[VVIEW2D]], [[XTRLQ2]], [[ZEITR]]
 |language=Fortran90
 |add_software= -
 |contact_original=[mailto:info.hamburg@baw.de V. Casulli], [mailto:guenther.lang@baw.de G. Lang]
-|contact_maintenance=[mailto:elisabeth.rudolph@baw.de E. Rudolph], [mailto:aissa.sehili@baw.de A. Sehili], [mailto:holger.weilbeer@baw.de H. Weilbeer]
+|contact_maintenance=[mailto:sim.proghome@baw.de Working Group SIM]
 |documentation=
 * please refer to $PROGHOME/examples/untrim2007/
 }}