structured_light op• Data kinds: images → depth
• Call: import fullseye as fs; fs.ledger.decode_fringe(phase_shift_images, ref_phase=None, k=1.0, mask=None, min_modulation=None, method='general') -> 'np.ndarray' (implementation को सीधे call करना हो तो import fringe; fringe.decode_fringe(phase_shift_images, ref_phase=None, k=1.0, mask=None, min_modulation=None, method='general') -> 'np.ndarray', registry से लेना हो तो ops3d.get("decode_fringe"))
• GPU: नहीं (केवल CPU reference implementation)
phase-shift image series को एक साथ decode करता है: wrapped → unwrap → (reference घटाकर) height।
phase_shift_images: N-step phase-shifted fringe images की sequence ((N,H,W) या length N की sequence)।
ref_phase: reference plane (height 0) की unwrapped phase। None होने पर height = k·(unwrapped)।
k: phase→height calibration constant।
mask: optional। True=valid pixel। invalid pixels NaN होते हैं।
min_modulation: optional। देने पर modulation < इस मान वाले pixels को कम भरोसेमंद मानकर invalid किया जाता है।
return value: height map (2D float)। ref_phase=None होने पर k से गुणा की गई continuous phase लौटाई जाती है। invalid pixels NaN होते हैं।
प्रक्रिया (जैसा लागू है): wrapped_phase → विश्वसनीयता मास्क बनाएँ (यदि min_modulation दिया है तो modulation(stack) >= min_modulation; यदि mask दिया है तो उसके साथ AND) → यदि ref_phase None है तो k * unwrap_phase_2d(wrapped, mask=विश्वसनीयता मास्क), अन्यथा k * unwrap_phase_2d(wrap(wrapped − ref_phase), mask=विश्वसनीयता मास्क) (वैश्विक 2πm वह शाखा है जो माध्यिका को [−π, π] में रखती है)।
तर्क:
• phase_shift_images: (N, H, W), N >= 3, समान अंतराल वाले फ़ेज़ शिफ़्ट।
• ref_phase: अदिश या (H, W)। संदर्भ तल (ऊँचाई 0) की फ़ेज़ —— इस op से ref_phase=None, k=1 के साथ डिकोड किया गया परिणाम हो या विश्लेषणात्मक फ़ेज़, दोनों चलेंगे। ★अंतर पहले लिया जाता है, फिर अनरैप: Δ = wrap(wrapped − ref_phase) को केवल 1 बार unwrap_phase_2d किया जाता है, और ref_phase का 2πm विचलन wrap में मिट जाता है। अनरैप का शेष वैश्विक 2πm उस शाखा पर रखा जाता है जहाँ "मान्य पिक्सेलों की माध्यिका [−π, π] में हो" (मान्यता: दृश्य-क्षेत्र का अधिकांश भाग संदर्भ तल से फ़ेज़ में π से कम ऊँचाई पर है)। 2026-11-05 तक मापन तल और संदर्भ तल को अलग-अलग अनरैप करके घटाया जाता था; दोनों के अनरैप की आरंभिक शाखा अलग होने पर ऊँचाई k·2πm से खिसक जाती थी (60 में से 24 स्थितियाँ)।
• k: फ़ेज़→ऊँचाई अंशांकन स्थिरांक (इकाई/rad)। synthesize_fringes के phase_gain के व्युत्क्रम के अनुरूप।
• mask: (H, W) bool, True = मान्य। min_modulation: मॉड्यूलेशन गहराई की निचली सीमा (लगभग [0, 1]; छाया और संतृप्त पिक्सेल हटाता है)।
validation (ValueError): image sequence 3-D न हो, N < 3, non-finite / mask का shape अलग हो / ref_phase का shape अलग हो / valid pixels शून्य हों। scikit-image न हो तो RuntimeError।
return value: (H, W) float64। invalid pixels NaN। unit k की unit है।
सावधानी: यह spatial unwrapping पर निर्भर है, इसलिए steps या occlusion से islands में बँटे दृश्यों में हर island में 2πm k का height offset रह सकता है। absolute height चाहिए तो रास्ता है graycode_decode → absolute_phase → triangulate_column।
• depth_sensors — Depth sensors — ranging के सिद्धांत, असली devices के आँकड़े, dropouts कैसे दिखते हैं
• 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 के स्रोत।
• structured_light — py -3.11 examples_3d/structured_light.py
depth को input के रूप में लेते हैं)depth_to_points · tsdf_from_depth · to_points · fuse_to_voxel · depth_to_organized_points · normals_from_depth · occlusion_edges · bearing_angle_image
structured_light)wrapped_phase · unwrap_phase_2d · graycode_decode · fringe_ftp_phase · depth_from_focus · synthesize_fringes · absolute_phase · triangulate_column
*Provenance: fringe.py — 3D operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.