........
从哪里下手呢?......从这里吧:

URDF 的作用

URDF(Unified Robot Description Format)是 ROS 中描述机器人结构的 XML 格式。
来个例子吧,unitree_go2的四足机器狗。
该 URDF 提供五类关键信息:

  • link: 机器人刚体,例如机身、髋关节、大腿、小腿、脚、IMU 和雷达。
  • joint: 刚体之间的连接关系、旋转轴、关节类型和运动限制。
  • visual: RViz 和 Gazebo Sim 显示模型时使用的 DAE 网格。
  • collision: 物理引擎用于碰撞检测的几何体。
  • inertial: 质量、质心和惯量矩阵,决定动力学仿真的响应。

go2_description 包中的静态 URDF 含有 30 个 link、29 个 joint,其中 12 个是腿部可动关节。该描述包只提供机器人结构和资源,不直接写入Gazebo 控制插件。

概况

  • URDF 路径:src/base/go2_description/urdf/go2_description.urdf
  • 机器人名称:go2_description
  • 链接数量:30 个 link
  • 关节数量:29 个 joint
  • 关节类型:12 个 revolute,17 个 fixed
  • 几何类型:17 个 mesh,17 个 cylinder,5 个 box,5 个 sphere
  • URDF 中声明的总质量约为 15.019 kg

URDF 默认使用的单位:

  • 长度:米(m)
  • 质量:千克(kg)
  • 角度:弧度(rad)
  • 转动惯量:kg·m^2
  • 力矩限制:N·m
  • 角速度限制:rad/s
    可以使用如下命令检查urdf的语法树:check_urdf src/base/go2_description/urdf/go2_description.urdf

URDF 标签和参数含义

1. robot

<robot name="go2_description">

robot 是 URDF 根标签,name 是机器人模型名称。该名称会被解析工具、RViz 和部分仿真工具用于标识当前机器人模型。

2. link

<link name="base">

link 表示一个刚体坐标系和刚体部件。一个 link 可以包含:

  • inertial:质量、质心、转动惯量,用于动力学仿真。
  • visual:显示模型,用于 RViz 或 Gazebo 视觉渲染。
  • collision:碰撞模型,用于物理接触、碰撞检测和距离计算。

物理意义上,link 是运动学树中的刚体节点。它本身的位置由父关节和关节状态决定。

3. joint

<joint name="FL_hip_joint" type="revolute">

joint 表示两个 link 之间的约束关系。该文件中使用了两类关节:

  • fixed:固定关节,父子链接之间没有相对运动。
  • revolute:旋转关节,子链接绕指定轴在角度范围内旋转。

关节中的关键子标签:

  • parent link="...":父链接。
  • child link="...":子链接。
  • origin xyz="..." rpy="...":子链接关节坐标系相对父链接坐标系的位置和姿态。
  • axis xyz="...":旋转轴方向,表达在关节坐标系中。
  • limit lower="..." upper="..." effort="..." velocity="...":关节角度、力矩和速度限制。

在 robot_state_publisher 中,关节定义决定 TF 树的父子关系。对于revolute 关节,还需要joint_state_publisher 或控制器发布关节角度,才能得到动态姿态。

4. origin

origin 是 URDF 中最常见也最容易混淆的标签。它在不同父标签下含义不同:

所在位置含义
joint/origin子链接关节坐标系相对父链接坐标系的位姿
inertial/origin质心坐标系相对当前链接坐标系的位姿
visual/origin视觉几何相对当前链接坐标系的位姿
collision/origin碰撞几何相对当前链接坐标系的位姿

实际作用分别是:

  • joint/origin 决定运动链尺寸、关节安装点和 TF 关系。
  • inertial/origin 决定质量分布和动力学响应。
  • visual/origin 决定 RViz/Gazebo 中模型显示位置。
  • collision/origin 决定碰撞检测和接触点位置。

xyz 表示平移,顺序为 X、Y、Z。rpy 表示 roll、pitch、yaw,顺序为绕 X、Y、Z 轴的旋转。

例如:

<origin xyz="0.1934 0.0465 0" rpy="0 0 0" />

在 FL_hip_joint 中表示左前髋关节安装在机身坐标系的 X=0.1934 m、Y=0.0465 m 处。

5. inertial

<inertial>
  <origin xyz="0.021112 0 -0.005366" rpy="0 0 0" />
  <mass value="6.921" />
  <inertia ixx="0.02448" ixy="0.00012166" ixz="0.0014849"
           iyy="0.098077" iyz="-3.12E-05" izz="0.107" />
</inertial>

inertial 描述链接的质量属性。它主要影响 Gazebo 等物理引擎中的动力学仿真,对 RViz 纯显示通常没有直接影响。

5.1 mass

mass value 是该刚体质量,单位 kg。质量越大,在同样外力或关节力矩下加速度越小。

5.2 origin

inertial/origin 的 xyz 是质心相对链接坐标系的位置。比如 base 的质心为:

<origin xyz="0.021112 0 -0.005366" rpy="0 0 0" />

这表示机身质心相对 base 链接坐标系向 X 正方向偏移 0.021112 m,向 Z 负方向偏移 0.005366 m。质心位置会影响平衡、翻倒趋势和惯性响应。

5.3 inertia

inertia 是关于 inertial/origin 所定义惯性坐标系的 3x3 转动惯量矩阵:

[ ixx  ixy  ixz ]
[ ixy  iyy  iyz ]
[ ixz  iyz  izz ]

物理意义:

  • ixx、iyy、izz:绕 X、Y、Z 轴旋转的转动惯量。
  • ixy、ixz、iyz:惯性积,表示质量分布相对坐标轴不完全对称时的耦合项。

转动惯量越大,刚体越难绕对应轴产生角加速度。对于四足机器人,错误的质量或惯量会直接影响站立稳定性、摆腿响应、碰撞后的姿态变化和控制器调参。

6. visual

<visual>
  <origin xyz="0 0 0" rpy="0 0 0" />
  <geometry>
    <mesh filename="package://go2_description/dae/base.dae" />
  </geometry>
  <material name="">
    <color rgba="1 1 1 1" />
  </material>
</visual>

visual 是显示模型。它决定机器人在 RViz 或 Gazebo 中看起来是什么样,但不参与碰撞检测。

本文件中,机身、髋部、大腿、小腿和脚部都使用 dae 网格作为视觉几何,例如:

  • base.dae
  • hip.dae
  • thigh.dae / thigh_mirror.dae
  • calf.dae / calf_mirror.dae
  • foot.dae

visual/origin 决定显示网格如何放置到当前 link 坐标系下。大多数链接为xyz="0 0 0"、rpy="0 0 0",说明网格坐标系已经和链接坐标系对齐。部分髋部通过 rpy 旋转复用同一个网格文件以表达左右、前后镜像关系。

7. material 和 color

<color rgba="1 1 1 1" />

rgba 分别表示红、绿、蓝、透明度,范围通常为 0 到 1。该文件基本使用白色不透明材质。如果 mesh 文件自身包含材质,实际显示效果还可能受 mesh内部材质影响。

8. collision

<collision>
  <origin rpy="0 0 0" xyz="0 0 0" />
  <geometry>
    <box size="0.3762 0.0935 0.114" />
  </geometry>
</collision>

collision 是碰撞模型。它影响:

  • Gazebo 等物理引擎中的接触检测。
  • 脚底与地面的碰撞和接触点生成。
  • MoveIt 或其他规划工具中的碰撞检查。
  • 仿真性能和接触稳定性。

该 URDF 没有直接使用复杂 mesh 做碰撞,而是用 box、cylinder、sphere 近似。这样通常比高精度三角网格更快、更稳定,也更适合腿足机器人接触仿真。

9. geometry

geometry 描述 visual 或 collision 的具体形状。本文件使用四类几何。

9.1 mesh

<mesh filename="package://go2_description/dae/base.dae" />

mesh 加载外部网格文件。package://go2_description/... 表示从 ROS2 包go2_description 的安装路径下查找资源。mesh 主要用于高质量视觉显示。

实际作用:

  • 让 RViz/Gazebo 显示接近真实 Go2 外观。
  • 对运动学和动力学没有直接影响。
  • 如果 mesh 路径错误,通常表现为模型不显示或只显示坐标/碰撞简化体。

9.2 box

<box size="0.3762 0.0935 0.114" />

box size 是长方体在局部 X、Y、Z 方向的尺寸,单位 m。

本文件中:

  • base 碰撞体用 box 近似机身。
  • *_thigh 碰撞体用 box 近似大腿段。

实际作用是以低成本方式描述较规则的机身和腿段碰撞边界。

9.3. cylinder

<cylinder length="0.12" radius="0.013" />

URDF 中圆柱默认沿局部 Z 轴延伸:

  • length:圆柱轴向长度,单位 m。
  • radius:圆柱半径,单位 m。

如果要让圆柱沿其他方向放置,需要通过 collision/origin rpy 旋转。例如髋部碰撞体:

<origin rpy="1.5707963267948966 0 0" xyz="0 0.08 0" />
<cylinder length="0.04" radius="0.046" />

这里 rpy 将圆柱从默认 Z 轴方向旋转到髋部需要的方向,xyz 将碰撞体偏移到髋部外侧。

本文件中,cylinder 用于:

  • Head_upper:头部上半部分。
  • *_hip:髋部侧向圆柱碰撞体。
  • *_calf:小腿杆状碰撞体。
  • *_calflower、*_calflower1:小腿末端附加碰撞段。

9.4 sphere

<sphere radius="0.022" />

sphere radius 是球半径,单位 m。

本文件中:

  • Head_lower 使用球体近似头部下半部分。
  • 四个 *_foot 使用球体近似脚端接触区域。

脚端使用球体有实际仿真意义:球体接触稳定、方向无关,能减少脚底边角导致的接触跳变。

Go2模型结构

根坐标与机身

  • base_footprint 是根链接,只作为地面投影或导航参考坐标系使用。
  • base_footprint_joint 是固定关节,将 base_footprint 连接到 base。
  • base 是机身主体,四条腿、头部、IMU 和雷达都挂在 base 下。

base_footprint 没有惯性、可视化和碰撞几何,因此它不是物理实体,只提供坐标树根节点。
base_footprint_joint 未显式写 origin,等价于 xyz="0 0 0"、rpy="0 0 0"。

附加结构

  • Head_upper、Head_lower:头部碰撞结构,分别使用圆柱和球体近似。
  • imu:IMU 坐标链接,固定在 base 上。
  • radar:雷达坐标链接,固定在 base 上,存在俯仰旋转 rpy="0 2.8782 0"。

imu 和 radar 的质量与惯量均为 0,也没有视觉或碰撞几何。它们在该 URDF 中主要作为传感器坐标系,而不是参与物理碰撞或动力学计算的实体。

可视模型与碰撞模型的区别

宇树的|Go2 URDF 明确区分了 visual 和 collision:

  • visual 使用 DAE mesh,负责外观精细度。
  • collision 使用 box、cylinder、sphere,负责物理接触。

两者可以不一致。对于仿真,这是常见设计:

  • 精细 mesh 看起来真实,但三角面多,碰撞计算慢且容易不稳定。
  • 简化几何不够真实,但接触计算稳定,适合实时仿真和控制验证。

例如,base 的视觉模型是 base.dae,碰撞模型却是一个尺寸为0.3762 0.0935 0.114 的长方体。这表示显示时看到的是完整机身外形,物理引擎计算碰撞时只使用简化机身盒。

惯性参数的实际影响

惯性参数对以下行为有直接影响:

  • 机器人站立时的重心位置。
  • 跌倒、碰撞、跳跃等动态响应。
  • 关节控制器所需力矩。
  • 地面接触时的姿态变化。
  • Gazebo 中仿真是否稳定。

如果 mass、origin 或 inertia 不合理,可能出现:

  • 机器人异常漂浮或下沉。
  • 关节控制力矩不足或过强。
  • 模型一启动就翻倒。
  • 接触时抖动明显。
  • 物理引擎报惯量矩阵非法或质量非法。

本文件中 *_calflower 和 *_calflower1 没有惯性参数,说明它们更像碰撞
辅助链接。因为它们通过固定关节连接到 *_calf,使用时应关注目标仿真器
是否会对无惯性碰撞链接给出警告。

结论

该 URDF 以 base_footprint -> base 为根部结构,向外展开四条腿、头部和
传感器坐标系。visual 部分使用 DAE 网格保证外观,collision 部分使用
简化几何保证接触稳定和计算效率,inertial 部分提供质量与转动惯量供
动力学仿真使用。理解 origin 在不同上下文中的含义,是正确分析该模型
运动学、碰撞和动力学行为的关键。


SimpleTriangle
128 声望116 粉丝

只会写 Hello World 的厨子


« 上一篇
网格拟合