Skip to main content

robopal: A Novel Simulation Framework based Mujoco

Project description

License GitHub Repo stars Language Documentation PyPI - Version DOI

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-baselines3MARL)
  • 提供多种基础控制方案,如关节空间/笛卡尔空间的位置控制、速度控制、阻抗控制,并提供了遥操作接口
  • 提供丰富的任务环境示例,如 ConveyorBelt,PickAndPlace, Drawer, Cabinet,VisualServo等
  • 模块化定制 MJCF 描述的机器人场景模型,可自由组合搭配场景,基座,机械臂,末端执行器和物体

请查看文档以获取更多信息 (更新中)


Getting Started

Preparation

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

robopal-0.4.1.tar.gz (10.8 MB view details)

Uploaded Source

Built Distribution

robopal-0.4.1-py3-none-any.whl (10.9 MB view details)

Uploaded Python 3

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

Hashes for robopal-0.4.1.tar.gz
Algorithm Hash digest
SHA256 2db94d25443682eb82c795dc75dede767604c3dded6af856e13bcc00cc6ad837
MD5 9410b78e847d7bb24fc190bcf67f25e5
BLAKE2b-256 39594b3caadc3aabc55ae047ba95df8e727b8a92fde2dfa306d9d9c766352194

See more details on using hashes here.

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

Hashes for robopal-0.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 82f5a198fe610aa846bbf64fe8f2f68bf1591c140f0af469634e1bdd0c777893
MD5 f41e9b26be4a3bd4342a21506cfeac62
BLAKE2b-256 247a01e6e219c00916b627a8fb5d6d711641b7413ea6371ef2e7f2a695b6ab6c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page