Actions

UNK.DAT: Difference between revisions

From BAWiki

imported>Lang Guenther
(maximum interpolation radius added for water level, current velocity and bathymetry)
(Reference to ISO 8601 for the file untrim_grid.dat)
 
(2 intermediate revisions by one other user not shown)
Line 2: Line 2:
|name_de=UNK.DAT
|name_de=UNK.DAT
|filetype=unk.dat  
|filetype=unk.dat  
|version=October 2018
|version=January 2020
|version_descr=October 2018
|version_descr=January 2020
|significance=contains specific input data related to the post processor program UnK (unstructured k-model).  
|significance=contains specific input data related to the post processor program UnK (unstructured k-model).  
|filecontents=
|filecontents=
# block '''Input_Files''', with different information concerning required as well as optional input files:
# block '''Input_Files''', with different information concerning required as well as optional input files:
## key "'''Grid_File'''" with name and type ('''GITTER05''', '''UNTRIM_BAW''') for the file with the '''computational grid''' (filetype [[UNTRIM_GRID.DAT|untrim_grid.dat]] or [[GITTER05.DAT und GITTER05.BIN|gitter05.dat/bin]]).
## key "'''Grid_File'''" with name and type ('''GITTER05''', '''UNTRIM_BAW''') for the file with the '''computational grid''' (filetype [[UNTRIM_GRID.DAT|untrim_grid.dat]] or [[GITTER05.DAT und GITTER05.BIN|gitter05.dat/bin]]). For files of the type '''UNTRIM_BAW''', the temporal validity of the (bathymetric) data can be expressed in the file name according to [https://en.wikipedia.org/wiki/ISO_8601 ISO 8601]. Example: untrim_grid_1957-04-23_GMT_P1Y.dat.
## Key "'''Wind_Speed_File'''" with name and type ('''BDF''' or '''NETCDF''') plus a (optional) '''maximum interpolation radius''' in case wind data are defined on an irregular grid for the file with space- and time-dependent '''wind speed''' above the computational domain (filetypes [[DIRZ.BIN.R|dirz.bin.r]], [[DIRZ.BIN.I|dirz.bin.i]] and [[DIRZ.BIN|dirz.bin]] or [[CF-NETCDF.NC|cf-netcdf.nc]]). Remarks:
## Key "'''Wind_Speed_File'''" with name and type ('''BDF''' or '''NETCDF''') plus a (optional) '''maximum interpolation radius''' in case wind data are defined on an irregular grid for the file with space- and time-dependent '''wind speed''' above the computational domain (filetypes [[DIRZ.BIN.R|dirz.bin.r]], [[DIRZ.BIN.I|dirz.bin.i]] and [[DIRZ.BIN|dirz.bin]] or [[CF-NETCDF.NC|cf-netcdf.nc]]). Remarks:
##* regular grid data: this file must be created using program [[METDIDA]] or [[UNTRIM2007]]. The grid must be regular, which means that it must possess constant grid size DX in x direction as well as constant grid size DY in y direction. DX and DY may differ.
##* regular grid data: this file must be created using program [[METDIDA]] or [[UNTRIM2007]]. The grid must be regular, which means that it must possess constant grid size DX in x direction as well as constant grid size DY in y direction. DX and DY may differ.

Latest revision as of 10:06, 13 January 2020

Basic Information

File-Type

unk.dat

File-Form

FORMATTED

Version

January 2020

Description-Date

January 2020

Significance of the File

contains specific input data related to the post processor program UnK (unstructured k-model).

File-Contents (in Catchwords)

  1. block Input_Files, with different information concerning required as well as optional input files:
    1. key "Grid_File" with name and type (GITTER05, UNTRIM_BAW) for the file with the computational grid (filetype untrim_grid.dat or gitter05.dat/bin). For files of the type UNTRIM_BAW, the temporal validity of the (bathymetric) data can be expressed in the file name according to ISO 8601. Example: untrim_grid_1957-04-23_GMT_P1Y.dat.
    2. Key "Wind_Speed_File" with name and type (BDF or NETCDF) plus a (optional) maximum interpolation radius in case wind data are defined on an irregular grid for the file with space- and time-dependent wind speed above the computational domain (filetypes dirz.bin.r, dirz.bin.i and dirz.bin or cf-netcdf.nc). Remarks:
      • regular grid data: this file must be created using program METDIDA or UNTRIM2007. The grid must be regular, which means that it must possess constant grid size DX in x direction as well as constant grid size DY in y direction. DX and DY may differ.
      • irregular grid data: UNK automatically converts wind data onto a regular grid. In case no (optional) maximum interpolation radius is prescribed by the user UNK tries to compute a reasonable one automatically.
    3. Key "K_Model_Steering_File" mit Name und Typ (STEERING) der Datei mit den Eingabesteuerdaten für das Softwarepaket K_Model (Datei des Typs k_model.dat).
      Notice: this file must have been generated beforehand using program METDIDA.
    4. Key "K_Model_Steering_File" with name and type (STEERING) for the file with input data of the software package k_model (filetype k_model.dat).
    5. (optional) key "Water_Level_File" with space- and time-dependent water level within the computational domain.In case BDF use dirz.bin.r, dirz.bin.i and dirz.bin, or cf-netcdf.nc (NETCDF) otherwise plus (optional) maximum interpolation radius.
      Notice: For case BDF water level data must be available for the computational grid prescribed in key "Grid_File".
    6. (optional) key "Current_Velocity_File" with space- and time-dependent depth-averaged current velocity within the computational domain. In case BDF use dirz.bin.r, dirz.bin.i and dirz.bin, or cf-netcdf.nc (NETCDF) otherwise plus (optional) maximum interpolation radius.
      Notice 1: For case BDF current velocity data must be available for the computational grid prescribed in key "Grid_File";
      Notice 2: For case NETCDF file must be identical with "Water_Level_File".
    7. (optional) key "Bathymetry_Depth_File" with alternative or dynamic bathymetry depths within the computational domain. In case BDF use dirz.bin.r, dirz.bin.i and dirz.bin, or cf-netcdf.nc (NETCDF) otherwise plus (optional) maximum interpolation radius.
      Notice 1: For case BDF bathymetry depth data must be available for the computational grid prescribed in key "Grid_File".
      Notice 2: For case BDF the type of bathymetry depths must be consistent with the water level and velocity files; e.g. all files have alternative bathymetry depths;
      Notice 2: For case NETCDF file must be identical with "Water_Level_File".
  2. block Simulation_Times with information for the simulation period:
    1. key "Start_Time" with start time given as DD.MM.YYYY-hh:mm:ss.nnnnnnnnn.
    2. key "End_Time" with end time given as DD.MM.YYYY-hh:mm:ss.nnnnnnnnn.

Notice:

  • dictionary-file unk_dico.dat, usually present in directory $PROGHOME/dic/, will be automatically read by the application program in addition to the user-specified input file.

Programs using this Type of File

UNK

Example-File

please refer to $PROGHOME/examples/unk/unk.dat
and $PROGHOME/examples/unk/BSP_dynamic_bathymetry/unk.10min.dat


back to: File Descriptions


Overview