tether_simulate — DRIVE ball op

• Data kinds: कोई नहीं → table (केवल arguments से तय होने वाला op — यह कोई image या data input नहीं लेता)

• Call: import fullseye as fs; fs.ledger.tether_simulate(p0, v0, handle, L: 'float', t_end: 'float', dt: 'float' = 0.001, g: 'float' = 9.81, mass: 'float' = 0.01) -> 'dict' (implementation को सीधे call करना हो तो import ballistics; ballistics.tether_simulate(p0, v0, handle, L: 'float', t_end: 'float', dt: 'float' = 0.001, g: 'float' = 9.81, mass: 'float' = 0.01) -> 'dict', registry से लेना हो तो opsdrive.get("tether_simulate"))

उपयोग

न खिंचने वाली डोरी (लंबाई L) से हाथ handle से बँधे point mass की गति (kendama की गेंद)।

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

handle は (3,) の固定点か、時刻 → (3,) の関数。各ステップで自由落下を進め、|p − h| > L になったら球面へ射影して外向きの相対径方向速度を消す(片側拘束: ひもは引くだけで押さない)。その瞬間に失う運動エネルギー ½ m v_r² を "snap_loss" に積む。張力の推定 = 射影で消した径方向の速度変化 × m / dt(≥ 0)。返り値 {"t", "p", "v", "tension", "taut" (bool), "snap_times", "snap_loss", "energy"}。定理の門: |p − h| ≤ L + 1e-9、張力 ≥ 0、手元が固定なら力学的エネルギーは snap の瞬間以外で不変(RK 誤差の範囲)、小振幅の周期は 2π√(L/g)。

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

• poc_kendama — py -3.11 examples/poc_kendama.py

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

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

इसी category के (ball)

ball_params · impact_params · flight_vacuum · flight_ode · flight_simulate · flight_state_at · magnus_lift_coefficient · drag_coefficient_sphere


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

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