The following Read Me provides an overview of the experimental and computational files associated with the CREATE report on SEAHIVE scour mitigation. These files support both the physical flume experiments and the SedFOAM/OpenFOAM modeling framework used to evaluate scour development around monopiles and SEAHIVE configurations. The experimental CSV files included here are intended to accompany the computational cases and provide the measured data used for comparison, validation, and interpretation of model performance.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~ Included Data Files ~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This release includes the following experimental CSV files:

Single_Vertical_SEAHIVES.csv
Single_Vertical_SEAHIVE_Setup.csv
Horizontal_SEAHIVES_(2D).csv
Horizontal_SEAHIVES_(2D)_(2).csv
Horizontal_SEAHIVES_(3D).csv
Horizontal_SEAHIVES_(3D)_(2).csv
Horizontal_SEAHIVES_(4D).csv
Horizontal_SEAHIVES_(4D)_(2).csv
Circular_Monopile_(D=4cm).csv
Circular_Monopile_(D=4cm)_(2).csv
D=4_cm_equiv_SEAHIVE.csv
D=4_cm_equiv_SEAHIVE_(2).csv

These files represent selected flume experiments used in the report. In general:
- files with “(2)” indicate replicate runs;
- Circular_Monopile files are control cases;
- D=4_cm_equiv_SEAHIVE files are hydrodynamically equivalent SEAHIVE monopile tests;
- Horizontal_SEAHIVES files correspond to grouped SEAHIVE configurations placed upstream of a circular monopile at 2D, 3D, or 4D spacing;
- Single_Vertical_SEAHIVES files correspond to single-unit SEAHIVE testing and associated setup information.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~ Experimental Data ~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The experimental data files contain laboratory flume measurements used to evaluate scour behavior under controlled clear-water conditions. Depending on the file, data may include time-series scour depth measurements, equilibrium scour metrics, configuration identifiers, setup parameters, or other processed values used in the report.

Single_Vertical_SEAHIVE_Setup.csv
    Contains setup and metadata for the single vertical SEAHIVE experiments. This file includes geometric dimensions, hydraulic conditions, sediment properties, and other test descriptors.

Single_Vertical_SEAHIVES.csv
    Contains processed results for single vertical SEAHIVE experiments. This file is set up with repeating columns for the four experiments:  Circular Monopile (D=2.66 cm), SEAHIVE with edge facing the flow (Solid Base) D=2.7, SEAHIVE with face perpendicular to the flow (Solid Base), SEAHIVE with face perpendicular to the flow (No Base). 
The table is set up as follows:		
|Time (hours) | Scour Depth (cm) | ds/b (unitless) | this series is repeated for each set up, "b" is the pile diameter.

Circular_Monopile_(D=4cm).csv
Circular_Monopile_(D=4cm)_(2).csv
    These files contain control-case data for a 4 cm diameter circular monopile tested in the flume. They are used as baseline cases for comparison with grouped SEAHIVE configurations. All columns have units. 

D=4_cm_equiv_SEAHIVE.csv
D=4_cm_equiv_SEAHIVE_(2).csv
    These files contain data for hydrodynamically equivalent SEAHIVE monopile experiments. They support direct comparison between a conventional circular monopile and a SEAHIVE monopile of equivalent hydraulic scale. All columns have units. 


Horizontal_SEAHIVES_(2D).csv
Horizontal_SEAHIVES_(2D)_(2).csv
Horizontal_SEAHIVES_(3D).csv
Horizontal_SEAHIVES_(3D.csv
Horizontal_SEAHIVES_(3D)_(2).csv
Horizontal_SEAHIVES_(4D).csv
Horizontal_SEAHIVES_(4D)_(2).csv
    These files contain grouped SEAHIVE experimental data for upstream spacings of 2D, 3D, and 4D relative to the circular monopile diameter. They are used to evaluate how spacing influences scour depth, flow interference, and equilibrium scour behavior. All columns have titles and units. 

Users should review each CSV file directly to confirm the exact column structure and units. 

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~ .stl File Naming ~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

10cm_cylinder.stl		A singular 10cm diameter pile. Used for validation of model against Roulund
4cm_cylinder.stl		A singular 4cm diameter pile. Used as a control for SEAHIVE groups
Case_II.stl			A SEAHIVE mono-pile where perforations start 12cm from the base of the pile. Noted as Case II in the report. 
Group_2D.stl			A pile spaced at 2D from a SEAHIVE group.
Group_3D.stl			A pile spaced at 3D from a SEAHIVE group.
Group_4D.stl			A pile spaced at 4D from a SEAHIVE group.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~ File Structure ~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

1) Download the files from Zenodo
2) Organize the files in the following structure

TEST_NAME/					← Case name
├── 0_org/
│	├── alpha.a
│	├── alphaPlastic
│	├── delta
│	├── epsilon.b
│	├── k.b
│	├── nut.b
│	├── omega.b
│	├── p_rbgh
│	├── pa
│	├── Theta
│	├── U.a
│	└── U.b
├── constant/
│	├── polyMesh/				← Mesh files will generate here on execution of command "blockMesh" and "snappyHexMesh -overwrite"
│	├── triSurface/
│	│	└── Cylinder.stl		← .stl file of SEAHVIVE(s) and/or pile group goes here named "Cylinder.stl"
│	├── filterProperties
│	├── forceProperties
│	├── g
│	├── granularRheologyProperties
│	├── interfacialProperties
│	├── kineticTheoryProperties
│	├── ppProperties
│	├── transportProperties
│	├── turbulenceProperties.a
│	├── turbulenceProperties.b
│	├── twophaseRASProperties
│	├── granularProperties			← Needed when using SedFoam
│	├── sedimentProperties			← Needed when using SedFoam
│	└── dragProperties			← Needed when using SedFoam
├── system/
│	├── blockMeshDict
│	├── controlDict
│	├── decomposeparDict
│	├── extrudeMeshDict
│	├── fvSchemes
│	├── fvSolution
│	├── mapFieldsDict
│	├── snappyHexMeshDict
│	└── snappyHexMeshDict_kEpsilon
├── Allclean
├── Allrun
└── m.Foam			← Need to create using command "touch m.Foam"


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~ Running a Model ~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

To run a model, execute the command "Allrun" or, run each command within the file line by line. 
"blockMesh" will generate a basic mesh and "snappyHexMesh" will refine the mesh and include the .stl file's boundaries.
The model was ran using OpenFOAM v2212.


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~ Viewing a Model ~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

To view a model, use ParaView and open the m.Foam file. 
