piv_ensemble_correlate — PIV estimate op

• Data kinds: images → flow2d

• Call: import fullseye as fs; fs.ledger.piv_ensemble_correlate(images, window=32, overlap=0.5, peak='gauss3', window_func='hann', normalize='overlap', search_limit=0.25) (implementation को सीधे call करना हो तो import pivops; pivops.piv_ensemble_correlate(images, window=32, overlap=0.5, peak='gauss3', window_func='hann', normalize='overlap', search_limit=0.25), registry से लेना हो तो opspiv.get("piv_ensemble_correlate"))

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

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

उपयोग

correlation map को जोड़ने के बाद peak खोजता है (ensemble correlation)।

कम particles या ज़्यादा noise होने पर, हर pair को अलग मापकर औसत लेने से गलत vectors का औसत मिलता है। Correlation stage पर जोड़ने से कमज़ोर peaks एक ही जगह इकट्ठा होकर उभर आते हैं। Steady flow (सभी pairs में समान displacement) पूर्व शर्त है।

Args:

images: 2 या ज़्यादा images का sequence। लगातार pairs (k, k+1) इस्तेमाल होते हैं।

window / overlap / peak / window_func / normalize / search_limit:

piv_cross_correlate के समान।

Returns:

(flow (2, h, w), info)। info["pairs"] में इस्तेमाल हुए pairs की संख्या होती है।

उपयोग की विस्तृत 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

• poc_river_surface_velocity — py -3.11 examples/poc_river_surface_velocity.py

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

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

इसी category के (estimate)

piv_cross_correlate · piv_multipass · piv_deform_pass

*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.