diff --git a/src/humanoid_loco_mujoco/README.md b/src/humanoid_loco_mujoco/README.md index 05ed6f7876..31d23c566e 100644 --- a/src/humanoid_loco_mujoco/README.md +++ b/src/humanoid_loco_mujoco/README.md @@ -1,4 +1,4 @@ -# _LocoMuJoCo_ +# LocoMuJoCo的介绍 LocoMuJoCo 是一款专为全身控制而设计的模仿学习基准。 它具有多种环境,包括四足动物、类人生物和(肌肉)骨骼人体模型, 每个都提供了全面的数据集(每个人形机器人超过 22,000 个样本)。 @@ -7,7 +7,7 @@ LocoMuJoCo 是一款专为全身控制而设计的模仿学习基准。 支持多种生物形态的运动开发,包括四足动物(如狗)、两足动物(如人类)以及肌肉骨骼驱动的人体模型。 内置真实世界数据(如动作捕捉数据、地面实测数据),算法可直接基于这些数据学习 “如何像生物一样行走、奔跑”。 -# _主要优势_ +## 主要优势 - 支持 MuJoCo(单一环境)和 MJX(并行环境) - 包括 12 个人形环境和 4 个四足环境,具有 4 个生物力学人体模型 - 干净的单文件 JAX 算法,用于快速基准测试(PPO、GAIL、AMP、DeepMimic) @@ -19,14 +19,16 @@ LocoMuJoCo 是一款专为全身控制而设计的模仿学习基准。 - 接口中 内置域和地形随机化 - 模块化设计:定义、交换和重用组件,如观察类型、奖励函数、终端状态处理程序和域随机化文档 -# _安装_ +# 安装说明 + +## 安装 安装 MuJoCo 并设置环境变量。 ``` cd loco-mujoco pip install -e . ``` -# _依赖_ +## 依赖 - numpy<2.0 - scipy>=1.14.0 @@ -36,24 +38,77 @@ pip install -e . - flax - gymnasium -# _模型地址_ +## 数据安装说明 + +### 1.模型地址 https://github.com/robfiras/loco-mujoco/tree/master/loco_mujoco/models/unitree_h1 -# _数据集百度网盘地址_ +### 2.数据集百度网盘地址 链接: https://pan.baidu.com/s/1Viqlg9VYZBuKgj7TiVo-Tw 提取码: 68aa 下载好的数据集放在当前文件夹下 -# _文件说明_ +# 文件使用说明 +## 文件结构 ``` locomujoco -├── ros2 #ros2接口 -│ ├── mujoco_ros2_sim # 使用mujoco进行的强化学习训练 -│ └── robot_controller # 控制节点 -├── main # 使用locomujoco的简单示例 -├── mujoco #使用mujoco的简单实例 -├── robot_RL # 强化学习算法 - -``` \ No newline at end of file +├── ros2 # ros2接口 +│ ├── launch # launch文件# 使用mujoco进行的强化学习训练 +│ ├── mujoco_ros2_cpp # c++_ros2封装 +│ | ├── mujoco_ros2_sim.cpp # mujoco与ros2的通信 +│ | └─── robot_control.cpp # 控制节点 +| └── mujoco_ros2_py # py_ros2封装 +│ ├── mujoco_ros2_sim.py # mujoco与ros2的通信 +│ └─── robot_control.py # 控制节点 +├── main.py # 使用locomujoco的简单示例 +├── mujoco.py #使用mujoco的简单实例 +├── robot_RL.py # 强化学习算法 + +``` + +## 文件使用 + +### 1.运行locomujoco的简单示例 + +``` +python main.py +``` +### 2.运行mujoco简单示例 + +``` +python mujoco.py +``` +### 3.运行强化学习行走 + +``` +python robot_RL.py +``` + +## MuJoCo ROS2 文件使用说明 + +### 1.创建功能包 + +``` +cd ros2/src +ros2 pkg create mujoco_ros2 --build-type ament_python --dependencies rclpy my_interfaces +``` + +### 2.运行mujoco_ros2_sim节点 + +``` +ros2 run mujoco_ros2 mujoco_ros2_sim +``` + +### 3.运行robot_control节点 + +``` +ros2 run mujoco_ros2 robot_control +``` + +# 项目参考 + +- [MuJoCo](https://github.com/deepmind/mujoco) - 高性能物理引擎 +- [ROS 2](https://github.com/ros2) - 机器人操作系统 +- [LocoMuJoCo](https://loco-mujoco.readthedocs.io) - locomujoco官方参考文档 \ No newline at end of file diff --git a/src/humanoid_loco_mujoco/ros2/package.xml b/src/humanoid_loco_mujoco/ros2/package.xml new file mode 100644 index 0000000000..007dc76183 --- /dev/null +++ b/src/humanoid_loco_mujoco/ros2/package.xml @@ -0,0 +1,23 @@ + + + + mujoco_ros2 + 0.0.0 + TODO: Package description + heyh + TODO: License declaration + + rclpy + std_msg + my_interfaces + + ament_copyright + ament_flake8 + ament_pep257 + ament_xmllint + python3-pytest + + + ament_python + + diff --git a/src/humanoid_loco_mujoco/ros2/setup.cfg b/src/humanoid_loco_mujoco/ros2/setup.cfg new file mode 100644 index 0000000000..a0703142ca --- /dev/null +++ b/src/humanoid_loco_mujoco/ros2/setup.cfg @@ -0,0 +1,4 @@ +[develop] +script_dir=$base/lib/mujoco_ros2 +[install] +install_scripts=$base/lib/mujoco_ros2 diff --git a/src/humanoid_loco_mujoco/ros2/setup.py b/src/humanoid_loco_mujoco/ros2/setup.py new file mode 100644 index 0000000000..b4c5817d8f --- /dev/null +++ b/src/humanoid_loco_mujoco/ros2/setup.py @@ -0,0 +1,27 @@ +from setuptools import find_packages, setup + +package_name = 'mujoco_ros2' + +setup( + name=package_name, + version='0.0.0', + packages=find_packages(exclude=['test']), + data_files=[ + ('share/ament_index/resource_index/packages', + ['resource/' + package_name]), + ('share/' + package_name, ['package.xml']), + ], + install_requires=['setuptools'], + zip_safe=True, + maintainer='heyh', + maintainer_email='heyh@todo.todo', + description='TODO: Package description', + license='TODO: License declaration', + tests_require=['pytest'], + entry_points={ + 'console_scripts': [ + 'mujoco_ros2_sim=mujoco_ros2.mujoco_ros2_sim:main', + 'robot_controller=mujoco_ros2.robot_controller:main', + ], + }, +)