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