mirror of
https://github.com/Farama-Foundation/Gymnasium.git
synced 2025-08-30 09:55:39 +00:00
94 lines
4.0 KiB
Markdown
94 lines
4.0 KiB
Markdown
![]() |
---
|
||
|
title: Enduro
|
||
|
---
|
||
|
# Enduro
|
||
|
|
||
|
```{figure} ../../_static/videos/atari/enduro.gif
|
||
|
:width: 120px
|
||
|
:name: Enduro
|
||
|
```
|
||
|
|
||
|
This environment is part of the <a href='..'>Atari environments</a>. Please read that page first for general information.
|
||
|
|
||
|
| | |
|
||
|
|---|---|
|
||
|
| Action Space | Discrete(18) |
|
||
|
| Observation Space | (250, 160, 3) |
|
||
|
| Observation High | 255 |
|
||
|
| Observation Low | 0 |
|
||
|
| Import | `gymnasium.make("ALE/Enduro-v5")` |
|
||
|
|
||
|
### Description
|
||
|
You are a racer in the National Enduro, a long-distance endurance race. You must overtake a certain
|
||
|
amount of cars each day to stay on the race. The first day you need to pass 200 cars, and 300 for
|
||
|
each following day. The game ends if you do not meet your overtake quota for the day.
|
||
|
|
||
|
Detailed documentation can be found on [the AtariAge page](https://atariage.com/manual_html_page.php?SoftwareLabelID=163).
|
||
|
|
||
|
### Actions
|
||
|
By default, all actions that can be performed on an Atari 2600 are available in this environment.
|
||
|
However, if you use v0 or v4 or specify `full_action_space=False` during initialization, only a reduced
|
||
|
number of actions (those that are meaningful in this game) are available. The reduced action space may depend
|
||
|
on the flavor of the environment (the combination of `mode` and `difficulty`). The reduced action space for the default
|
||
|
flavor looks like this:
|
||
|
|
||
|
| Num | Action |
|
||
|
|-----|------------------------|
|
||
|
| 0 | NOOP |
|
||
|
| 1 | UP |
|
||
|
| 2 | RIGHT |
|
||
|
| 3 | LEFT |
|
||
|
| 4 | DOWN |
|
||
|
| 5 | UPRIGHT |
|
||
|
| 6 | UPLEFT |
|
||
|
| 7 | DOWNRIGHT |
|
||
|
| 8 | DOWNLEFT |
|
||
|
|
||
|
### Observations
|
||
|
By default, the environment returns the RGB image that is displayed to human players as an observation. However, it is
|
||
|
possible to observe
|
||
|
- The 128 Bytes of RAM of the console
|
||
|
- A grayscale image
|
||
|
|
||
|
instead. The respective observation spaces are
|
||
|
- `Box([0 ... 0], [255 ... 255], (128,), uint8)`
|
||
|
- `Box([[0 ... 0]
|
||
|
...
|
||
|
[0 ... 0]], [[255 ... 255]
|
||
|
...
|
||
|
[255 ... 255]], (250, 160), uint8)
|
||
|
`
|
||
|
|
||
|
respectively. The general article on Atari environments outlines different ways to instantiate corresponding environments
|
||
|
via `gymnasium.make`.
|
||
|
|
||
|
### Rewards
|
||
|
You get 1 point for each vehicle you overtake.
|
||
|
|
||
|
### Arguments
|
||
|
|
||
|
```
|
||
|
env = gymnasium.make("ALE/Enduro-v5")
|
||
|
```
|
||
|
|
||
|
The various ways to configure the environment are described in detail in the article on Atari environments.
|
||
|
It is possible to specify various flavors of the environment via the keyword arguments `difficulty` and `mode`.
|
||
|
A flavor is a combination of a game mode and a difficulty setting.
|
||
|
|
||
|
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|
||
|
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
|
||
|
| Enduro | `[0]` | `[0]` | `0` |
|
||
|
|
||
|
You may use the suffix "-ram" to switch to the RAM observation space. In v0 and v4, the suffixes "Deterministic" and "Noframeskip"
|
||
|
are available. These are no longer supported in v5. In order to obtain equivalent behavior, pass keyword arguments to `gymnasium.make` as outlined in
|
||
|
the general article on Atari environments.
|
||
|
The versions v0 and v4 are not contained in the "ALE" namespace. I.e. they are instantiated via `gymnasium.make("Enduro-v0")`.
|
||
|
|
||
|
### Version History
|
||
|
A thorough discussion of the intricate differences between the versions and configurations can be found in the
|
||
|
general article on Atari environments.
|
||
|
|
||
|
* v5: Stickiness was added back and stochastic frameskipping was removed. The entire action space is used by default. The environments are now in the "ALE" namespace.
|
||
|
* v4: Stickiness of actions was removed
|
||
|
* v0: Initial versions release (1.0.0)
|