robopal

robopal: a multi-platform, modular robot simulation framework based on MuJoCo, mainly used for reinforcement learning and control algorithm implementation of robotic arms.

https://github.com/nonejou072/robopal

Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 4 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (15.4%) to scientific vocabulary
Last synced: 6 months ago · JSON representation ·

Repository

robopal: a multi-platform, modular robot simulation framework based on MuJoCo, mainly used for reinforcement learning and control algorithm implementation of robotic arms.

Basic Info
Statistics
  • Stars: 255
  • Watchers: 2
  • Forks: 18
  • Open Issues: 4
  • Releases: 2
Created over 2 years ago · Last pushed 9 months ago
Metadata Files
Readme License Citation

README.md

![License](https://img.shields.io/badge/license-Apache2.0-yellow?style=flat-square) ![GitHub Repo stars](https://img.shields.io/github/stars/NoneJou072/robopal?style=flat-square&logo=github) ![Language](https://img.shields.io/badge/language-python-brightgreen?style=flat-square) [![Documentation](https://img.shields.io/badge/documentation-yes-brightgreen?style=flat-square)](https://robopal.readthedocs.io/zh/latest/index.html) ![PyPI - Version](https://img.shields.io/pypi/v/robopal?style=flat-square) [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.11078757.svg)](https://doi.org/10.5281/zenodo.11078757)

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

commandline $ pip install robopal

Install from source

python # Clone robopal $ git clone https://github.com/NoneJou072/robopal $ cd robopal # Install robopal and its requirements. $ pip install -r requirements.txt

Run a demo

bash 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: bibtex @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} }

Owner

  • Name: Round Dolphiiin
  • Login: NoneJou072
  • Kind: user
  • Location: Shanghai
  • Company: USST

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
- family-names: "Zhou"
  given-names: "Haoran"
  orcid: "https://orcid.org/0009-0000-1824-1994"
- family-names: "Huang"
  given-names: "Yichao"
  orcid: "https://orcid.org/0000-0000-0000-0000"
- family-names: "Zhao"
  given-names: "Yuhan"
  orcid: "https://orcid.org/0000-0000-0000-0000"
- family-names: "Lu"
  given-names: "Yang"
  orcid: "https://orcid.org/0000-0000-0000-0000"
title: "robopal: A Simulation Framework based Mujoco"
version: 0.3.1
doi: 10.5281/zenodo.11078757
date-released: 2024-04-28
url: "https://github.com/NoneJou072/robopal"

GitHub Events

Total
  • Issues event: 3
  • Watch event: 104
  • Push event: 7
  • Fork event: 4
Last Year
  • Issues event: 3
  • Watch event: 104
  • Push event: 7
  • Fork event: 4

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 59 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 0
  • Total versions: 6
  • Total maintainers: 1
pypi.org: robopal

robopal: A Novel Simulation Framework based Mujoco

  • Versions: 6
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 59 Last month
Rankings
Dependent packages count: 7.4%
Stargazers count: 28.0%
Forks count: 30.0%
Average: 33.7%
Dependent repos count: 69.2%
Maintainers (1)
Last synced: 6 months ago

Dependencies

Dockerfile docker
  • python 3.10 build
requirements-extra.txt pypi
  • gymnasium *
  • opencv-contrib-python *
  • opencv-python *
  • ruckig *
requirements.txt pypi
setup.py pypi
  • mujoco ==2.3.7
  • numpy >=1.25.0
  • ruckig *