What problem does it solve?
Measuring fluid velocity from experimental Particle Image Velocimetry image pairs requires cross-correlation, vector validation, outlier replacement, and unit scaling, which is error-prone to implement from scratch and easy to misconfigure across OpenPIV versions.
Core Features & Use Cases
- PIV Cross-Correlation: Run single-pass or multi-pass window-deformation analysis on image pairs with tunable window size, overlap, and search area.
- Vector Validation & Post-Processing: Flag spurious vectors via signal-to-noise, global range, and local median tests, then replace outliers or mask them as NaN.
- Derived Quantities: Compute vorticity, strain rate, and turbulence statistics from saved velocity fields with correct grid spacing and axis orientation.
- Use Case: Given a pair of PIV images from a wind tunnel experiment, run the bundled CLI to produce a scaled vector field plot, a vectors.txt file, and a params.npz archive ready for vorticity and turbulence analysis.
Quick Start
Use the openpiv skill to analyze my PIV image pair frame_a.bmp and frame_b.bmp and generate the velocity vector field with vorticity statistics.