Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
85 changes: 70 additions & 15 deletions src/humanoid_loco_mujoco/README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# _LocoMuJoCo_
# LocoMuJoCo的介绍
LocoMuJoCo 是一款专为全身控制而设计的模仿学习基准。
它具有多种环境,包括四足动物、类人生物和(肌肉)骨骼人体模型, 每个都提供了全面的数据集(每个人形机器人超过 22,000 个样本)。

Expand All @@ -7,7 +7,7 @@ LocoMuJoCo 是一款专为全身控制而设计的模仿学习基准。
支持多种生物形态的运动开发,包括四足动物(如狗)、两足动物(如人类)以及肌肉骨骼驱动的人体模型。
内置真实世界数据(如动作捕捉数据、地面实测数据),算法可直接基于这些数据学习 “如何像生物一样行走、奔跑”。

# _主要优势_
## 主要优势
- 支持 MuJoCo(单一环境)和 MJX(并行环境)
- 包括 12 个人形环境和 4 个四足环境,具有 4 个生物力学人体模型
- 干净的单文件 JAX 算法,用于快速基准测试(PPO、GAIL、AMP、DeepMimic)
Expand All @@ -19,14 +19,16 @@ LocoMuJoCo 是一款专为全身控制而设计的模仿学习基准。
- 接口中 内置域和地形随机化
- 模块化设计:定义、交换和重用组件,如观察类型、奖励函数、终端状态处理程序和域随机化文档

# _安装_
# 安装说明

## 安装

安装 MuJoCo 并设置环境变量。
```
cd loco-mujoco
pip install -e .
```
# _依赖_
## 依赖

- numpy<2.0
- scipy>=1.14.0
Expand All @@ -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 # 强化学习算法

```
├── 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官方参考文档
23 changes: 23 additions & 0 deletions src/humanoid_loco_mujoco/ros2/package.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
<?xml version="1.0"?>
<?xml-model href="http://download.ros.org/schema/package_format3.xsd" schematypens="http://www.w3.org/2001/XMLSchema"?>
<package format="3">
<name>mujoco_ros2</name>
<version>0.0.0</version>
<description>TODO: Package description</description>
<maintainer email="heyh@todo.todo">heyh</maintainer>
<license>TODO: License declaration</license>

<depend>rclpy</depend>
<depend>std_msg</depend>
<depend>my_interfaces</depend>

<test_depend>ament_copyright</test_depend>
<test_depend>ament_flake8</test_depend>
<test_depend>ament_pep257</test_depend>
<test_depend>ament_xmllint</test_depend>
<test_depend>python3-pytest</test_depend>

<export>
<build_type>ament_python</build_type>
</export>
</package>
4 changes: 4 additions & 0 deletions src/humanoid_loco_mujoco/ros2/setup.cfg
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
[develop]
script_dir=$base/lib/mujoco_ros2
[install]
install_scripts=$base/lib/mujoco_ros2
27 changes: 27 additions & 0 deletions src/humanoid_loco_mujoco/ros2/setup.py
Original file line number Diff line number Diff line change
@@ -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',
],
},
)
Loading