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
Below is an overview of the tasks in the MyoSuite. Full task details are available here, and baseline details are available here
Getting Started
You will need Python 3.7.1 or later versions. At this moment the library has been tested only on MacOs and Linux with MuJoCo v2.1.0.
It is recommended to use Miniconda and to create a separate environment with
conda create --name myosuite python=3.7.1
conda activate myosuite
It is possible to install MyoSuite with:
pip install -U myosuite
for advance installation see here.
Test your installation using (this will return also a list of all the current environments):
python myosuite/tests/test_myo.py
You can also visualize the environments with random controls using the command below:
$ python myosuite/utils/examine_env.py --env_name myoElbowPose1D6MRandom-v0
NOTE: If the visualization results in a GLFW error, this is because mujoco-py does not see some graphics drivers correctly. This can usually be fixed by explicitly loading the correct drivers before running the python script. See this page for details.
Examples
It is possible to create and interface with MyoSuite environments 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.sim.render(mode='window')
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 it 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 fast and contact-rich simulation suite for musculoskeletal motor control},
howpublished = {\url{https://github.com/facebookresearch/myosuite}},
year = {2022}
}
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file MyoSuite-1.0.1-py2.py3-none-any.whl.
File metadata
- Download URL: MyoSuite-1.0.1-py2.py3-none-any.whl
- Upload date:
- Size: 17.6 MB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.10.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.7.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
db7dd2a194059ce3fc2b189ee584bc2edc2388af3b869ea56df98d5a33219309
|
|
| MD5 |
e4712214f4896710c9c07cbffcd16bed
|
|
| BLAKE2b-256 |
b6475fa5eecd6c2150771b1ac520cf4f4f3c8736e8f96c53da574851adb96eec
|
