Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

Abstract

uPrime is an open-source, cross-platform desktop application for the post-processing and turbulence analysis of planar velocity fields obtained from particle image velocimetry (PIV) and computational fluid dynamics (CFD). The software provides an integrated graphical environment covering the full range of standard turbulence diagnostics: mean velocity profiles with cumulative-statistics convergence verification, Reynolds normal and shear stresses, turbulent kinetic energy (TKE) budgets, one-dimensional and two-dimensional spatial and temporal power spectral densities, two-point spatial and temporal correlation functions with automatic integral length and time scale extraction, turbulence anisotropy analysis via the Lumley triangle and barycentric maps, snapshot Proper Orthogonal Decomposition (POD) with modal energy spectra and low-order flow field reconstruction, Dynamic Mode Decomposition (DMD) with frequency-growth rate spectra and spatial mode visualization, vortex identification using five scalar criteria including gradient-based methods and the Graftieaux Γ\Gamma functions, and probability analysis comprising velocity and fluctuation probability density functions, forward- and reverse-flow probability maps for separation diagnostics, binary space-time maps of coherent structure passage, and quadrant analysis of the Reynolds shear stress with hole-size conditioning. All analyzes are accessible through a labeled graphical interface without requiring programming knowledge, making the tool accessible to students and researchers new to quantitative flow analysis.

uPrime reads multi-snapshot Tecplot ASCII .dat files exported from LaVision DaVis, as well as MATLAB .mat files (classic v5/v7 and HDF5-based v7.3). It supports both 2D two-component (2D2C) and stereo three-component (2D3C) PIV datasets. It includes coordinate transformation tools for correcting camera calibration misalignment, snapshot subsampling for efficient handling of large time-resolved datasets, and a multi-case import and comparison workflow for overlaying results from different experiments or runs. Figures are exportable as PNG (300 DPI) or vector graphics (PDF, SVG) with editable text, facilitating direct integration into publication workflows.

Keywords: particle image velocimetry; turbulence post-processing; Reynolds stresses; turbulent kinetic energy budget; power spectral density; two-point correlation; integral length scale; Lumley triangle; Proper Orthogonal Decomposition; Dynamic Mode Decomposition; vortex identification; probability density function; quadrant analysis; ejections and sweeps; reverse-flow probability; backflow coefficient; binary space-time map; mean and convergence; MATLAB .mat input; open-source software; LaVision DaVis