Froth monitor is an interactive GUI application for analyzing froth videos in real-time or offline. It allows users to draw Regions of Interest (ROIs), track froth movement using optical flow algorithm (more algorithms in the future), and export detailed analysis results, including delta pixels between frames, velocity data and timestamps. It allows user to calibrate the ratio of pixel to real distance by ruler drawing, and define the overflow direction of froths by arrow drawing. It is also capable of recording real-time video from the camera.
-
Clone the repository:
git clone https://github.com/gyyyno1/Froth_monitor.git
-
Navigate to the project directory:
cd your-repo -
Install dependencies by poetry
pipx install poetry poetry install
-
Run the application by poetry
poetry run python -m froth_monitor
A dynamic and interactive application designed to analyze and visualize froth movement from video data using advanced image processing and data visualization techniques.
Draw, lock, and display an arrow indicating the direction of froth overflow. Customizable and adjustable arrow direction for flexible analysis.
Draw rulers on the video canvas to calibrate the distance between two points. The distance between the two points is calculated and displayed on the canvas.
Draw multiple ROIs on the video canvas. Real-time movement analysis for each ROI. Axis visualization (X and Y axes) within each ROI to track movement.
Real-time velocity analysis for each ROI. Velocity data is displayed in a Cartesian coordinate system. Velocity data is exported to an Excel file.
This program is able to record the video stream directly from the camera. In case that the user want to re-analyze the video.
Export analysis results as Excel files. Customizable file naming and export directory. Separate sheets for each ROI in the Excel output.
Save and end the current session, clearing ROIs and resetting the interface for a new analysis.
- Mr Yiyang Guan - Department of Earth Science and Engineering, Imperial College London