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

<div> <div> <h1>PALAGRAM Monograph</h1> </div> <p>This repository contains the data used in the book chapter:</p> <blockquote> <p>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. (2025).&nbsp;<strong>Particle-laden Gravity Currents: The Lock-release Slumping Regime at the Laboratory Scale.</strong> In Particulate Gravity Currents.&nbsp;<a href="https://doi.org/10.1002/9781394216727.ch2">10.1002/9781394216727.ch2</a></p> </blockquote> <div> <h2>Repository organization</h2> </div> <div> <pre><code> 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 </code></pre> <div>&nbsp;</div> </div> <div> <h2>Data organization</h2> </div> <p>The CSV file <code>dataset_summary.csv</code> offers a summary of all runs and corresponding experimental parameters, allowing for easier access to the data.</p> <p>The folder <code>data/output_data</code> 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:</p> <ul> <li> <p>attributes:</p> <ul> <li>particle_type: particle type used (silica sand, glass beads, etc..)</li> <li>label: filename</li> <li>lab: lab where this run has been performed</li> <li>run_oldID: Old filename, corresponding to the experimental notebook</li> <li>author: author(s) that acquired this run</li> <li>setup: setup used to acquire the data. See article.</li> <li>dataset: Dataset classification of this run, See paper.</li> </ul> </li> <li> <p>dimensions(sizes): time(n)</p> </li> <li> <p>variables(dimensions):</p> <ul> <li>At(): Atwood number</li> <li>Fr(): Froude number (adi. initial current velocity)</li> <li>H0(): initial heavy fluid height inside the lock</li> <li>H_a(): ambient fluid height outside the lock</li> <li>L0(): streamwise lock length</li> <li>L_1(): streamwise tank length after the lock</li> <li>Re(): Reynolds number</li> <li>S(): Settling number</li> <li>St(): Stokes number</li> <li>T_a(): ambient temperature</li> <li>T_f(): heavy fluid temperature inside the lock</li> <li>W0(): crossstream lock width</li> <li>a(): lock aspect ratio</li> <li>alpha(): bottom slope</li> <li>d(): particle diameter</li> <li>gprime(): specific gravity</li> <li>lamb(): adi. attenuation parameter</li> <li>nu_a(): ambient viscosity</li> <li>nu_f(): heavy fluid lock viscosity</li> <li>phi(): initial particle volume fraction inside the lock</li> <li>rho_a(): ambient fluid density</li> <li>rho_c(): heavy fluid mix density inside the lock</li> <li>rho_f():</li> <li>rho_p(): particle density</li> <li>t('time',): time vector</li> <li>t0(): characteristic timescale, t0 = L0/u0</li> <li>u0(): characteristic velocity scale, u0 = sqrt(gprime*H0)</li> <li>vs(): particle Stokes velocity</li> <li>x_front('time',): front position vector</li> </ul> </li> </ul> <p>Variables can sometimes possess the following attributes:</p> <ul> <li>unit: corresponding unit</li> <li>std: error(s) on the given quantity, calculated by error propagation from measurement uncertainties using the <code>uncertainties</code> module (<a href="https://pythonhosted.org/uncertainties/" rel="nofollow">https://pythonhosted.org/uncertainties/</a>) in Python.</li> <li>comments: comments on the given quantity (definition, formulas, etc ..)</li> </ul> <div> <h2>Related works</h2> </div> <ul> <li> <p>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. (2025). Particle-laden Gravity Currents: The Lock-release Slumping Regime at the Laboratory Scale. In Particulate Gravity Currents.&nbsp;<a href="https://doi.org/10.1002/9781394216727.ch2">10.1002/9781394216727.ch2</a></p> </li> <li>Gadal, C., Mercier, M. J., Rastello, M., &amp; Lacaze, L. (2023). Slumping regime in lock-release turbidity currents. <em>Journal of Fluid Mechanics</em>, 974, A4. <a href="https://doi.org/10.1017/jfm.2023.762" rel="nofollow">doi:10.1017/jfm.2023.762</a></li> <li> <p>Gadal, C., Mercier, M., Rastello, M., &amp; Lacaze, L. (2023). Data used in 'Slumping regime in lock-release turbidity currents' [Data set]. In Journal of Fluid Mechanics (Vol. 974, p. A4). <em>Zenodo</em>. <a href="https://doi.org/10.5281/zenodo.10058946" rel="nofollow">https://doi.org/10.5281/zenodo.10058946</a></p> </li> <li> <p>Schneider, J., Dossmann, Y., Farges, O. et al. Investigation of particle laden gravity currents using the light attenuation technique. <em>Exp Fluids</em>, 64, 23 (2023). <a href="https://doi.org/10.1007/s00348-022-03562-y" rel="nofollow">doi:10.1007/s00348-022-03562-y</a></p> </li> <li> <p>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, <em>Geosci. Model Dev.</em>, 10, 4367-4392, <a href="https://doi.org/10.5194/gmd-10-4367-2017" rel="nofollow">doi:10.5194/gmd-10-4367-2017</a> and <a href="https://github.com/sedfoam/sedfoam">github</a></p> </li> </ul> </div>