fullseye

piv_sample_at_windows — PIV assess op

• データ種: flow2d → flow2d
• 呼び出し: import fullseye as fs; fs.ledger.piv_sample_at_windows(field, info) (実装を直接呼ぶなら import pivops; pivops.piv_sample_at_windows(field, info)、台帳から引くなら opspiv.get("piv_sample_at_windows"))

使い方

画素ごとの場 (2, H, W) を窓中心の格子へ落とす(最近傍)。

真値は画素解像度で作られるが、PIV の出力は窓の格子に載る。比べる前に 同じ格子へ持ってくる必要があり、その持ってき方(最近傍か窓内平均か)で 誤差が変わる。ここは最近傍 —— 窓内平均にすると、勾配のある場で PIV 自身の 平滑化と区別がつかなくなる。

詳しい使い方ガイド

• piv_displacement ファミリ ガイド

参考(サンプルデータ・文献)

• サンプルデータ カタログ(DL URL / ライセンス) — 2-D は skimage.data(BSD/public)+ 合成、3-D は実データ源(Stanford/PDS 等)の DL URL。
• 演算子の来歴・参考文献 — この op 族の元になった研究/手法の出典。
• アルゴリズムの正典(著者・年)と用途は上記ファミリ使い方ガイドに記載。

実行できる例(この op を実際に呼ぶ検証済みサンプル)

• piv_field_analysis_tour — py -3.11 examples/piv_field_analysis_tour.py
• piv_flow_from_particles — py -3.11 examples/piv_flow_from_particles.py
• poc_river_surface_velocity — py -3.11 examples/poc_river_surface_velocity.py
• poc_strain_history — py -3.11 examples/poc_strain_history.py

型が繋がる次の op(flow2d を入力に取れる)

piv_deform_pass · piv_outlier_mask · piv_replace_outliers · piv_vorticity · piv_divergence · piv_flow_magnitude · piv_to_velocity · piv_velocity_gradient

同カテゴリ(assess)

piv_error_stats · piv_peak_locking · piv_time_statistics

---

Provenance: pivops.py — PIV operator registry. この per-op ノートは tools/opdocs.py md が自動生成(手編集しない)。

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.

This site is open source. Improve this page.