# Gymnasium-Planar-Robotics (GymPR)
This library contains reinforcement learning environments for motion planning and object manipulation in the field of planar robotics. The environments follow either the [Gymnasium](https://gymnasium.farama.org/) API for single-agent RL or the [PettingZoo parallel API](https://pettingzoo.farama.org/api/parallel/) for multi-agent RL. All environments are based on the [MuJoCo](https://mujoco.org/) physics engine. Note that this library depends on the latest MuJoCo Python bindings.
[mujoco-py](https://github.com/openai/mujoco-py) is not supported.
<img src="https://github.com/ubi-coro/gymnasium-planar-robotics/raw/main/docs/images/visual_abstract.png" />
## Installation
The Gymnasium-Planar-Robotics package can be installed via PIP:
```
pip install gymnasium-planar-robotics
```
To install optional dependencies, to build the documentation, or to run the tests, use:
```
pip install gymnasium-planar-robotics[docs, tests]
```
**Note:** Depending on your shell (e.g. when using Zsh), you may need to use additional quotation marks:
```
pip install "gymnasium-planar-robotics[docs, tests]"
```
## Documentation
The documentation is available at: [https://ubi-coro.github.io/gymnasium-planar-robotics/](https://ubi-coro.github.io/gymnasium-planar-robotics/)
## License
GymPR is published under the GNU General Public License v3.0.
## Example
The following example shows how to use a trained policy with an example environment that follows the Gymnasium API:
```python
import gymnasium as gym
env = gym.make("BenchmarkPushingEnv-v0", render_mode="human")
observation, info = env.reset(seed=42)
for _ in range(0,100):
while not terminated and not truncated:
action = policy(observation) # custom policy
observation, reward, terminated, truncated, info = env.step(action)
observation, info = env.reset()
env.close()
```
## Maintainer
Gymnasium-Planar-Robotics is currently maintained by Lara Bergmann (@lbergmann1).
Raw data
{
"_id": null,
"home_page": null,
"name": "gymnasium-planar-robotics",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "Reinforcement Learning, Gymnasium, RL, AI, Robotics, Planar Robotics, Magnetic Levitation",
"author": null,
"author_email": "Lara Bergmann <lara.bergmann@uni-bielefeld.de>",
"download_url": "https://files.pythonhosted.org/packages/15/b2/f342ecefb3478bd860e9449a64965b17fd0aa701c7804681be3ffbfe6378/gymnasium_planar_robotics-1.0.2.tar.gz",
"platform": null,
"description": "# Gymnasium-Planar-Robotics (GymPR)\nThis library contains reinforcement learning environments for motion planning and object manipulation in the field of planar robotics. The environments follow either the [Gymnasium](https://gymnasium.farama.org/) API for single-agent RL or the [PettingZoo parallel API](https://pettingzoo.farama.org/api/parallel/) for multi-agent RL. All environments are based on the [MuJoCo](https://mujoco.org/) physics engine. Note that this library depends on the latest MuJoCo Python bindings. \n[mujoco-py](https://github.com/openai/mujoco-py) is not supported.\n\n<img src=\"https://github.com/ubi-coro/gymnasium-planar-robotics/raw/main/docs/images/visual_abstract.png\" />\n\n## Installation\nThe Gymnasium-Planar-Robotics package can be installed via PIP:\n```\npip install gymnasium-planar-robotics\n```\nTo install optional dependencies, to build the documentation, or to run the tests, use:\n```\npip install gymnasium-planar-robotics[docs, tests]\n```\n**Note:** Depending on your shell (e.g. when using Zsh), you may need to use additional quotation marks: \n```\npip install \"gymnasium-planar-robotics[docs, tests]\"\n```\n\n## Documentation\nThe documentation is available at: [https://ubi-coro.github.io/gymnasium-planar-robotics/](https://ubi-coro.github.io/gymnasium-planar-robotics/)\n\n## License\nGymPR is published under the GNU General Public License v3.0.\n\n## Example\nThe following example shows how to use a trained policy with an example environment that follows the Gymnasium API:\n\n```python\nimport gymnasium as gym\n\nenv = gym.make(\"BenchmarkPushingEnv-v0\", render_mode=\"human\")\nobservation, info = env.reset(seed=42)\n\nfor _ in range(0,100):\n while not terminated and not truncated:\n action = policy(observation) # custom policy\n observation, reward, terminated, truncated, info = env.step(action)\n\n observation, info = env.reset()\nenv.close()\n```\n\n## Maintainer\nGymnasium-Planar-Robotics is currently maintained by Lara Bergmann (@lbergmann1).\n",
"bugtrack_url": null,
"license": null,
"summary": "A library for reinforcement learning environments in the field of planar robotics",
"version": "1.0.2",
"project_urls": {
"Documentation": "https://ubi-coro.github.io/gymnasium-planar-robotics/",
"Homepage": "https://www.uni-bielefeld.de/fakultaeten/technische-fakultaet/arbeitsgruppen/kollaborative-robotik/",
"Repository": "https://github.com/ubi-coro/gymnasium-planar-robotics"
},
"split_keywords": [
"reinforcement learning",
" gymnasium",
" rl",
" ai",
" robotics",
" planar robotics",
" magnetic levitation"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3fc6d4cae505c2afc83347f7a74a37ebbd62b36924027414fe10a9100634b8da",
"md5": "5f5851c8b12208208324be964f1679af",
"sha256": "45906adf386783b1bba4e79d901a6e37770050b3c1f9399eba3c62d1fb06ed6a"
},
"downloads": -1,
"filename": "gymnasium_planar_robotics-1.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5f5851c8b12208208324be964f1679af",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 70426,
"upload_time": "2024-07-30T12:20:30",
"upload_time_iso_8601": "2024-07-30T12:20:30.933560Z",
"url": "https://files.pythonhosted.org/packages/3f/c6/d4cae505c2afc83347f7a74a37ebbd62b36924027414fe10a9100634b8da/gymnasium_planar_robotics-1.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "15b2f342ecefb3478bd860e9449a64965b17fd0aa701c7804681be3ffbfe6378",
"md5": "44930744f3d537af64ff904c39ea7997",
"sha256": "961d2c7d7a7bd14a40f038d403b546aa8ca65046d5db5990369dfcd38c93fb7d"
},
"downloads": -1,
"filename": "gymnasium_planar_robotics-1.0.2.tar.gz",
"has_sig": false,
"md5_digest": "44930744f3d537af64ff904c39ea7997",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 71607,
"upload_time": "2024-07-30T12:20:32",
"upload_time_iso_8601": "2024-07-30T12:20:32.855568Z",
"url": "https://files.pythonhosted.org/packages/15/b2/f342ecefb3478bd860e9449a64965b17fd0aa701c7804681be3ffbfe6378/gymnasium_planar_robotics-1.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-30 12:20:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ubi-coro",
"github_project": "gymnasium-planar-robotics",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "gymnasium-planar-robotics"
}
JSON
