算子的机器人描述文件:自定义评测流程
输入说明:评测配置文件以及机器人描述文件,支持自定义评测
从界面上选择的机器人描述文件夹需包含:
├── 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 | Link 名称 | 说明 |
|---|---|
| base_link | 机器人整体基座坐标系。 |
| left_arm_base_link | 左臂运动链起点。 |
| right_arm_base_link | 右臂运动链起点。 |
| left_tool_link | 左臂末端工具坐标,代表左手在任务空间中的位置。 |
| right_tool_link | 右臂末端工具坐标。 |
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 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:
...
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数组中的位置是第一个。