locomotion op• データ種: points → table
• 呼び出し: import fullseye as fs; fs.ledger.support_polygon(contacts, ground=None, contact_tol: 'float' = 0.02) -> 'dict' (実装を直接呼ぶなら import locomotion; locomotion.support_polygon(contacts, ground=None, contact_tol: 'float' = 0.02) -> 'dict'、台帳から引くなら opsdrive.get("support_polygon"))
• GPU: なし(CPU 参照実装のみ)
接地点の凸な支持多角形(地面の x, y 平面)。
Returns {vertices (M,2 CCW), area, perimeter, centroid}. With <3 distinct points it degenerates gracefully (a point or a segment, area = 0). This is the base of support a static-stability check is measured against. 空の入力(contacts が 0 要素)は頂点 0 個・面積 0 の多角形を返す(理由: 足が 1 つも接地していない状態そのもの。重心は nan)。
★Precondition — only feet ACTUALLY TOUCHING the floor may take part: every contact is projected to (x, y), so a lifted foot out at some far x/y inflates the polygon and can make a tipping robot read as statically stable.
• ground given (recommended for anti-cheat) — a floor level z or a plane [a, b, c, d]; contacts further than contact_tol from it are filtered out here, so an airborne foot supports nothing.
• ground=None (default, backward-compatible) — no z check at all; the caller MUST pre-filter with contact_points.
• サンプルデータ カタログ(DL URL / ライセンス) — 2-D は skimage.data(BSD/public)+ 合成、3-D は実データ源(Stanford/PDS 等)の DL URL。
• 演算子の来歴・参考文献 — この op 族の元になった研究/手法の出典。
• アルゴリズムの正典(著者・年)と用途は上記ファミリ使い方ガイドに記載。
• consumer_hillco — py -3.11 examples/consumer_hillco.py
• consumer_onocollo — py -3.11 examples/consumer_onocollo.py
• physical_ai_perception — py -3.11 examples/physical_ai_perception.py
• walking_ops_tour — py -3.11 examples/walking_ops_tour.py
table を入力に取れる)course_layout · course_occupancy · course_contains · world_build · world_camera · world_move · lidar_scan · rss_longitudinal_same
locomotion)contact_points · com_from_silhouette · com_support_margin · gait_phase · support_line_margin · lipm_capture_point · capture_margin · gait_step_events
*Provenance: locomotion.py — DRIVE operator registry. この per-op ノートは tools/opdocs.py md が自動生成(手編集しない)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.