POSIM v1.0.1Platform for Ocean Simulation · 文档
文档菜单
POSIM / 机器人控制

水面机器人与波浪

使用 Wave Sim 波浪和 ArduRover 船舶模式来仿真 WAM-V。POSIM 标准安装程序和 Docker 构建流程会编译外部波浪库。

标准教程

标准 POSIM 安装包含带相机、激光雷达和预设 RViz 视图的 WAM-V 浮标航道示例,无需下方的可选镜像。在准备好的 POSIM 终端中运行:

ros2 launch posim_demos surface_tutorial.launch.py

场景、激光雷达显示、QGroundControl 视频与控制步骤见第一次仿真。

准备 WAM-V

此可选镜像采用 ARM64 桌面布局。在 Apple Silicon Mac 上准备好 Docker 与 RDP,然后进入 POSIM 仓库副本,在 macOS 终端执行:

docker pull ioeslab/posim:latest
docker build -f extras/surface/Dockerfile \
  --build-arg POSIM_BASE_IMAGE=ioeslab/posim:latest -t posim:surface .
docker run -d --name posim-surface --shm-size=1g \
  -p 127.0.0.1:3390:3389 posim:surface

通过 RDP 连接 127.0.0.1:3390,使用 docker 账号。在 Linux 桌面内打开终端:

source /opt/ros/lyrical/setup.bash
source /home/docker/posim_ws/install/setup.bash
ros2 launch /opt/posim-surface/wamv.launch.py headless:=false

镜像包含独立的 ArduSub 和 ArduRover 可执行文件。本例选择 FRAME_CLASS=2 的 ArduRover。车辆名称、生成文件和控制器端口固定,因此每个环境只运行一个实例。多艇运行需要分开文件、名称、控制器标识和端口,或使用相互隔离的环境。

控制器等待模型生成并收到 IMU 数据。若生成失败或超过 180 秒,或生成后 180 秒内没有 IMU 测量值,启动程序会报告失败阶段并以错误状态退出。重试前先检查 Gazebo 和传感器消息。

模型、控制与导航

extras/surface/wamv.py 负责配置外部模型。船尾两台螺旋桨由输出 1 和 3 驱动,船从水面开始运行。

外部导航适配器向 MAVROS 发送 Gazebo 仿真的位姿与速度。发送任务前,请检查控制器状态、导航数据有效性和推力方向。

要研究接收机噪声、接触水面和重新捕获,请加入海洋 GNSS、天线及合适的导航适配器。本例的外部位姿适配器属于另一种导航输入。

调整波浪

通过 /world/<world_name>/waves 发送 gz.msgs.Param。名称来自 SDF 的 <world name="…">。先列出当前话题:

gz topic -l

WAM-V 启动文件的默认名称是 posim_surface,因此话题为 /world/posim_surface/waves。在准备好的容器中可以更改名称:

SURFACE_WORLD=harbour
ros2 launch /opt/posim-surface/wamv.launch.py headless:=false world_name:="$SURFACE_WORLD"

此时波浪话题为 /world/harbour/waves,ROS IMU 仍使用 /model/wamv/imu。world_name 设置生成世界的名称,不选择地形文件,也不会隔离另一个实例。

本例海底为 z = −10 m 的平面。自定义地形请参考高度图地形。

参数(double) 单位 用途
wind_speed m/s 波浪模型的风速
wind_angle 度 风向
steepness 无量纲 波陡

保持视觉与水动力设置一致。海流单独配置。除了安装库,还必须在世界中加入并配置波浪系统。

限制与依赖

此可选 Dockerfile 支持 ARM64 布局。船体、推进和阻力参数需要根据船舶及运行条件标定。退出时,MAVROS 或 Gazebo 可能需要由监控进程终止;再次启动前请确认两者都已退出。

extras/surface/dependency.json 固定外部依赖版本。安装程序将库编译到 /opt/waves,并把源码保留在 /opt/asv_wave_sim。它是构建依赖,不是 Git 子模块。另见集成指南和许可证。