Mujoco 学习系列（五）Menagerie模型实战：从导入到自定义仿真场景
1. 认识Mujoco Menagerie模型仓库
如果你正在学习Mujoco仿真，那么Menagerie模型仓库绝对是个宝藏。这个由Mujoco官方维护的GitHub项目，收集了各种高质量的机器人模型，从常见的UR5e机械臂到Unitree G1人形机器人，应有尽有。我第一次发现这个仓库时，就像找到了一个装满玩具的百宝箱，每个模型都经过精心设计，可以直接拿来学习和使用。
仓库里的模型都采用Mujoco原生的XML格式，这意味着你可以直接查看和修改它们的底层参数。对于初学者来说，这比从头开始建模要友好得多。我建议你先浏览一下仓库目录，里面包含了universal_robots、agilex、unitree等知名品牌的机器人模型，每个模型文件夹里都有详细的XML文件和必要的资源。
2. 获取并准备Menagerie模型
要使用这些模型，第一步当然是克隆仓库。打开终端，执行以下命令：
git clone https://github.com/google-deepmind/mujoco_menagerie.git这个过程可能会花费一些时间，因为仓库大小约1.8GB。完成后，你会看到一个按品牌和型号组织的目录结构。这里有个小技巧：我习惯在克隆完成后，先运行tree -L 2命令快速浏览目录结构，这样能对可用模型有个整体印象。
需要注意的是，有些模型可能需要额外的依赖。比如带摄像头的机器人模型，可能需要安装相应的视觉处理库。我在第一次使用时，就遇到了缺少纹理文件的问题，后来发现需要手动下载一些资源包。
3. 基础模型导入与查看
让我们以UR5e机械臂为例，看看如何快速导入模型。在终端中导航到模型目录，然后运行：
python -m mujoco.viewer --mjcf=./universal_robots_ur5e/ur5e.xml这个命令会启动Mujoco的交互式查看器，加载UR5e模型。如果一切顺利，你应该能看到一个完整的机械臂出现在仿真环境中。我特别喜欢这个查看器的交互功能，可以用鼠标拖动来旋转视角，观察机器人的各个细节。
对于Unitree G1人形机器人，导入方式类似：
python -m mujoco.viewer --mjcf=./unitree_g1/g1_with_hands.xml不过这里有个常见问题：很多初学者第一次运行时，会发现机器人直接"掉出"了视野范围。这是因为原始模型没有设置地面，我们接下来会解决这个问题。
4. 自定义仿真场景基础
要让仿真场景更完整，通常需要添加一些基础元素。最基本的当然是地面，否则所有物体都会无限下坠。打开模型XML文件，找到<worldbody>标签，在里面添加：
<geom name="ground" type="box" size="2 2 0.1" pos="0 0 -0.1"/>这个代码片段创建了一个长宽各2米、厚0.1米的盒子作为地面，放置在Z轴-0.1米处。我建议把这个尺寸设置得比机器人活动范围稍大一些，避免边缘效应。
除了地面，你可能还想添加一些环境元素。比如在机械臂工作场景中，可以添加一个工作台：
<geom name="table" type="box" size="0.5 0.5 0.4" pos="0 0.8 0.2" rgba="0.8 0.8 0.8 1"/>5. 解决模型导入的常见问题
在实际使用中，有几个常见问题需要注意。首先是单位问题，Mujoco默认使用米-千克-秒(MKS)单位制，但有些模型可能使用了其他单位。如果发现物理表现不正常，比如物体移动速度过快或过慢，可能需要检查质量、惯量等参数。
其次是碰撞检测问题。有时候模型部件会意外穿透，这是因为碰撞几何体(geom)没有正确设置。我常用的解决方法是：
- 在XML中找到相关geom标签
- 确保设置了正确的type和size参数
- 必要时添加
<contact>标签定义碰撞关系
还有一个常见问题是纹理丢失。如果模型使用了外部纹理文件，确保这些文件位于正确路径。我习惯把纹理文件放在模型同级目录下的textures文件夹中。
6. 高级场景定制技巧
当你熟悉了基础操作后，可以尝试更高级的场景定制。比如给UR5e机械臂添加一个末端执行器：
<body name="gripper" pos="0 0 0.1" parent="wrist_3_link"> <geom type="box" size="0.03 0.03 0.05" pos="0 0 0.025" rgba="0.5 0.5 0.5 1"/> </body>这段代码在机械臂末端添加了一个简单的夹爪。在实际项目中，你可能需要更复杂的设计，但这个例子展示了如何扩展现有模型。
另一个实用技巧是使用<include>标签模块化你的场景。比如可以把常用的环境元素（如墙壁、灯光）保存为单独的XML文件，然后在主文件中引用：
<include file="common_environment.xml"/>7. 调试与优化仿真场景
创建好场景后，调试是必不可少的环节。我常用的调试方法包括：
使用
<option>标签调整仿真参数，比如：<option timestep="0.002" iterations="50"/>较小的timestep能提高精度，但会增加计算量。
开启可视化调试信息：
python -m mujoco.viewer --mjcf=your_scene.xml --visualize="contact"这会显示碰撞接触点，帮助诊断物理问题。
使用Mujoco的日志功能记录仿真数据，后期分析问题原因。
记得在修改参数后，要逐步测试效果。我经常犯的错误是一次改太多参数，结果不知道是哪个改动导致了问题。
8. 实战案例：构建完整工作场景
让我们把这些知识综合起来，构建一个完整的机械臂工作场景。假设我们要创建一个UR5e抓取小物件的仿真：
- 首先导入UR5e基础模型
- 添加地面和工作台
- 在工作台上放置几个小立方体作为抓取目标
- 调整相机位置以获得更好的视角
- 设置适当的照明
完整的XML结构大致如下：
<mujoco> <option timestep="0.002"/> <worldbody> <!-- 地面 --> <geom name="ground" type="box" size="2 2 0.1" pos="0 0 -0.1"/> <!-- 工作台 --> <geom name="table" type="box" size="0.6 0.6 0.4" pos="0 0.8 0.2"/> <!-- 目标物体 --> <body name="object1" pos="0.1 0.8 0.5"> <geom type="box" size="0.03 0.03 0.03" rgba="1 0 0 1"/> </body> <!-- 导入UR5e --> <include file="./universal_robots_ur5e/ur5e.xml"/> </worldbody> </mujoco>这个场景虽然简单，但包含了所有必要元素。在实际项目中，你可能还需要添加更复杂的物体和交互逻辑。