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字段表示单元数。WAM-V演示使用香港地形;练习使用独立场地,平坦海底深20 m。参阅地形生成流程与算法。

按需地形生成

项目 规格
数据准备 获取数值高程/水深及可用陆地影像,投影到本地米制网格
瓦片构建 视觉与碰撞网格共享样本,两单元采样缓冲区保持边界连续
Gazebo生成 在本地坐标生成真实SDF地形实体
就绪检查 检查实体存在、RGBD 深度以及半径 0.25 m、质量 10 kg 的球体接触;以反映坡度的碰撞网格距离判定 · 地形物理接触检查
预取 按位置和速度准备下一外圈:前视120 s、至少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前照灯 两个前向聚光灯;默认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二维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, 地形三维对角线 × 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

坐标转换发生在自动驾驶接口处。这些参数描述仿真模型,不代表厂商的续航、额定深度或传感器精度。

参考资料

搜索文档