WWW-POSIM v0.6.16シミュレーターのドキュメント
ドキュメントメニュー
WWW-POSIM / シミュレーターのドキュメント

構成要素とライブラリ

WWW-POSIMは、公開されたシミュレーション・アルゴリズムライブラリと非公開のアプリケーションコードを組み合わせ、Webワークスペース、インストール版、サービスAPIを提供します。

WWW-POSIMの構成

公開コンポーネント

非公開のアプリ構成

  • ワークスペースと配信UI、シーン表示、動画
  • アカウントとセッションログイン、権限、利用枠、待機列
  • ワールドと保存資料準備処理、機体ライブラリ、保存
  • 航海の実行管理行程、復帰地点、復旧調整
  • デスクトップ連携ランチャー、実行環境、配布
WWW-POSIMアプリケーションとAPI

Web · インストール版 · API

公開コンポーネントと非公開コードがWWW-POSIMを構成します。SLAMは導入済みセンサーとプロバイダーに依存します。
  1. POSIM

    POSIM
  2. POSIM-Terrain

    POSIM-Terrain
  3. POSIM-Routing

    POSIM-Routing
  4. POSIM-Control

    POSIM-Control
  5. POSIM-SLAM

    POSIM-SLAM
  6. WWW-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画像を使います。

インストール、衛星テクスチャの準備、出力コマンドはPOSIM-Terrain READMEをご覧ください。

POSIM-Routing

寄港順と各到着区域への経路を計画します。港間の接続にはOSMの陸地ポリゴンを使い、沿岸・局所プランナーは表現された地形を確認します。港のカタログ位置と水上の到着目標は別の入力です。

コマンドとAPIはPOSIM-Routing READMEにあります。広域経路だけでは水深を確認できません。

POSIM-Control

Gazeboの機体モデルに推進力を加えます。先行機体は指定ウェイポイントを進み、追従機体は計測された先行機体の姿勢を追います。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の例には、陸と海を含むニューヨーク、釜山、東京があります。

出力グリッドを細かくしても、元データの測定精度は上がりません。地形生成の処理とアルゴリズムを参照してください。

Macのネイティブエンジンには、Apache-2.0のGazebo Sim Sensorsを独自修正したものが含まれます。変更ソース、ビルド手順、パッチ、告知、ライセンスはエンジン内のwww-posim/sources/gz-sim-sensors-stopにあります。POSIMのGNSSセンサーには個別のMITライセンスと告知があります。

ドキュメントを検索