%23%20%2F%2F%2F%20script%0A%23%20requires-python%20%3D%20%22%3E%3D3.11%22%0A%23%20dependencies%20%3D%20%5B%0A%23%20%20%20%20%20%22marimo%22%2C%0A%23%20%20%20%20%20%22openpiv%3D%3D0.26.3%22%2C%0A%23%20%20%20%20%20%22numpy%22%2C%0A%23%20%20%20%20%20%22matplotlib%22%2C%0A%23%20%20%20%20%20%22scipy%22%2C%0A%23%20%20%20%20%20%22scikit-image%22%2C%0A%23%20%5D%0A%23%20%2F%2F%2F%0A%0Aimport%20marimo%0A%0A__generated_with%20%3D%20%220.25.2%22%0Aapp%20%3D%20marimo.App(width%3D%22medium%22)%0A%0A%0A%40app.cell%0Adef%20_()%3A%0A%20%20%20%20import%20marimo%20as%20mo%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%2004%20%E2%80%94%20Validation%20%26%20filtering%0A%0A%20%20%20%20PIV%20always%20produces%20some%20**spurious%20vectors**%20(outliers).%20Validation%20detects%20them%3B%20filtering%2Freplacement%20fixes%20gaps.%0A%0A%20%20%20%20%23%23%20Common%20methods%0A%20%20%20%20-%20**Signal-to-noise%20ratio%20(s2n)**%3A%20reject%20vectors%20with%20weak%2Fambiguous%20correlation%20peaks.%0A%20%20%20%20-%20**Global%2Frange%20filter**%3A%20remove%20physically%20impossible%20velocities.%0A%20%20%20%20-%20**Local%20median%20%2F%20normalized%20median**%3A%20compare%20each%20vector%20to%20neighbors.%0A%20%20%20%20-%20**Standard%20deviation%20filter**%3A%20reject%20vectors%20far%20from%20local%20statistics.%0A%0A%20%20%20%20%23%23%20Learn%20from%20these%20examples%0A%20%20%20%20-%20**%5Bcompare_median_filters%5D(marimo_notebooks%2Fcompare_median_filters.html)**%20(%5Binteractive%20.py%5D(marimo_notebooks%2Fcompare_median_filters.py)%2C%20%5Bmolab%5D(https%3A%2F%2Fmolab.marimo.io%2Fgithub%2Fopenpiv%2Fopenpiv-python-examples%2Fblob%2Fmain%2Fmarimo_notebooks%2Fcompare_median_filters.py))%20%E2%80%94%20original%20vs%20normalized%20median%20filter.%20*Use%20when%3A*%20choosing%20robust%20outlier%20detection.%0A%20%20%20%20-%20**%5Bexample_normalized_correlation_effect%5D(marimo_notebooks%2Fexample_normalized_correlation_effect.html)**%20(%5Binteractive%20.py%5D(marimo_notebooks%2Fexample_normalized_correlation_effect.py)%2C%20%5Bmolab%5D(https%3A%2F%2Fmolab.marimo.io%2Fgithub%2Fopenpiv%2Fopenpiv-python-examples%2Fblob%2Fmain%2Fmarimo_notebooks%2Fexample_normalized_correlation_effect.py))%20%E2%80%94%20effect%20of%20normalized%20correlation%20on%20complex%20images.%0A%20%20%20%20-%20**%5Bcompare_correlations_algorithms%5D(marimo_notebooks%2Fcompare_correlations_algorithms.html)**%20(%5Binteractive%20.py%5D(marimo_notebooks%2Fcompare_correlations_algorithms.py)%2C%20%5Bmolab%5D(https%3A%2F%2Fmolab.marimo.io%2Fgithub%2Fopenpiv%2Fopenpiv-python-examples%2Fblob%2Fmain%2Fmarimo_notebooks%2Fcompare_correlations_algorithms.py))%20%E2%80%94%20linear%20vs%20circular%20correlation.%20*Use%20when%3A*%20understanding%20correlation%20choices%20and%20artifacts.%0A%20%20%20%20-%20**%5Bstudying_correlations%5D(marimo_notebooks%2Fstudying_correlations.html)**%20(%5Binteractive%20.py%5D(marimo_notebooks%2Fstudying_correlations.py)%2C%20%5Bmolab%5D(https%3A%2F%2Fmolab.marimo.io%2Fgithub%2Fopenpiv%2Fopenpiv-python-examples%2Fblob%2Fmain%2Fmarimo_notebooks%2Fstudying_correlations.py))%20%E2%80%94%20deep%20dive%20into%20correlation%20behavior.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%20(mo%2C)%0A%0A%0A%40app.cell%0Adef%20_()%3A%0A%20%20%20%20import%20numpy%20as%20np%0A%20%20%20%20from%20openpiv.tools%20import%20synimage%0A%20%20%20%20from%20openpiv%20import%20pyprocess%0A%20%20%20%20img_a%2C%20img_b%20%3D%20synimage.synimagegen(128%2C%20dt%3D0.1)%0A%20%20%20%20u%2C%20v%2C%20s2n%20%3D%20pyprocess.extended_search_area_piv(%0A%20%20%20%20%20%20%20%20img_a.astype(np.int32)%2C%20img_b.astype(np.int32)%2C%0A%20%20%20%20%20%20%20%20window_size%3D32%2C%20overlap%3D16%2C%20dt%3D0.1%2C%20search_area_size%3D64%2C%0A%20%20%20%20%20%20%20%20sig2noise_method%3D'peak2peak'%0A%20%20%20%20)%0A%20%20%20%20print('s2n%20min%2Fmedian%2Fmax%3A'%2C%20float(np.nanmin(s2n))%2C%20float(np.nanmedian(s2n))%2C%20float(np.nanmax(s2n)))%0A%20%20%20%20return%20np%2C%20s2n%2C%20u%2C%20v%0A%0A%0A%40app.cell%0Adef%20_(np%2C%20s2n%2C%20u%2C%20v)%3A%0A%20%20%20%20%23%20Simple%20s2n-based%20masking%20example%0A%20%20%20%20mask_bad%20%3D%20s2n%20%3C%201.1%0A%20%20%20%20u_clean%20%3D%20u.copy()%3B%20v_clean%20%3D%20v.copy()%0A%20%20%20%20u_clean%5Bmask_bad%5D%20%3D%20np.nan%3B%20v_clean%5Bmask_bad%5D%20%3D%20np.nan%0A%20%20%20%20print('flagged%20by%20s2n%3A'%2C%20int(mask_bad.sum())%2C%20'of'%2C%20mask_bad.size)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%20Tips%0A%20%20%20%20-%20**Do%20not%20smooth%20before%20validation**%20%E2%80%94%20smoothing%20can%20hide%20bad%20vectors.%0A%20%20%20%20-%20Tune%20thresholds%20on%20your%20data%3B%20synthetic%20tests%20help%20find%20sensible%20defaults.%0A%20%20%20%20-%20Inspect%20where%20outliers%20cluster%20(boundaries%2C%20masks%2C%20low%20seeding).%0A%20%20%20%20-%20Keep%20raw%20%2B%20validated%20results%20so%20decisions%20are%20reproducible.%0A%0A%20%20%20%20Next%3A%20%5B05%20%E2%80%94%20Masking%20%26%20preprocessing%5D(05_masking_and_preprocessing.html)%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0Aif%20__name__%20%3D%3D%20%22__main__%22%3A%0A%20%20%20%20app.run()%0A
c6f640adbff780eeded7d3c1b39bc6a7