synth op• Data kinds: कोई नहीं → image2d (केवल arguments से तय होने वाला op — यह कोई image या data input नहीं लेता)
• Call: import fullseye as fs; fs.ledger.piv_synth_particles(shape, density=0.02, diameter_px=2.5, seed=0, intensity=(0.6, 1.0), background=0.0) (implementation को सीधे call करना हो तो import pivops; pivops.piv_synth_particles(shape, density=0.02, diameter_px=2.5, seed=0, intensity=(0.6, 1.0), background=0.0), registry से लेना हो तो opspiv.get("piv_synth_particles"))
• Ledger के ज़रिए return value: fullseye.ledger.piv_synth_particles(...) केवल घोषित out type image2d का value लौटाता है (मूल function सहायक जानकारी भी लौटाता है)। जो हिस्सा छोड़ दिया गया है उसकी ज़रूरत हो तो fullseye.ledger.piv_synth_particles.raw(...) का उपयोग करें, या pivops.piv_synth_particles को सीधे call करें।
• मूल function का return: (image, positions) -> image2d
tracer particle बिखेरी गई 1 image बनाता है। (image, positions) लौटाता है।
Particles Gaussian चमकीले धब्बे हैं (PIV convention के अनुसार, diameter_px का अर्थ standard deviation का 2 गुना है, 1/e^2 width नहीं)। Positions continuous हैं, इसलिए subpixel ground truth वाली images बनाई जा सकती हैं।
density प्रति pixel particles की संख्या है। PIV का thumb rule प्रति window 5-10 है मार्गदर्शन के रूप में, जो 32x32 window के लिए 0.005-0.01 के समकक्ष है। बहुत कम हों तो कोई correlation peak नहीं उभरता; बहुत ज़्यादा हों तो particle images एक-दूसरे पर चढ़ जाती हैं और अलग-अलग correspondences खो जाते हैं।
Args:
shape: (H, W)।
density: प्रति pixel particles (> 0)।
diameter_px: particle image का व्यास [px] (> 0)।
seed: random seed।
intensity: particles की brightness range (lo, hi)।
background: uniform offset।
Returns:
(image (H, W) float64, positions (N, 2) as (row, col))।
• piv_displacement family guide
• 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 में दिए गए हैं।
• piv_field_analysis_tour — py -3.11 examples/piv_field_analysis_tour.py
image2d को input के रूप में लेते हैं)piv_cross_correlate · piv_multipass · piv_deform_pass · strain_from_displacement · correlation_quality · speckle_quality
synth)piv_synth_pair · piv_synth_sequence
*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.