POSIM v1.0.1Platform for Ocean Simulation · 文档
文档菜单
POSIM / 进阶指南

添加与配置传感器

传感器需要模型定义、负责更新的系统,以及通向接收程序的数据链路。每次添加一个传感器,确认测量正常后再继续。

工作环境

使用 Ubuntu 原生安装、WSL 或 Docker 中准备好的 Linux 终端。macOS 用户在 RDP 桌面内操作。编辑和编译都在该环境中完成;POSIM_WS 表示其工作空间。

选择集成位置

测量 模型中的位置 世界系统 / ROS 连接
IMU link/sensor type="imu" IMU 系统;将 gz.msgs.IMU 桥接为 ROS Imu
水下相机 RGBD 传感器与图像效果插件 带渲染器的 Sensors 系统及相机话题
DVL DVL 传感器与波束配置 DVL 系统及随附的声学消息桥接
压力 model 下的直接子插件 直接发布 ROS 压力与深度消息
海洋 GNSS 机器人模型上的接收机插件 Gazebo gz.msgs.Double_V 测量消息;接入 ROS 需要单独的适配器
USBL 收发机与应答器插件 匹配的声学标识及 ROS 接口
多波束声纳 连杆下的自定义传感器 Sensors 渲染器、世界多波束系统及 CPU/WGPU/CUDA

参考各页的 SDF 和参数表,并遵守插件位置要求:世界系统放在世界中,模型插件放在其作用的模型中。

为示例世界添加 IMU

打开创建世界中的 calm_water.sdf。在 <world> 下、与物理系统同级的位置添加:

<plugin filename="gz-sim-imu-system" name="gz::sim::systems::Imu"/>

在 pressure_station 模型的 <link name="base_link"> 内添加:

<sensor name="imu" type="imu">
  <pose>0 0 0.1 0 0 0</pose>
  <always_on>true</always_on>
  <update_rate>20</update_rate>
  <topic>/tutorial/imu</topic>
  <imu/>
</sensor>

安装位姿相对于所属连杆,位置单位为米,旋转单位为弧度。更新频率使用仿真时间。观测点固定,因此角速度应接近零;加速度包含对重力的响应。

连接并查看数据

停止之前的世界,在终端 A 校验并重新启动:

gz sdf -k calm_water.sdf
gz sim -r calm_water.sdf

在加载了环境的 终端 B 启动桥接,并保持运行:

ros2 run ros_gz_bridge parameter_bridge \
  '/tutorial/imu@sensor_msgs/msg/Imu[gz.msgs.IMU'

在以相同方式准备的 终端 C 查看测量值:

ros2 topic echo --no-daemon /tutorial/imu sensor_msgs/msg/Imu --once

确认时间戳、坐标系标识、角速度和加速度。去掉 --once 可持续查看,按 Ctrl+C 停止显示。完成后停止桥接和仿真器。ROS 终端与话题解释了如何共享运行环境。

改变更新频率

将 update_rate 从 20 改为 5,重新启动世界和桥接。相邻时间戳间隔应从约 0.05 秒变为 0.2 秒仿真时间。按实际时间计算的接收频率还取决于实时因子和传输过程。

相机应一起检查分辨率、视场角及近远裁剪距离。扫描传感器应检查波束几何和量程。移动传感器前,先确认所属连杆的坐标系和朝向。

核对集成结果

用高度图地形检查海底位置。声纳对比实验请结合配置与性能和参数参考。