Actions

DATACONVERT.DAT

From BAWiki

Basic Information

File-Type

dataconvert.dat

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.


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

Additional Information

Language

Fortran90

File-Form

FORMATTED

File-Access

SEQUENTIAL

File-Extension

.dat

WRITE-Subroutine(s)/Module(s)

Editor

READ-Subroutine(s)/Module(s)

$PROGHOME/fortran/prg/dataconvert/*/mod_m_dataconvert_steu.f90

Original Version

G. Lang

Maintenance

G. Lang, S. Spohr

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