Actions

DATACONVERT.DAT: Difference between revisions

From BAWiki

imported>BAWiki 3
mNo edit summary
imported>Lang Guenther
(conversion and merge of (DWD) NetCDF data files)
Line 2: Line 2:
|name_de=DATACONVERT.DAT
|name_de=DATACONVERT.DAT
|filetype=dataconvert.dat  
|filetype=dataconvert.dat  
|version=6.x / December 2009
|version=7.x / August 2010
|version_descr=December 2009
|version_descr=August 2010
|significance=Contains various input steering data for the postprocessor DATACONVERT
|significance=Contains various input steering data for the postprocessor DATACONVERT
|filecontents=
|filecontents=
Contains various input steering data, which are required during conversion of computational results for the integrated modelling system [[Delft3D]]. Original data are stored in NetCDF data files and are going to be converted and written to BAW-specific BDF data files.
Contains various input steering data, which are required during  
* '''mode 1''' , conversion of computational results for the integrated modelling system [[Mathematical Model DELFT3D|Delft3D]]. Original data are stored in NetCDF data files and are going to be converted and written to BAW-specific BDF data files, or,
* '''mode 2''' , conversion of (DWD) NetCDF files to BAW-specific BDF data files, or,
* '''mode 3''' , merge of several (DWD) NetCDF files to a single NetCDF data file (times for input data must be identical in all input files).


informations related to output files (block '''Output_Information''')
'''informations related to output files''' (block '''Output_Information''')
:* file to store converted depth averaged (2D-) computational results (filetype [[DIRZ.BIN.R|dirz.bin.r]], [[DIRZ.BIN.I|dirz.bin.i]] and [[DIRZ.BIN|dirz.bin]]).
* '''mode 1'''
:: Notice: data for multiple computational domains are going to be gathered and stored in this file.
** file to store converted depth averaged (2D-) computational results (filetype [[DIRZ.BIN.R|dirz.bin.r]], [[DIRZ.BIN.I|dirz.bin.i]] and [[DIRZ.BIN|dirz.bin]]).
:* file to store the converted computational grid (filetype [[UNTRIM_GRID.DAT|untrim_grid.dat]]).
**: Notice: data for multiple computational domains are going to be gathered and stored in this file.
:: Notice: computational grid data for multiple computational domains are going to be gathered and stored in this grid file.
** file to store the converted computational grid (filetype [[UNTRIM_GRID.DAT|untrim_grid.dat]]).
:* (optional) file to store converted depth dependent (3D-) computational results (filetype [[DIRZ.BIN.R|dirz.bin.r]], [[DIRZ.BIN.I|dirz.bin.i]] and [[DIRZ.BIN|dirz.bin]]).
**: Notice: computational grid data for multiple computational domains are going to be gathered and stored in this grid file.
:: Notice: data for multiple computational domains are going to be gathered and stored in this file.
** (optional) file to store converted depth dependent (3D-) computational results (filetype [[DIRZ.BIN.R|dirz.bin.r]], [[DIRZ.BIN.I|dirz.bin.i]] and [[DIRZ.BIN|dirz.bin]]).
:* (optional) file with description of the vertical layer structure (z-layers), to be used for the converted computational results (filetype [[VERTICAL.DAT|vertical.dat]]).
**: Notice: data for multiple computational domains are going to be gathered and stored in this file.
:: Notice: this file must be always specified in situations when three-dimensional data are going to be generated by conversion.
** (optional) file with description of the vertical layer structure (z-layers), to be used for the converted computational results (filetype [[VERTICAL.DAT|vertical.dat]]).
:* (optional) threshold depth for drying and wetting.
**: Notice: this file must be always specified in situations when three-dimensional data are going to be generated by conversion.
:: Notice: the value prescribed shall be not smaller than the one used during the Delft3D simulation.
** (optional) threshold depth for drying and wetting.
:* (optional) start time for data conversion.
**: Notice: the value prescribed shall be not smaller than the one used during the Delft3D simulation.
:: Notice: if not specified the first date contained in the input data will be used.
** (optional) start time for data conversion.
:* (optional) end time for data conversion.
**: Notice: if not specified the first date contained in the input data will be used.
:: Notice: if not specified the last date contained in the input data will be used.
** (optional) end time for data conversion.
:* (optional) time step for data conversion.
**: Notice: if not specified the last date contained in the input data will be used.
:: Notice: if not specified all dates contained in the input data will be converted.
** (optional) time step for data conversion.
:* (optional) maximum increase of depth during a morphodynamic simulation. Depth at all grid points is increased by this amount to cover depth variation due to morphodynamics within a z-layered (vertical) grid. Exception: depths at (protected) structures will not be altered.
**: Notice: if not specified all dates contained in the input data will be converted.
:: Notice: if this parameter is not prescribed all depth values will remain unchanged.
** (optional) maximum increase of depth during a morphodynamic simulation. Depth at all grid points is increased by this amount to cover depth variation due to morphodynamics within a z-layered (vertical) grid. Exception: depths at (protected) structures will not be altered.
:* (optional) steering parameter for the method chosen to compute initial depth values at grid points. Depths can be computed from values prescribed in grid files or in computational result files.
**: Notice: if this parameter is not prescribed all depth values will remain unchanged.
:: Notice: if this parameter is not prescribed, depth values are derived from grid data only.
** (optional) steering parameter for the method chosen to compute initial depth values at grid points. Depths can be computed from values prescribed in grid files or in computational result files.
:* (optional) steering parameter for type of method used to compute depth values for new edges inserted during the grid refinement process. Method can be either '''MEAN''', '''MAX''' or '''MIN'''.
**: Notice: if this parameter is not prescribed, depth values are derived from grid data only.
:: Notice: if this parameter is missing, method '''MEAN''' will be used.
** (optional) steering parameter for type of method used to compute depth values for new edges inserted during the grid refinement process. Method can be either '''MEAN''', '''MAX''' or '''MIN'''.
:* (optional) steering parameter for rounding of time and date information (digits for nanoseconds). The number of digits for nanoseconds (0 - 9) has to be prescribed. In case 0 (zero) is prescribed, no digits for nanoseconds are taken into account and all internal time and date items are rounded to seconds.
**: Notice: if this parameter is missing, method '''MEAN''' will be used.
:: Notice: if this parameter is not specified, no time and date item will be subject to rounding (full accuracy).  
** (optional) steering parameter for rounding of time and date information (digits for nanoseconds). The number of digits for nanoseconds (0 - 9) has to be prescribed. In case 0 (zero) is prescribed, no digits for nanoseconds are taken into account and all internal time and date items are rounded to seconds.
:: informations related to input files (block '''Input_Files''').
**: Notice: if this parameter is not specified, no time and date item will be subject to rounding (full accuracy).  
:: Notice: this block can be specified several times, i. e. one time for each computational domain.
* '''mode 2'''
:* name of NetCDF-file which contains the computational results from Delft3D going to be converted (filetype [[NETCDF.CDF|netcdf.cdf]]; Notice: has to be specified only once per computational domain), plus (optional) code numbers for the converted physical quantities (Notice: in case code numbers are not specified, all quantities which are feasible for conversion are going to be converted automatically).
** file to store converted data (filetype [[DIRZ.BIN.R|dirz.bin.r]], [[DIRZ.BIN.I|dirz.bin.i]] and [[DIRZ.BIN|dirz.bin]]).
:* name of file which contains the computational grid going to be converted (filetype [[DELFT3D.GRD|delft3d.grd]]).
**: Notice: file is not generated, only the filetype is used.
:: Additionally the following files of type [[DELFT3D.DEP|delft3d.dep]] and [[DELFT3D.ENC|delft3d.enc]] must be present in the working directory.
** file to store the converted computational grid (filetype [[GITTER05.DAT and GITTER05.BIN|gitter05.dat or gitter05.bin]]).
:: Optionally files of type [[DELFT3D.DRY|delft3d.dry]], [[DELFT3D.THD|delft3d.thd]], [[DELFT3D.LWL|delft3d.lwl]], [[DELFT3D.EXT|delft3d.ext]] as well as [[DELFT3D.BND|delft3d.bnd]] may be present in the working directory.
**: Notice: file is not generated, only filetype is used.
** (optional) start time for data conversion.
**: Notice: if not specified the first date contained in the input data will be used.
** (optional) end time for data conversion.
**: Notice: if not specified the last date contained in the input data will be used.
** (optional) time step for data conversion.
**: Notice: if not specified all dates contained in the input data will be converted.
** (optional) steering parameter for rounding of time and date information (digits for nanoseconds). The number of digits for nanoseconds (0 - 9) has to be prescribed. In case 0 (zero) is prescribed, no digits for nanoseconds are taken into account and all internal time and date items are rounded to seconds.
**: Notice: if this parameter is not specified, no time and date item will be subject to rounding (full accuracy).  
** EPSG code for coordinates in input data file (see [http://www.epsg-registry.org/ EPSG Geodetic Parameter Registry]).
* '''mode 3'''
** file to store merged data (filetype [[NETCDF.CDF|netcdf.cdf]]).
** (optional) start time for data conversion.
**: Notice: if not specified the first date contained in the input data will be used.
** (optional) end time for data conversion.
**: Notice: if not specified the last date contained in the input data will be used.
** (optional) time step for data conversion.
**: Notice: if not specified all dates contained in the input data will be converted.
** (optional) steering parameter for rounding of time and date information (digits for nanoseconds). The number of digits for nanoseconds (0 - 9) has to be prescribed. In case 0 (zero) is prescribed, no digits for nanoseconds are taken into account and all internal time and date items are rounded to seconds.
**: Notice: if this parameter is not specified, no time and date item will be subject to rounding (full accuracy).  


:: Remark 1: Only one file with extension '''grd''' per computational domain can be specified. The other (related) files are only allowed to differ with respect to their extension.
'''informations related to input files''' (block '''Input_Files''') - block can be specified several times
 
* '''mode 1'''
:: Remark 2: For each computational domain the converted computational grid as well as the converted computational results are stored in files of type [[UNTRIM_GRID.DAT|untrim_grid.dat]], [[DIRZ.BIN.R|dirz.bin.r]], [[DIRZ.BIN.I|dirz.bin.i]] and [[DIRZ.BIN|dirz.bin]].  
** name of NetCDF-file which contains the computational results from Delft3D going to be converted (filetype [[NETCDF.CDF|netcdf.cdf]]);
**: Notice: has to be specified only once per computational domain), plus (optional) code numbers for the converted physical quantities (Notice: in case code numbers are not specified, all quantities which are feasible for conversion are going to be converted automatically).
** name of file which contains the computational grid going to be converted (filetype [[DELFT3D.GRD|delft3d.grd]]).
** Additionally the following files of type [[DELFT3D.DEP|delft3d.dep]] and [[DELFT3D.ENC|delft3d.enc]] must be present in the working directory.
** Optionally files of type [[DELFT3D.DRY|delft3d.dry]], [[DELFT3D.THD|delft3d.thd]], [[DELFT3D.LWL|delft3d.lwl]], [[DELFT3D.EXT|delft3d.ext]] as well as [[DELFT3D.BND|delft3d.bnd]] may be present in the working directory.
**: Remark 1: Only one file with extension '''grd''' per computational domain can be specified. The other (related) files are only allowed to differ with respect to their extension.
**: Remark 2: For each computational domain the converted computational grid as well as the converted computational results are stored in files of type [[UNTRIM_GRID.DAT|untrim_grid.dat]], [[DIRZ.BIN.R|dirz.bin.r]], [[DIRZ.BIN.I|dirz.bin.i]] and [[DIRZ.BIN|dirz.bin]].
* '''mode 2'''
** name of NetCDF-file with data to be converted (filetype [[NETCDF.CDF|netcdf.cdf]]);
**: Remark 1: For each input file a grid file of type [[GITTER05.DAT and GITTER05.BIN|gitter05.dat or gitter05.bin]] as well as data files of type [[DIRZ.BIN.R|dirz.bin.r]], [[DIRZ.BIN.I|dirz.bin.i]] and [[DIRZ.BIN|dirz.bin]] will be generated.
** EPSG code for coordinates of resulting grid file (see [http://www.epsg-registry.org/ EPSG Geodetic Parameter Registry]).
* '''mode 3'''
** file name with type [[NETCDF.CDF|netcdf.cdf]], contents will be merged into the output file.


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

Revision as of 16:43, 12 August 2010

Basic Information

File-Type

dataconvert.dat

File-Form

FORMATTED

Version

7.x / August 2010

Description-Date

August 2010

Significance of the File

Contains various input steering data for the postprocessor DATACONVERT

File-Contents (in Catchwords)

Contains various input steering data, which are required during

  • mode 1 , conversion of computational results for the integrated modelling system Delft3D. Original data are stored in NetCDF data files and are going to be converted and written to BAW-specific BDF data files, or,
  • mode 2 , conversion of (DWD) NetCDF files to BAW-specific BDF data files, or,
  • mode 3 , merge of several (DWD) NetCDF files to a single NetCDF data file (times for input data must be identical in all input files).

informations related to output files (block Output_Information)

  • mode 1
    • file to store converted depth averaged (2D-) computational results (filetype dirz.bin.r, dirz.bin.i and dirz.bin).
      Notice: data for multiple computational domains are going to be gathered and stored in this file.
    • file to store the converted computational grid (filetype untrim_grid.dat).
      Notice: computational grid data for multiple computational domains are going to be gathered and stored in this grid file.
    • (optional) file to store converted depth dependent (3D-) computational results (filetype dirz.bin.r, dirz.bin.i and dirz.bin).
      Notice: data for multiple computational domains are going to be gathered and stored in this file.
    • (optional) file with description of the vertical layer structure (z-layers), to be used for the converted computational results (filetype vertical.dat).
      Notice: this file must be always specified in situations when three-dimensional data are going to be generated by conversion.
    • (optional) threshold depth for drying and wetting.
      Notice: the value prescribed shall be not smaller than the one used during the Delft3D simulation.
    • (optional) start time for data conversion.
      Notice: if not specified the first date contained in the input data will be used.
    • (optional) end time for data conversion.
      Notice: if not specified the last date contained in the input data will be used.
    • (optional) time step for data conversion.
      Notice: if not specified all dates contained in the input data will be converted.
    • (optional) maximum increase of depth during a morphodynamic simulation. Depth at all grid points is increased by this amount to cover depth variation due to morphodynamics within a z-layered (vertical) grid. Exception: depths at (protected) structures will not be altered.
      Notice: if this parameter is not prescribed all depth values will remain unchanged.
    • (optional) steering parameter for the method chosen to compute initial depth values at grid points. Depths can be computed from values prescribed in grid files or in computational result files.
      Notice: if this parameter is not prescribed, depth values are derived from grid data only.
    • (optional) steering parameter for type of method used to compute depth values for new edges inserted during the grid refinement process. Method can be either MEAN, MAX or MIN.
      Notice: if this parameter is missing, method MEAN will be used.
    • (optional) steering parameter for rounding of time and date information (digits for nanoseconds). The number of digits for nanoseconds (0 - 9) has to be prescribed. In case 0 (zero) is prescribed, no digits for nanoseconds are taken into account and all internal time and date items are rounded to seconds.
      Notice: if this parameter is not specified, no time and date item will be subject to rounding (full accuracy).
  • mode 2
    • file to store converted data (filetype dirz.bin.r, dirz.bin.i and dirz.bin).
      Notice: file is not generated, only the filetype is used.
    • file to store the converted computational grid (filetype gitter05.dat or gitter05.bin).
      Notice: file is not generated, only filetype is used.
    • (optional) start time for data conversion.
      Notice: if not specified the first date contained in the input data will be used.
    • (optional) end time for data conversion.
      Notice: if not specified the last date contained in the input data will be used.
    • (optional) time step for data conversion.
      Notice: if not specified all dates contained in the input data will be converted.
    • (optional) steering parameter for rounding of time and date information (digits for nanoseconds). The number of digits for nanoseconds (0 - 9) has to be prescribed. In case 0 (zero) is prescribed, no digits for nanoseconds are taken into account and all internal time and date items are rounded to seconds.
      Notice: if this parameter is not specified, no time and date item will be subject to rounding (full accuracy).
    • EPSG code for coordinates in input data file (see EPSG Geodetic Parameter Registry).
  • mode 3
    • file to store merged data (filetype netcdf.cdf).
    • (optional) start time for data conversion.
      Notice: if not specified the first date contained in the input data will be used.
    • (optional) end time for data conversion.
      Notice: if not specified the last date contained in the input data will be used.
    • (optional) time step for data conversion.
      Notice: if not specified all dates contained in the input data will be converted.
    • (optional) steering parameter for rounding of time and date information (digits for nanoseconds). The number of digits for nanoseconds (0 - 9) has to be prescribed. In case 0 (zero) is prescribed, no digits for nanoseconds are taken into account and all internal time and date items are rounded to seconds.
      Notice: if this parameter is not specified, no time and date item will be subject to rounding (full accuracy).

informations related to input files (block Input_Files) - block can be specified several times

  • mode 1
    • name of NetCDF-file which contains the computational results from Delft3D going to be converted (filetype netcdf.cdf);
      Notice: has to be specified only once per computational domain), plus (optional) code numbers for the converted physical quantities (Notice: in case code numbers are not specified, all quantities which are feasible for conversion are going to be converted automatically).
    • name of file which contains the computational grid going to be converted (filetype delft3d.grd).
    • Additionally the following files of type delft3d.dep and delft3d.enc must be present in the working directory.
    • Optionally files of type delft3d.dry, delft3d.thd, delft3d.lwl, delft3d.ext as well as delft3d.bnd may be present in the working directory.
      Remark 1: Only one file with extension grd per computational domain can be specified. The other (related) files are only allowed to differ with respect to their extension.
      Remark 2: For each computational domain the converted computational grid as well as the converted computational results are stored in files of type untrim_grid.dat, dirz.bin.r, dirz.bin.i and dirz.bin.
  • mode 2
  • mode 3
    • file name with type netcdf.cdf, contents will be merged into the output file.

dictionary-file hyd_untrim_dico.dat, normally 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

DATACONVERT

Example-File

please refer to $PROGHOME/examples/dataconvert/

back to: File Descriptions

Overview

Retrieved from "http://wiki.baw.de/en/index.php?title=DATACONVERT.DAT&oldid=919"