piv_deform_pass — PIV estimate op

• Data kinds: image2d × image2d × flow2d → flow2d

• Call: import fullseye as fs; fs.ledger.piv_deform_pass(a, b, flow, info, window=32, overlap=0.5, peak='gauss3', window_func='hann', order=3) (implementation को सीधे call करना हो तो import pivops; pivops.piv_deform_pass(a, b, flow, info, window=32, overlap=0.5, peak='gauss3', window_func='hann', order=3), registry से लेना हो तो opspiv.get("piv_deform_pass"))

• Ledger के ज़रिए return value: fullseye.ledger.piv_deform_pass(...) केवल घोषित out type flow2d का value लौटाता है (मूल function सहायक जानकारी भी लौटाता है)। जो हिस्सा छोड़ दिया गया है उसकी ज़रूरत हो तो fullseye.ledger.piv_deform_pass.raw(...) का उपयोग करें, या pivops.piv_deform_pass को सीधे call करें।

• मूल function का return: (flow, info) -> flow2d

उपयोग

window deformation वाला 1 चरण। अनुमानित displacement से पहले image को ही warp करके correlation लेता है।

Integer shifting (piv_cross_correlate का shift) मानता है कि displacement window के अंदर स्थिर है। Rotation या shear जैसे fields में, जहाँ displacement window के अंदर बदलता है, correlation peak बिखर जाता है, इसलिए correlate करने से पहले 2 images को prediction के आधे-आधे से उल्टी दिशाओं में warp किया जाता है (central-difference deformation)।

Args:

a, b: image pair।

flow: अनुमानित displacement (2, h, w) (piv_multipass आदि का आउटपुट)।

info: उसका info (window-centre coordinates ज़रूरी हैं)।

window / overlap / peak / window_func: नए pass की settings।

order: deformation के लिए इस्तेमाल interpolation का order (3 = 3rd-order spline)।

Returns:

(flow (2, h', w'), info)। लौटाया गया displacement मूल image coordinates में कुल displacement है।

उपयोग की विस्तृत guide

• piv_displacement family guide

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• piv_field_analysis_tour — py -3.11 examples/piv_field_analysis_tour.py

वे अगले ops जिनसे type जुड़ता है (flow2d को input के रूप में लेते हैं)

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

इसी category के (estimate)

piv_cross_correlate · piv_multipass · piv_ensemble_correlate

*Provenance: pivops.py — PIV operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

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