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

世界场景库

场景文件位于 models/posim_worlds/worlds。启动时填写文件名,省略 .world 扩展名。

海洋演示场景包含 model://calm_waves:Wave Sim FFT 波浪使用 3 m/s 风速输入、256 m 周期网格和 768 × 768 m 显示区域,水面从上下两侧均可见。原生水下效果作用于 RGB 传感器图像;浅水教程也将其应用到 Gazebo 世界视图。标准安装脚本和镜像包含 Wave Sim。水下机器人的浮力、海洋 GNSS 和光学边界使用平均水面 z = 0,独立于显示波高;WAM-V 则使用与波浪耦合的 Wave Sim 水动力。无水的 USBL 示例和独立声呐测试场景保留各自的几何结构。

启动场景

无论使用 Ubuntu 原生安装、WSL、Docker 还是 RDP 桌面,都在对应安装方式的 POSIM 终端中执行。

ros2 launch posim_demos posim_world.launch.py \
  world_name:=posim_ocean_waves headless:=false

文件名可能与内部世界名称不同。例如,posim_ocean_waves.world 定义的内部名称是 oceans_waves;Gazebo 的话题和服务路径使用内部名称。填写路径前,先检查 <world name="…">。

按实验选择场景

实验 世界场景
首次运行机器人 posim_ocean_waves
水下相机图像效果 camera_tutorial
DVL 测量 dvl_world
USBL 询问与应答 usbl_tutorial
海流配置 ocean_current_plugin
近岸与地理坐标场景 posim_Santorini
声纳 posim_multibeam_sonar 及名称含 sonar 的海洋场景
操作任务 posim_bimanual_example、posim_plug_and_socket、posim_electrical_mating

声纳场景需要相应的声纳运行环境。引用 Fuel 资源的模型可能需要在首次运行时下载。

SDF 文件

打开文件可查看系统、模型、原点、光源和相机配置。

世界 SDF
camera_tutorial
dvl_world
new_dvl
ocean_current_plugin
posim_Santorini
posim_bimanual_example
posim_electrical_mating
posim_graded_seabed
posim_integrated
posim_multibeam_sonar
posim_ocean_models
posim_ocean_waves
posim_ocean_waves_mossy_ground
posim_ocean_waves_sonar
posim_ocean_waves_sonar_integrated
posim_ocean_waves_transient_current
posim_plug_and_socket
shallow_surface
shallow_underwater
usbl_tutorial

组合新场景

将适合的 SDF 复制到 models/posim_worlds/worlds,为文件和世界分别设置新名称。使用能够解析到已安装资源的 URI。重新编译并加载工作空间,然后用新文件名启动。另见高度图地形和物体模型。

等待 Fuel 下载完成

posim_integrated 和 posim_ocean_models 使用远程模型。等待首次下载完成,加载过程中不要反复启动仿真。设置 verbose:=true 可查看资源加载信息。

在同一环境的另一个终端中查询已加载的场景:

# posim_integrated.world uses the internal name posim_integrated.
gz service -s /world/posim_integrated/scene/info \
  --reqtype gz.msgs.Empty --reptype gz.msgs.Scene --timeout 5000 --req ''
# For posim_ocean_models.world, use /world/posim_ocean_model/scene/info.

确认返回结果包含预期模型,仿真时钟持续推进,传感器正常输出测量值。如果下载停滞,请查看加载信息,并检查运行 Gazebo 的计算机或容器的网络连接。

查看启动参数

ros2 launch posim_demos posim_sensor.launch.py --show-args
参数 用途 传感器启动文件的默认值
namespace 已安装模型的目录 空,需明确指定
world_name 世界场景文件 empty.sdf
paused 以暂停状态启动 true
gui / headless 显示 / 隐藏 Gazebo 界面 true / false
use_sim_time ROS 节点使用仿真时钟 true
x, y, z 初始位置,m 各为 0.0
roll, pitch, yaw 初始姿态,rad 各为 0.0
debug / verbosity_level 详细日志 / 日志级别 false / 1
use_ned_frame 发布 world_ned 变换(ENU → NED) false

要让传感器产生数据,请设置 paused:=false。机器人和世界启动文件的参数,请分别用 --show-args 查询。