ddg93/LeRing_JFM_experiments

Overview

This dataset repository contains training data and experimental recordings to measure the rotations of particles suspended in viscous shear flows.

This dataset is intended to support the development of machine learning research in fluid dynamics, especially in the study of multi-phase flows.

Content

The repository contains training data and extensive experimental measurements of single particle suspended in confined shear flows in the viscous and small-inertial regime. As of today, the dataset includes the following particles:

• —oblate spheroid ELL_r06 with particle aspect ratio r=0.56;

Organization

Training data and experimental recordings are separated by particle shape. Within each particle folder, the following hierarcy is created:

particle_folder/
├── dataset/
│ ├── top_view/
│ │ ├── TOP_*.jpg
│ ├── side_view/
│ │ ├── SIDE_*.jpg
├── experiments/
│ ├── Rep_**/
│ │ ├── above/
│ │ │ └──  outpy_9_*.avi
│ │ ├── side/
│ │ │ └── outpy_9_*.avi
│ │ └── infos.txt
│ └── sizes.txt

Training dataset

The dataset directory contains the synthetic training data for the two coupled top/side perpendicular camera views, stored in separated folders and name with matching patterns. The top/side image names contain the corresponding true labels, encoded in their file names as the three components of the particle orientation vector n=(n1,n2,n_3).

Experimental recordings

Particle rotations in viscous shear flows were observed under controlled laboratory conditions, and their rotational dynamics were captured through perpendicular camera views. See our articles [1] and [2] for more details about the measurements and our study on the influence of inertia on Jeffery orbits for axis-symmetric and -asymmetric suspended particles.

The experiments directory contains the measurements of multiple experimental sessions at constant particle Reynolds number (the free controlling parameter, Rep), stored in separate sub-folders, e.g. Rep=0.02. Recordings are separated according to the top/side camera that captured them inside the above and side sub-folders.

Details about the experimental session are given in the infos.txt files: these include the fluid density, the fluid viscosity, the mean shear rate and the error on the shear rate measurement. Details about the particle size are given in sizes.txt: these include the mean diameter, the error on the diameter measurement, the mean particle axial length, the error on the axial length measurement.

Model training

See this GitHub repository for an example of model training over the given particle dataset.

License

This dataset is licensed under a cc-by-4.0 license. You are free to use, share, and adapt this dataset for any purpose, provided you give appropriate credit to the original author.

Citation

If you use this dataset in your work or are inspired by our approach, please cite:

[1] Di Giusto, D. and Bergougnoux L. and Guazzelli, É., 2025. Orientation of flat bodies of revolution in shear flows at low Reynolds number, Journal of Fluid Mechanics, 1017, P.A41

and

[2] Di Giusto, D. and Bergougnoux, L. and Marchioli, C. and Guazzelli, É., 2024. Influence of small inertia on Jeffery orbits, Journal of Fluid Mechanics, 979, p.A42.

Contact

For questions or collaborations, please contact me on the forum: ddg93

Thank you for your interest!