ボールトラッキングシステム¶
目的¶
SSL-VisionおよびSSL-Vision-Tracker(または互換外部トラッカー)からの観測データを統合し、3D物理モデル(BallPhysicsModel)に基づいたボールの位置・速度・状態を推定し、/world_model トピックとしてシステム全体に配信します。
アーキテクチャと優先順位規約¶
- トラッキング優先順位契約:
- 外部トラッカー (
TrackedFrame): 最優先ソース。トラッカーの推定データを採用する。 - Vision生データ (
DetectionFrame): トラッカー途絶・未検出時のフォールバックとして補完。
- 外部トラッカー (
- データフロー:
SSL Vision / Tracker UDP──>WorldModelDataProvider──>WorldModelPublisher──>/world_model
- ネットワーク規約: アドレス・ポートは
crane.launch.xmlのsimと各引数を正本とする。
物理モデル規約¶
- 状態規約:
STOPPED、ROLLING、FLYINGの判定条件と物理パラメータはBallPhysicsModelおよび設定ファイルを正本とする。
実装リファレンス¶
- 世界モデル配信ノード: world_model_publisher.cpp
- ボール物理モデル: ball_info.hpp
- クライアントAPI: WorldModelWrapper