tether_simulate — DRIVE ball op

• Datenarten: keine → table (ein Operator, der allein durch seine Argumente bestimmt ist — er nimmt kein Bild und keine Daten entgegen)

• Aufruf: 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' (die Implementierung direkt: 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'; aus dem Register: opsdrive.get("tether_simulate"))

Verwendung

Bewegung eines Massenpunkts, der über eine undehnbare Schnur (Länge L) mit der Hand handle verbunden ist (die Kendama-Kugel).

handle ist entweder ein fester Punkt (3,) oder eine Funktion Zeit → (3,). Jeder Schritt führt den freien Fall fort; wird |p − h| > L, wird auf die Kugel projiziert und die nach außen gerichtete relative Radialgeschwindigkeit entfernt (einseitige Bindung: die Schnur zieht nur, sie drückt nicht). Die in diesem Moment verlorene kinetische Energie ½ m v_r² wird in "snap_loss" aufsummiert. Spannungsschätzung = durch die Projektion entfernte radiale Geschwindigkeitsänderung × m / dt (≥ 0). Rückgabewert {"t", "p", "v", "tension", "taut" (bool), "snap_times", "snap_loss", "energy"}. Theorem-Gates: |p − h| ≤ L + 1e-9, Spannung ≥ 0, bei fester Hand ist die mechanische Energie außer in den Snap-Momenten invariant (im Rahmen des RK-Fehlers), die Periode bei kleiner Amplitude ist 2π√(L/g).

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• poc_kendama — py -3.11 examples/poc_kendama.py

Typkompatible Folge-Operatoren (nehmen table als Eingabe)

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

Gleiche Kategorie (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. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

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