MyoSuite is a collection of musculoskeletal environments and tasks simulated with the MuJoCo physics engine and wrapped in the OpenAI gym API to enable the application of Machine Learning to bio-mechanic control problems.
Full task details | Baselines | Documentation | Tutorials
Below is an overview of the tasks in the MyoSuite.
Getting Started
You will need Python 3.8 or later versions.
It is recommended to use Miniconda and to create a separate environment with:
conda create --name myosuite python=3.8
conda activate myosuite
It is possible to install MyoSuite with:
pip install -U myosuite
for advanced installation, see here.
Test your installation using the following command (this will return also a list of all the current environments):
python -m myosuite.tests.test_myo
You can also visualize the environments with random controls using the command below:
python -m myosuite.utils.examine_env --env_name myoElbowPose1D6MRandom-v0
NOTE: On MacOS, we moved to mujoco native launch_passive which requires that the Python script be run under mjpython:
mjpython -m myosuite.utils.examine_env --env_name myoElbowPose1D6MRandom-v0
Examples
It is possible to create and interface with MyoSuite environments just like any other OpenAI gym environments. For example, to use the myoElbowPose1D6MRandom-v0 environment, it is possible simply to run:
import myosuite
import gym
env = gym.make('myoElbowPose1D6MRandom-v0')
env.reset()
for _ in range(1000):
env.mj_render()
env.step(env.action_space.sample()) # take a random action
env.close()
You can find tutorials on how to load MyoSuite models/tasks, train them, and visualize their outcome. Also, you can find baselines to test some pre-trained policies.
License
MyoSuite is licensed under the Apache License.
Citation
If you find this repository useful in your research, please consider giving a star ⭐ and cite our arXiv paper by using the following BibTeX entrys.
@Misc{MyoSuite2022,
author = {Vittorio, Caggiano AND Huawei, Wang AND Guillaume, Durandau AND Massimo, Sartori AND Vikash, Kumar},
title = {MyoSuite -- A contact-rich simulation suite for musculoskeletal motor control},
publisher = {arXiv},
year = {2022},
howpublished = {\url{https://github.com/myohub/myosuite}},
year = {2022}
doi = {10.48550/ARXIV.2205.13600},
url = {https://arxiv.org/abs/2205.13600},
}
1 maintainer
Release files for MyoSuite 2.1.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| MyoSuite-2.1.5.tar.gz | 83.2 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| MyoSuite-2.1.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 167.0 MB
Release files / MyoSuite-2.1.5.tar.gz
| Download URL | MyoSuite-2.1.5.tar.gz |
|---|---|
| Size | 83.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5e0081e0be29ec818d5d3336b1717fc34397cc169c0d9bcfce12c38bd8b79c24
|
|
BLAKE2b-256 checksum How to use checksums |
14eb5d85783cc7593bf45e3ca050c60cf328373c36b38a226a5197299e88d4b8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.9.18
|
Release files / MyoSuite-2.1.5-py3-none-any.whl
| Download URL | MyoSuite-2.1.5-py3-none-any.whl |
|---|---|
| Size | 83.9 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
23e614d34402d1306439e32e280f79ad799e8baacc802d71a5a910c932917c7f
|
|
BLAKE2b-256 checksum How to use checksums |
e08b9e99d00c1356cde46346822b9f18d5bef8467062e63878ad393b7a8e1a0e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.9.18
|
