SEDIMORPH.DAT

Basic Information

File-Type

sedimorph.dat

File-Form

FORMATTED

Version

1.x

Description-Date

August 2007

Significance of the File

general input data for the computational morphodynamic module SediMorph, which can be used together with different simulation methods (e.g. Telemac or UNTRIM).

File-Contents (in Catchwords)

Block "Input_Files" with the names of the different input data files:

• Key "Sediment_Classification_File": filetype soil.dat with description of the sediment classification used (e.g. Udden-Wentworth-Scale);
• Key "Input_Morphological_Dataset_ASC": filetype ipds.dat with data for the initial state (e.g. spatial distribution of sediments, dune height and dune length, etc.), in situations when the initial state has to be prescribed manually (e.g. from measured data);
• Key "Input_Restart_File": filetype netcdf.cdf with data for the initial state, in situations when data from an earlier SediMorph simulation shall be used;
• Key "Restart_Time": time for the initial state if "Input_Restart_File" was specified before;
• Key "Readjust_Initial_Bathymetry": switch (true/false) to readjust the initial bathymetry in situations when data from an earlier SediMorph simulation shall be used;
• Key "Vertical_Structure_File": filetype vertical.dat with description of the vertical structure for simulation of a two- or three-dimensional sediment distribution.

Notice: "Input_Morphological_Dataset_ASC" and "Input_Restart_File"+"Restart_Time"+"Readjust_Initial_Bathymetry" must not be prescribed at the same time.
(optional) Block "Morphological_Data_Output" with steering data concerning the output of morphologically relevant data sets:

• Key "Output_Morphological_DataSet_2D": filetype dirz.bin.r, dirz.bin.i und dirz.bin for output of two-dimensional data :

• water level

• current velocity
• time dependent bathymetry
• vertical erosion
• effective bed roughness
• rigid layer depth
• rigid layer roughness
• porosity in the exchange layer
• sediment fraction in the exchange layer
• particle diameter d_m in the exchange layer
• [opt.] ripple height
• [opt.] ripple wave number
• [opt.] dune height
• [opt.] dune wave number

• Key "Output_Morphological_DataSet_3D": (optional) filetype dirz.bin.R, dirz.bin.I and dirz.bin for output of three-dimensional data:

• porosity
• sediment fraction
• particle diameter d_m
• Key "First_Time_of_MDS_Output": start time for the output of data;
• Key "Last_Time_of_MDS_Output": end time for the output of data;
• Key "Time_Increment_of_MDS_Output": time interval between two successive times of data output.

Notice: results will be eventually interpolated to the nodes of the computational grid. (optional) Block "Sediment_Transport_Output" with steering data for the output of sediment transport data at the bottom:

• Key "Sediment_Transport_Results_File": filetype dirz.bin.r, dirz.bin.i und dirz.bin for the output of all sediment transport data;
• Key "First_Time_of_STR_Output": start time for the output of data;
• Key "Last_Time_of_STR_Output": end time for the output of data;
• Key "Time_Increment_of_STR_Output": time interval between two successive times of data output.
• Key "Output_of_Transport_Rate": switch (true/false) to trigger the output of the sediment transport rate;
• Key "Output_of_Transport_Capacity": switch (true/false) to trigger the output of the sediment transport capacity;
• Key "Output_of_Erosion_Rate": switch (true/false) to trigger the output of the erosion rate of suspended sediments at the bottom;
• Key "Output_of_Deposition_Rate": switch (true/false) to trigger the output of the deposition rate of suspended sediments at the bottom;
• Key "Output_of_Effective_Bed_Shear_Stress": switch (true/false) to trigger output of effective bed shear stress at the bottom, which is relevant for sediment transport;
• Key "Output_of_Critical_Bed_Shear_Stress": switch (true/false) to trigger output of critical bed shear stress at the bottom.

Notice: results will be eventually interpolated to the nodes of the computational grid. (optional) Block "Restart_Data_Output" with steering data to generate a restart file:

• Key "Output_Restart_File": filetype netcdf.cdf for output of restart data belonging to the actual computational grid;
• Key "First_Time_of_Restart_Output": start time for the output of restart data;
• Key "Last_Time_of_Restart_Output": end time for the output of restart data;
• Key "Time_Increment_of_Restart_Output": time interval between two successive times of restart data output.

Notice: a "Output_Restart_File" can be re-used in any later simulation as a "Input_Restart_File", as far as the computational grid is identical. Block "Bed_Roughness" with steering data to compute the effective bottom roughness:

• Key "Ripple_Roughness_Included": switch, whether ripples (if present) are (not) taken into account in the computation of the bottom roughness;
• Key "Dune_Roughness_Included": switch, whether dunes (if present) are (not) taken into account in the computation of the bottom roughness.

(optional) Key "Dune_Prediction": switch (true/false) for the prediction of dunes; (optional) Block "Exchange_Layer" with steering data for the exchange layer definition:

• Key "Exchange_Layer_Depth_Formula": choice of a exchange layer depth model (e.g. "5dmax_poly", "Borah", "new_Approach"). If this block is neglected "5dmax_global" is taken into account. This approach is fixed in older versions.

Block "Bed_Load_Transport" with steering data for the parametrization of bed load transport near the bottom:

• Key "Transport_Formula": choice of a transport formula (e.g. "Bagnold", "van_Rijn", "Meyer_Peter_Mueller" or "Hunziker").

Block "Suspended_Load_Transport" with steering data for the parametrization of the erodibility:

• Key "Erosion_Flux_Model": Choose of "linear" or "quadratic" dependence from the bottom shear stress.
• Key "Erosion_Flux_Constant": Constant value according to the "Erosion_Flux_Model".

(optional) Block "Porosity" with steering data for the porosity: If "Erosion_Flux_Model" = "linear" and "Porosity_Prediction" = "true" the "Erosion_Flux_Constant" will be ignored and internaly calculated as a function of the porosity.

• Key "Porosity_Prediction": switch (true/false) for the prediction of porosity;

Block "Sediment_Class" with relevant informations concerning the sediment classes used during computation:

• Key "Sediment_Class_Name": name of a sediment class to be used;
• Key "Transport_Mode": type of sediment transport (e.g. "No_Transport", "Bed_Load" or "Suspension").
• Key "Critical_Shear_Stress_for_Erosion": critical shear stress for erosion (e.g. "User_Defined" plus value, or "Shields" - according to Shields diagram).
• (optional) Key "Settling_Velocity": choice of a settling velocity formula ("Stokes", "Dietrich", "Malcherek" or "Manning").

Notice: all classes to be used must be defined inside the "Sediment_Classification_File" before (see above). Notice: dictionary-file sedimorph_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

TELEMAC-2D, UNS, UNTRIM, UNTRIM2007

Example-File

please refer to $PROGHOME/examples/sedimorph/

for UnTRIM see also in directory $PROGHOME/examples/untrim/BSP_SediMorph_kurve/

---

back to: File Descriptions

---

Overview