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.

Tips, Workflow, and Troubleshooting

For any new dataset, follow this order:

  1. Load your files (.dat or .mat). Use stride subsampling if the dataset is large.

  2. Set acquisition type and fsf_s in the popup dialog or the info ribbon.

  3. Transform: rotate to correct tilt, shift the origin to a physical reference.

  4. Inspect the mean field. Does the flow look correct? Right direction, sensible magnitudes?

  5. Mean & Convergence: plot the mean velocity profile through your region of interest, then check at a representative point that first and second moments are converged. Skip ⟨u′u′u′⟩\langle u'u'u' \rangle if your dataset is small.

  6. Reynolds stresses: identify turbulent regions and shear layers.

  7. TKE budget: understand energy production and transport.

  8. Correlations: measure integral length and time scales.

  9. POD: identify dominant coherent structures.

  10. DMD (TR only): extract frequency-specific coherent modes.

  11. Vortex identification: locate and quantify vortex cores.

  12. Export results. Use the multi-case workflow to overlay against benchmark data when relevant.

Performance tips

Exporting figures for publication

Known limitations

Common issues

Common issues and solutions.

IssueSolution
Files do not load (.dat)Confirm files are Tecplot ASCII format from DaVis. Binary .dat files are not supported.
.mat load shows “Insufficient Snapshots” immediatelyThe file contains only one snapshot. uPrime requires multiple snapshots. Re-export from MATLAB with the time axis included as the third dimension of u, v, etc.
.mat variable dialog cannot find uThe velocity variable name is not in the recognized list. Use the manual dropdowns in the dialog to map your variables to xx, yy, uu, vv, etc.
.mat dx/dy shown as 0.000 mmCoordinate arrays are degenerate (all values equal along one axis), or the meshgrid orientation could not be inferred. Check that x and y contain real coordinate values.
Anisotropy module is greyed outData is 2D2C. This module requires stereo (2D3C) data with a WW component.
DMD button is greyed outSet Acquisition Type to TR in the info ribbon and ensure at least 50 snapshots are loaded.
Temporal tabs are greyed outSet Acquisition Type to Time-Resolved and enter fsf_s before opening the analysis window.
Top-bar amber non-convergence label is shownDataset has fewer than 500 snapshots. Open Mean & Convergence and verify convergence at a point in your region of interest.
PDF save fails: permission deniedThe file is open in Adobe Acrobat. Close it in Acrobat first, then save again.
Rotation gives a blank resultMirror the dataset before rotating, not after.
Lumley triangle points outside boundaryInsufficient snapshots or masked/invalid vectors near the sampling line. Avoid masked regions when drawing the analysis line.
DMD spectrum dominated by high-∣σ∣|\sigma| modesApply the growth rate filter (∣σ∣<|\sigma| < threshold) to focus on near-neutral physically meaningful modes.
Γ\Gamma computation is very slowReduce the neighborhood half-width SS, or subsample the dataset before computing.
Binary Space-Time tab is greyed outData is marked Non-TR. Set Acquisition Type to Time-Resolved and enter fsf_s in the info ribbon before opening the window.
PDF looks spiky or has empty binsToo few samples for the chosen bin count. Reduce the number of bins, or switch from Point to Line, ROI, or Whole field sampling to pool more samples.
Reverse-flow probability is 0 everywhereThe flow does not reverse in this dataset, or the coordinate system is rotated so that reversal appears in the other component. Check the alignment in Coordinate Transform.
Quadrant fractions do not sum as expectedBoth the time fractions and the stress fractions sum to 1 only at hole size H=0H = 0. At H>0H > 0 the excluded weak events are missing by design, and the shortfall measures how much of the signal is weak.
Grey patches in an FFP or RFP mapThose points lie outside the ROI, so they were never computed. Grey means untouched, not zero probability.
Imported case appears at wrong scaleThe imported CSV uses a different UmU_m or different units than the current session. Check the case’s header and re-export consistently.