kendama_clearance — DRIVE kendamaworld op

• Datenarten: table → table

• Aufruf: import fullseye as fs; fs.ledger.kendama_clearance(kp: 'dict', hand, p_ball, *, R_ken=None, grip=None) -> 'dict' (die Implementierung direkt: import kendamaworld; kendamaworld.kendama_clearance(kp: 'dict', hand, p_ball, *, R_ken=None, grip=None) -> 'dict'; aus dem Register: opsdrive.get("kendama_clearance"))

Verwendung

Abstand [m] von der Kugeloberfläche zum Kendama (den Rotationskörpern von Ken und Querstück) (negativ = die Kugel dringt in das Kendama ein). Mit der Trick-Haltung aus kp (R_ken, Griffpunkt grip), Hand hand und Kugelmitte p_ball (jeweils (3,) oder (N, 3)). Der Abstand zu einem Rotationskörper ist exakt gleich dem 2-D-Abstand zur Meridiankontur und hängt daher nicht von der Mesh-Diskretisierung ab. Rückgabewert {"gap" (N,), "ken" (N,), "cross" (N,)} (ken / cross = Abstand zum jeweiligen Teil). Die Physik löst Kollisionen zwischen Kugel und Kendama nicht auf; mit dieser Größe werden daher die steps gezählt, in denen "die Kugel das Kendama durchdrungen hat" (für Gates und ehrliche Berichte). R_ken (Durchgang 19, Umgreifen bei Trickfolgen): Pose als (3, 3) oder pro Zeitpunkt als (N, 3, 3) statt kp["R_ken"] übergeben. grip = Überschreiben des Griffpunkts (lokal). Sind beide None, verhält es sich wie bisher.

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 (kendamaworld)

ken_mesh · add_ken · ken_set_pose · string_mesh · add_string · string_set · kendama_world · kendama_rig


*Provenance: kendamaworld.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.