DATACONVERT.DAT

Basic Information

File-Type

dataconvert.dat

File-Form

FORMATTED

Version

December 2018

Description-Date

December 2018

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), or
mode 4, conversion of BDF data files into a single NetCDF data file using CF Metadata conventions, or
mode 6, conversion of meteorological data in BDF-Format into Delft3D format METEO_DLFT, or
mode 7, conversion of timeseries in BOEWRT format into cf-netcdf.nc data according to NODC's feature type template for timeSeries, or
mode 8, conversion from CF SGRID NetCDF into CF UGRID NetCDF format (see cf-netcdf.nc).

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).
- (optional) dry bed density: bedload and suspended matter transport rates are in Delft3D result files stored as volume per time and in BDF files as mass per time. A dry bed density for each fraction is necessary for the conversion into a mass transport, i.e. into measures with the code 621 or 622.
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 of resulting grid 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).
mode 4
- file to store merged data (filetype cf-netcdf.nc).
- (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) threshold depth for drying and wetting.
  Notice: if not specified 0.1 m will be used.
- (optional) title (corresponds to global CF attribute title).
- (optional) comment (corresponds to global CF attribute comment).
- (optional) source (corresponds to global CF attribute source).
- (optional) creation mode ID for a CF NetCDF file (see Unidata NetCDF).
- (optional) deflate_level for a CF-NetCDF file (see Unidata NetCDF).
  Notice: For further informations on global CF attributes see NetCDF global attributes.
mode 6
- file to store converted data (filetype METEO_DLFT)
- (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) EPSG code for coordinates of resulting grid file (see EPSG Geodetic Parameter Registry).
  Notice: There will be be no mapping, but the code will be written as a comment into the METEO_DELFT file.
- (optional) No_Data_Value for invalid data.
- (optional) Timezone for the time string of the output file (Default: UTC)
mode 7
- file to time series data (filetype cf-netcdf.nc).
- (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, e.g. for time series with time steps of different lengths.
- (optional) creation mode ID for a CF NetCDF file (see Unidata NetCDF).
- (optional) deflate_level for a CF-NetCDF file (see Unidata NetCDF).
mode 8
- file for converted data (filetype cf-netcdf.nc, CF UGRID NetCDF).
- (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, e.g. for time series with time steps of different lengths.
- (optional) creation mode ID for a CF NetCDF file (see Unidata NetCDF).
- (optional) deflate_level for a CF-NetCDF file (see Unidata NetCDF).
- (optional) time step used during simulation.
- (optional) dimensionality of simulation.
Notice: For further informations on global CF attributes see NetCDF global attributes.

informations related to input files (block Input_Files) - block can be specified several times, but only once in case of modes 7 and 8.

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
- name of NetCDF-file with data to be converted (filetype netcdf.cdf);
  Remark 1: For each input file a grid file of type gitter05.dat or gitter05.bin as well as data files of type dirz.bin.r, dirz.bin.i and dirz.bin will be generated.
- EPSG code for coordinates in input data file (see EPSG Geodetic Parameter Registry).
mode 3
- file name with type netcdf.cdf, contents will be merged into the output file.
mode 4
- BDF data file of type dirz.bin.
  Remarks:
  1. Files of type dirz.bin.I and dirz.bin.R must be also available.
  2. Valid data types:
    Synoptic data.
  3. Valid grid types:
    location_grid.dat or cf-netcdf.nc from GRIDCONVERT.
    
    gitter05.dat and gitter05.bin or cf-netcdf.nc from GRIDCONVERT.
    
    untrim_grid.dat or cf-netcdf.nc from GRIDCONVERT.
    
    utrsub_grid.dat (only with false subgrid - one subpolygon/polygon, one subedge/edge).
    
    profil05.bin or cf-netcdf.nc from GRIDCONVERT.
mode 6
- data files of type dirz.bin.r, dirz.bin.i and dirz.bin
- alle grid formats connectable with BDF files, e.g. GITTER05
mode 7
- a data file of type boewrt.dat; all quantities will be converted automatically. If you intend to analyze the converted data with NCANALYSE, the needed quantities will have to be packed into one file of type boewrt.dat. Missing water level data could be taken from near by gauging stations.
mode 8
- file with input data (filetype netcdf.cdf, CF SGRID NetCDF);
- EPSG code for coordinates in input data file (see EPSG Geodetic Parameter Registry).

informations related to the meaning of variables (Block SGRID_Variable_Meaning) - must be specified once in case of mode 8, otherwise not.

mode 8
- name of variable and meaning of variable.

dictionary-file dataconvert_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/.

mode 1 : dataconvert.Delft3D-NetCDF.BDF.dat.
mode 2 : dataconvert.DWD-NetCDF.BDF.dat.
mode 3 : dataconvert.DWD-NetCDF.DWD-NetCDF.dat.
mode 4 : dataconvert.BDF.CF-NetCDF.dat.
mode 6 : dataconvert.BDF-METEO_DELFT.dat.
mode 7 : dataconvert.BOEWRT.CF-NetCDF.dat.
mode 8 : dataconvert.CF_SGRID_NetCDF.CF_UGRID_NetCDF.dat.

back to: File Descriptions

Overview