scoop op• Data kinds: image2d × scalar × scalar × scalar × scalar → table
• Call: import fullseye as fs; fs.ledger.tilted_surface_read(side, lip_row: 'float', lip_col: 'float', theta_deg: 'float', L_px: 'float', *, wall_px: 'float | None' = None, threshold: 'float' = 0.5, shell_px: 'float' = 0.0, smooth_px: 'int' = 1) -> 'dict' (implementation को सीधे call करना हो तो import scoop; scoop.tilted_surface_read(side, lip_row: 'float', lip_col: 'float', theta_deg: 'float', L_px: 'float', *, wall_px: 'float | None' = None, threshold: 'float' = 0.5, shell_px: 'float' = 0.0, smooth_px: 'int' = 1) -> 'dict', registry से लेना हो तो opsdrive.get("tilted_surface_read"))
झुके पात्र की बगल से ली गई image (coverage) से, पात्र में बचे पाउडर का cross-section क्षेत्रफल और पीछे की समतल सतह की ऊँचाई पढ़ता है।
पात्र के निर्देशांक: मुँह (lip_row, lip_col; पिक्सेल के किनारे पूर्णांक हैं) मूलबिंदु, तल के साथ पीछे की ओर x (मुँह नीचे करके θ झुका तल = छवि में दाएँ ऊपर की ओर चढ़ता), तल के लंबवत y। 0 ≤ x ≤ L_px और 0 ≤ y ≤ wall_px (None = L_px) के भीतर आवरण-अनुपात का योग अनुप्रस्थ-काट क्षेत्रफल [px²] है (मुँह के बाहर का प्रवाह नहीं गिना जाता)। कणों की पार्श्व छवि की रूपरेखा कणों के बाहरी आवरण की होती है, इसलिए मुक्त सतह के साथ लगभग 1 कण-त्रिज्या मोटा खोल अतिरिक्त शामिल हो जाता है —— shell_px (कण की त्रिज्या [px] दें) × मुक्त सतह की लंबाई (पात्र के भीतर प्रत्येक स्तंभ की चूर्ण-सतह को smooth_px स्तंभों पर चल-औसत करके बनी टूटी रेखा की लंबाई) घटाकर area_corrected भी लौटाया जाता है। पीछे की समतल सतह की ऊँचाई plateau_px = पात्र के पिछले आधे भाग की चूर्ण-सतह की तल से ऊँचाई की माध्यिका (फन्नी मॉडल में यह θ < θ_b रहने तक नहीं बदलती; वास्तविक परत बहकर पतली होती है —— PoC में देखें)।
वापसी: area_px, area_corrected, surface_len_px, plateau_px (पिछले आधे भाग में चूर्ण-सतह न हो तो None)। Raises ValueError: आवरण-अनुपात नहीं / पात्र के भीतर खाली / तर्कों की सीमा।
• 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 में दिए गए हैं।
• poc_powder_scoop_pour — py -3.11 examples/poc_powder_scoop_pour.py
table को input के रूप में लेते हैं)course_layout · course_occupancy · course_contains · world_build · world_camera · world_move · lidar_scan · rss_longitudinal_same
scoop)spoon_bowl_volume · scoop_synth_side · revolution_volume_side · two_view_volume · scoop_volume_read · scoop_count · scoop_image_limit · tilt_wedge_retained
*Provenance: scoop.py — DRIVE operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.