/palagram_monograph

Primary LanguageTeXCreative Commons Attribution 4.0 InternationalCC-BY-4.0

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