kendama_catch_check — DRIVE kendama op

• Data kinds: table → table

• Call: import fullseye as fs; fs.ledger.kendama_catch_check(kp: 'dict', p_ball, v_ball, cup_center, cup_axis=(0.0, 0.0, 1.0), v_cup=(0.0, 0.0, 0.0), v_rel_max: 'float' = 1.0, window: 'float' = None) -> 'dict' (implementation को सीधे call करना हो तो import kendama; kendama.kendama_catch_check(kp: 'dict', p_ball, v_ball, cup_center, cup_axis=(0.0, 0.0, 1.0), v_cup=(0.0, 0.0, 0.0), v_rel_max: 'float' = 1.0, window: 'float' = None) -> 'dict', registry से लेना हो तो opsdrive.get("kendama_catch_check"))

उपयोग

गेंद (त्रिज्या r_b) cup (किनारे की त्रिज्या r_c < r_b, किनारे का केंद्र cup_center, axis cup_axis, velocity v_cup) पर टिकती है या नहीं, इसकी geometric जाँच।

> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।

縁に乗った玉の中心は縁の面から h_c = √(r_b² − r_c²) 上、静的な安定条件は横ずれ ≤ r_c。ballistics.cup_catch_check (皿 > 玉が前提)を有効な皿(半径 r_c + r_b、中心を軸方向に h_c 上げる)で呼ぶ → 横ずれ ≤ r_c、縁の面からの高さ h_c ≤ h ≤ h_c + 1.5 r_b、皿に対する相対速さ ≤ v_rel_max。さらに 下から昇ってくる玉(相対速度の軸成分 > 0)は受けない (皿は上からしか受けられない。支点 = 皿の中心の簡略化では昇る玉が皿の位置を通り抜けるため必要)。window を渡すと高さの窓を「縁に最初に触れる高さ」+ window 以下に狭める(着地の判定: kendama_simulate は kp["catch_window"])。横ずれ δ の玉は √(r_b² − (r_c − δ)²)(δ = 0 で h_c)で縁に触れる —— 中心からずれた玉は縁の片側に先に触れ、皿の中へ転がり込む(横ずれ ≤ r_c なら受けたとする)。縁の半径は kp["cup_radius"] (受ける皿、無ければ大皿)。返り値 {"caught", "lateral", "height" (縁の面から), "speed" (相対), "descending"}。

संदर्भ (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 करते हैं)

• (अभी कुछ नहीं)

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

course_layout · course_occupancy · course_contains · world_build · world_camera · world_move · lidar_scan · rss_longitudinal_same

इसी category के (kendama)

kendama_params · elliptic_k_agm · pendulum_period_exact · pendulum_launch_speed · pendulum_rod_simulate · tether_tension_fixed · tether_slack_angle · swing_up_plan


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

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