構成要素とライブラリ
WWW-POSIMは、公開されたシミュレーション・アルゴリズムライブラリと非公開のアプリケーションコードを組み合わせ、Webワークスペース、インストール版、サービスAPIを提供します。
WWW-POSIMの構成
公開コンポーネント
- POSIMエンジン、海洋モデル、センサー
- POSIM-Terrain地理地形、メッシュ、画像
- POSIM-Routing航法と検証済み経路計画
- POSIM-Control推進と運動方策
- POSIM-SLAMセンサーによる推定と地図作成
非公開のアプリ構成
- ワークスペースと配信UI、シーン表示、動画
- アカウントとセッションログイン、権限、利用枠、待機列
- ワールドと保存資料準備処理、機体ライブラリ、保存
- 航海の実行管理行程、復帰地点、復旧調整
- デスクトップ連携ランチャー、実行環境、配布
POSIM
POSIMPOSIM-Terrain
POSIM-TerrainPOSIM-Routing
POSIM-RoutingPOSIM-Control
POSIM-ControlPOSIM-SLAM
POSIM-SLAMWWW-POSIM
WWW-POSIM — 非公開リポジトリ。アクセス権が必要です。
アプリケーションは各ライブラリをアカウント、永続的なワークスペース、ユーザーインターフェースにつなぎます。利用できるセンサーと推定方式は、導入したエンジンとプロバイダーによって決まります。
構成要素別のガイド
| 構成要素 | 使い方 | 技術資料 |
|---|---|---|
| 地形 | 目的の場所の地形を生成 | 地形生成の処理とアルゴリズム |
| 経路計画と制御 | LIVE 世界航海、インストール版のワークスペースを制御 | 経路計画と制御アルゴリズム |
| エンジンとアプリ | ワークスペースの基本、ワールドをカスタマイズ | シミュレーション・描画・センサーの構成 |
地形ライブラリは数値地形、画像、メッシュを生成します。WWW-POSIMはタイルの常駐、詳細度、衝突判定の準備、セッションキャッシュを管理します。ライブラリが公開されていても、そのセンサーやSLAM推定器が実行ホストに導入されているとは限りません。
海洋ロボット研究向けの技術資料は、海洋動力学と描画、センサーモデルとパラメーター、地形生成の処理とアルゴリズム、経路計画と制御アルゴリズム、シミュレーション・描画・センサーの構成、物理モデルによるソナーのプレビュー、GNSSと航法で構成します。各章でモデル、設定、出力、解釈上の限界を分けて説明します。
公開ライブラリ
| ライブラリ | 役割 |
|---|---|
| POSIM | Gazebo上のシミュレーションエンジン、海洋環境、機体モデル、センサー |
| POSIM-Terrain | Pythonによる地理サンプリング、陸海データ選択、メッシュ・SDF出力、テクスチャ |
| POSIM-Routing | Pythonの広域・沿岸・局所経路計画。POSIM-Terrainに依存 |
| POSIM-Control | Pythonの運動方策と、C++製Gazebo先行・追従推進プラグイン |
| POSIM-SLAM | 独立した視覚・音響・慣性推定ライブラリ。アプリで使うには対応センサーとプロバイダーが必要 |
POSIM-Terrain
利用可能な標高・水深データを組み合わせ、陸地と海底の形状を作ります。数値地形はメッシュと経路の衝突確認に使い、陸地のテクスチャにはSentinel-2画像を使います。
- 入力:緯度、経度、領域サイズ、グリッドサンプル。
- 出力:標高値、メッシュ、SDF、テクスチャ、出典マニフェスト。
- 単独利用:領域の生成、都市地形パッケージの読み込み。
インストール、衛星テクスチャの準備、出力コマンドはPOSIM-Terrain READMEをご覧ください。
POSIM-Routing
寄港順と各到着区域への経路を計画します。港間の接続にはOSMの陸地ポリゴンを使い、沿岸・局所プランナーは表現された地形を確認します。港のカタログ位置と水上の到着目標は別の入力です。
- 入力:出発地、目的地、通過ゲート、数値地形。
- 出力:広域経路、沿岸回廊、局所ウェイポイント。
- 単独利用:航路の出力、生成地形上の経路計画。
コマンドとAPIはPOSIM-Routing READMEにあります。広域経路だけでは水深を確認できません。
POSIM-Control
Gazeboの機体モデルに推進力を加えます。先行機体は指定ウェイポイントを進み、追従機体は計測された先行機体の姿勢を追います。Pythonの方策は実測運動を使って速度を制限し、安定性、進捗、復帰を評価します。
- 入力:確認済みウェイポイント、要求速度、計測された機体状態。
- 出力:推進指令、制御器状態、運動方策の判断。
- 単独利用:Python方策、先行・追従ネイティブプラグインのビルド。
モデル要件、ビルド、制御トピックはPOSIM-Control READMEにあります。ネイティブプラグインには、準備済みPOSIM環境のGazebo開発パッケージが必要です。
各ライブラリは英語・韓国語の説明、ソース構造、インストール手順、テストを含みます。WWW-POSIMはGitサブモジュールでリビジョンを固定します。実行アダプターはその実装を読み込み、配布パッケージも選択したソースを含みます。
git submodule update --init --recursive
処理のつながりと都市の例
POSIM-Terrainが地形を生成し、POSIM-Routingが経路を計画・確認し、POSIM-Controlが承認済みウェイポイントに沿って進めます。Gazeboが物理運動を計算し、WWW-POSIMが結果を観測して次の地形・経路・制御更新を調整します。アカウント、セッション所有権、動画配信、航海の復帰地点、AIS表示はアプリの担当です。
Web版とインストール版は同じ固定リビジョンを使います。モデル、センサー、エンジン設定はPOSIMライブラリガイドをご覧ください。
POSIM-Terrainの例には、陸と海を含むニューヨーク、釜山、東京があります。
- 領域:20 × 20 km。
- 数値グリッド:257 × 257頂点、間隔78.125 m。
- 出典:GEBCO 2026、Copernicus GLO-30、利用可能な地域水深データ。
- ファイル:メッシュ、SDF、数値配列、Sentinel-2陸地テクスチャ、出典マニフェスト。
- 各都市にGazebo画像と再生成用READMEを添付。
出力グリッドを細かくしても、元データの測定精度は上がりません。地形生成の処理とアルゴリズムを参照してください。
Macのネイティブエンジンには、Apache-2.0のGazebo Sim Sensorsを独自修正したものが含まれます。変更ソース、ビルド手順、パッチ、告知、ライセンスはエンジン内のwww-posim/sources/gz-sim-sensors-stopにあります。POSIMのGNSSセンサーには個別のMITライセンスと告知があります。