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

シミュレーション・描画・センサーの構成

WWW-POSIMがワークスペースを管理し、POSIMとGazeboが物理とセンサーを計算します。ブラウザーやビューアーはその結果を表示します。

処理の流れ

  1. 1. 地形検証とセッション準備

    スキーマ、エンジン・ライブラリ互換性、必要リソースを検査します。初期位置を変換・検証し、セッション専用ワールド・機体SDFを準備します。nonceが実行を識別します。

  2. 2. Gazeboと制御器を起動

    質量、慣性、衝突形状、関節、環境システムを読み込み、ArduPilot、ROS 2直接制御、自動航海の経路を選びます。

  3. 3. 指令 → 物理積分

    駆動力、浮力、流体力、波、接触を適用します。Gazeboが時間を進め、姿勢と速度を求めます。表示アニメーションが物理を動かすわけではありません。

  4. 4. 状態 → センサーとROS 2

    設定したメッセージを生成し、ブリッジとサービスで状態を公開します。カメラとGPU LiDARは引き続きGazeboと描画環境を使います。

  5. 5. ワークスペースとRViz

    Browserは受信した状態と地形を描き、Gazebo表示はエンジン画像を配信します。RViz Webはセッション接続・配置付きのLichtblickを開き、アプリは同梱ネイティブRVizを起動します。

  6. 6. 監視・範囲拡張・復帰

    起動、トピック・TF、画像、進捗を別々に監視します。前方の検証済み地形を読み込み、原点移動では航法と追従航跡を整合して変換し、物理速度を保ちます。

技術の対応表

構成要素 担当 詳細
POSIM-Terrain・地理ライブラリ WGS 84、数値投影、ラスタ・海岸線、メッシュ、由来情報。 地形生成の処理とアルゴリズム
Gazebo・Wave Sim 剛体、接触、駆動、浮力、抗力、周期波。 海洋動力学と描画
POSIM・Gazeboセンサー 描画、運動計測、音響、座標、有効性。 センサーモデルとパラメーター
POSIM-Routing・POSIM-Control 地形余裕、範囲制限付き計画、ネイティブ航海推進。 経路計画と制御アルゴリズム
ArduPilot SITL・MAVROS モード、航法推定、MAVLink・ROS変換、出力。 GNSSと航法 · インストール版のワークスペースを制御
Ogre2・Three.js エンジン/センサー描画とブラウザー描画。同じ状態を別経路で表示。 海洋動力学と描画
POSIM-SLAM 対応する入力、外部パラメーター、プロバイダーを必要とする推定・地図生成。 センサーモデルとパラメーター · POSIM-SLAM
WWW-POSIM アカウント、セッション、組立て、一時接続許可、タイル管理、ビューアー、アプリ配布。 構成要素とライブラリ

ライブラリは再利用できる実装を提供します。実際に動く構成には、プラグイン実行ファイル、対応SDK、モデル構成、メッセージ接続も必要です。センサー選択やSLAM録画だけで、すべての配布版に推定処理が常時動いているとは判断できません。

時刻・座標・識別情報

項目 解釈
シミュレーション時間・実時間 物理と計測はシミュレーション時間。利用許可、接続失効、一部の監視は実時間。処理量や遅延の評価では両方記録します。
地形map・機体FLU 地理地形をメートル座標へ投影し、機体軸は前・左・上。外部パラメーターで取付位置を対応付けます。
カメラ・FCU 光学軸は右・下・前。ArduPilotはENU/FLUをNED/FRDに変換し、GNSSは別FCU原点を使います。軸名の変更だけで済ませず変換を保ちます。
セッション・構成 nonceが実行を、センサーマニフェスト・地形ID・ライブラリ版が構成を識別します。新しい実行には現在のトピックと許可が必要です。
リセット・浮動原点 リセットは計測時系列を変えます。原点平行移動は座標を変えても物理速度を保ちます。両方のイベントを記録します。
真値・観測・推定 Gazebo姿勢は参照、カメラ・GNSS・DVLは計測、FCU・SLAMは推定です。由来を分け、推定器が直接使う真値に対して同じ推定器を評価しないでください。

描画と計測の境界

BrowserはThree.jsでシーンを描きます。この選択でもカメラ・GPU LiDAR生成はGazeboに残ります。Ogre2はエンジン表示と描画型センサーを担当します。表示LOD、可視マスク、レンズ位置、水材質、クリッピングは、衝突形状が同じでも観測を変えます。

ソナーレイ形状、RGB色、深度は別出力です。RGB専用表示を音響形状から除外できます。表示点群が単発のレイ・深度観測だけの場合もあり、累積や姿勢補正には実行中の地図生成処理が必要です。物理モデルによるソナーのプレビューを参照してください。

動画とセンサーの配信

  1. Gazebo → 計測・画像

    エンジンホストが物理状態、メッセージ、画素を生成し、Browserは受信状態を独立して描画します。

  2. アプリ → 接続許可 → ゲートウェイ

    Webがアカウント・セッションのアクセスと接続先を準備します。公開データは別のシミュレーターオリジンへ直接接続します。対応ホストでは私用画像とRVizに範囲限定の一時許可を使います。

  3. ビューアー → バッファー・鮮度 → 表示

    動画は再生バッファーを使い、メッセージは時刻と受信状態を保持します。接続中と古いデータを区別し、センサー時刻と物理RTFを確認します。

インターフェース 形式・動作
LIVE・香港デモのGazeboシーン 共有H.264 HLS。短いセグメントをメディアサーバーから直接取得し、バッファー再生。
香港デモRGB 共有H.264 HLS。初期バッファー準備まで接続中表示。
個人シーン・カメラ Gazebo JPEGフレーム要求。対応ホストは限定直接アクセス、アプリはローカルサービス。
ROS圧縮カメラ JPEG CompressedImage。標準コネクターは最大1シミュレーションHzで、HLSとは独立。
RViz Web・外部ROSビューアー WebSocketのROSメッセージ。RViz Webは読取り専用で、トピック制限はRVizとFoxgloveで表示に記載。

VercelはUIと短い接続設定リクエストを処理できます。公開の継続動画・トピックはVercel Functionsを通りません。私用ワークスペースの直接配信はホストが示す能力に従います。一時URLは公開しないでください。画面の1フレームだけでは制御遅延を測れません。

共有エンコードと要求

LIVEは読取り専用配信です。要求されたビューごとに共有エンコーダープロセスがあり、要求で5秒の利用期限を更新します。視聴がなければ期限切れで停止します。見られていないシーンカメラはGazebo購読を解除し、到着写真は別途短い撮影を要求できます。物理、航法、機体センサーは継続します。

配信 動画目標
シーン低画質 15 FPS、最大640 × 360、0.6 Mbit/s
シーン高画質 15 FPS、最大960 × 540、1.2 Mbit/s
選択機体のカメラ 5 FPS、最大幅640画素、0.4 Mbit/s
非視聴ビュー 5秒の期限切れでエンコーダー停止

同じ取得画像から2画質を1回ずつエンコードし、全視聴者で共有します。回線に応じてプレーヤーが選び、低画質でも目標は15 FPSです。機体カメラと対話デモには個別設定があります。

LIVE航海はログインページから誰でも視聴できます。地図や機体データなど、航海画面の一部が表示されている間は選択したシーンの接続を維持します。全画面表示からログインページに戻っても、同じシーンの接続が続きます。一時停止した場合、タブを非表示にしたり閉じたりした場合、ライブデモやウェブワークスペースを開いた場合は、ログインページの配信が止まります。開いていて画面に表示されているセンサーカメラは個別に接続を更新します。動画とメタデータはサーバーから直接取得します。LIVEに視聴人数の上限はありません。対話型デモの上限は2人です。

最初のバッファー準備中は、サーバーにある当該シーンのキャッシュJPEGを直接表示します。ネイティブワールドのnonceを検査します。接続メッセージと動くバーは、航海状態・目的地・RTF・速度の下に表示します。ワールド・ビュー変更で古いプレビューを破棄し、非表示なら要求を止めます。再生開始でJPEGを消し、後の途切れでは最後の動画フレームを残して再接続を表示します。

シーン購読は最新ネイティブテレメトリーを待ちます。地形準備だけなら大型シーンカメラを起動する必要はありません。エンコードを共有しても通信量は視聴者数に比例します。40人がシーンとカメラを見る場合、目標合計は付加通信を除いて40~64 Mbit/sです。実際の容量は上り回線と描画性能で決まり、人数だけでFPS目標は下がりません。

バッファーと実際の画像頻度

LIVEはHLSライブ端より3秒遅れの目標で開始し、停止時は最大12秒まで増やします。新しい配信は2秒セグメント2個と撮影時刻の補正がそろうと再生可能になります。約4秒に撮影・エンコーダー起動時間が加わります。対話デモも3秒で開始します。計器とカメラは映像の表示時刻に従い、全体の遅延には符号化とセグメントの準備時間が含まれます。

計器とカメラパネルは動画提示時計に合わせます。撮影から表示までにはエンコードとセグメント準備も含むため、バッファー目標だけでは総遅延を測れません。

撮影はシミュレーション時間基準です。低RTFや撮影の停止は、実時間1秒当たりの異なる画像数を減らします。source_fps、source_frames、max_source_gap_secondsは入力フレームから計算します。デコーダーが15 FPSでも同じ画像の繰返しがあり、毎秒15枚の新規撮影を証明するものではありません。

解釈と担当範囲

地形準備完了、セッション実行、カメラの最新受信は別状態です。背景画像更新は実行中の衝突データを書き換えません。メッシュ標高が接触を決め、衛星・砂・水・地図は表示層です。RTFはシミュレーション時間と実時間の比です。

WWW-POSIMはセッション、配信、ビューアー起動を担当し、Terrain・Routing・Controlは各アルゴリズムを担当します。POSIMエンジン・ライブラリガイド。

構成要素とライブラリ · 地形生成の処理とアルゴリズム · 経路計画と制御アルゴリズム · ワールドをカスタマイズ · 物理モデルによるソナーのプレビュー

ドキュメントを検索