Data and codes for "Chapter 16: Particle-laden gravity currents: the lock-release slumping regime at the laboratory scale"

PALAGRAM Monograph

This repository contains the data used in the research paper:

Gadal C., Schneider J., Bonamy C., Chauchat J., Dossmann Y., Kiesgen de Richter S., Mercier M. J., Naaim-Bouvet F., Rastello M., and Lacaze L. Chapter 16: Particle-laden gravity currents: the lock-release slumping regime at the laboratory scale. Submitted to AGU Monograph.

Repository organization

palagram_monograph
│
└───data: data are stored here
│ └───input_data: input data as sent by everyone
│ └─── ... : NETCDF files
│ └───output_data: processed data output by analysis.py (also contains input_data)
│ └─── ... : NETCDF files
└───analysis:
└───analysis.py: analysis code, that reads input_data and writes output_data
└───paper: contains source files for article
│ └───figures: contains source figures
│ └─── ... : PDF files
│ └─── figure_scripts: contains figure scripts that reads data in data/output_data and writes figures in paper/figures
│ └─── *.py : python scripts for figures
│ └─── ... : various files (.tex, .bib, ...)
│ └─── main.pdf : article preprint

Data organization

The CSV file dataset_summary.csv offers a summary of all runs and corresponding experimental parameters, allowing for easier access to the data.

The folder data/output_data contains 287 netcdf4 files corresponding to each experimental run used in the paper. For each run, the structure of the NetCDF file is the following:

attributes:

particle_type: particle type used (silica sand, glass beads, etc..)

label: filename

lab: lab where this run has been performed

run_oldID: Old filename, corresponding to the experimental notebook

author: author(s) that acquired this run

setup: setup used to acquire the data. See article.

dataset: Dataset classification of this run, See paper.

dimensions(sizes): time(n)

variables(dimensions):

At(): Atwood number

Fr(): Froude number (adi. initial current velocity)

H0(): initial heavy fluid height inside the lock

H_a(): ambient fluid height outside the lock

L0(): streamwise lock length

L_1(): streamwise tank length after the lock

Re(): Reynolds number

S(): Settling number

St(): Stokes number

T_a(): ambient temperature

T_f(): heavy fluid temperature inside the lock

W0(): crossstream lock width

a(): lock aspect ratio

alpha(): bottom slope

d(): particle diameter

gprime(): specific gravity

lamb(): adi. attenuation parameter

nu_a(): ambient viscosity

nu_f(): heavy fluid lock viscosity

phi(): initial particle volume fraction inside the lock

rho_a(): ambient fluid density

rho_c(): heavy fluid mix density inside the lock

rho_f():

rho_p(): particle density

t('time',): time vector

t0(): characteristic timescale, t0 = L0/u0

u0(): characteristic velocity scale, u0 = sqrt(gprime*H0)

vs(): particle Stokes velocity

x_front('time',): front position vector

Variables can sometimes possess the following attributes:

unit: corresponding unit

std: error(s) on the given quantity, calculated by error propagation from measurement uncertainties using the uncertainties module (https://pythonhosted.org/uncertainties/) in Python.

comments: comments on the given quantity (definition, formulas, etc ..)

Related works

Gadal, C., Mercier, M. J., Rastello, M., & Lacaze, L. (2023). Slumping regime in lock-release turbidity currents. Journal of Fluid Mechanics, 974, A4. doi:10.1017/jfm.2023.762

Gadal, C., Mercier, M., Rastello, M., & Lacaze, L. (2023). Data used in 'Slumping regime in lock-release turbidity currents' [Data set]. In Journal of Fluid Mechanics (Vol. 974, p. A4). Zenodo. https://doi.org/10.5281/zenodo.10058946

Schneider, J., Dossmann, Y., Farges, O. et al. Investigation of particle laden gravity currents using the light attenuation technique. Exp Fluids, 64, 23 (2023). doi:10.1007/s00348-022-03562-y

Chauchat, J., Cheng, Z., Nagel, T., Bonamy, C., and Hsu, T.-J. (2017) SedFoam-2.0: a 3-D two-phase flow numerical model for sediment transport, Geosci. Model Dev., 10, 4367-4392, doi:10.5194/gmd-10-4367-2017 and github