📚 课程目录第4章 Gazebo基础操作

4. Gazebo基础操作

在PX4仿真中，Gazebo不仅是“把飞机放进去飞”的容器，更是决定传感器数据质量、物理真实度与仿真效率的核心环境。本节围绕世界文件、模型导入、光照与物理参数、GUI工具以及性能优化五个方面展开，帮助你从“能跑起来”进阶到“跑得准、跑得快、跑得稳”。

一、世界文件：仿真的舞台脚本

Gazebo世界文件（.world）本质是一个SDF格式的XML文档，它定义了仿真中所有静态与动态对象的初始状态。一个典型的世界文件包含：<world>根节点、<include>引入的模型、<light>光照、<physics>物理引擎参数、<scene>环境背景以及<gui>界面配置。PX4的默认世界文件位于Tools/sitl_gazebo/worlds/目录下，例如empty.world、iris.world、warehouse.world等。

编辑世界文件时，推荐使用gz sdf -p命令校验语法，避免因标签闭合错误导致Gazebo启动失败。常见操作包括：添加地面纹理、插入障碍物、调整重力方向、设置初始相机视角等。

<world name="default">
  <include>
    <uri>model://sun</uri>
  </include>
  <include>
    <uri>model://ground_plane</uri>
  </include>
  <physics type="ode">
    <max_step_size>0.004</max_step_size>
    <real_time_update_rate>250</real_time_update_rate>
    <gravity>0 0 -9.8</gravity>
  </physics>
</world>

二、模型导入：从静态物体到传感器挂载

Gazebo模型分为两类：环境模型（如建筑、树木、车辆）和机器人模型（如PX4的iris、typhoon H480）。环境模型可通过Insert面板直接拖入，也可在world文件中用<include>引用model://路径。机器人模型则通常以.sdf或.urdf描述，并通过gzserver加载。

在PX4仿真中，模型导入的关键是传感器挂载。例如，为iris添加一个下视相机，需要在模型SDF中增加<sensor type="camera">标签，并配置<pose>、<update_rate>、<camera>内参。若使用MAVROS或mavlink转发，还需确保gazebo_ros_camera插件正确加载。

模型导入后，建议用gz model -m <model_name> -i查看模型信息，确认位姿、关节与传感器是否按预期解析。

三、光照与物理参数：真实感与稳定性的平衡

光照直接影响视觉传感器的成像质量。Gazebo支持directional、point、spot三种光源。在<light>标签中，<cast_shadows>控制阴影，<diffuse>与<specular>决定颜色与高光。若做视觉SLAM或光流仿真，建议开启阴影并设置合理的环境光，避免过曝或全黑。

物理参数集中在<physics>标签：max_step_size是仿真步长，real_time_update_rate是实时更新率，二者乘积决定仿真速度。步长过大易导致接触不稳定，过小则计算量激增。通常PX4 SITL推荐max_step_size=0.004、real_time_update_rate=250，即每步4ms、每秒250步。

参数	典型值	作用	调整建议
max_step_size	0.004 s	物理积分步长	越小越稳，但CPU负载越高
real_time_update_rate	250 Hz	每秒仿真步数	与步长乘积≈1时接近实时
gravity	0 0 -9.8	重力加速度	可模拟月球/火星重力
ode solver	quick	求解器类型	复杂接触场景可换world

四、GUI工具：高效调试的入口

Gazebo的GUI左侧面板包含World、Insert、Layers、Models等标签。常用操作包括：

平移/旋转/缩放：鼠标左键旋转视角，中键平移，滚轮缩放；
选择与移动模型：点击模型后按T进入平移模式，按R旋转；
查看传感器数据：通过Window → Topic Visualization订阅/camera/image_raw等话题；
记录与回放：使用gz log记录仿真状态，便于复盘。

此外，gz topic、gz model、gz physics等命令行工具可在终端直接查询和修改仿真状态，适合自动化脚本集成。

五、仿真性能优化：让SITL跑得更流畅

当仿真场景复杂或传感器数量增多时，Gazebo容易出现卡顿、实时率下降。优化思路如下：

降低视觉复杂度：关闭不必要的阴影、减少纹理分辨率、使用<scene>简化背景；
调整物理步长：在保证稳定的前提下适当增大max_step_size，如0.005~0.008；
禁用未使用传感器：在模型SDF中注释掉不用的相机、激光雷达；
使用headless模式：通过gzserver无GUI运行，配合gzclient按需连接；
限制实时更新率：将real_time_update_rate降至150~200，牺牲少量实时性换取流畅度。

性能优化不是一味降参数。若步长过大导致无人机抖动或传感器噪声异常，应优先保证物理稳定性，再考虑视觉简化。

六、案例与复盘：从“能飞”到“飞得准”

假设你要仿真一个室内光流定位场景。初始世界使用empty.world，光照为默认方向光，物理步长0.004。运行后发现光流数据噪声大、无人机漂移。复盘步骤如下：

检查光照：地面纹理过少导致光流特征不足，添加ground_plane纹理并提高环境光；
检查物理：将max_step_size降至0.002，提高积分精度；
检查传感器：确认下视相机update_rate与PX4光流模块频率匹配；
检查性能：若实时率低于0.8，关闭阴影并降低相机分辨率。

经过上述调整，光流数据趋于稳定，无人机悬停精度明显提升。这说明Gazebo基础操作不是孤立的“设置”，而是与传感器联调、控制效果紧密耦合的系统工程。

掌握以上五个模块，你就能在PX4 Gazebo仿真中自由构建场景、精准复现传感器数据，并在性能与真实度之间找到最佳平衡点。后续的传感器联调，都将建立在这些基础操作之上。