READ ME File For ‘Jet direction in bubble collapse within rectangular and triangular channels'

Dataset DOI: https://doi.org/10.5258/SOTON/D1151

READ ME Author: Lebo Molefe, University of Chicago

This dataset supports the publication:
‘Jet direction in bubble collapse within rectangular and triangular channels’ by Lebo Molefe and Ivo R. Peters
Physical Review E.

Contents
++++++++++

*** movies.csv ***
The raw data file is ‘movies.csv’, which contains data about all movies used in the article. The columns contain the following information:
Movie: movie number corresponding to a movie file name
Date: date the movie was recorded (ddmmyyyy)
Description: brief description of experiment being conducted
Series Number: number assigned to a group of experiments
Boundary Shape Number: number identifying a specific boundary shape assembly (5: 15 mm equilateral triangle, 8: 15 mm square)
Laser Power: laser power setting (0-1.00)
Attenuator: laser attenuator setting (0-1.0)
Frames Per Second: high-speed camera recording frame rate
Shutter Speed: camera lens shutter speed
Translation Stage X Position (mm): position recorded from translation stage x-position dial
Translation Stage Y Position (mm): position recorded from translation stage y-position dial
Translation Stage Z Position (mm): position recorded from translation stage z-position dial

*** calibrateddata.csv ***
The main data file is ‘calibrateddata.csv’, which contains data from all trials extracted from the movies 518-610 (equilateral triangle) and 624-658 (square). The columns contain the following information:
Movie Number: movie number corresponding to a movie file name
Trial Number: laser fire number from this movie
Bubble Appears: bubble detection result, 0 = no bubble and 1 = bubble present
Bubble Eccentricity: bubble eccentricity between 0 and 1, measure of how elliptical bubble is, measured at its first maximum area
Bubble Roundness: bubble roundness, equal to (4 * pi * a) / p^2, where a = area and p = perimeter, measured at its first maximum area
x_0_calibrated: bubble centroid x-position at its first maximum area
y_0_calibrated: bubble centroid y-position at its first maximum area
Area (sq. pixels): bubble area in pixels
x_1_calibrated: bubble centroid x-position at its second maximum area
y_1_calibrated: bubble centroid y-position at its second maximum area
Jet Angle (radians): angle of vector between the two calibrated points

*** figure02.py ***
Python code that plots the example movies from the square and triangle experiments.
Requires: mraw.py
This corresponds to Figure 2.

*** figure03.py ***
Python code that plots diagrams of method of images solutions for various boundary conditions: (a) flat wall, (b) 60 degree corner, (c) parallel walls, (d) semi-enclosed parallel walls, (e) rectangle, (f) equilateral triangle, (g) isosceles right triangle, and (h) 30-60-90 degree right triangle.
Requires: sink_positions.py
This corresponds to Figure 3.

*** figure04.py ***
Python code that plots predictions of jet direction within four shapes: (a) square, (b) equilateral triangle, (c) isosceles right triangle, and (d) 30-60-90 degree right triangle.
Requires: sink_positions.py, fluid_velocity.py, jet_angle.py
This corresponds to Figure 4.

*** figure05.py ***
Python code that plots volatility of the jet angle by color, to show sensitivity to position in various areas of each shape: (a) square, (b) equilateral triangle, (c) isosceles right triangle, and (d) 30-60-90 degree right triangle.
Requires: square_volatility.csv, equilateral_triangle_volatility.csv, isosceles_right_triangle_volatility.csv, 306090_triangle_volatility.csv
* The above csv files were produced by figure05_calculations.py.
This corresponds to Figure 5.

*** figure06.py ***
Python code that plots results of experiments within a square channel.
Requires: sink_positions.py, fluid_velocity.py, jet_angle.py

*** figure07.py ***
Python code that plots results of experiments within an equilateral triangular channel.
Requires: sink_positions.py, fluid_velocity.py, jet_angle.py


Geographic location of data collection: University of Southampton, U.K.

Data available under a CC BY 4.0 license

Related projects: EP/P012981/1

Publisher: University of Southampton, U.K.

Date: July 2019