更新时间:2026-11-02 GMT+08:00
分享

算子的机器人描述文件:自定义评测流程

输入说明:评测配置文件以及机器人描述文件,支持自定义评测

从界面上选择的机器人描述文件夹需包含:

├── robot.urdf
├── robots.yaml

yaml配置文件名称必须为robots.yaml, urdf的名称非固定。

机器人描述文件(URDF)

URDF文件(如星海图的)描述机器人的运动学结构,包括所有link与joint的定义。评测工具从URDF中解析左右臂的运动链结构。

URDF 文件需包含关键Link如表1。

一份适用内置青龙(SH)robot.yml示例如下:

This site uses XSLT; that functionality is being removed from this browser very soon. When that happens, this page will likely no longer display correctly. You might be able to install a browser extension that allows you to continue viewing it. Otherwise, you should contact the maintainer of the site for further information.
# 统一机器人注册表
#
# 本文件定义所有已知机器人类型的完整配置。
# 用户可通过 ROBOT_CONFIG 环境变量指定自定义 robots.yaml,
# 系统会将用户配置与本文件深度合并(用户字段覆盖内置字段)。
#
# 每个机器人类型必须定义所有字段,即使某些评测模式不使用。
#
# 字段分层:
#   - 通用字段:robot_name, robot_type, urdf_path, base_frame
#   - 手臂定义:arms 列表(支持单臂和双臂,含 camera_link)
#   - 多样性评测字段:state_layout, chains, fk_chains, angles_in_degrees 等
#
# 注意:质量评测的 gripper 阈值可通过 robots.yaml 中的 gripper_* 字段配置,
#       未定义时使用 interface_init_cli.py 的 CLI 默认值(mm 单位)。

robots:
  # ==================== R1 双臂机器人 ====================
  r1:
    robot_name: "Galaxea R1"
    robot_type: "R1"
    urdf_path: "config/robot_urdf/galaxea_r1.urdf"
    base_frame: "base_link"

    arms:
      - name: "left_arm"
        base_link: "left_arm_base_link"
        tip_link: "left_tool_link"
        hand_parent_link: "left_tool_link"
        camera_link: "left_camera_link"
      - name: "right_arm"
        base_link: "right_arm_base_link"
        tip_link: "right_tool_link"
        hand_parent_link: "right_tool_link"
        camera_link: "right_camera_link"

    # ── 多样性评测字段 ──
    high_value_is_open: true
    vertical_axis: "z"
    desktop_axes: "xy"
    angles_in_degrees: false
    fk_chains: ["left_arm", "right_arm"]
    state_layout:
      state_size: 14
      mapping:
        left_arm_joint1: 0
        left_arm_joint2: 1
        left_arm_joint3: 2
        left_arm_joint4: 3
        left_arm_joint5: 4
        left_arm_joint6: 5
        left_gripper: 6
        right_arm_joint1: 7
        right_arm_joint2: 8
        right_arm_joint3: 9
        right_arm_joint4: 10
        right_arm_joint5: 11
        right_arm_joint6: 12
        right_gripper: 13
    chains:
      left_arm:
        joints: [left_arm_joint1, left_arm_joint2, left_arm_joint3, left_arm_joint4, left_arm_joint5, left_arm_joint6]
        end_effector: left_gripper_link
        gripper_index: 6
      right_arm:
        joints: [right_arm_joint1, right_arm_joint2, right_arm_joint3, right_arm_joint4, right_arm_joint5, right_arm_joint6]
        end_effector: right_gripper_link
        gripper_index: 13
  # ==================== SO101 单臂机器人 ====================
  so101:
    robot_name: "SO101"
    robot_type: "SO101"
    urdf_path: "config/robot_urdf/so101_new_calib.urdf"
    base_frame: "base_link"

    arms:
      - name: "arm"
        base_link: "base_link"
        tip_link: "gripper_frame_link"
        hand_parent_link: "gripper_frame_link"
        camera_link: "gripper_frame_link"

    # ── 多样性评测字段 ──
    high_value_is_open: true
    vertical_axis: "z"
    angles_in_degrees: true
    fk_chains: ["arm"]
    state_layout:
      state_size: 6
      mapping:
        shoulder_pan: 0
        shoulder_lift: 1
        elbow_flex: 2
        wrist_flex: 3
        wrist_roll: 4
        gripper: 5
    chains:
      arm:
        joints: [shoulder_pan, shoulder_lift, elbow_flex, wrist_flex, wrist_roll]
        end_effector: gripper_frame_link
        gripper_index: -1

# ==================== SH(青龙)双臂机器人 ====================
 sh:
   robot_name: "SH"
   robot_type: "SH"
   urdf_path: "config/robot_urdf/AzureLoong_v2.5_ctag.urdf"
   base_frame: "base_link"

   arms:
     - name: "left_arm"
      base_link: "base_link"
      tip_link: "Link_arm_l_07"
      hand_parent_link: "Link_arm_l_07"
      camera_link: "Link_arm_l_07"
     - name: "right_arm"
      base_link: "base_link"
      tip_link: "Link_arm_r_07"
      hand_parent_link: "Link_arm_r_07"
      camera_link: "Link_arm_r_07"

  # ── 多样性评测字段 ──
   high_value_is_open: false
   vertical_axis: "z"
   desktop_axes: "xy"
   angles_in_degrees: false
   fk_chains: ["left_arm", "right_arm"]
  # ── 离线评测字段 ──
  # 显式观测通道顺序(95 列,与数据集 observation.state 一一对应)。
  # 手臂位置列(0-13)用 URDF 链关节名(J_arm_l/r_01..07,去掉 _pos 后缀);
  # 夹爪列(42-43)含 gripper 关键字;其余列(vel/eff/head/hip/waist)保持数据集通道名。
   observation_order:
    - J_arm_l_01
    - J_arm_l_02
    - J_arm_l_03
    - J_arm_l_04
    - J_arm_l_05
    - J_arm_l_06
    - J_arm_l_07
    - J_arm_r_01
    - J_arm_r_02
    - J_arm_r_03
    - J_arm_r_04
    - J_arm_r_05
    - J_arm_r_06
    - J_arm_r_07
    - J_arm_l_01_vel
    - J_arm_l_02_vel
    - J_arm_l_03_vel
    - J_arm_l_04_vel
    - J_arm_l_05_vel
    - J_arm_l_06_vel
    - J_arm_l_07_vel
    - J_arm_r_01_vel
    - J_arm_r_02_vel
    - J_arm_r_03_vel
    - J_arm_r_04_vel
    - J_arm_r_05_vel
    - J_arm_r_06_vel
    - J_arm_r_07_vel
    - J_arm_l_01_eff
    - J_arm_l_02_eff
    - J_arm_l_03_eff
    - J_arm_l_04_eff
    - J_arm_l_05_eff
    - J_arm_l_06_eff
    - J_arm_l_07_eff
    - J_arm_r_01_eff
    - J_arm_r_02_eff
    - J_arm_r_03_eff
    - J_arm_r_04_eff
    - J_arm_r_05_eff
    - J_arm_r_06_eff
    - J_arm_r_07_eff
    - left_gripper
    - right_gripper
    - J_head_yaw_pos
    - J_head_pitch_pos
    - J_head_yaw_vel
    - J_head_pitch_vel
    - J_head_yaw_eff
    - J_head_pitch_eff
    - J_hip_l_roll_pos
    - J_hip_l_yaw_pos
    - J_hip_l_pitch_pos
    - J_knee_l_pitch_pos
    - J_ankle_l_pitch_pos
    - J_ankle_l_roll_pos
    - J_hip_r_roll_pos
    - J_hip_r_yaw_pos
    - J_hip_r_pitch_pos
    - J_knee_r_pitch_pos
    - J_ankle_r_pitch_pos
    - J_ankle_r_roll_pos
    - J_hip_l_roll_vel
    - J_hip_l_yaw_vel
    - J_hip_l_pitch_vel
    - J_knee_l_pitch_vel
    - J_ankle_l_pitch_vel
    - J_ankle_l_roll_vel
    - J_hip_r_roll_vel
    - J_hip_r_yaw_vel
    - J_hip_r_pitch_vel
    - J_knee_r_pitch_vel
    - J_ankle_r_pitch_vel
    - J_ankle_r_roll_vel
    - J_hip_l_roll_eff
    - J_hip_l_yaw_eff
    - J_hip_l_pitch_eff
    - J_knee_l_pitch_eff
    - J_ankle_l_pitch_eff
    - J_ankle_l_roll_eff
    - J_hip_r_roll_eff
    - J_hip_r_yaw_eff
    - J_hip_r_pitch_eff
    - J_knee_r_pitch_eff
    - J_ankle_r_pitch_eff
    - J_ankle_r_roll_eff
    - J_waist_pitch_pos
    - J_waist_roll_pos
    - J_waist_yaw_pos
    - J_waist_pitch_vel
    - J_waist_roll_vel
    - J_waist_yaw_vel
    - J_waist_pitch_eff
    - J_waist_roll_eff
    - J_waist_yaw_eff
  # 显式动作通道顺序(33 列,与数据集 action 一一对应)。
  # 手臂列(0-13)即 URDF 链关节名;夹爪列(14-15)为 _command 指令名;
  # 其余列(head/hip/knee/waist)保持数据集通道名。
   action_order:
    - J_arm_l_01
    - J_arm_l_02
    - J_arm_l_03
    - J_arm_l_04
    - J_arm_l_05
    - J_arm_l_06
    - J_arm_l_07
    - J_arm_r_01
    - J_arm_r_02
    - J_arm_r_03
    - J_arm_r_04
    - J_arm_r_05
    - J_arm_r_06
    - J_arm_r_07
    - left_gripper_command
    - right_gripper_command
    - J_head_yaw
    - J_head_pitch
    - J_hip_l_roll
    - J_hip_l_yaw
    - J_hip_l_pitch
    - J_knee_l_pitch
    - J_ankle_l_pitch
    - J_ankle_l_roll
    - J_hip_r_roll
    - J_hip_r_yaw
    - J_hip_r_pitch
    - J_knee_r_pitch
    - J_ankle_r_pitch
    - J_ankle_r_roll
    - J_waist_pitch
    - J_waist_roll
    - J_waist_yaw
   state_layout:
     state_size: 95
     mapping:
      J_arm_l_01: 0
      J_arm_l_02: 1
      J_arm_l_03: 2
      J_arm_l_04: 3
      J_arm_l_05: 4
      J_arm_l_06: 5
      J_arm_l_07: 6
      J_arm_r_01: 7
      J_arm_r_02: 8
      J_arm_r_03: 9
      J_arm_r_04: 10
      J_arm_r_05: 11
      J_arm_r_06: 12
      J_arm_r_07: 13
      left_gripper: 42
      right_gripper: 43
   chains:
     left_arm:
      joints: [J_arm_l_01, J_arm_l_02, J_arm_l_03, J_arm_l_04, J_arm_l_05, J_arm_l_06, J_arm_l_07]
      end_effector: Link_arm_l_07
      gripper_index: 42
     right_arm:
      joints: [J_arm_r_01, J_arm_r_02, J_arm_r_03, J_arm_r_04, J_arm_r_05, J_arm_r_06, J_arm_r_07]
      end_effector: Link_arm_r_07
      gripper_index: 43

表1 Link说明

Link 名称

说明

base_link

机器人整体基座坐标系。

left_arm_base_link

左臂运动链起点。

right_arm_base_link

右臂运动链起点。

left_tool_link

左臂末端工具坐标,代表左手在任务空间中的位置。

right_tool_link

右臂末端工具坐标。

表2 字段说明

字段

类型

必填

说明

robot_name

string

是

机器人名称,用于报告展示。

robot_type

string

是

机器人类型,目前仅支持R1。

base_frame

string

否

基座坐标系,默认base_link,作为模型元数据保存,实际FK链路不直接使用此字段。

left_arm_base_link

string

是

左臂运动链起点,代码从left_tool_link 往父节点回溯至此link,解析出左臂所有关节。

right_arm_base_link

string

是

右臂运动链起点,同理用于解析右臂链路。

left_tip_link

string

是

左臂末端工具坐标link,位于左夹爪后面,代表任务空间中的左手/末端执行器位置。

right_tip_link

string

是

右臂末端工具坐标link。

left_arm_base_link、right_arm_base_link、left_tip_link、right_tip_link的值必须与 URDF 文件中定义的 link 名称完全一致。

配置文件robots.yaml主要分为三块地方。按照上面的完整的内置配置样例来说明用户进行自定义配置的时候,需要进行自定义配置。

质量评测

如果用户涉及修改质量评测的配置文件,用户主要修改robots中机器人下的arms值。

  # ==================== SO101 单臂机器人 ====================
robots:
  ...
  so101:
    robot_name: "SO101"
    robot_type: "SO101"
    urdf_path: "config/robot_urdf/so101_new_calib.urdf"
    base_frame: "base_link"

    arms:
      - name: "arm"
        base_link: "base_link"
        tip_link: "gripper_frame_link"
        hand_parent_link: "gripper_frame_link"
        camera_link: "gripper_frame_link"
    
    observation_order:
         -shoulder_pan.pos
         -shoulder_lift.pos
         -elbow_flex.pos
         -wrist_flex.pos
         -wrist_roll.pos
         -gripper.pos

     action_order:
         -shoulder_pan.pos
         -shoulder_lift.pos
         -elbow_flex.pos
         -wrist_flex.pos
         -wrist_roll.pos
         -gripper.pos    
      
    
    

base_frame: "base_link" #这是机器人整体基座坐标系, 作为模型元数据保存;当前核心任务空间计算没有直接用它做 FK 链路起点。默认值base_link,无需修改。实际左右臂 FK 用的是下面两个 arm base link。

tip_link: "gripper_frame_link" #臂末端点。这里的tip不是“夹爪某个关节”,而是URDF里定义的工具坐标link,位于左夹爪后面,用来代表任务空间里的左手/末端执行器位置。

hand_parent_link与camera_link是预填充的配置,算子评测流程中实际不使用这俩配置进行评测。不需要修改。

observation_order显式观测通道顺序与数据集observation.state一一对应 (可选,没写依赖自动推算)

action_order显式动作,与数据集action--对应(可选,没写依赖自动推算)

多样性评测

如果用户涉及修改多样性评测,用户主要修改robots.中机器人名称下的
robots:
   ...
   r1:
    # ── 多样性评测字段 ──
    high_value_is_open: true
    vertical_axis: "z"
    desktop_axes: "xy"
    angles_in_degrees: false
    fk_chains: ["left_arm", "right_arm"]
    state_layout:
      state_size: 14
      mapping:
        left_arm_joint1: 0
        left_arm_joint2: 1
        left_arm_joint3: 2
        left_arm_joint4: 3
        left_arm_joint5: 4
        left_arm_joint6: 5
        left_gripper: 6
        right_arm_joint1: 7
        right_arm_joint2: 8
        right_arm_joint3: 9
        right_arm_joint4: 10
        right_arm_joint5: 11
        right_arm_joint6: 12
        right_gripper: 13
    chains:
      left_arm:
        joints: [left_arm_joint1, left_arm_joint2, left_arm_joint3, left_arm_joint4, left_arm_joint5, left_arm_joint6]
        end_effector: left_gripper_link
        gripper_index: 6
      right_arm:
        joints: [right_arm_joint1, right_arm_joint2, right_arm_joint3, right_arm_joint4, right_arm_joint5, right_arm_joint6]
        end_effector: right_gripper_link
        gripper_index: 13

这里按照星海图R1机器人进行字段说明。基本上分为两块配置(机器人的数据通道映射以及手臂链接)

星海图是两条手臂的人形机器人,示例中提供了完整的两条手臂的链路,如果是只想计算单臂的,可以修改fk_chain以及chains中的手臂链路。例如以下配置

robots:
   ...
   r1:
    # ── 多样性评测字段 ──
    fk_chains: ["left_arm"]
    state_layout:
      state_size: 14
      mapping:
        left_arm_joint1: 0
        left_arm_joint2: 1
        left_arm_joint3: 2
        left_arm_joint4: 3
        left_arm_joint5: 4
        left_arm_joint6: 5
        left_gripper: 6
    chains:
      left_arm:
        joints: [left_arm_joint1, left_arm_joint2, left_arm_joint3, left_arm_joint4, left_arm_joint5, left_arm_joint6]
        end_effector: left_gripper_link
        gripper_index: 6

mapping中的是URDF中关节的名称在lerobot数据集observation.state中的映射关系,上面的例子中,left_arm_joint1:0对应的是数据集observation.state数组中的位置是第一个。

相关文档