A toolkit for developing OpenAI Gym environments simulated with Ignition Gazebo.
Project description
gym-ignition
Description
gym-ignition is a framework to create reproducible robotics environments for reinforcement learning research.
It is based on the ScenarIO project which provides the low-level APIs to interface with the Ignition Gazebo simulator.
By default, RL environments share a lot of boilerplate code, e.g. for initializing the simulator or structuring the classes
to expose the gym.Env
interface.
Gym-ignition provides the Task
and Runtime
abstractions that help you focusing on the development of the decision-making logic rather than engineering.
It includes randomizers to simplify the implementation of domain randomization
of models, physics, and tasks.
Gym-ignition also provides powerful dynamics algorithms compatible with both fixed-base and floating-based robots by
exploiting robotology/idyntree and exposing
high-level functionalities.
Gym-ignition does not provide out-of-the-box environments ready to be used.
Rather, its aim is simplifying and streamlining their development.
Nonetheless, for illustrative purpose, it includes canonical examples in the
gym_ignition_environments
package.
Visit the website for more information about the project.
Installation
- First, follow the installation instructions of ScenarIO.
pip install gym-ignition
, preferably in a virtual environment.
Contributing
You can visit our community forum hosted in GitHub Discussions. Even without coding skills, replying user's questions is a great way of contributing. If you use gym-ignition in your application and want to show it off, visit the Show and tell section! You can advertise there your environments created with gym-ignition.
Pull requests are welcome.
For major changes, please open a discussion first to propose what you would like to change.
Citation
@INPROCEEDINGS{ferigo2020gymignition,
title={Gym-Ignition: Reproducible Robotic Simulations for Reinforcement Learning},
author={D. {Ferigo} and S. {Traversaro} and G. {Metta} and D. {Pucci}},
booktitle={2020 IEEE/SICE International Symposium on System Integration (SII)},
year={2020},
pages={885-890},
doi={10.1109/SII46433.2020.9025951}
}
License
LGPL v2.1 or any later version.
Disclaimer: Gym-ignition is an independent project and is not related by any means to OpenAI and Open Robotics.
Project details
Release history Release notifications | RSS feed
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
Hashes for gym_ignition-1.2.3.dev161.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8d3b491d58b24f50052c61df52db21ad0b7205c3cd1fdeafabedaa8a15e2893c |
|
MD5 | bf027ea6713348e13167725527618dc4 |
|
BLAKE2b-256 | 3b9fd9de07b4f06903f551f34b1f0544666e5d0bb7a3af8d11fafefc5c055b38 |
Hashes for gym_ignition-1.2.3.dev161-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7c3641be1b6989cc17e02ed23d64e62d06d1d4408c491843d66f0e5b9693f488 |
|
MD5 | 9fbcc1b82f6b48c5a8c14d2dd0d3f25e |
|
BLAKE2b-256 | 1da0c78ebfd7937aeb6a49728009b1d57fe615e5fc50b0adec20e9728eedc5b1 |