Article

Introducing Turbulence Realm-Tracker

May 31, 2025

The Turbulence Realm-Tracker interface tracking bubbles in a fluid-flow video
turbulencerealm.com

Anyone who has studied bubbles or particles in a flow video knows the ritual: step forward a frame, click on the bubble, note its position, step forward again, and repeat until the coffee runs out. I built Turbulence Realm-Tracker to end that ritual in my own research, and to turn a pile of video into calibrated, physical numbers.

The idea is simple. Load a video, tell the software how long something in the picture really is, draw a box around each bubble you care about, and let it follow them. Under the hood, a Dlib correlation tracker follows each bubble, while the software converts every pixel of motion into metres and metres per second.

How it works

Videos in the common formats (MP4, AVI, MOV and MPEG) open with a drag and drop. A line drawn across a known distance in the frame sets the scale, and from then on every measurement is in physical units. Each bubble is selected with a rectangle and added to a list, and the software reports its starting size in both pixels and metres.

Then the tracker takes over, following each bubble through the whole video while velocity and displacement plots build up live on screen. When it is done, the raw data (positions per frame, velocity components and speed, displacement components and magnitude) exports to a time-stamped CSV file that also records the initial bubble size, and the plots save as high-resolution images ready for a report. An Analyze button summarises every tracked bubble at once: average and peak speed, final displacement and starting size.

Load, calibrate, select, track, analyse, save: the whole method fits in a single line.

Why it matters

The first gain is accuracy. Because everything is calibrated, the results are physical quantities rather than pixel counts, and they can go straight into a scientific comparison. The second is time: sequences that once took an afternoon of clicking are processed in minutes.

Just as important, the tool stays approachable. The graphical interface and the step-by-step flow make it usable by people with very different levels of technical background, while the live plots let the user watch the analysis unfold and stop it the moment something looks wrong. The researcher keeps control of the calibration, the choice of bubbles and the run itself; the software simply removes the drudgery between them.