Bubble dynamics data for oscillating gas flow as inlet to a quasi(pseudo) 2D fluidized bed

# README

## Dataset Title

Bubble dynamics data for oscillating gas flow as inlet to a quasi(pseudo) 2D fluidized beds.

## Description

This dataset contains 35 comma-separated values (CSV) files, each representing a unique gas flow condition with a sinusoidal modulation around a specific mean operating velocity. The sinusoidal flow profiles use five amplitude values: 0.0, 0.25, 0.5, 0.75, and 1.0.

For each amplitude, the mean gas flow velocities are set to seven discrete values: 12.8, 16.0, 19.2, 25.6, 32.0, 38.4, and 44.8 liters per minute (L/min). These values are selected as integer multiples of the experimentally determined minimum fluidization velocity, which is 12.8 L/min.

Each file is named using the following format:

VXX_AmpY.Y_umfZ.Z

Where:
- VXX indicates the video number (e.g., V01 for video 1)
- AmpY.Y refers to the amplitude of the sinusoidal flow modulation (e.g., Amp0.25 for 0.25 amplitude)
- umfZ.Z represents the multiple of the minimum fluidization velocity used as the mean flow rate (e.g., umf2.0 means 2.0 × 12.8 L/min)

For example, the filename "V01_Amp0.0_umf1.0" refers to video 1, with an amplitude of 0.0 and a mean gas flow rate equal to 12.8 L/min.

The dataset is structured so that:
- The first 7 videos represent the 7 mean velocities at an amplitude of 0.0
- The next 7 videos correspond to the same 7 velocities at an amplitude of 0.25
- This pattern continues through all five amplitude levels

This results in a total of 5 amplitudes × 7 velocities = 35 distinct flow conditions.

The table table below provides the valve settings and calculated operating velocities used to produce each oscillating gas flow profile.

| Video Name | Amplitude | Operating Velocity | Valve 1 & 5 | Valve 2 & 4 | Valve 3 |
|------------|-----------|--------------------|-------------|-------------|---------|
| V01        | 0         | 12.8               | 12.8        | 12.8        | 12.8    |
| V02        | 0         | 16.0               | 16.0        | 16.0        | 16.0    |
| V03        | 0         | 19.2               | 19.2        | 19.2        | 19.2    |
| V04        | 0         | 25.6               | 25.6        | 25.6        | 25.6    |
| V05        | 0         | 32.0               | 32.0        | 32.0        | 32.0    |
| V06        | 0         | 38.4               | 38.4        | 38.4        | 38.4    |
| V07        | 0         | 44.8               | 44.8        | 44.8        | 44.8    |
| V08        | 0.25      | 12.8               | 10.2        | 13.8        | 16.0    |
| V09        | 0.25      | 16.0               | 12.7        | 17.3        | 20.0    |
| V10        | 0.25      | 19.2               | 15.3        | 20.7        | 24.0    |
| V11        | 0.25      | 25.6               | 20.4        | 27.6        | 32.0    |
| V12        | 0.25      | 32.0               | 25.5        | 34.5        | 40.0    |
| V13        | 0.25      | 38.4               | 30.6        | 41.4        | 48.0    |
| V14        | 0.25      | 44.8               | 35.7        | 48.3        | 56.0    |
| V15        | 0.5       | 12.8               | 7.6         | 14.8        | 19.2    |
| V16        | 0.5       | 16.0               | 9.5         | 18.5        | 24.0    |
| V17        | 0.5       | 19.2               | 11.4        | 22.2        | 28.8    |
| V18        | 0.5       | 25.6               | 15.2        | 29.6        | 38.4    |
| V19        | 0.5       | 32.0               | 18.9        | 37.0        | 48.0    |
| V20        | 0.5       | 38.4               | 22.7        | 44.4        | 57.6    |
| V21        | 0.5       | 44.8               | 26.5        | 51.8        | 67.2    |
| V22        | 0.75      | 12.8               | 5.0         | 15.8        | 22.4    |
| V23        | 0.75      | 16.0               | 6.2         | 19.8        | 28.0    |
| V24        | 0.75      | 19.2               | 7.4         | 23.7        | 33.6    |
| V25        | 0.75      | 25.6               | 9.9         | 31.6        | 44.8    |
| V26        | 0.75      | 32.0               | 12.4        | 39.5        | 56.0    |
| V27        | 0.75      | 38.4               | 14.9        | 47.4        | 67.2    |
| V28        | 0.75      | 44.8               | 17.4        | 55.3        | 78.4    |
| V29        | 1.0       | 12.8               | 2.4         | 16.8        | 25.6    |
| V30        | 1.0       | 16.0               | 2.9         | 21.0        | 32.0    |
| V31        | 1.0       | 19.2               | 3.5         | 25.2        | 38.4    |
| V32        | 1.0       | 25.6               | 4.7         | 33.6        | 51.2    |
| V33        | 1.0       | 32.0               | 5.9         | 42.0        | 64.0    |
| V34        | 1.0       | 38.4               | 7.1         | 50.4        | 76.8    |
| V35        | 1.0       | 44.8               | 8.2         | 58.8        | 89.6    |

Each recorded video captures one minute of operation of the fluidized bed, with a frame rate of 50 fps. The files are in CSV format. The data represented in each column is as follows:

 1. video_name: Video data used to generate the numerical data
 2. frame_number: Activity capture at a particular frame
 3. time[sec]: Time of recording the activity in the bed
 4. num_contours_per_frame: Number of bubbles detected for a particular frame
 5. ID: Individual ID for each bubble at a frame
 6. cx_pos[px]: Bubble position in x direction in pixels
 7. cx_pos[m]: Bubble position in x direction in meters relative to the fluidized beds
 8. cy_pos[px]: Bubble position in y direction in pixels
 9. cy_pos[m]: Bubble position in y direction in meters relative to the fluidized beds
10. size[px^2]: Bubble size in pixels
11. size[m^2]: Bubble size in meters relative to the fluidized beds
12. perimeter[px]: Bubble perimeter in pixels
13. perimeter[m]: Bubble perimeter in meters relative to the fluidized beds
14. approx_diameter[px]: Approximated diameter of bubble in pixels
15. approx_diameter[m]: Approximated diameter of bubble in meters relative to the fluidized beds
16. x_velocity[m/s]: Bubble velocity in x direction
17. y_velcoity[m/s]: Bubble velocity in y direction 18: valve* : Last five columns represent individual valve velocities in L/min

## Data Format

The data format is CSV

This work is funded by the Deutsche Forschungsgemeinschaft (DFG, German Research Foundation), SPP 2364, project number 504548777.