piv_synth_pair — PIV synth op

資料種類:image2d(僅由參數決定的運算子 —— 不接受影像或資料輸入)

呼叫:import pivops; pivops.piv_synth_pair(shape, displacement, density=0.02, diameter_px=2.5, seed=0, noise_sigma=0.0, intensity=(0.6, 1.0), background=0.0)(或 opspiv.get("piv_synth_pair"))

用法

> 該運算子的說明尚無譯文,以下照原文給出。

既知の変位場を持つ画像対を作る。返りは `(image_a, image_b, truth)`。

粒子を動かしてから 2 枚目を描く(1 枚目を補間で歪めるのではない)。

補間で作ると、補間の平滑化が「PIV が当てやすい絵」を作ってしまい、

自分の実装を自分に有利な入力で測ることになる。

Args:

shape: `(H, W)`。

displacement: 変位の与え方。次のいずれか。

• 長さ 2 の列 —— 一様並進 `(dy, dx)` [px]。

• `callable(rows, cols) -> (dy, dx)` —— 位置に依存する場。

引数は粒子の連続座標の配列。

density / diameter_px / seed / intensity / background: :func:piv_synth_particles と同じ。

noise_sigma: 2 枚それぞれに独立に足す加法ガウス雑音の標準偏差。

Returns:

`(a (H, W), b (H, W), truth (2, H, W))truth` は画素ごと

真の変位で、窓の格子に落とすには :func:piv_sample_at_windows を使う。

詳細使用指南

piv_displacement 族使用指南

參考(範例資料・文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

• 演算法的正典(作者・年份)與用途見上面的族使用指南

可執行的範例(實際呼叫該運算子並已驗證的樣例)

piv_flow_from_particlespy -3.11 examples/piv_flow_from_particles.py

poc_strain_historypy -3.11 examples/poc_strain_history.py

型別可銜接的下一個運算子(可接受 image2d 作為輸入)

piv_cross_correlate · piv_multipass · piv_deform_pass · strain_from_displacement · correlation_quality · speckle_quality

同類別(synth)

piv_synth_particles · piv_synth_sequence


*Provenance: pivops.py — PIV 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

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