This file describes the structure of the model data used in the paper "The influence of swash-based reflection on surf zone hydrodynamics: a wave-by-wave approach", published in Coastal Engineering, vol. 122, pp. 27–43. doi: http://dx.doi.org/10.1016/j.coastaleng.2017.01.006
The dataset is composed of 4 .mat files, which require the MATLAB software. The description of the data structure is given below for every file of the dataset. This concerns the raw model data used in the analysis of the paper except for the local void fraction (represented by the variable alpha in OpenFOAM) and the local velocity timeseries due to their very important size. In case any user desires to run the model, the model option files and meshes are provided. The authors can be contacted on this matter. This dataset is distributed under the Creative Commons Attribution 4.0 International license.
1) The model dataset of the A7 mono wave test is stored as a structure in the .mat file called "Data_Model_A7mono.mat". For this dataset, nb_pos is the number of cross-shore locations (corresponding to the resolution described in the paper) and nb_dt is the number of time steps (dt=0.05 s here, corresponding to 80 second-long runs).
-------------------------------------------------------------------
Field | Unit | Description
-------------------------------------------------------------------
x | m | Array (1,nb_pos) - Cross-shore position
time | s | Array (nb_dt,1) - Time
zBed | m | Array (1,nb_pos) - Bed Elevation
eta | m | Array (nb_dt,nb_pos) - Time-varying surface elevation
-------------------------------------------------------------------
2) The model dataset of the A6 mono wave test is stored as a structure in the .mat file called "Data_Model_A6mono.mat". For this dataset, nb_pos is the number of cross-shore locations (corresponding to the resolution described in the paper) and nb_dt is the number of time steps (dt=0.05 s here, corresponding to 80 second-long runs).
-------------------------------------------------------------------
Field | Unit | Description
-------------------------------------------------------------------
x | m | Array (1,nb_pos) - Cross-shore position
time | s | Array (nb_dt,1) - Time
zBed | m | Array (1,nb_pos) - Bed Elevation
eta | m | Array (nb_dt,nb_pos) - Time-varying surface elevation
-------------------------------------------------------------------
3) The model dataset of the A6-01 wave test is stored as a structure in the .mat file called "Data_Model_A601.mat". For this dataset, nb_pos is the number of cross-shore locations (corresponding to the resolution described in the paper) and nb_dt is the number of time steps (dt=0.10 s here, corresponding to 670 second-long runs).
-------------------------------------------------------------------
Field | Unit | Description
-------------------------------------------------------------------
x | m | Array (1,nb_pos) - Cross-shore position
time | s | Array (nb_dt,1) - Time
zBed | m | Array (1,nb_pos) - Bed Elevation
eta | m | Array (nb_dt,nb_pos) - Time-varying surface elevation
PT_x | m | Array (1,7) - Cross-shore position of the PTs used in Figure 5
PT_z | m | Array (1,7) - Elevation above the flume base of the PTs used in Figure 5
p | hPa | Array (1,7) - Modelled pressure at the PTs locations (Figure 5, error in the y-label).
EMCM_x | m | Array (1,7) - Cross-shore position of the EMCMs used to produce Figure 6
EMCM_z | m | Array (1,7) - Elevation above the flume base of the PTs used to produce Figure 6
u | m/s | Array (1,7) - Modelled horizontal current velocity at the EMCMs locations (Figure 6)
v | m/s | Array (1,7) - Modelled vertical current velocity at the EMCMs locations (Figure 6)
-------------------------------------------------------------------
4) The modelled mean currents and skewness (total, incident and outgoing) used to produce Figure 16 and 17 are stored as a structure in the .mat file called "Figure_16_and_17.mat". For this dataset, nb_pos is the number of cross-shore locations (corresponding to the resolution described in the paper) and nb_dz is the number of cells in the vertical dimension (varying dz, see paper and data).
-------------------------------------------------------------------
Field | Unit | Description
-------------------------------------------------------------------
xGrid | m | Array (nb_pos,nb_dz) - Cross-shore grid for visualizing the mean quantities
zGrid | m | Array (nb_pos,nb_dz) - Vertical grid for visualizing the mean quantities
mean_u | m/s | Array (nb_pos,nb_dz) - Mean total horizontal velocity
mean_u_inc | m/s | Array (nb_pos,nb_dz) - Mean incident horizontal velocity
mean_u_inc | m/s | Array (nb_pos,nb_dz) - Mean outgoing horizontal velocity
Sk_u | - | Array (nb_pos,nb_dz) - Skewness of the total horizontal velocity
Sk_u_inc | - | Array (nb_pos,nb_dz) - Skewness of the incident horizontal velocity
Sk_u_out | - | Array (nb_pos,nb_dz) - Skewness of the outgoing horizontal velocity
-------------------------------------------------------------------