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

技術仕様

実行環境、データ、物理、機体インターフェースの既定値です。プラットフォームやワールドによる違いは個別に示します。

ソフトウェア

項目 仕様
ROS ROS 2 Lyrical
Gazebo Jetty · Gazebo Sim 10; macOS: 10.5.0
水上オートパイロット ArduRover 4.7.2 · SITL
水中オートパイロット ArduSub 4.7.2 · SITL
ArduPilotソース fb773567896014da007bca58358704d4a0d8516f
ブラウザー描画 Three.js 0.186.1 · React Three Fiber 9.8.1

シミュレーション時間

項目 仕様
既定の要求速度 1×
macOS物理ステップ 10 ms
Windows/Linux物理ステップ 20 ms
競技評価ステップ 10 ms
Webサーバー物理ステップ サーバー設定による

周波数はシミュレーション時間基準です。実時間比RTF、物理更新頻度、センサー周波数、表示FPSは別の指標です。

物理と描画

項目 仕様
剛体運動と接触 Gazebo Physics、既定DART
海洋運動 Wave Simの波浪場・浮力・流体力
BlueROV2流体力 波を考慮した浮力と並進・回転減衰
Gazeboビュー・センサー エンジンホストのOgre2、macOSはMetal
ブラウザーシーン Three.js/WebGLが状態から地形・機体・水を描画
ブラウザー波面形状 物理波ソルバーのサンプル

地形・海面・海底の範囲

項目 仕様
WAM-Vデモ地形 準備済み香港、中心2 × 2 km・周囲6 × 6 km、数値標高/水深と航空画像
カスタムワールド既定 固定1 × 1 km、必要時読込みは任意
必要時読込みの初期範囲 1,000 × 1,000 m · 129 × 129
必要時読込み数値間隔 7.8125 m
既定タイル 1,000 × 1,000 m
個人ワークスペースの必要海底 5 × 5 タイル · 5 × 5 km
LIVEの必要海底 7 × 7 タイル · 7 × 7 km
ストリーミング無効時の固定範囲 1 × 1 km · 513 × 513 · 1.953125 m
周期物理波タイル 256 × 256 m · 64 × 64 セル
個人Gazebo詳細海面 3 × 3 タイル · 768 × 768 m
LIVE表示波タイル 15 × 15 タイル · 3,840 × 3,840 m

波の計算タイル、見える水面、数値地形、読込み済み衝突海底はそれぞれ異なる範囲です。波タイルは同じ周期場を繰り返し、独立した海洋計算ではありません。グリッド寸法はサンプル数、FFTはセル数です。デモは香港、課題は深さ20 mの平坦海底を持つ専用アリーナを使います。地形生成の処理とアルゴリズムを参照してください。

必要時の地形生成

項目 仕様
データ準備 数値標高/水深と利用可能な陸域画像を取得しローカルメートル座標へ投影
タイル構築 表示・衝突メッシュはサンプルを共有し、2セルの余白で境界を連続化
Gazebo配置 実SDF地形エンティティをローカル座標に配置
準備検査 エンティティ存在、RGBD 深度、および半径 0.25 m・質量 10 kg の球体による接触を確認。傾斜を反映した衝突メッシュまでの距離で判定 · 地形の物理接触検査
先読み 位置・速度から次の外周列を準備。120秒先、最低250 m、タイルの40 %まで
待機と再開 必要範囲がなければ待機し、現在の正方形全体が検査を通ると再開
キャッシュと常駐 サンプルと最近のタイルを再利用し、常駐数制限で遠方を削除

データセット

項目 仕様
GEBCO 2026 全球標高・水深、原データ15秒角
Copernicus GLO-30 陸域標高、公称30 m
Copernicus Marine 202511 利用可能な地域の沿岸水深
EMODnet DTM 2024 主に欧州海域の地域水深
KHOA BADA2024 任意の韓国水深データ
Cesium World Bathymetry ライセンス付き数値アクセス設定時に優先
OpenStreetMap 海岸線・陸水境界の補正
Sentinel-2 RGB 陸域画像、公称10 m

ワールドには実際に使ったデータ源を記録します。メッシュ間隔を細かくしても、元の測定精度は上がりません。

機体モデル

項目 仕様
WAM-V推進 2基、左右
BlueROV2推進 6
WAM-V質量 船体リンク180 kg、全リンク211.151 kg
BlueROV2質量 船体リンク10 kg、全リンク約10.0132 kg
WAM-V船体衝突範囲 5.006 × 2.487 × 1.291 m
BlueROV2船体衝突箱 0.457 × 0.338 × 0.065 m
BlueROV2前方ライト 前方スポットライト2灯、既定ON、モデル減衰距離25 m
メーカー公表BlueROV2全体寸法 0.457 × 0.338 × 0.254 m

衝突寸法はシミュレーション形状で、実製品全体の大きさとは別です。合計質量はSDFリンク質量の和です。

既定センサー・状態出力

項目 仕様
WAM-V GNSS 標準、5 Hz、遅延0.2 s、GPS_INPUT → EKF
BlueROV2衛星GNSS 標準で有効、明示的に無効化可能、アンテナ水没判定、再捕捉3 s
WAM-V IMU 200 Hz
BlueROV2 IMU 設定1,000 Hz、物理ステップで制限
両機体の前方RGB 640 × 480 px · 5 Hz · HFOV 1.05 rad (60.2°)
BlueROV2点検RGB-D 640 × 480 px、5 Hz、水平画角60.2°、下向き45°
WAM-V 2D LiDAR 5 Hz、360°に360点、0.2~50 m、距離分解能0.02 m
BlueROV2磁力計 20 Hz · Gazebo
WAM-Vオドメトリー 20 Hz
BlueROV2オドメトリー 100 Hz

カメラは必要時に有効になります。標準ROSコネクターはシミュレーション時間で最大1 HzのJPEGを配信します。オドメトリーはシミュレーター状態であり、誤差を持つ物理測位センサーではありません。実配信頻度は設定値より低い場合があります。HFOVは水平画角です。

GNSSと航法に品質、アンテナ座標、喪失・復帰を定義しています。機体編集はセンサー構成、取付位置、設定を変更できます。生成トピックは/vehicle/sensors/{sensor_id}と出力別の接尾辞を使います。実行中の一覧とsensor-manifest.jsonで確認してください。センサーをカスタマイズでDVL、Ping、マルチビームを区別し、センサーモデルとパラメーターで実装、SDF、誤差、有効条件を説明します。

カメラのクリッピングと可視範囲

項目 仕様
標準WAM-V前方RGB near 0.1 m · far 5,000 m
標準BlueROV2前方RGB near 0.1 m · far 5,000 m
BlueROV2点検RGB-D near 0.1 m · far 80 m
機体編集のカメラ 保存済み設定、上記標準カメラとは別
個人Gazeboシーンカメラ near 0.1 m、far = max(5,000 m, 地形3D対角線 × 16)
LIVE Gazeboシーンカメラ near 0.1 m · far 5,000 m · 1280 × 720 px
ブラウザーWorld/Vehicleカメラ near可変0.03~40 m、far最低8,000 m、ワールドと視距離で拡大

nearとfarは幾何学的な描画範囲です。水中減衰、遮蔽、読込み済み地形、画像範囲によって有効な視距離は短くなります。シーンカメラと機体センサーは別です。

ROSトピックとメッセージ

項目 仕様
/clock rosgraph_msgs/msg/Clock
/model/{robot}/odometry nav_msgs/msg/Odometry
/model/{robot}/imu sensor_msgs/msg/Imu
/model/{robot}/camera/compressed sensor_msgs/msg/CompressedImage · JPEG ≤1 Hz
/model/wamv/scan sensor_msgs/msg/LaserScan
/model/bluerov2/inspection/image/compressed sensor_msgs/msg/CompressedImage · RGB
/tf, /tf_static tf2_msgs/msg/TFMessage
/mavros/battery sensor_msgs/msg/BatteryState · Autopilot
/wwos/cmd_vel geometry_msgs/msg/TwistStamped · WAM-V · ROS 2
/wwos/thrusters std_msgs/msg/Float64MultiArray · ROS 2 · N

{robot}はwamvまたはbluerov2です。コネクターは点検RGBを公開し、RGBD深度は独立したネイティブ出力です。指令更新が止まると0.75秒のウォッチドッグで中立に戻ります。

座標・単位・モデル仮定

項目 仕様
地理座標 WGS 84、緯度・経度、度
ローカル軸 ENU:東・北・上
Gazebo機体軸 FLU:前・左・上
ArduPilot機体軸 FRD:前・右・下
ArduPilot航法軸 NED:北・東・下
ROS運動単位 m · s · m/s · rad/s · m/s² · N

座標変換はオートパイロットとの境界で行います。ここでの値はモデル仕様であり、メーカーの航続時間、耐深度、センサー精度を保証するものではありません。

参考資料

ドキュメントを検索