PRBonn/rko_lio

RKO‑LIO – ロバストなLiDAR-慣性オドメトリ

何であるか – RKO‑LIOは、3D LiDARスキャナとIMUを融合してロボットの姿勢（オドメトリ）を推定するオープンソースライブラリです。センサ固有のキャリブレーションモデルは必要ありません。RawなROSバッグ（ROS 1またはROS 2）上で動作可能で、純粋なPythonパッケージとしても実行できます。

主な特徴

• センサ非依存：特定のLiDARやIMU用に手動で調整されたモデルは不要。2つのフレーム間の外挿変換のみが必要です。
• マルチプラットフォーム：1つのコードベースで4つの異なるロボットと環境で実証済み。
• PythonおよびROSインターフェース：pipでインストールして即座に実験可能、またはROS 2パッケージ（apt install ros-<distro>-rko-lio）として利用可能。
• 可視化：Rerun SDKを使用したオプションのリアルタイムビジュアライザー（-vフラグ）。
• カスタマイズ可能：外挿変換は小さなYAMLファイルで供給。その他のパラメータは妥当なデフォルト値を備えています。
• 公開された研究：2026年の査読付きIEEE RA‑L論文およびarXivプレプリントと併記されています。

Pythonでの導入方法

pip install "rko_lio[all]"   # rko_lio, rosbags, rerun-sdk を取得
rko_lio -v /path/to/rosbag_folder   # ビジュアライザー付きで実行

• rko_lio --dump_config > config.yaml を使用してテンプレートを作成。
• config.yaml を編集し、extrinsic_imu2base_quat_xyzw_xyz および extrinsic_lidar2base_quat_xyzw_xyz を設定（例：[0,0,0,1,0,0,0]）。
• rko_lio --config config.yaml で実行。

ROS 2での導入方法

sudo apt install ros-$ROS_DISTRO-rko-lio   # Humble, Jazzyなど向けバイナリインストール
# またはcolconワークスペースでソースからビルド
colcon build --packages-select rko_lio
ros2 launch rko_lio odometry.launch.py   # トピックとフレームを自動検出

• 自動検出が失敗した場合、imu_topic、lidar_topic、base_frame（または完全な設定ファイル）を起動引数で提供。

一般的なワークフロー

1. LiDARスキャン、IMUデータ、TFツリーを含むROSバッグを記録。
2. IMUからベース、LiDARからベースへの外挿変換がTFツリー内にあるか、YAMLファイルで供給されていることを確認。
3. パッケージ（Python CLIまたはROS起動）を実行して継続的な姿勢推定を取得。
4. Rerun（-v）でリアルタイム可視化、またはPlotJugglerで後で再生。

なぜ重要か – 伝統的なLiDAR-慣性オドメトリはセンサごとのキャリブレーション（ノイズモデル、バイアスパラメータなど）を必要とします。RKO‑LIOはその負担を軽減し、新しいハードウェアへの展開や迅速プロトタイピングの場面でも、正確でドリフトが少ない姿勢推定を可能にします。

ドキュメントとサポート

• Python APIドキュメント: https://prbonn.github.io/rko_lio/pages/python.html
• ROS統合ガイド: https://prbonn.github.io/rko_lio/pages/ros.html
• ビデオデモ（README内の画像をクリック）では、4つのプラットフォームでシステムが動作している様子を確認できます。

引用 RKO‑LIOを研究で使用する場合、付随するIEEE RA‑L論文（2026年）を引用してください。READMEに完全なBibTeXエントリが提供されています。

---

TL;DR – RKO‑LIOは、Rerunによるリアルタイム可視化をオプションでサポートする、ロボティクス向けの即時利用可能なセンサ非依存LiDAR-慣性オドメトリライブラリです。pipでインストール可能なPythonパッケージおよびROS 2パッケージとして利用可能です。