M3Bench
收藏资源简介:
M3Bench数据集包含30k个移动操作机器人的联合轨迹,覆盖119个场景。数据集的组织结构包括机器人URDF模型、场景URDF资产、拾取任务和放置任务的相关文件。每个任务实例包含规划请求配置、运动规划器输出、任务配置文件和完成任务的关节轨迹及任务语言描述。
The M3Bench dataset contains 30k joint trajectories of mobile manipulation robots, spanning 119 distinct scenarios. Its organizational structure includes robot URDF models, URDF assets for scenarios, and relevant files for pick-and-place tasks. Each task instance comprises planning request configurations, motion planner outputs, task configuration files, joint trajectories for completed tasks, and natural language descriptions of the respective tasks.
M3Bench数据集概述
1. 数据集基本信息
- 名称: M3Bench
- 用途: 用于移动操作器在3D场景中的全身运动生成基准测试
- 数据量: 30k条联合轨迹
- 场景数量: 119个
- 发布年份: 2025
- 相关论文: IEEE Robotics and Automation Letters (RA-L)
- 下载地址: https://huggingface.co/datasets/M3Bench/M3Bench
2. 数据集结构
robot_urdf/: 包含机器人的URDF模型scene_urdf/<physcene_xxx>/: 包含场景的URDF资产,physcene_xxx为场景IDpick/<physcene_xxx>/<object_linkname>/: 包含场景中特定物体的拾取任务数据<timestamp>/<instance-id>/: 包含任务实例的具体文件vkc_request.json: 运动规划器的规划请求配置pick_vkc_return.json: 运动规划器的输出config.json: 任务配置文件(目标物体链接名称、初始位姿、机器人初始位置)<trajectory>/pick_vkc_caption_trajectory.json: 完成任务实例的关节轨迹和任务语言描述
place/: 结构与pick/类似,用于放置任务
3. 评估协议
3.1 评估阶段
- PyBullet评估:
- 评估物理约束遵守情况(碰撞率、关节违规、轨迹平滑度)
- Isaac Sim评估:
- 评估任务成功率(拾取/放置是否成功)
3.2 环境设置
PyBullet环境
-
安装命令: bash cd evaluation/ bash setup.sh cd ../
-
需修改
yourdfpy源代码
Isaac Sim环境
- 安装命令: bash cd tongverse/ bash setup.sh cd ../
3.3 评估流程
准备工作
- 确保生成轨迹结构与M2Diffuser输出一致
- 更新
utils/path.py中的目录路径 - 修改
config/task/pick.yaml中的轨迹目录路径
PyBullet评估
-
添加轨迹加载代码至
evaluate_traj.py -
运行命令: bash bash scripts/evaluate.sh
-
结果存储位置:
<model-name>/results_dataset/
Isaac Sim评估
-
激活TongVerse conda环境
-
移动
evaluate/tv_evaluate至tongverse/目录 -
运行命令: bash python evaluate_pick.py --result_dir /your_ws_path/m3bench/results/pick/${timestamp} --dataset_test_dir /your_data_path/pick/test
-
处理聚合结果: bash python eval_all_result_pick_dataset.py --result_dir ../../results_dataset/pick/${timestamp} --dataset_test_dir /your_data_path/pick/test




