robopal: A Novel Simulation Framework based Mujoco
Project description
robopal is a multi-platform, modular robot simulation framework based on MuJoCo physics engine, which is mainly used for reinforcement learning training and control algorithm implementation of robotic arms. Please check the Documentation for more information.
robopal 是一个基于 MuJoCo 物理引擎搭建的多平台的,模块化的机器人仿真框架,主要用于机械臂的强化学习训练与控制算法实施。
robopal 为您提供了:
- 采用 Mujoco 原生 API 计算机械臂动力学与运动学,无需额外安装扩展库,提高运行帧数
- 简洁的代码结构,没有复杂的嵌套关系,方便快速上手学习和使用
- 具备 Gymnasium 风格的单臂环境与 PettingZoo 风格的双臂环境,方便集成大部分的单/多智能体强化学习算法库(eg. stable-baselines3,MARL)
- 提供多种基础控制方案,如关节空间/笛卡尔空间的位置控制、速度控制、阻抗控制,并提供了遥操作接口
- 提供丰富的任务环境示例,如 ConveyorBelt,PickAndPlace, Drawer, Cabinet,VisualServo等
- 模块化定制 MJCF 描述的机器人场景模型,可自由组合搭配场景,基座,机械臂,末端执行器和物体
请查看文档以获取更多信息 (更新中)
Getting Started
Preparation
- Windows / Linux
- MuJoCo-3.1.5
- Python 3.8 +
Install from pip
You are advised to Install from source to obtain the latest version
$ pip install robopal
Install from source
# Clone robopal
$ git clone https://github.com/NoneJou072/robopal
$ cd robopal
# Install robopal and its requirements.
$ pip install -r requirements.txt
Run a demo
python -m robopal.demos.demo_controllers
Contribute
robopal currently has many shortcomings. Welcome to raise questions or leave suggestions in Issue, and also welcome to Pull Request to improve this project together.
Citation
Please cite robopal if you find useful in this work:
@software{Zhou_robopal_A_Simulation_2024,
author = {Zhou, Haoran and Huang, Yichao and Zhao, Yuhan and Lu, Yang},
doi = {10.5281/zenodo.11078757},
month = apr,
title = {{robopal: A Simulation Framework based Mujoco}},
url = {https://github.com/NoneJou072/robopal},
version = {0.3.1},
year = {2024}
}
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file robopal-0.4.1.tar.gz
.
File metadata
- Download URL: robopal-0.4.1.tar.gz
- Upload date:
- Size: 10.8 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2db94d25443682eb82c795dc75dede767604c3dded6af856e13bcc00cc6ad837 |
|
MD5 | 9410b78e847d7bb24fc190bcf67f25e5 |
|
BLAKE2b-256 | 39594b3caadc3aabc55ae047ba95df8e727b8a92fde2dfa306d9d9c766352194 |
File details
Details for the file robopal-0.4.1-py3-none-any.whl
.
File metadata
- Download URL: robopal-0.4.1-py3-none-any.whl
- Upload date:
- Size: 10.9 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 82f5a198fe610aa846bbf64fe8f2f68bf1591c140f0af469634e1bdd0c777893 |
|
MD5 | f41e9b26be4a3bd4342a21506cfeac62 |
|
BLAKE2b-256 | 247a01e6e219c00916b627a8fb5d6d711641b7413ea6371ef2e7f2a695b6ab6c |