# 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/3d/68/cf2aaac217fbce74ba39d81aebaa11970a51ca4fbb55e3e3a074674b0fdd/gymnasium_planar_robotics-1.0.1.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.1",
"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": "b406dbe376993b8dc0ec1d78c19811e3b49f518674ffe450a5ad7da0ec15dc5c",
"md5": "c6275b58149176f1fa6a485105879505",
"sha256": "02b2fd431ff0a89b8b22ee2ad4a45d3b817069b3310b6574456198ff0cbd6ada"
},
"downloads": -1,
"filename": "gymnasium_planar_robotics-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c6275b58149176f1fa6a485105879505",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 70405,
"upload_time": "2024-05-27T22:31:36",
"upload_time_iso_8601": "2024-05-27T22:31:36.931537Z",
"url": "https://files.pythonhosted.org/packages/b4/06/dbe376993b8dc0ec1d78c19811e3b49f518674ffe450a5ad7da0ec15dc5c/gymnasium_planar_robotics-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3d68cf2aaac217fbce74ba39d81aebaa11970a51ca4fbb55e3e3a074674b0fdd",
"md5": "5d790057c1116cfa17a0982b9fd11a14",
"sha256": "23866d8f128e8cfac75d8af19ffb88c6cf64d417e896e7dae81852d2bf96d19f"
},
"downloads": -1,
"filename": "gymnasium_planar_robotics-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "5d790057c1116cfa17a0982b9fd11a14",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 71073,
"upload_time": "2024-05-27T22:31:38",
"upload_time_iso_8601": "2024-05-27T22:31:38.801334Z",
"url": "https://files.pythonhosted.org/packages/3d/68/cf2aaac217fbce74ba39d81aebaa11970a51ca4fbb55e3e3a074674b0fdd/gymnasium_planar_robotics-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-27 22:31:38",
"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"
}