cup_catch_check — 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.cup_catch_check(p_ball, v_ball, cup_center, cup_axis, cup_radius: 'float', ball_radius: 'float', v_rel_max: 'float' = 1.0) -> 'dict' (die Implementierung direkt: import ballistics; ballistics.cup_catch_check(p_ball, v_ball, cup_center, cup_axis, cup_radius: 'float', ball_radius: 'float', v_rel_max: 'float' = 1.0) -> 'dict'; aus dem Register: opsdrive.get("cup_catch_check"))

Verwendung

Geometrischer Test, ob die Kugel in eine Schale (Mittelpunkt, Achse, Radius) gelangt: der Kugelmittelpunkt liegt innerhalb von (cup_radius − ball_radius) zur Schalenachse, in einer Höhe von höchstens dem 1.5-Fachen des Kugelradius über der Schalenfläche (0 ≤ height ≤ 1.5 r), und die Geschwindigkeit ist ≤ v_rel_max. {"caught", "lateral", "height", "speed"}. ValueError, wenn die Schale kleiner als die Kugel ist.

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)

• (noch keine)

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.