3、AGV小车模型导入：支持格式（URDF、USD等）、导入流程、模型层级结构解析与常见问题

在Isaac Sim中进行AGV（自动导引车）仿真调试，第一步也是最关键的一步，是将AGV的物理与视觉模型正确导入仿真环境。模型导入的质量直接决定了后续的传感器仿真、运动学解算、物理碰撞检测以及感知算法验证的准确性。本章将系统讲解Isaac Sim支持的模型格式、标准导入流程、模型层级结构的解析方法，以及在实际操作中高频出现的导入问题与解决方案。

3.1 支持格式与选型原则

核心原理：Isaac Sim基于NVIDIA Omniverse平台，其原生3D格式为USD（Universal Scene Description）。USD是一种可扩展、可协作的场景描述语言，能够将几何、材质、物理属性、动画、语义标签等整合在一个层级化场景图中。对于AGV仿真，USD是最推荐的格式，因为它能完整保留物理属性（质量、惯性、碰撞形状）、关节约束（转动副、移动副）以及传感器配置。

URDF（Unified Robot Description Format）是ROS生态中广泛使用的机器人描述格式，它使用XML描述机器人的运动学树、视觉网格、碰撞网格和关节属性。Isaac Sim提供了URDF导入器，能够将URDF转换为USD，但转换过程中存在信息丢失或映射不完整的风险。此外，OBJ、STL、FBX等纯几何格式仅包含视觉网格，需要手动添加物理属性和关节定义。

3.2 标准导入流程（以URDF为例）

操作流程：Isaac Sim提供了两种URDF导入方式：通过菜单栏的 File → Import → URDF，或使用Python脚本调用 omni.isaac.urdf 扩展。推荐使用菜单方式，因为其内置了可视化预览和参数调整界面。

# 菜单导入步骤
1. 准备URDF文件及其引用的网格文件（.dae/.stl/.obj），确保路径相对或正确。
2. 打开Isaac Sim，选择 File → Import → URDF。
3. 在弹出窗口中点击“...”选择URDF文件路径。
4. 设置导入参数：
   - 固定底盘（Fix Base Link）：勾选后底盘将固定在世界原点，适合静态测试。
   - 距离缩放（Distance Scale）：默认1.0，若URDF使用毫米单位，需设为0.001。
   - 关节驱动模式（Joint Drive Mode）：选择“Velocity”或“Position”，AGV通常使用速度控制。
5. 点击“Import”，等待转换完成。
6. 导入后，在Stage面板中检查生成的USD层级。

对于USD格式，导入更为直接：File → Import → USD，选择文件后即可加载。但需要注意，USD文件可能引用外部纹理或子层（sublayer），需确保所有依赖文件在同一目录或已设置Omniverse Nucleus服务器路径。

3.3 模型层级结构解析

核心原理：USD场景采用Prim（Primitive）树状结构组织。每个Prim是一个节点，可以包含子Prim，并携带属性（Attribute）和关系（Relationship）。对于AGV模型，典型的层级结构如下：

/World
  /AGV_Root (Xform)
    /Chassis (RigidBody, CollisionShape)
      /VisualMesh (Mesh)
      /CollisionMesh (Mesh)
    /Front_Left_Wheel (RigidBody, Joint)
      /Wheel_Visual (Mesh)
      /Wheel_Collision (Cylinder)
    /Front_Right_Wheel (RigidBody, Joint)
    /Rear_Left_Wheel (RigidBody, Joint)
    /Rear_Right_Wheel (RigidBody, Joint)
    /LiDAR (Xform, LidarSensor)
    /IMU (Xform, ImuSensor)
    /Camera (Xform, CameraSensor)

理解层级结构的关键在于区分视觉、物理和传感器三类Prim。视觉Prim仅包含Mesh和材质；物理Prim需要添加 RigidBodyAPI 和 CollisionAPI；传感器Prim则挂载对应的Sensor API。关节（Joint）通过 PhysicsJointAPI 连接两个刚体Prim，并定义运动轴和限制。

3.4 常见问题与排障策略

问题1：模型导入后显示为紫色或透明。原因通常是材质纹理路径失效。USD引用纹理时使用路径或相对路径，若文件移动位置，则纹理丢失。解决方法：在Omniverse中打开“Asset Store”面板，检查缺失资产，重新指定纹理路径；或使用 usdzip 工具将纹理打包进USDZ文件。

问题2：AGV在仿真中沉入地面或弹跳。这通常是因为碰撞体未正确生成，或物理引擎的接触偏移（contactOffset）设置过小。检查碰撞Prim是否添加了CollisionAPI，并确认碰撞网格的尺寸与视觉网格一致。若使用凸包碰撞，需确保凸包计算正确。

问题3：关节运动方向相反或无法转动。URDF中的关节轴定义在关节坐标系下，而USD的PhysicsJointAPI使用父级坐标系。导入后需检查关节的 axis 属性，必要时在USD中手动调整旋转方向。另外，驱动模式（Drive Mode）设置错误也会导致关节无法响应控制指令。

from pxr import UsdPhysics, Usd
stage = Usd.Stage.Open("/path/to/agv.usd")
for prim in stage.Traverse():
    if prim.GetName().startswith("wheel_joint"):
        joint_api = UsdPhysics.Joint(prim)
        joint_api.GetTypeAttr().Set("revolute")
        joint_api.GetAxisAttr().Set("Y")
stage.Save()

问题4：传感器数据异常（如LiDAR点云偏移）。这通常是传感器Prim的坐标未正确对齐。在URDF中，传感器坐标系定义在连杆末端；导入USD后，需确认传感器Prim是否位于正确位置，并检查其旋转方向是否与仿真世界坐标系一致。建议在导入后使用“Move Tool”手动调整传感器位置，并通过仿真验证点云是否与场景几何对齐。

3.5 导入后的验证与优化

验证流程：模型导入后，必须进行系统性验证，而非直接开始算法开发。验证步骤包括：

1. 视觉检查：在Viewport中旋转视角，确认模型外观完整、材质正确。
2. 物理检查：点击Play按钮，观察AGV是否因重力自然下落并稳定在地面；手动拖动AGV，检查碰撞响应是否合理。
3. 关节检查：通过Debug Visualizer显示关节轴，确认每个关节的旋转方向符合预期。
4. 传感器检查：添加一个简单的LiDAR可视化，确认点云数据与场景几何匹配。

性能优化：对于复杂AGV模型，建议在导入后执行以下优化：

• 使用 Mesh Simplify 工具降低视觉网格面数（不影响物理计算）。
• 将碰撞网格替换为基本几何体（Box/Cylinder/Sphere），减少物理引擎计算量。
• 合理设置 RigidBodyAPI 的 linearDamping 和 angularDamping，避免仿真中不必要的振荡。
• 如果AGV包含多个相同零件（如4个轮子），使用USD的 Instanceable 属性，让GPU实例化渲染，大幅提升帧率。