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.

Vortex Identification

Open from ‘3. Analysis →\to Vortex Identification‘.

Vortex identification methods seek to objectively define the boundary and core of a vortex from the instantaneous or mean velocity field. uPrime implements five scalar criteria, which can be broadly divided into gradient-based (Eulerian) methods and the integral-based Graftieaux criteria.

Gradient-based methods

All four gradient-based methods derive from the 2D velocity gradient tensor:

∇u=(∂u/∂x∂u/∂y∂v/∂x∂v/∂y)\nabla \mathbf{u} = \begin{pmatrix} \partial u/\partial x & \partial u/\partial y \\ \partial v/\partial x & \partial v/\partial y \end{pmatrix}

which is decomposed into its symmetric strain rate S=12(∇u+∇u⊤)\mathbf{S} = \tfrac{1}{2}(\nabla\mathbf{u} + \nabla\mathbf{u}^\top) and antisymmetric rotation rate Ω=12(∇u−∇u⊤)\boldsymbol{\Omega} = \tfrac{1}{2}(\nabla\mathbf{u} - \nabla\mathbf{u}^\top).

References: Hunt, J.C.R., Wray, A. & Moin, P. (1988). Eddies, stream, and convergence zones in turbulent flows. CTR Report CTR-S88, 193–208. Zhou, J., Adrian, R.J., Balachandar, S. & Kendall, T.M. (1999). Mechanisms for generating coherent packets of hairpin vortices in channel flow. Journal of Fluid Mechanics, 387, 353–396. Jeong, J. & Hussain, F. (1995). On the identification of a vortex. Journal of Fluid Mechanics, 285, 69–94.

Graftieaux Γ\Gamma functions

The Γ\Gamma functions (Graftieaux et al., 2001) are computed directly from the velocity vectors without differentiation, making them substantially more robust to PIV measurement noise:

Γ1(P)=1N∑M∈Ssin⁡ ⁣(PM, UM^),Γ2(P)=1N∑M∈Ssin⁡ ⁣(PM, UM−U~^)\Gamma_1(P) = \frac{1}{N} \sum_{M \in \mathcal{S}} \sin\!\left(\widehat{\mathbf{PM},\, \mathbf{U}_M}\right), \qquad \Gamma_2(P) = \frac{1}{N} \sum_{M \in \mathcal{S}} \sin\!\left(\widehat{\mathbf{PM},\, \mathbf{U}_M - \widetilde{\mathbf{U}}}\right)

where S\mathcal{S} is a local neighborhood of NN points around PP, (⋅,⋅)^\widehat{(\cdot,\cdot)} denotes the angle between two vectors, and U~\widetilde{\mathbf{U}} is the local mean velocity over S\mathcal{S}. Both functions are bounded between -1 and +1. The sign gives the rotation direction (+1 = CCW, -1 = CW). A vortex core is identified where ∣Γ1∣>0.6|\Gamma_1| > 0.6–0.7; the vortex boundary is where ∣Γ2∣>2/π≈0.64|\Gamma_2| > 2/\pi \approx 0.64. The neighborhood half-width SS (default 2, corresponding to a 5×55 \times 5 stencil) is user-adjustable.

Reference: Graftieaux, L., Michard, M. & Grosjean, N. (2001). Combining PIV, POD and vortex identification algorithms for the study of unsteady turbulent swirling flows. Measurement Science and Technology, 12(9), 1422–1429.

Field View tab

The threshold is expressed as a fraction of the field maximum, making it dataset-agnostic. The actual physical value is shown in the readout next to the slider. For the Γ\Gamma criteria the threshold has a universal meaning (∣Γ1∣=0.6|\Gamma_1| = 0.6 corresponds to the standard core boundary); for gradient-based criteria it is dataset-dependent and must be chosen by the user.

Vortex Identification window showing the swirling strength \lambda_{ci} field for an instantaneous snapshot. Detected vortex boundaries (black contour lines) are overlaid on the colormap. The threshold is set to 15% of the field maximum. Red regions indicate positive (CCW) rotation; blue regions indicate negative (CW) rotation. A total of 94 vortices are detected above the minimum area threshold.

Figure 1:Vortex Identification window showing the swirling strength λci\lambda_{ci} field for an instantaneous snapshot. Detected vortex boundaries (black contour lines) are overlaid on the colormap. The threshold is set to 15% of the field maximum. Red regions indicate positive (CCW) rotation; blue regions indicate negative (CW) rotation. A total of 94 vortices are detected above the minimum area threshold.

Vortex Statistics tab

After clicking ‘Show Statistics‘, two plots appear: a spatial probability map showing how often a vortex is detected at each grid point across all snapshots, and a histogram of the selected per-vortex quantity (area, circulation, or aspect ratio) with positive and negative vortices shown separately in red and blue.

Vortex Statistics view. Top: spatial probability map showing the fraction of snapshots in which a vortex is detected at each grid point (viridis colormap, 0–1). Yellow regions indicate persistent vortex locations concentrated in the shear layers. Bottom: circulation histogram for 94 detected vortices (50 CCW in red, 44 CW in blue). The near-symmetric distribution about zero is consistent with a turbulent shear layer with no mean rotation bias.

Figure 2:Vortex Statistics view. Top: spatial probability map showing the fraction of snapshots in which a vortex is detected at each grid point (viridis colormap, 0–1). Yellow regions indicate persistent vortex locations concentrated in the shear layers. Bottom: circulation histogram for 94 detected vortices (50 CCW in red, 44 CW in blue). The near-symmetric distribution about zero is consistent with a turbulent shear layer with no mean rotation bias.

Exporting

Click ‘Export scalar field…‘ to save the scalar field as a Tecplot .dat file. Click ‘Export vortex table (CSV)…‘ to save a per-vortex table with columns: vortex ID, centroid position, area, sign, circulation, aspect ratio, and frame index. The default filename now reflects the active criterion (e.g. vortex_lambda_ci_dataset.csv). This CSV is designed to be imported into post-processing scripts for vortex tracking or further statistical analysis.