📚 课程目录第3章船舶仿真常用工具链

3. 船舶仿真常用工具链

在智能船舶ROS2仿真开发中，工具链的选择与组合方式直接决定了开发效率和后续迁移成本。本节围绕四个核心环节展开：仿真引擎的版本选择、模型描述格式的取舍、可视化调试手段，以及用launch文件把各节点组织成可复现的启动流程。理解它们之间的分工与衔接，是搭建一条稳定仿真链路的前提。

一、Gazebo与Ignition Gazebo：同一血脉的两代引擎

Gazebo Classic（常称Gazebo 11）与Ignition Gazebo（现更名为Gazebo，如Gazebo Fortress、Gazebo Harmonic）并非简单的新旧版本，而是架构上的重写。Classic依赖ROS1时代的gazebo_ros插件体系，在ROS2中通过gazebo_ros_pkgs桥接；Ignition Gazebo则从设计之初就采用分布式架构，通过ros_gz_bridge在Gazebo Transport与ROS2 DDS之间转发话题。

对船舶仿真而言，关键差异体现在三处。其一是物理引擎接口：Ignition Gazebo默认使用DART并支持更灵活的物理插件配置，对浮力、流体阻力这类需要自定义力的场景更友好；Classic的ODE默认配置在大型船舶模型上容易出现接触抖动。其二是传感器仿真：Ignition的传感器系统独立于渲染主循环，激光雷达、IMU、相机可分别配置更新频率，适合船舶多传感器融合验证。其三是资源组织：Ignition使用.sdf世界文件与ign gazebo命令，模型库通过Fuel在线获取，而Classic依赖本地~/.gazebo/models目录。

选型建议：新项目优先选择与ROS2发行版匹配的Ignition Gazebo（如Humble配Fortress、Jazzy配Harmonic）；若需复用大量既有Gazebo Classic船舶模型与插件，可暂留Classic，但应规划迁移路径。

二、URDF与SDF：描述模型的两套语言

URDF是ROS生态的机器人描述格式，以<link>和<joint>构成树状运动学结构，适合描述船舶的推进器、舵机、云台等关节部件，并可直接被robot_state_publisher和RViz消费。SDF则是Gazebo的原生格式，除运动学外还能描述世界环境、光照、物理参数、传感器插件和嵌套模型，表达能力强于URDF。

实际工程中常见的做法是“URDF为主、SDF为辅”：用URDF维护船舶本体与关节，通过<gazebo>标签内嵌Gazebo专用参数（如<plugin>、<mu1>摩擦系数），启动时由Gazebo自动转换为SDF。若需要精细控制世界环境或使用Ignition特有插件，则直接编写SDF。下面是一个船体link的URDF片段示例（参数为教学假设值）：

<link name="hull">
  <inertial>
    <mass value="1200.0"/>
    <inertia ixx="820" iyy="2400" izz="2400" ixy="0" ixz="0" iyz="0"/>
  </inertial>
  <collision>
    <geometry><box size="6.0 2.0 0.8"/></geometry>
  </collision>
  <visual>
    <geometry><mesh filename="package://ship_desc/meshes/hull.dae"/></geometry>
  </visual>
</link>

需要注意坐标系约定：URDF中link坐标系原点由建模者定义，通常取船体几何中心，x轴指向船首、y轴指向左舷、z轴向上；惯性张量必须相对该原点给出，否则仿真中会出现异常的旋转响应。这一约定应在整船模型中保持一致。

三、RViz2：不渲染物理，只呈现数据

RViz2不参与物理计算，它订阅ROS2话题并把数据画出来。船舶仿真中最常用的显示项包括：RobotModel（读取/robot_description与TF显示船体与推进器位姿）、TF（检查base_link到各传感器link的变换链是否完整）、LaserScan/PointCloud2（观察雷达点云是否被船体自身遮挡）、Image（相机画面）、Odometry与Path（航迹）。

一个典型排障场景：RViz中船体模型显示为白色且位置漂移，通常是robot_state_publisher未启动或/joint_states无数据，导致TF树断裂。此时在RViz的TF显示中会看到base_link与world之间缺少连接，应检查launch中是否遗漏了joint_state_publisher节点。另一个常见问题是Fixed Frame设置错误：若设为map而仿真只发布odom，所有显示项都会报“No transform”警告，应改为odom或world。

四、ros2 launch：把链路固化为可复现的启动流程

手动逐个开终端启动gazebo、robot_state_publisher、bridge和RViz既繁琐又易错。launch文件用Python描述启动逻辑，支持参数注入、命名空间、条件判断和事件编排。以下示例（参数为教学假设值）演示一条船舶仿真启动链：

from launch import LaunchDescription
from launch.actions import IncludeLaunchDescription, DeclareLaunchArgument
from launch.launch_description_sources import PythonLaunchDescriptionSource
from launch.substitutions import LaunchConfiguration
from launch_ros.actions import Node
from launch.conditions import IfCondition

def generate_launch_description():
    use_rviz = LaunchConfiguration('use_rviz', default='true')
    return LaunchDescription([
        DeclareLaunchArgument('use_rviz', default_value='true'),
        IncludeLaunchDescription(
            PythonLaunchDescriptionSource(
                '/opt/ros/humble/share/ros_gz_sim/launch/gz_sim.launch.py'),
            launch_arguments={'gz_args': '-r ship_world.sdf'}.items()),
        Node(package='robot_state_publisher', executable='robot_state_publisher',
             parameters=[{'robot_description': open('ship.urdf').read()}]),
        Node(package='ros_gz_bridge', executable='parameter_bridge',
             arguments=['/clock@rosgraph_msgs/msg/Clock[gz.msgs.Clock',
                        '/scan@sensor_msgs/msg/LaserScan[gz.msgs.LaserScan']),
        Node(package='rviz2', executable='rviz2',
             arguments=['-d', 'ship.rviz'], condition=IfCondition(use_rviz)),
    ])

几个实践要点：/clock桥接必须存在，否则ROS2节点使用系统时间而仿真使用仿真时间，TF会因时间戳不匹配而失效；use_sim_time参数应在所有订阅仿真数据的节点上设为true；bridge的话题映射语法ROS话题@ROS类型[gz话题中方向符号[表示Gazebo到ROS的单向传输，传感器数据用单向即可，控制指令则用]反向。启动后可用ros2 topic hz /scan确认雷达频率是否符合配置的10 Hz，用ros2 run tf2_tools view_frames生成TF树PDF检查链路完整性。

常见陷阱：在Ignition Gazebo中直接使用Classic的gazebo_ros插件会静默失效，模型加载后无任何传感器数据。应确认插件命名空间为ignition::gazebo，并通过ign topic -l先验证Gazebo侧话题是否存在，再排查bridge配置。

把上述四环串起来，一条最小可用的船舶仿真链路是：URDF描述船体与推进器 → Gazebo（Classic或Ignition）加载并计算浮力与运动 → ros_gz_bridge转发/clock、/scan、/odom → RViz2显示TF与传感器 → launch文件一键启动并注入参数。链路中任一环的坐标系、时间源或话题名不一致，都会表现为“模型不动”或“数据不显示”，因此建议在项目初期就用launch固化配置，并用话题频率与TF树两项检查作为每次改动的回归验证手段。