Skip to content

ROADMAP.md

Latest commit

 

History

History
51 lines (38 loc) · 2.55 KB

ROADMAP.md

File metadata and controls

51 lines (38 loc) · 2.55 KB
Raw

PIVPy Development Roadmap

For full architectural designs and implementation details, see:

Executive Summary

PIVPy's development roadmap synthesizes key capabilities from MATLAB's PIVMat 4.22 toolbox (F. Moisy), the Python PyPostPiv library (J. Hu et al., Univ. of Waterloo), and the PIV Flow Visualizer suite (ASPiRE Lab, Univ. of Toronto):

  1. Phase 1: Synthetic Flow Generators & Benchmarking Suite

    • Analytical vortices (Burgers, Lamb-Oseen, Rankine, Vatistas)
    • Multi-vortex synthetic turbulence fields
    • Random divergence-free vector fields
    • Canonical analytical flow profiles (channel, shear layer)

  2. Phase 2: Vortex Identification Criteria & Flow Topology

    • Normalized Angular Momentum ($\Gamma_1$ & $\Gamma_2$)
    • Circulation-based noise-robust vorticity
    • Solid-body rotation subtraction (subsbr)
    • Invariant metrics ($Q$-criterion, Okubo-Weiss parameter)

  3. Phase 3: Spatial Filtering, Geometry Masking & Gradient Calculus

    • High-order and robust gradient schemes (2nd_central, 4th_central, least_squares)
    • 2D spatial median filtering for outlier removal
    • Circular, rectangular, and arbitrary polygon obstacle masking
    • Arbitrary grid remapping (remapf), rotation, and flipping

  4. Phase 4: Temporal Frequency Analysis & Modal Filtering

    • Fourier temporal bandpass and notch filtering (tempfilterf)
    • Unsteady shedding mode isolation and phase-averaging

  5. Phase 5: Turbulence Statistics, TKE & Structure Functions

    • Velocity fluctuations ($u', v', w'$), RMS, and Turbulent Kinetic Energy ($k$)
    • Multi-order longitudinal and transverse velocity structure functions ($S_p(r)$)
    • Full Reynolds stress tensor and Lumley anisotropy invariants
    • 2D/1D spatial wavenumber energy spectra ($E(k)$)

  6. Phase 6: Multi-Camera, Dynamic Studio & Ingestion Pipeline

    • Stereoscopic 3-component ($u, v, w$) pipeline support across all accessors
    • Direct batch DaVis .vc7/.set to Zarr conversion tool (convert_vc7_to_zarr)
    • Dantec Dynamic Studio multi-trial CSV batch ingestion

  7. Phase 7: Advanced RK Streamlines, Uncertainty & Report Generation

    • Adaptive Runge-Kutta (RK2/RK4) particle streamline tracking with LineCollection coloring
    • Uncertainty-propagating 2D spatial interpolation and point probing
    • Automated multi-page PDF & Marimo dashboard publication report generation