READ ME File For 'Cavity collapse near slot geometries'

ReadMe Author: Elijah Andrews, University of Southampton

This dataset supports the publication:
'Cavity collapse near slot geometries' by Elijah Andrews, David Fernandez Rivaz and Ivo R. Peters, Journal of Fluid Mechanics (2020)

Contents
++++++++

This archive has two sections, Code and Data.

--------
Code
--------
- bem: Code used for the Boundary Element Method, including an example slot sweep model.
    - bem.py: The BEM calculation code.
    - slot.py: The slot sweep model.
    - util/: Utility functions.
- figure_plots: Code to generate graph figures found in the paper and supporting data.
    - all_direct_comparisons.py: Code to generate all the numerical vs experimental comparison plots.
    - figureN.py: Code to generate figure N.
    - figureN_data/: Additional data required to generate figure N.
    - experiment_data/: Processed experiment data. This is duplicated from the main Data section for convenience.
    - model_predictions/: Numerical model data for configurations matching the experiment data.
    - util/: Utility functions.

--------
Data
--------
- Processed Data/: Data processed into x vs theta (as in the paper) formats.
    - Experimental Data/
        - raw_data/:
            Data for each individual bubble collapse processed into x and theta measurements. Each file contains one sweep. File names refer to the geometry label (e.g. W2H3a) and the mean Y value for that sweep (e.g. Y3.89).
        - mean_data/:
            Data for bubble collapses where each X position is grouped and the mean and 99% confidence interval of theta is calculated. File names refer to the geometry label (e.g. W2H3a) and the mean Y value for that sweep (e.g. Y3.89).
        - shifted_data:
            The same data as in 'raw_data/' but with data points shifted to account for measured offsets.
        - shifted_mean_data:
            The same data as in 'mean_data/' but with data points shifted to account for measured offsets.
    - Numerical Predictions/:
        Contains numerical predictions for each experimental configuration. Named by W, H, and Y values. The final three file name numbers refer to the number of panels used, the panel density ratio, and the w threshold at which the density variation is applied.
- Raw Data/: Raw experimental data with one directory for each geometry. Geometry directories contain the following files.
    - movie_SXXXX/: Movie directory for bubbles at position index XXXX.
        - video_N.mp4: MP4 file for repeat N at the given index. All repeats are included, even where no bubble was created or the data was invalid.
        - analysis_plot_rN.png: Analysis plot to verify the analysis for repeat N. The two maxima frames are plotted in both original grayscale and binary as well as the bubble area variation graph and a visual of the calculated direction. All analysis plots are included, although some were subsequently flagged as invalid.
    - description.txt: A file with notes from the experiments. Typically containing laser settings, approximate geometry dimensions, and a brief description.
    - index.csv: A CSV file with columns relating the x and y measurements from the translation stage and the corresponding movie index (XXXX above).
    - params.py: A Python file containing measurements from the geometry including slot geometry measurements, position of the geometry in frame, and the mm per pixel ratio for the movies.
    - readings_dump.csv: A CSV file containing all of the processed movie data including bubble positions, translation vectors, and some other useful parameters. The '#' at the beginning of some lines denotes a reading that was flagged as invalid.



Publisher: University of Southampton, U.K.

Date: June 2020