DOI: 10.5281/zenodo.11388949
title: Model Data for Dynamic Controls on the Asymmetry of Mouth Bars: Role of Alongshore Currents

description: The Model dataset is exported and integrated from Delft3D numerical setup files and results by using the Quickplot module, which is used in the manuscript entitled "Dynamic Controls on the Asymmetry of Mouth Bars: Role of Alongshore Currents". 

In terms of the Delft3D setup files, please see the zipped file "Delft3D_setup_files.zip", including the run 2-A0.75 and run 4-N0.075.

In terms of model result dataset, each folder is organized based on the unique RunID assigned to the Delft3D simulations, as detailed in the Table 1 in the main text of the manuscript.  Given the employment of multiple decomposition domains within the model, the numerical results are exported individually for each domain. To facilitate the analysis of "bulk" data, encompassing three dimensions (two in horizontal space and one in time), all single domains are intergrated by Matlab script into three comprehensive data files. The data files with the ".mat" extension can be directly opened and loaded in MATLAB. The prefixes of the MAT-files are as follows:



The "bedlevel_daily_*.mat" files contain daily map data of the bed level (ZZ) spanning 74 simulation days (73 time steps in total). This data is used to calculate metrics for assessing mouth bar asymmetry.

The "map_u_c_h_day5_*.mat" files represent map data (recorded every 15 minutes, 97 time steps in total) including depth-averaged velocity (u), suspended sediment concentration (c), water depth (h), bed level (bl), and sediment flux (qs) after t=5 hydrodynamic days. This data is used to analyze sediment plume and currents during the period of the initial formation of mouth bars, providing predictive insights.



The "map_u_c_h_day5_include_channel_*.mat" files serve a unique purpose in visualizing the flow vectors (u) and the suspended sediment concentration (c) at the river mouth, incorporating the extended channel. We present two specific scenarios: "2-A0.75" and "4-N0.075," which directly correlate with the cases illustrated in Figure 8 of the manuscript, facilitating a more comprehensive understanding and analysis.



The "map_h_u_qs_afterday74_*.mat" files contain hourly map data comprising bed level (h), water depth (d), depth-averaged velocity (U for instantaneous and v for tidally-averaged), and suspended sediment flux (QS for instantaneous and q for tidally-averaged) within a tidal cycle of 12-hr semidiurnal tide (13 time steps). This data is utilized to visualize and extract distributary channels after 10 morphological years of evolution. The MATLAB code for extracting channels follows the GRL paper (Gao et al., 2018) and JGR-ES paper (Gao et al., 2019), also seen in https://github.com/weilungao/ShorelineExtraction. For added convenience, the comprehensive integration packages, titled 'ShorelineExtraction-master' and 'DeltaicDistributaryNetwork-main', containing essential Matlab codes, have been pre-uploaded to this dataset.


The MATLAB-compatible '.m' code files enable direct opening and data processing. Simply execute the files in sequential order, prefixed "step0-4", for seamless data manipulation. The default list for 32 simulation cases is given by "file_case_index_group.txt". Individual cases can be processed separately by modifying the loading script within the code files as needed.

Tip: To ensure the smooth execution of the script, kindly place all downloaded single files or packaged folders (once unzipped but keep the subdirectories) within the same directory.