POSIM v1.0.1Platform for Ocean Simulation · 文档
文档菜单
POSIM / 插件参考

水下相机

UnderwaterCamera 利用深度信息,让 RGB 颜色随距离衰减。可按目标水体调整衰减系数和背景色。整个场景共用的视觉效果见水下场景渲染。

运行示例

相机示例世界默认启用小波浪和水下场景效果。传感器启动时设置 POSIM_UNDERWATER_PLUGIN,让兼容输出直接传递已渲染的 RGB 像素,避免重复衰减。比较独立的深度滤镜时,请使用未加载场景系统的世界,并取消该环境变量。

在准备好的终端 A中运行示例。

ros2 launch posim_demos posim_sensor.launch.py \
  namespace:=underwater_camera world_name:=camera_tutorial \
  x:=10 z:=-93.5 pitch:=0.3 yaw:=3.14 \
  paused:=false gui:=true headless:=false

在准备好的终端 B 中查看:

ros2 topic echo /underwater_camera/simulated_image \
  sensor_msgs/msg/Image --once --no-arr
ros2 topic hz /underwater_camera/simulated_image

在 RViz 中添加 Image 显示项。如果话题可见但图像停止到达,请检查大图像消息的传输设置。

配置插件

将以下 RGBD 传感器放在 <link> 内。世界还需加载指定 <render_engine>ogre2</render_engine> 的 gz-sim-sensors-system,参见相机世界。插件读取 Gazebo 彩色和深度图像,直接发布 ROS 话题 /underwater_camera/simulated_image。

<sensor name="underwater_camera" type="rgbd_camera">
  <update_rate>10</update_rate>
  <topic>underwater_camera</topic>
  <camera>
    <horizontal_fov>1.05</horizontal_fov>
    <image><width>320</width><height>240</height></image>
    <clip><near>0.1</near><far>10.0</far></clip>
  </camera>
  <plugin filename="UnderwaterCamera"
          name="posim_gz_sensor_plugins::UnderwaterCamera">
    <attenuationR>0.8</attenuationR>
    <attenuationG>0.5</attenuationG>
    <attenuationB>0.2</attenuationB>
    <backgroundR>85</backgroundR>
    <backgroundG>107</backgroundG>
    <backgroundB>47</backgroundB>
  </plugin>
</sensor>
SDF 参数 含义 默认值
attenuationR 红色通道每米衰减系数,有限且 ≥ 0 1/30
attenuationG 绿色通道每米衰减系数,有限且 ≥ 0 1/30
attenuationB 蓝色通道每米衰减系数,有限且 ≥ 0 1/30
backgroundR 背景红色分量,0–255 整数 0
backgroundG 背景绿色分量,0–255 整数 0
backgroundB 背景蓝色分量,0–255 整数 0

话题与相机几何参数

<topic> 必须生成有效的 ROS 话题名。省略时使用 Gazebo 路径 /world/<world>/model/<model>/link/<link>/sensor/<sensor>,再加 /simulated_image 作为 ROS 输出。嵌套模型还包含父模型路径。

将深度转换为沿视线的距离时,依次采用显式镜头投影、显式内参,最后才使用图像尺寸和水平视场角。主点坐标可以为零。焦距必须为正,镜头参数必须有限,以米为单位的裁剪距离须满足 0 < near < far。无效配置会报错并停用输出。

帧同步与示例值

彩色帧和深度帧按采集时间戳配对,与到达顺序无关。ROS 输出图像保留彩色帧的时间戳和坐标系标识。缓冲区满时丢弃未配对帧;仿真时间重置会清空待配对帧,允许时间戳重新开始。

示例设置为 320 × 240、10 Hz,RGB 衰减系数 0.8/0.5/0.2,背景 85/107/47。SDF 配置优先于代码默认值。

调整与比较

将容易辨认的物体放在已知距离处。固定位置姿态、光照、材质和相机设置,每次只修改一个通道。除图像外,也检查采集时间戳和实际接收频率。

每个通道采用指数衰减并混合背景色。需要无衰减对照时,将表中的六个参数全部设为零。省略标签会恢复默认值。

场景渲染器为 PBR 表面和相机提供共同效果。该系统运行时,POSIM_UNDERWATER_PLUGIN 会让已着色像素直接通过,避免二次衰减。输入输出连接见相机模型。

悬浮颗粒

场景渲染器可在 RGB/RGBD 彩色图像中显示悬浮颗粒。默认关闭,可通过外观设置服务开启。

这是程序生成的视觉效果。定量研究散射需要适合的光学模型。评估视觉导航时,将颗粒视作运动观测对象,并在对比实验中保持外观设置一致。

比较水下图像

Gazebo中的水下相机场景
Gazebo中的水下相机场景
显示水下相机图像
显示水下相机图像
RGB衰减为零、背景为黑色时的图像
RGB衰减为零、背景为黑色时的图像
浑浊近岸水体:RGB衰减为0.8/0.5/0.2,背景色为85/107/47
浑浊近岸水体:RGB衰减为0.8/0.5/0.2,背景色为85/107/47

图片来源:POSIM Notion Wiki;DAVE 署名见引用与许可证。执行时使用本页代码块中的命令和话题名称。