Files
Gymnasium/docs/environments/mujoco.md

42 lines
2.3 KiB
Markdown
Raw Normal View History

2022-09-13 20:27:34 +01:00
---
firstpage:
lastpage:
---
# MuJoCo
2022-09-13 20:27:34 +01:00
```{toctree}
:hidden:
mujoco/ant
mujoco/half_cheetah
mujoco/hopper
mujoco/humanoid_standup
mujoco/humanoid
mujoco/inverted_double_pendulum
mujoco/inverted_pendulum
mujoco/reacher
mujoco/swimmer
mujoco/pusher
mujoco/walker2d
2022-09-13 20:27:34 +01:00
```
```{raw} html
2022-10-03 19:01:14 +01:00
:file: mujoco/list.html
2022-09-13 20:27:34 +01:00
```
2022-10-10 17:23:40 +02:00
MuJoCo stands for Multi-Joint dynamics with Contact. It is a physics engine for facilitating research and development in robotics, biomechanics, graphics and animation, and other areas where fast and accurate simulation is needed.
2022-09-13 20:27:34 +01:00
The unique dependencies for this set of environments can be installed via:
````bash
pip install gymnasium[mujoco]
````
2022-10-10 17:23:40 +02:00
These environments also require that the MuJoCo engine be installed. As of October 2021 DeepMind has acquired MuJoCo and is open-sourcing it in 2022, making it free for everyone. Instructions on installing the MuJoCo engine can be found on their [website](https://mujoco.org)](https://mujoco.org) and [GitHub repository](https://github.com/deepmind/mujoco). Using MuJoCo with Gymnasium also requires that the framework `mujoco-py` be installed, which can be found in the [GitHub](https://github.com/openai/mujoco-py/tree/master/mujoco_py) repository](https://github.com/openai/mujoco-py/tree/master/mujoco_py) (this dependency is installed with the above command).
2022-09-13 20:27:34 +01:00
2022-10-10 17:23:40 +02:00
There are ten Mujoco environments: Ant, HalfCheetah, Hopper, Humanoid, HumanoidStandup, IvertedDoublePendulum, InvertedPendulum, Reacher, Swimmer, and Walker. All of these environments are stochastic in terms of their initial state, with a Gaussian noise added to a fixed initial state in order to add stochasticity. The state spaces for MuJoCo environments in Gymnasium consist of two parts that are flattened and concatenated together: a position of a body part ('*mujoco-py.mjsim.qpos*') or joint and its corresponding velocity ('*mujoco-py.mjsim.qvel*'). Often, some of the first positional elements are omitted from the state space since the reward is calculated based on their values, leaving it up to the algorithm to infer those hidden values indirectly.
2022-09-13 20:27:34 +01:00
Among Gymnasium environments, this set of environments can be considered as more difficult ones to solve by a policy.
Environments can be configured by changing the XML files or by tweaking the parameters of their classes.