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