OpenPIV Flow Analysis
Extract velocity fields from PIV image pairs and derive vorticity, strain rate, and turbulence statistics with OpenPIV.
Data & AnalyticsAdvanced★ 33,030⑂ 3,248AI score 8/10Last updated: Aug 9, 2026
What it does
This skill teaches Claude the full OpenPIV workflow for experimental Particle Image Velocimetry data.
- End-to-end pipeline: preprocessing (dynamic masking) → cross-correlation → vector validation → outlier replacement → smoothing → scaling to physical units.
- Covers both single-pass
extended_search_area_pivand multi-pass window deformation viawindef.simple_multipass. - Computes vorticity, the 2D strain-rate tensor, RMS fluctuations and turbulent kinetic energy.
- Plots vector fields over the source image and saves
vectors.txt/params.npzoutputs. - Ships a CLI runner (
runner.py), an example verifier (run_example.py), and aPIVAnalyzerclass.
The standout feature is the honesty about API traps: differing s2n scales, windef silently ignoring dt, unrecognized replace_outliers methods failing quietly, and the vorticity sign flip after transform_coordinates.
Who it's for
- Fluid dynamics researchers and flow-visualization labs
- Graduate students processing PIV image pairs for the first time
- Engineers who want reproducible, version-pinned PIV pipelines
- Anyone working with measured flow data rather than CFD simulations
Example uses
- Basic velocity field — "Process frame_a.bmp and frame_b.bmp with window_size 32, overlap 12, dt 0.02 and render the vector field over the first image."
- Large displacements — "This jet has big displacements; run multi-pass 64→32→16 and convert the px/frame output to px/s."
- Post-processing — "From results/params.npz, compute vorticity and shear strain, then summarize RMS and TKE in a table."
· · · Install guide · · ·
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/openpiv folder from the GitHub repo K-Dense-AI/scientific-agent-skills into my ~/.claude/skills/openpiv/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/sci-skills && cp -r /tmp/sci-skills/skills/openpiv ~/.claude/skills/openpiv⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and confirm Python 3.10+ is available:
python3 --version - Install OpenPIV, pinned for reproducibility:
uv pip install "openpiv==0.25.4"(orpip install "openpiv==0.25.4"if you don't use uv). - Clone the skill repository:
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/sci-skills - Copy the skill into your Claude skills folder:
mkdir -p ~/.claude/skills && cp -r /tmp/sci-skills/skills/openpiv ~/.claude/skills/openpiv - Restart Claude Code and try a prompt such as "Compute the velocity field from this PIV image pair."
- Verify the install end to end:
python ~/.claude/skills/openpiv/scripts/run_example.py --output_dir /tmp/openpiv-demoand check that the demo outputs appear.
View source on GitHub ↗License: MIT