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

センサーをカスタマイズ

センサー設定は機体のSDFに含まれます。まず機体ビルダーで構成を選び、開始前の確認画面でSDFをダウンロードします。ファイルには有効なセンサーと、その機体で対応する全オプションのコメント付き例が含まれます。

変更する項目を選ぶ

SDFの項目 変更内容
sensor / pose 取付位置はm、ロール・ピッチ・ヨーはrad。ローカル座標はXが前、Yが左、Zが上です。
update_rate シミュレーション時間1秒当たりの要求測定回数。描画や中継の制限で受信周波数が下がる場合があります。
camera / image / width, height 画像のピクセル数。アップロード時にもビルダーの寸法・画素数上限を適用します。
camera / horizontal_fov 水平画角(rad)。変更すると画像の幾何特性と校正値も変わります。
camera / clip / near, far 幾何学的なクリップ面(m)。0 < near < far ≤ 10000。水中の濁りにより実用的な視程は短くなる場合があります。
lidar / scan、lidar / range 光線の角度、サンプル数、測定範囲。センサーの型と接続経路を維持します。
gz:dvl / maximum_range 海底反射の最大距離。保存値はDVLアダプターにも反映されます。
noise 既存のノイズモデルのパラメーター。型を維持し、含まれる数値を編集します。
音響プラグインの項目 プロバイダー固有の周波数、ビーム形状、範囲、強度処理。センサーモデルとパラメーターを参照してください。

クリッピングは光の吸収とは別の設定です。単一Ping、DVL、イメージングソナーは異なる測定を行うため、範囲の値を増やしても測定方式は変わりません。

校正と接続を保つ

SDFファイルを編集 → 編集した機体SDFをアップロードからファイルを読み込みます。対応する取付位置、周波数、画像寸法、画角、範囲は、保存するレシピとセンサーマニフェストにも反映されます。次のセッションは保存したSDF自体を使い、ほかの許可された数値パラメーターも保持します。

トピック名、フレーム名、プラグインのファイル名、制御系の接続は変えないでください。センサーの追加・削除は保存済みの機体 → コピーを編集で行い、その構成をエクスポートします。マルチビームソナーには実行ホスト上の対応プロバイダーが必要です。DVLと単一Pingは同時に選べません。

完全な例と確認

WAM-Vの完全なSDFとBlueROV2の完全なSDFに、モデル全体と無効なセンサーの一覧を掲載しています。コメントは説明であり、センサーを有効にするものではありません。

再起動後、センサーツリー、画像寸法、タイムスタンプ、取付方向を確認します。出力の確認にはRVizとFoxgloveで表示を使えます。検証に失敗した場合は指摘された項目を修正します。上限を超える値を指定しても、実行環境の機能は増えません。

オプションセンサーとプロバイダー

測定方式と実行ホストを確認してから選びます。プロバイダーが必要と表示されて選べない項目には、対応する検証済みプラグインのインストールが必要です。Webサーバーと自分のコンピューターでは利用できるプロバイダーが異なる場合があります。

センサー 出力と用途
前方/下向きカメラ カラー画像と校正情報。取付方向、画角、解像度をまとめて確認します。
WAM-Vの2D LiDAR 平面内の距離走査。走査高さの外側にある物体は映らない場合があります。
下向き単一Ping 狭い光線束から求める1つの距離。DVLの代わりに選択し、イメージングソナーとは異なります。
DVL 海底基準の速度と状態。有効な海底反射が必要で、Pingとの選択式です。
前方マルチビームソナー 対応する音響プロバイダーによる距離・方位別の強度。物理モデルによるソナーのプレビューを参照してください。

センサーを追加するだけではSLAM地図は作成されません。対応する推定器、入力データ、校正、時刻同期、座標フレームも必要です。録画デモでは専用のSLAM構成を使います。ホストの対応機能とPOSIM-SLAMのドキュメントを確認してください。

ドキュメントを検索