gaspersic/Gymnasium
1
0
Fork 0
mirror of https://github.com/Farama-Foundation/Gymnasium.git synced 2025-08-30 01:50:19 +00:00
Code Issues Packages Projects Releases Wiki Activity

Rename gymnasium as gym in docs (#24)

Browse Source
This commit is contained in:
Mark Towers
2022-09-19 21:14:09 +01:00
committed by GitHub
parent 5674a52d4c
commit c9056e37e1
68 changed files with 1134 additions and 1131 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
docs/environments/atari/adventure.md
View File

@@ -12,12 +12,12 @@ firstpage:
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 |
| | |
|-------------------|--------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (250, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Adventure-v5")` |
### Description
@@ -60,9 +60,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------|----------------------|----------------|
| Adventure | `[0, 1, 2]` | `[0, ..., 3]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Adventure | `[0, 1, 2]` | `[0, ..., 3]` | `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

34
docs/environments/atari/air_raid.md
View File

@@ -11,13 +11,13 @@ title: Air Raid
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/AirRaid-v5")` |
| | |
|-------------------|------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (250, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/AirRaid-v5")` |
### Description
You control a ship that can move sideways. You must protect two buildings (one on the right and one on the left side of the screen) from
@@ -30,14 +30,14 @@ number of actions (those that are meaningful in this game) are available. The re
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 | FIRE |
| 2 | RIGHT |
| 3 | LEFT |
| Num | Action |
|-----|-----------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | RIGHT |
| 3 | LEFT |
| 4 | RIGHTFIRE |
| 5 | LEFTFIRE |
| 5 | LEFTFIRE |
### Observations
@@ -68,9 +68,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| AirRaid | `[1, ..., 8]` | `[0]` | `1` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|---------------|--------------------|--------------|
| AirRaid | `[1, ..., 8]` | `[0]` | `1` |
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

20
docs/environments/atari/alien.md
View File

@@ -11,13 +11,13 @@ title: Alien
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Alien-v5")` |
| | |
|-------------------|----------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Alien-v5")` |
### Description
You are stuck in a maze-like space ship with three aliens. You goal is to destroy their eggs that are scattered
@@ -65,9 +65,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Alien | `[0, ..., 3]` | `[0, ..., 3]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|---------------|--------------------|--------------|
| Alien | `[0, ..., 3]` | `[0, ..., 3]` | `0` |
You may use the suffix "-ram" to switch to the RAM observation space. In v0 and v4, the suffixes "Deterministic" and "NoFrameskip"

42
docs/environments/atari/amidar.md
View File

@@ -11,13 +11,13 @@ title: Amidar
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Amidar-v5")` |
| | |
|-------------------|-----------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Amidar-v5")` |
### Description
This game is similar to Pac-Man: You are trying to visit all places on a 2-dimensional grid while simultaneously avoiding
@@ -32,18 +32,18 @@ on the flavor of the environment (the combination of `mode` and `difficulty`). T
flavor looks like this:
| Num | Action |
|-----|------------------------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
| 6 | UPFIRE |
| Num | Action |
|-----|-----------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
| 6 | UPFIRE |
| 7 | RIGHTFIRE |
| 8 | LEFTFIRE |
| 9 | DOWNFIRE |
| 8 | LEFTFIRE |
| 9 | DOWNFIRE |
### Observations
By default, the environment returns the RGB image that is displayed to human players as an observation. However, it is
@@ -78,9 +78,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Amidar | `[0]` | `[0, 3]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Amidar | `[0]` | `[0, 3]` | `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

36
docs/environments/atari/assault.md
View File

@@ -10,13 +10,13 @@ title: Assault
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Assault-v5")` |
| | |
|-------------------|------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Assault-v5")` |
### Description
You control a vehicle that can move sideways. A big mother ship circles overhead and continually deploys smaller drones.
@@ -29,15 +29,15 @@ number of actions (those that are meaningful in this game) are available. The re
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 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| Num | Action |
|-----|-----------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | RIGHTFIRE |
| 6 | LEFTFIRE |
| 6 | LEFTFIRE |
### Observations
By default, the environment returns the RGB image that is displayed to human players as an observation. However, it is
@@ -65,9 +65,9 @@ env = gymnasium.make("ALE/Assault-v5")
The various ways to configure the environment are described in detail in the article on Atari environments.
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Assault | `[0]` | `[0]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Assault | `[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"

40
docs/environments/atari/asterix.md
View File

@@ -10,13 +10,13 @@ title: Asterix
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Asterix-v5")` |
| | |
|-------------------|------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Asterix-v5")` |
### Description
You are Asterix and can move horizontally (continuously) and vertically (discretely). Objects
@@ -33,17 +33,17 @@ number of actions (those that are meaningful in this game) are available. The re
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 |
| Num | Action |
|-----|-----------|
| 0 | NOOP |
| 1 | UP |
| 2 | RIGHT |
| 3 | LEFT |
| 4 | DOWN |
| 5 | UPRIGHT |
| 6 | UPLEFT |
| 7 | DOWNRIGHT |
| 8 | DOWNLEFT |
| 8 | DOWNLEFT |
### Observations
By default, the environment returns the RGB image that is displayed to human players as an observation. However, it is
@@ -74,9 +74,9 @@ env = gymnasium.make("ALE/Asterix-v5")
The various ways to configure the environment are described in detail in the article on Atari environments.
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Asterix | `[0]` | `[0]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Asterix | `[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"

28
docs/environments/atari/asteroids.md
View File

@@ -10,13 +10,13 @@ title: Asteroids
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Asteroids-v5")` |
| | |
|-------------------|--------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Asteroids-v5")` |
### Description
This is a well-known arcade game: You control a spaceship in an asteroid field and must break up asteroids by shooting
@@ -43,10 +43,10 @@ flavor looks like this:
| 7 | UPLEFT |
| 8 | UPFIRE |
| 9 | RIGHTFIRE |
| 10 | LEFTFIRE |
| 11 | DOWNFIRE |
| 12 | UPRIGHTFIRE |
| 13 | UPLEFTFIRE |
| 10 | LEFTFIRE |
| 11 | DOWNFIRE |
| 12 | UPRIGHTFIRE |
| 13 | UPLEFTFIRE |
@@ -83,9 +83,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Asteroids | `[0, ..., 31, 128]` | `[0, 3]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|---------------------|--------------------|--------------|
| Asteroids | `[0, ..., 31, 128]` | `[0, 3]` | `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

20
docs/environments/atari/atlantis.md
View File

@@ -11,13 +11,13 @@ title: Atlantis
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Atlantis-v5")` |
| | |
|-------------------|-------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Atlantis-v5")` |
### Description
Your job is to defend the submerged city of Atlantis. Your enemies slowly descend towards the city and you must
@@ -74,9 +74,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Atlantis | `[0, ..., 3]` | `[0]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|---------------|--------------------|--------------|
| Atlantis | `[0, ..., 3]` | `[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

20
docs/environments/atari/bank_heist.md
View File

@@ -10,13 +10,13 @@ title: Bank Heist
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/BankHeist-v5")` |
| | |
|-------------------|--------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/BankHeist-v5")` |
### Description
You are a bank robber and (naturally) want to rob as many banks as possible. You control your getaway car and must
@@ -65,9 +65,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| BankHeist | `[0, 4, 8, 12, 16, 20, 24, 28]` | `[0, ..., 3]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|---------------------------------|--------------------|--------------|
| BankHeist | `[0, 4, 8, 12, 16, 20, 24, 28]` | `[0, ..., 3]` | `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

20
docs/environments/atari/battle_zone.md
View File

@@ -11,13 +11,13 @@ title: Battle Zone
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/BattleZone-v5")` |
| | |
|-------------------|---------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/BattleZone-v5")` |
### Description
You control a tank and must destroy enemy vehicles. This game is played in a first-person perspective and creates
@@ -65,9 +65,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| BattleZone | `[1, 2, 3]` | `[0]` | `1` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| BattleZone | `[1, 2, 3]` | `[0]` | `1` |
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

20
docs/environments/atari/beam_rider.md
View File

@@ -17,13 +17,13 @@ grid:
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/BeamRider-v5")` |
| | |
|-------------------|--------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/BeamRider-v5")` |
### Description
You control a space-ship that travels forward at a constant speed. You can only steer it sideways between discrete
@@ -84,9 +84,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| BeamRider | `[0]` | `[0, 1]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| BeamRider | `[0]` | `[0, 1]` | `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

20
docs/environments/atari/berzerk.md
View File

@@ -10,13 +10,13 @@ title: Berzerk
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Berzerk-v5")` |
| | |
|-------------------|------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Berzerk-v5")` |
### Description
You are stuck in a maze with evil robots. You must destroy them and avoid touching the walls of the maze, as this will kill you. You may be awarded extra lives after scoring a sufficient number of points, depending on the game mode.
@@ -62,9 +62,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Berzerk | `[1, ..., 9, 16, 17, 18]` | `[0]` | `1` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|---------------------------|--------------------|--------------|
| Berzerk | `[1, ..., 9, 16, 17, 18]` | `[0]` | `1` |
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

20
docs/environments/atari/bowling.md
View File

@@ -10,13 +10,13 @@ title: Bowling
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Bowling-v5")` |
| | |
|-------------------|------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Bowling-v5")` |
### Description
Your goal is to score as many points as possible in the game of Bowling. A game consists of 10 frames and you have two
@@ -76,9 +76,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Bowling | `[0, 2, 4]` | `[0, 1]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Bowling | `[0, 2, 4]` | `[0, 1]` | `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

20
docs/environments/atari/boxing.md
View File

@@ -10,13 +10,13 @@ title: Boxing
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Boxing-v5")` |
| | |
|-------------------|-----------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Boxing-v5")` |
### Description
You fight an opponent in a boxing ring. You score points for hitting the opponent. If you score 100 points, your opponent is
@@ -61,9 +61,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Boxing | `[0]` | `[0, ..., 3]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Boxing | `[0]` | `[0, ..., 3]` | `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

32
docs/environments/atari/breakout.md
View File

@@ -10,13 +10,13 @@ title: Breakout
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Breakout-v5")` |
| | |
|-------------------|-------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Breakout-v5")` |
### Description
Another famous Atari game. The dynamics are similar to pong: You move a paddle and hit the ball in a brick wall at the
@@ -31,12 +31,12 @@ number of actions (those that are meaningful in this game) are available. The re
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 | FIRE |
| 2 | RIGHT |
| 3 | LEFT |
| Num | Action |
|-----|--------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | RIGHT |
| 3 | LEFT |
### Observations
By default, the environment returns the RGB image that is displayed to human players as an observation. However, it is
@@ -71,9 +71,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Breakout | `[0, 4, 8, 12, 16, 20, 24, 28, 32, 36, 40, 44]` | `[0, 1]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------------------------------------------|--------------------|--------------|
| Breakout | `[0, 4, 8, 12, 16, 20, 24, 28, 32, 36, 40, 44]` | `[0, 1]` | `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

20
docs/environments/atari/carnival.md
View File

@@ -10,13 +10,13 @@ title: Carnival
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 | (214, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Carnival-v5")` |
| | |
|-------------------|-------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (214, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Carnival-v5")` |
### Description
This is a "shoot 'em up" game. Targets move horizontally across the screen and you must shoot them. You are
@@ -75,9 +75,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Carnival | `[0]` | `[0]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Carnival | `[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

20
docs/environments/atari/centipede.md
View File

@@ -10,13 +10,13 @@ title: Centipede
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Centipede-v5")` |
| | |
|-------------------|--------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Centipede-v5")` |
### Description
You are an elf and must use your magic wands to fend off spiders, fleas and centipedes. Your goal is to protect mushrooms in
@@ -66,9 +66,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Centipede | `[22, 86]` | `[0]` | `22` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Centipede | `[22, 86]` | `[0]` | `22` |
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

20
docs/environments/atari/chopper_command.md
View File

@@ -10,13 +10,13 @@ title: Chopper Command
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/ChopperCommand-v5")` |
| | |
|-------------------|-------------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/ChopperCommand-v5")` |
### Description
You control a helicopter and must protect truck convoys. To that end, you need to shoot down enemy aircraft.
@@ -63,9 +63,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| ChopperCommand | `[0, 2]` | `[0, 1]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|----------------|-------------|--------------------|--------------|
| ChopperCommand | `[0, 2]` | `[0, 1]` | `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

40
docs/environments/atari/crazy_climber.md
View File

@@ -10,13 +10,13 @@ title: Crazy Climber
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/CrazyClimber-v5")` |
| | |
|-------------------|-----------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (250, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/CrazyClimber-v5")` |
### Description
You are a climber trying to reach the top of four builidings, while avoiding obstacles like closing
@@ -35,17 +35,17 @@ number of actions (those that are meaningful in this game) are available. The re
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 |
| Num | Action |
|-----|-----------|
| 0 | NOOP |
| 1 | UP |
| 2 | RIGHT |
| 3 | LEFT |
| 4 | DOWN |
| 5 | UPRIGHT |
| 6 | UPLEFT |
| 7 | DOWNRIGHT |
| 8 | DOWNLEFT |
| 8 | DOWNLEFT |
### Observations
By default, the environment returns the RGB image that is displayed to human players as an observation. However, it is
@@ -78,9 +78,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| CrazyClimber | `[0, ..., 3]` | `[0, 1]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|--------------|---------------|--------------------|--------------|
| CrazyClimber | `[0, ..., 3]` | `[0, 1]` | `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

18
docs/environments/atari/defender.md
View File

@@ -11,12 +11,12 @@ title: Defender
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| | |
|-------------------|-------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Defender-v5")` |
### Description
@@ -66,9 +66,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------|--------------------|---------------|
| Defender | `[1, ..., 9, 16]` | `[0, 1]` | `1` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------------|--------------------|--------------|
| Defender | `[1, ..., 9, 16]` | `[0, 1]` | `1` |
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

40
docs/environments/atari/demon_attack.md
View File

@@ -10,13 +10,13 @@ title: Demon Attack
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/DemonAttack-v5")` |
| | |
|-------------------|----------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/DemonAttack-v5")` |
### Description
You are facing waves of demons in the ice planet of Krybor. Points are accumulated by destroying
@@ -34,17 +34,17 @@ number of actions (those that are meaningful in this game) are available. The re
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 |
| Num | Action |
|-----|-----------|
| 0 | NOOP |
| 1 | UP |
| 2 | RIGHT |
| 3 | LEFT |
| 4 | DOWN |
| 5 | UPRIGHT |
| 6 | UPLEFT |
| 7 | DOWNRIGHT |
| 8 | DOWNLEFT |
| 8 | DOWNLEFT |
### Observations
By default, the environment returns the RGB image that is displayed to human players as an observation. However, it is
@@ -79,9 +79,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| DemonAttack | `[1, 3, 5, 7]` | `[0, 1]` | `1` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|----------------|--------------------|--------------|
| DemonAttack | `[1, 3, 5, 7]` | `[0, 1]` | `1` |
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

40
docs/environments/atari/double_dunk.md
View File

@@ -10,13 +10,13 @@ title: Double Dunk
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/DoubleDunk-v5")` |
| | |
|-------------------|---------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (250, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/DoubleDunk-v5")` |
### Description
You are playing a 2v2 game of basketball. At the start of each possession, you select between a set
@@ -32,17 +32,17 @@ number of actions (those that are meaningful in this game) are available. The re
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 |
| Num | Action |
|-----|-----------|
| 0 | NOOP |
| 1 | UP |
| 2 | RIGHT |
| 3 | LEFT |
| 4 | DOWN |
| 5 | UPRIGHT |
| 6 | UPLEFT |
| 7 | DOWNRIGHT |
| 8 | DOWNLEFT |
| 8 | DOWNLEFT |
### Observations
By default, the environment returns the RGB image that is displayed to human players as an observation. However, it is
@@ -77,9 +77,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| DoubleDunk | `[0, ..., 15]` | `[0]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|----------------|--------------------|--------------|
| DoubleDunk | `[0, ..., 15]` | `[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

40
docs/environments/atari/elevator_action.md
View File

@@ -10,13 +10,13 @@ title: Elevator Action
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/ElevatorAction-v5")` |
| | |
|-------------------|-------------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (250, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/ElevatorAction-v5")` |
### Description
You are a secret agent that must retrieve some secret documents and reach the ground level of a
@@ -35,17 +35,17 @@ number of actions (those that are meaningful in this game) are available. The re
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 |
| Num | Action |
|-----|-----------|
| 0 | NOOP |
| 1 | UP |
| 2 | RIGHT |
| 3 | LEFT |
| 4 | DOWN |
| 5 | UPRIGHT |
| 6 | UPLEFT |
| 7 | DOWNRIGHT |
| 8 | DOWNLEFT |
| 8 | DOWNLEFT |
### Observations
By default, the environment returns the RGB image that is displayed to human players as an observation. However, it is
@@ -80,9 +80,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| ElevatorAction | `[0]` | `[0]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|----------------|-------------|--------------------|--------------|
| ElevatorAction | `[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

40
docs/environments/atari/enduro.md
View File

@@ -10,13 +10,13 @@ title: 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")` |
| | |
|-------------------|-----------------------------------|
| 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
@@ -32,17 +32,17 @@ number of actions (those that are meaningful in this game) are available. The re
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 |
| Num | Action |
|-----|-----------|
| 0 | NOOP |
| 1 | UP |
| 2 | RIGHT |
| 3 | LEFT |
| 4 | DOWN |
| 5 | UPRIGHT |
| 6 | UPLEFT |
| 7 | DOWNRIGHT |
| 8 | DOWNLEFT |
| 8 | DOWNLEFT |
### Observations
By default, the environment returns the RGB image that is displayed to human players as an observation. However, it is
@@ -75,9 +75,9 @@ The various ways to configure the environment are described in detail in the art
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` |
| 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

70
docs/environments/atari/fishing_derby.md
View File

@@ -10,13 +10,13 @@ title: FishingDerby
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/FishingDerby-v5")` |
| | |
|-------------------|-----------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/FishingDerby-v5")` |
### Description
your objective is to catch more sunfish than your opponent. But it's not just between you and the other fisherman, as a big, black shark is lurking just below the surface, waiting to steal your catch! Detailed documentation can be found on [the AtariAge page](https://atariage.com/manual_html_page.php?SoftwareLabelID=182).
@@ -30,26 +30,26 @@ Atari environments are simulated via the Arcade Learning Environment (ALE) [[1]]
### Action Space
The action space a subset of the following discrete set of legal actions:
| Num | Action |
|-----|------------------------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
| 6 | UPRIGHT |
| 7 | UPLEFT |
| 8 | DOWNRIGHT |
| 9 | DOWNLEFT |
| 10 | UPFIRE |
| 11 | RIGHTFIRE |
| 12 | LEFTFIRE |
| 13 | DOWNFIRE |
| 14 | UPRIGHTFIRE |
| 15 | UPLEFTFIRE |
| 16 | DOWNRIGHTFIRE |
| 17 | DOWNLEFTFIRE |
| Num | Action |
|-----|---------------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
| 6 | UPRIGHT |
| 7 | UPLEFT |
| 8 | DOWNRIGHT |
| 9 | DOWNLEFT |
| 10 | UPFIRE |
| 11 | RIGHTFIRE |
| 12 | LEFTFIRE |
| 13 | DOWNFIRE |
| 14 | UPRIGHTFIRE |
| 15 | UPLEFTFIRE |
| 16 | DOWNRIGHTFIRE |
| 17 | DOWNLEFTFIRE |
If you use v0 or v4 and the environment is initialized via `make`, the action space will usually be much smaller since most legal actions don't have
any effect. Thus, the enumeration of the actions will differ. The action space can be expanded to the full
@@ -84,10 +84,10 @@ env = gymnasium.make("ALE/FishingDerby-v5")
```
The various ways to configure the environment are described in detail in the article on Atari environments.
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| FishingDerby | `[0]` | `[0, ..., 3]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|--------------|-------------|--------------------|--------------|
| FishingDerby | `[0]` | `[0, ..., 3]` | `0` |
You may use the suffix "-ram" to switch to the RAM observation space. In v0 and v4, the suffixes "Deterministic" and "NoFrameskip"
@@ -99,11 +99,11 @@ The versions v0 and v4 are not contained in the "ALE" namespace. I.e. they are i
A thorough discussion of the intricate differences between the versions and configurations can be found in the
general article on Atari environments.
|Version|`frameskip=`|`repeat_action_probability=`|`full_action_space=`|
| ----- | --------- | ------------------------- | ---------|
|v0 |`(2, 5,)` |`0.25` |`False` |
|v4 |`(2, 5,)` |`0.0` |`False` |
|v5 |`5` |`0.25` |`True` |
| Version | `frameskip=` | `repeat_action_probability=` | `full_action_space=` |
|---------|--------------|------------------------------|----------------------|
| v0 | `(2, 5,)` | `0.25` | `False` |
| v4 | `(2, 5,)` | `0.0` | `False` |
| v5 | `5` | `0.25` | `True` |
> Version v5 follows the best practices outlined in [[2]](#2). Thus, it is recommended to transition to v5 and
> customize the environment using the arguments above, if necessary.

61
docs/environments/atari/freeway.md
View File

@@ -10,13 +10,13 @@ title: Freeway
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Freeway-v5")` |
| | |
|-------------------|------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Freeway-v5")` |
### Description
your objective is to guide your chicken across lane after lane of busy rush hour traffic. You receive a point for every chicken that makes it to the top of the screen after crossing all the lanes of traffic. Detailed documentation can be found on [the AtariAge page](https://atariage.com/manual_thumbs.php?SoftwareLabelID=192).
@@ -30,26 +30,26 @@ Atari environments are simulated via the Arcade Learning Environment (ALE) [[1]]
### Action Space
The action space a subset of the following discrete set of legal actions:
| Num | Action |
|-----|------------------------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
| 6 | UPRIGHT |
| 7 | UPLEFT |
| 8 | DOWNRIGHT |
| 9 | DOWNLEFT |
| 10 | UPFIRE |
| 11 | RIGHTFIRE |
| 12 | LEFTFIRE |
| 13 | DOWNFIRE |
| 14 | UPRIGHTFIRE |
| 15 | UPLEFTFIRE |
| 16 | DOWNRIGHTFIRE |
| 17 | DOWNLEFTFIRE |
| Num | Action |
|-----|---------------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
| 6 | UPRIGHT |
| 7 | UPLEFT |
| 8 | DOWNRIGHT |
| 9 | DOWNLEFT |
| 10 | UPFIRE |
| 11 | RIGHTFIRE |
| 12 | LEFTFIRE |
| 13 | DOWNFIRE |
| 14 | UPRIGHTFIRE |
| 15 | UPLEFTFIRE |
| 16 | DOWNRIGHTFIRE |
| 17 | DOWNLEFTFIRE |
If you use v0 or v4 and the environment is initialized via `make`, the action space will usually be much smaller since most legal actions don't have
any effect. Thus, the enumeration of the actions will differ. The action space can be expanded to the full
@@ -84,9 +84,10 @@ env = gymnasium.make("ALE/Freeway-v5")
```
The various ways to configure the environment are described in detail in the article on Atari environments.
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Freeway | `[0, ..., 7]` | `[0, 1]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|---------------|--------------------|--------------|
| Freeway | `[0, ..., 7]` | `[0, 1]` | `0` |

71
docs/environments/atari/frostbite.md
View File

@@ -10,13 +10,13 @@ title: Frostbite
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Frostbite-v5")` |
| | |
|-------------------|--------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Frostbite-v5")` |
### Description
In Frostbite, the player controls "Frostbite Bailey" who hops back and forth across across an Arctic river, changing the color of the ice blocks from white to blue. Each time he does so, a block is added to his igloo. [the AtariAge page](https://atariage.com/manual_html_page.php?SoftwareLabelID=199).
@@ -30,26 +30,26 @@ Atari environments are simulated via the Arcade Learning Environment (ALE) [[1]]
### Action Space
The action space a subset of the following discrete set of legal actions:
| Num | Action |
|-----|------------------------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
| 6 | UPRIGHT |
| 7 | UPLEFT |
| 8 | DOWNRIGHT |
| 9 | DOWNLEFT |
| 10 | UPFIRE |
| 11 | RIGHTFIRE |
| 12 | LEFTFIRE |
| 13 | DOWNFIRE |
| 14 | UPRIGHTFIRE |
| 15 | UPLEFTFIRE |
| 16 | DOWNRIGHTFIRE |
| 17 | DOWNLEFTFIRE |
| Num | Action |
|-----|---------------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
| 6 | UPRIGHT |
| 7 | UPLEFT |
| 8 | DOWNRIGHT |
| 9 | DOWNLEFT |
| 10 | UPFIRE |
| 11 | RIGHTFIRE |
| 12 | LEFTFIRE |
| 13 | DOWNFIRE |
| 14 | UPRIGHTFIRE |
| 15 | UPLEFTFIRE |
| 16 | DOWNRIGHTFIRE |
| 17 | DOWNLEFTFIRE |
If you use v0 or v4 and the environment is initialized via `make`, the action space will usually be much smaller since most legal actions don't have
any effect. Thus, the enumeration of the actions will differ. The action space can be expanded to the full
@@ -84,9 +84,10 @@ env = gymnasium.make("ALE/Frostbite-v5")
```
The various ways to configure the environment are described in detail in the article on Atari environments.
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Frostbite | `[0, 2]` | `[0]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Frostbite | `[0, 2]` | `[0]` | `0` |
@@ -99,11 +100,11 @@ The versions v0 and v4 are not contained in the "ALE" namespace. I.e. they are i
A thorough discussion of the intricate differences between the versions and configurations can be found in the
general article on Atari environments.
|Version|`frameskip=`|`repeat_action_probability=`|`full_action_space=`|
| ----- | --------- | ------------------------- | ---------|
|v0 |`(2, 5,)` |`0.25` |`False` |
|v4 |`(2, 5,)` |`0.0` |`False` |
|v5 |`5` |`0.25` |`True` |
| Version | `frameskip=` | `repeat_action_probability=` | `full_action_space=` |
|---------|--------------|------------------------------|----------------------|
| v0 | `(2, 5,)` | `0.25` | `False` |
| v4 | `(2, 5,)` | `0.0` | `False` |
| v5 | `5` | `0.25` | `True` |
> Version v5 follows the best practices outlined in [[2]](#2). Thus, it is recommended to transition to v5 and
> customize the environment using the arguments above, if necessary.

71
docs/environments/atari/gopher.md
View File

@@ -10,13 +10,13 @@ title: Gopher
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Gopher-v5")` |
| | |
|-------------------|-----------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Gopher-v5")` |
### Description
The player controls a shovel-wielding farmer who protects a crop of three carrots from a gopher. [the AtariAge page](https://atariage.com/manual_html_page.php?SoftwareLabelID=218).
@@ -30,26 +30,26 @@ Atari environments are simulated via the Arcade Learning Environment (ALE) [[1]]
### Action Space
The action space a subset of the following discrete set of legal actions:
| Num | Action |
|-----|------------------------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
| 6 | UPRIGHT |
| 7 | UPLEFT |
| 8 | DOWNRIGHT |
| 9 | DOWNLEFT |
| 10 | UPFIRE |
| 11 | RIGHTFIRE |
| 12 | LEFTFIRE |
| 13 | DOWNFIRE |
| 14 | UPRIGHTFIRE |
| 15 | UPLEFTFIRE |
| 16 | DOWNRIGHTFIRE |
| 17 | DOWNLEFTFIRE |
| Num | Action |
|-----|---------------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
| 6 | UPRIGHT |
| 7 | UPLEFT |
| 8 | DOWNRIGHT |
| 9 | DOWNLEFT |
| 10 | UPFIRE |
| 11 | RIGHTFIRE |
| 12 | LEFTFIRE |
| 13 | DOWNFIRE |
| 14 | UPRIGHTFIRE |
| 15 | UPLEFTFIRE |
| 16 | DOWNRIGHTFIRE |
| 17 | DOWNLEFTFIRE |
If you use v0 or v4 and the environment is initialized via `make`, the action space will usually be much smaller since most legal actions don't have
any effect. Thus, the enumeration of the actions will differ. The action space can be expanded to the full
@@ -84,9 +84,10 @@ env = gymnasium.make("ALE/Gopher-v5")
```
The various ways to configure the environment are described in detail in the article on Atari environments.
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Gopher | `[0, 2]` | `[0, 1]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Gopher | `[0, 2]` | `[0, 1]` | `0` |
@@ -99,11 +100,11 @@ The versions v0 and v4 are not contained in the "ALE" namespace. I.e. they are i
A thorough discussion of the intricate differences between the versions and configurations can be found in the
general article on Atari environments.
|Version|`frameskip=`|`repeat_action_probability=`|`full_action_space=`|
| ----- | --------- | ------------------------- | ---------|
|v0 |`(2, 5,)` |`0.25` |`False` |
|v4 |`(2, 5,)` |`0.0` |`False` |
|v5 |`5` |`0.25` |`True` |
| Version | `frameskip=` | `repeat_action_probability=` | `full_action_space=` |
|---------|--------------|------------------------------|----------------------|
| v0 | `(2, 5,)` | `0.25` | `False` |
| v4 | `(2, 5,)` | `0.0` | `False` |
| v5 | `5` | `0.25` | `True` |
> Version v5 follows the best practices outlined in [[2]](#2). Thus, it is recommended to transition to v5 and
> customize the environment using the arguments above, if necessary.

71
docs/environments/atari/gravitar.md
View File

@@ -10,13 +10,13 @@ title: Gravitar
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Gravitar-v5")` |
| | |
|-------------------|-------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Gravitar-v5")` |
### Description
The player controls a small blue spacecraft. The game starts in a fictional solar system with several planets to explore. If the player moves his ship into a planet, he will be taken to a side-view landscape. Player has to destroy red bunkers [the AtariAge page](https://atariage.com/manual_html_page.php?SoftwareLabelID=223).
@@ -30,26 +30,26 @@ Atari environments are simulated via the Arcade Learning Environment (ALE) [[1]]
### Action Space
The action space a subset of the following discrete set of legal actions:
| Num | Action |
|-----|------------------------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
| 6 | UPRIGHT |
| 7 | UPLEFT |
| 8 | DOWNRIGHT |
| 9 | DOWNLEFT |
| 10 | UPFIRE |
| 11 | RIGHTFIRE |
| 12 | LEFTFIRE |
| 13 | DOWNFIRE |
| 14 | UPRIGHTFIRE |
| 15 | UPLEFTFIRE |
| 16 | DOWNRIGHTFIRE |
| 17 | DOWNLEFTFIRE |
| Num | Action |
|-----|---------------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
| 6 | UPRIGHT |
| 7 | UPLEFT |
| 8 | DOWNRIGHT |
| 9 | DOWNLEFT |
| 10 | UPFIRE |
| 11 | RIGHTFIRE |
| 12 | LEFTFIRE |
| 13 | DOWNFIRE |
| 14 | UPRIGHTFIRE |
| 15 | UPLEFTFIRE |
| 16 | DOWNRIGHTFIRE |
| 17 | DOWNLEFTFIRE |
If you use v0 or v4 and the environment is initialized via `make`, the action space will usually be much smaller since most legal actions don't have
any effect. Thus, the enumeration of the actions will differ. The action space can be expanded to the full
@@ -84,9 +84,10 @@ env = gymnasium.make("ALE/Gravitar-v5")
```
The various ways to configure the environment are described in detail in the article on Atari environments.
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Gravitar | `[0, ..., 4]` | `[0]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|---------------|--------------------|--------------|
| Gravitar | `[0, ..., 4]` | `[0]` | `0` |
@@ -99,11 +100,11 @@ The versions v0 and v4 are not contained in the "ALE" namespace. I.e. they are i
A thorough discussion of the intricate differences between the versions and configurations can be found in the
general article on Atari environments.
|Version|`frameskip=`|`repeat_action_probability=`|`full_action_space=`|
| ----- | --------- | ------------------------- | ---------|
|v0 |`(2, 5,)` |`0.25` |`False` |
|v4 |`(2, 5,)` |`0.0` |`False` |
|v5 |`5` |`0.25` |`True` |
| Version | `frameskip=` | `repeat_action_probability=` | `full_action_space=` |
|---------|--------------|------------------------------|----------------------|
| v0 | `(2, 5,)` | `0.25` | `False` |
| v4 | `(2, 5,)` | `0.0` | `False` |
| v5 | `5` | `0.25` | `True` |
> Version v5 follows the best practices outlined in [[2]](#2). Thus, it is recommended to transition to v5 and
> customize the environment using the arguments above, if necessary.

18
docs/environments/atari/hero.md
View File

@@ -11,12 +11,12 @@ title: Hero
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| | |
|-------------------|---------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Hero-v5")` |
### Description
@@ -67,9 +67,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|--------------------------|--------------------|---------------|
| Hero | `[0, ..., 4]` | `[0]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|---------------|--------------------|--------------|
| Hero | `[0, ..., 4]` | `[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

20
docs/environments/atari/ice_hockey.md
View File

@@ -10,13 +10,13 @@ title: IceHockey
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/IceHockey-v5")` |
| | |
|-------------------|--------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/IceHockey-v5")` |
### Description
Your goal is to score as many points as possible in a standard game of Ice Hockey over a 3-minute time period. The ball is usually called "the puck".
@@ -64,9 +64,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| IceHockey | `[0, 2]` | `[0, ..., 3]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| IceHockey | `[0, 2]` | `[0, ..., 3]` | `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

74
docs/environments/atari/index.md
View File

@@ -83,26 +83,26 @@ Atari environments are simulated via the Arcade Learning Environment (ALE) [[1]]
The action space a subset of the following discrete set of legal actions:
| Num | Action |
|-----|------------------------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
| 6 | UPRIGHT |
| 7 | UPLEFT |
| 8 | DOWNRIGHT |
| 9 | DOWNLEFT |
| 10 | UPFIRE |
| 11 | RIGHTFIRE |
| 12 | LEFTFIRE |
| 13 | DOWNFIRE |
| 14 | UPRIGHTFIRE |
| 15 | UPLEFTFIRE |
| 16 | DOWNRIGHTFIRE |
| 17 | DOWNLEFTFIRE |
| Num | Action |
|-----|---------------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
| 6 | UPRIGHT |
| 7 | UPLEFT |
| 8 | DOWNRIGHT |
| 9 | DOWNLEFT |
| 10 | UPFIRE |
| 11 | RIGHTFIRE |
| 12 | LEFTFIRE |
| 13 | DOWNFIRE |
| 14 | UPRIGHTFIRE |
| 15 | UPLEFTFIRE |
| 16 | DOWNRIGHTFIRE |
| 17 | DOWNLEFTFIRE |
If you use v0 or v4 and the environment is initialized via `make`, the action space will usually be much smaller since most legal actions don't have
any effect. Thus, the enumeration of the actions will differ. The action space can be expanded to the full
@@ -168,11 +168,11 @@ action space will be reduced to a subset.
All Atari games are available in three versions. They differ in the default settings of the arguments above.
The differences are listed in the following table:
|Version|`frameskip=`|`repeat_action_probability=`|`full_action_space=`|
| ----- | --------- | ------------------------- | ---------|
|v0 |`(2, 5,)` |`0.25` |`False` |
|v4 |`(2, 5,)` |`0.0` |`False` |
|v5 |`5` |`0.25` |`True` |
| Version | `frameskip=` | `repeat_action_probability=` | `full_action_space=` |
|---------|--------------|------------------------------|----------------------|
| v0 | `(2, 5,)` | `0.25` | `False` |
| v4 | `(2, 5,)` | `0.0` | `False` |
| v5 | `5` | `0.25` | `True` |
> Version v5 follows the best practices outlined in [[2]](#2). Thus, it is recommended to transition to v5 and
> customize the environment using the arguments above, if necessary.
@@ -180,23 +180,23 @@ The differences are listed in the following table:
For each Atari game, several different configurations are registered in Gymnasium. The naming schemes are analogous for
v0 and v4. Let us take a look at all variations of Amidar-v0 that are registered with gymnasium:
|Name |`obs_type=`|`frameskip=`|`repeat_action_probability=`|`full_action_space=`|
| ---------------------------- | -------- | --------- | ------------------------- | ----------------- |
|Amidar-v0 |`"rgb"` |`(2, 5,)` |`0.25` |`False` |
|AmidarDeterministic-v0 |`"rgb"` |`4` |`0.0` |`False` |
|AmidarNoframeskip-v0 |`"rgb"` |`1` |`0.25` |`False` |
|Amidar-ram-v0 |`"ram"` |`(2, 5,)` |`0.25` |`False` |
|Amidar-ramDeterministic-v0 |`"ram"` |`4` |`0.0` |`False` |
|Amidar-ramNoframeskip-v0 |`"ram"` |`1` |`0.25` |`False` |
| Name | `obs_type=` | `frameskip=` | `repeat_action_probability=` | `full_action_space=` |
|----------------------------|-------------|--------------|------------------------------|----------------------|
| Amidar-v0 | `"rgb"` | `(2, 5,)` | `0.25` | `False` |
| AmidarDeterministic-v0 | `"rgb"` | `4` | `0.0` | `False` |
| AmidarNoframeskip-v0 | `"rgb"` | `1` | `0.25` | `False` |
| Amidar-ram-v0 | `"ram"` | `(2, 5,)` | `0.25` | `False` |
| Amidar-ramDeterministic-v0 | `"ram"` | `4` | `0.0` | `False` |
| Amidar-ramNoframeskip-v0 | `"ram"` | `1` | `0.25` | `False` |
Things change in v5: The suffixes "Deterministic" and "NoFrameskip" are no longer available. Instead, you must specify the
environment configuration via arguments passed to `gymnasium.make`. Moreover, the v5 environments
are in the "ALE" namespace. The suffix "-ram" is still available. Thus, we get the following table:
|Name |`obs_type=`|`frameskip=`|`repeat_action_probability=`|`full_action_space=`|
| ---------------------------- | -------- | --------- | ------------------------- | ----------------- |
|ALE/Amidar-v5 |`"rgb"` |`5` |`0.25` |`True` |
|ALE/Amidar-ram-v5 |`"ram"` |`5` |`0.25` |`True` |
| Name | `obs_type=` | `frameskip=` | `repeat_action_probability=` | `full_action_space=` |
|-------------------|-------------|--------------|------------------------------|----------------------|
| ALE/Amidar-v5 | `"rgb"` | `5` | `0.25` | `True` |
| ALE/Amidar-ram-v5 | `"ram"` | `5` | `0.25` | `True` |
### Flavors
Some games allow the user to set a difficulty level and a game mode. Different modes/difficulties may have different

20
docs/environments/atari/jamesbond.md
View File

@@ -10,13 +10,13 @@ title: Jamesbond
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Jamesbond-v5")` |
| | |
|-------------------|--------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Jamesbond-v5")` |
### Description
Your mission is to control Mr. Bond's specially designed multipurpose craft to complete a variety of missions.
@@ -65,9 +65,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Jamesbond | `[0, 1]` | `[0]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Jamesbond | `[0, 1]` | `[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

53
docs/environments/atari/journey_escape.md
View File

@@ -10,13 +10,13 @@ title: JourneyEscape
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/JourneyEscape-v5")` |
| | |
|-------------------|------------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/JourneyEscape-v5")` |
### Description
You must lead all 5 members of JOURNEY through waves of pesky characters and backstage obstacles to the Scarab Escape Vehicle before time runs out.
@@ -30,27 +30,24 @@ number of actions (those that are meaningful in this game) are available. The re
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 |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
| 6 | UPRIGHT |
| 7 | UPLEFT |
| 8 | DOWNRIGHT |
| 9 | DOWNLEFT |
| 11 | RIGHTFIRE |
| 12 | LEFTFIRE |
| 13 | DOWNFIRE |
| 14 | UPRIGHTFIRE |
| 15 | UPLEFTFIRE |
| 16 | DOWNRIGHTFIRE |
| 17 | DOWNLEFTFIRE |
| Num | Action |
|-----|---------------|
| 0 | NOOP |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
| 6 | UPRIGHT |
| 7 | UPLEFT |
| 8 | DOWNRIGHT |
| 9 | DOWNLEFT |
| 11 | RIGHTFIRE |
| 12 | LEFTFIRE |
| 13 | DOWNFIRE |
| 14 | UPRIGHTFIRE |
| 15 | UPLEFTFIRE |
| 16 | DOWNRIGHTFIRE |
| 17 | DOWNLEFTFIRE |
### Observations
By default, the environment returns the RGB image that is displayed to human players as an observation. However, it is

20
docs/environments/atari/kangaroo.md
View File

@@ -10,13 +10,13 @@ title: Kangaroo
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Kangaroo-v5")` |
| | |
|-------------------|-------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Kangaroo-v5")` |
### Description
The object of the game is to score as many points as you can while controlling Mother Kangaroo to rescue her precious baby. You start the game with three lives.
@@ -63,9 +63,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Kangaroo | `[0, 1]` | `[0]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Kangaroo | `[0, 1]` | `[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

20
docs/environments/atari/krull.md
View File

@@ -10,13 +10,13 @@ title: Krull
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Krull-v5")` |
| | |
|-------------------|----------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Krull-v5")` |
### Description
Your mission is to find and enter the Beast's Black Fortress, rescue Princess Lyssa, and destroy the Beast.
@@ -63,9 +63,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Krull | `[0]` | `[0]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Krull | `[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

52
docs/environments/atari/kung_fu_master.md
View File

@@ -10,13 +10,13 @@ title: Kung Fu Master
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/KungFuMaster-v5")` |
| | |
|-------------------|-----------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/KungFuMaster-v5")` |
### Description
You are a Kung-Fu Master fighting your way through the Evil Wizard's temple. Your goal is to rescue Princess Victoria, defeating various enemies along the way. Detailed documentation can be found on [the AtariAge page](https://atariage.com/manual_thumbs.php?SoftwareLabelID=268).
@@ -24,22 +24,22 @@ You are a Kung-Fu Master fighting your way through the Evil Wizard's temple. You
### 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 | DOWNRIGHT |
| 6 | DOWNLEFT |
| 7 | RIGHTFIRE |
| 8 | LEFTFIRE |
| 9 | DOWNFIRE |
| 10 | UPRIGHTFIRE |
| 11 | UPLEFTFIRE |
| 12 | DOWNRIGHTFIRE |
| 13 | DOWNLEFTFIRE |
| Num | Action |
|-----|---------------|
| 0 | NOOP |
| 1 | UP |
| 2 | RIGHT |
| 3 | LEFT |
| 4 | DOWN |
| 5 | DOWNRIGHT |
| 6 | DOWNLEFT |
| 7 | RIGHTFIRE |
| 8 | LEFTFIRE |
| 9 | DOWNFIRE |
| 10 | UPRIGHTFIRE |
| 11 | UPLEFTFIRE |
| 12 | DOWNRIGHTFIRE |
| 13 | DOWNLEFTFIRE |
### Observations
By default, the environment returns the RGB image that is displayed to human players as an observation. However, it is
@@ -67,9 +67,9 @@ env = gymnasium.make("ALE/KungFuMaster-v5")
The various ways to configure the environment are described in detail in the article on Atari environments.
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| KungFuMaster | `[0]` | `[0]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|--------------|-------------|--------------------|--------------|
| KungFuMaster | `[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

20
docs/environments/atari/montezuma_revenge.md
View File

@@ -10,13 +10,13 @@ title: Montezuma Revenge
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/MontezumaRevenge-v5")` |
| | |
|-------------------|---------------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/MontezumaRevenge-v5")` |
### Description
Your goal is to acquire Montezuma's treasure by making your way through a maze of chambers within the emperor's fortress. You must avoid deadly creatures while collecting valuables and tools which can help you escape with the treasure. Detailed documentation can be found on [the AtariAge page](https://atariage.com/manual_html_page.php?SoftwareLabelID=310).
@@ -52,9 +52,9 @@ env = gymnasium.make("ALE/MontezumaRevenge-v5")
The various ways to configure the environment are described in detail in the article on Atari environments.
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| MontezumaRevenge | `[0]` | `[0]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|------------------|-------------|--------------------|--------------|
| MontezumaRevenge | `[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

40
docs/environments/atari/ms_pacman.md
View File

@@ -10,13 +10,13 @@ title: Ms Pacman
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/MsPacman-v5")` |
| | |
|-------------------|-------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/MsPacman-v5")` |
### Description
Your goal is to collect all of the pellets on the screen while avoiding the ghosts.
@@ -24,17 +24,17 @@ Your goal is to collect all of the pellets on the screen while avoiding the ghos
### 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 |
| Num | Action |
|-----|-----------|
| 0 | NOOP |
| 1 | UP |
| 2 | RIGHT |
| 3 | LEFT |
| 4 | DOWN |
| 5 | UPRIGHT |
| 6 | UPLEFT |
| 7 | DOWNRIGHT |
| 8 | DOWNLEFT |
| 8 | DOWNLEFT |
### Observations
By default, the environment returns the RGB image that is displayed to human players as an observation. However, it is
@@ -62,9 +62,9 @@ env = gymnasium.make("ALE/MsPacman-v5")
The various ways to configure the environment are described in detail in the article on Atari environments.
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| MsPacman | `[0, ..., 3]` | `[0]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|---------------|--------------------|--------------|
| MsPacman | `[0, ..., 3]` | `[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

34
docs/environments/atari/name_this_game.md
View File

@@ -10,13 +10,13 @@ title: Name This Game
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/NameThisGame-v5")` |
| | |
|-------------------|-----------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/NameThisGame-v5")` |
### Description
Your goal is to defend the treasure that you have discovered. You must fight off a shark and an octopus while keeping an eye on your oxygen supply. Detailed documentation can be found on [the AtariAge page](https://atariage.com/manual_html_page.php?SoftwareLabelID=323).
@@ -24,14 +24,14 @@ Your goal is to defend the treasure that you have discovered. You must fight off
### 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 | FIRE |
| 2 | RIGHT |
| 3 | LEFT |
| Num | Action |
|-----|-----------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | RIGHT |
| 3 | LEFT |
| 4 | RIGHTFIRE |
| 5 | LEFTFIRE |
| 5 | LEFTFIRE |
### Observations
@@ -60,9 +60,9 @@ env = gymnasium.make("ALE/NameThisGame-v5")
The various ways to configure the environment are described in detail in the article on Atari environments.
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| NameThisGame | `[8, 24, 40]` | `[0, 1]` | `8` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|--------------|---------------|--------------------|--------------|
| NameThisGame | `[8, 24, 40]` | `[0, 1]` | `8` |
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

38
docs/environments/atari/phoenix.md
View File

@@ -10,13 +10,13 @@ title: Phoenix
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Phoenix-v5")` |
| | |
|-------------------|------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Phoenix-v5")` |
### Description
Your goal is to reach and shoot the alien pilot. On your way there, you must eliminate waves of war birds while avoiding their bombs. Detailed documentation can be found on [the AtariAge page](https://atariage.com/manual_thumbs.php?SoftwareLabelID=355).
@@ -24,16 +24,16 @@ Your goal is to reach and shoot the alien pilot. On your way there, you must eli
### 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 | FIRE |
| 2 | RIGHT |
| 3 | LEFT |
| 4 | DOWN |
| Num | Action |
|-----|-----------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | RIGHT |
| 3 | LEFT |
| 4 | DOWN |
| 5 | RIGHTFIRE |
| 6 | LEFTFIRE |
| 7 | DOWNFIRE |
| 6 | LEFTFIRE |
| 7 | DOWNFIRE |
### Observations
By default, the environment returns the RGB image that is displayed to human players as an observation. However, it is
@@ -61,9 +61,9 @@ env = gymnasium.make("ALE/Phoenix-v5")
The various ways to configure the environment are described in detail in the article on Atari environments.
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Phoenix | `[0]` | `[0]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Phoenix | `[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

20
docs/environments/atari/pitfall.md
View File

@@ -10,13 +10,13 @@ title: Pitfall
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Pitfall-v5")` |
| | |
|-------------------|------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Pitfall-v5")` |
### Description
You control Pitfall Harry and are tasked with collecting all the treasures in a jungle within 20 minutes. You have three lives. The game is over if you collect all the treasures or if you die or if the time runs out.
@@ -58,9 +58,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Pitfall | `[0]` | `[0]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Pitfall | `[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

34
docs/environments/atari/pong.md
View File

@@ -10,13 +10,13 @@ title: Pong
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Pong-v5")` |
| | |
|-------------------|---------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Pong-v5")` |
### Description
You control the right paddle, you compete against the left paddle controlled by the computer. You each try to keep deflecting the ball away from your goal and into your opponent's goal.
@@ -28,14 +28,14 @@ However, if you use v0 or v4 or specify `full_action_space=False` during initial
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 | FIRE |
| 2 | RIGHT |
| 3 | LEFT |
| Num | Action |
|-----|-----------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | RIGHT |
| 3 | LEFT |
| 4 | RIGHTFIRE |
| 5 | LEFTFIRE |
| 5 | LEFTFIRE |
@@ -70,9 +70,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Pong | `[0, 1]` | `[0, ..., 3]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Pong | `[0, 1]` | `[0, ..., 3]` | `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

36
docs/environments/atari/pooyan.md
View File

@@ -10,13 +10,13 @@ title: Pooyan
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Pooyan-v5")` |
| | |
|-------------------|-----------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Pooyan-v5")` |
### Description
@@ -29,17 +29,15 @@ However, if you use v0 or v4 or specify `full_action_space=False` during initial
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 | FIRE |
| 2 | UP |
| 3 | DOWN |
| 4 | UPFIRE |
| Num | Action |
|-----|----------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | UP |
| 3 | DOWN |
| 4 | UPFIRE |
| 5 | DOWNFIRE |
### 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
@@ -71,9 +69,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Pooyan | `[10, 30, 50, 70]` | `[0]` | `10` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|--------------------|--------------------|--------------|
| Pooyan | `[10, 30, 50, 70]` | `[0]` | `10` |
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

20
docs/environments/atari/private_eye.md
View File

@@ -10,13 +10,13 @@ title: PrivateEye
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/PrivateEye-v5")` |
| | |
|-------------------|---------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/PrivateEye-v5")` |
### Description
You control the French Private Eye Pierre Touche. Navigate the city streets, parks, secret passages, dead-ends and one-ways in search of the ringleader, Henri Le Fiend and his gang. You also need to find evidence and stolen goods that are scattered about. There are five cases, complete each case before its statute of limitations expires.
@@ -58,9 +58,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| PrivateEye | `[0, ..., 4]` | `[0, ..., 3]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|---------------|--------------------|--------------|
| PrivateEye | `[0, ..., 4]` | `[0, ..., 3]` | `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

36
docs/environments/atari/qbert.md
View File

@@ -10,13 +10,13 @@ title: Qbert
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Qbert-v5")` |
| | |
|-------------------|----------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Qbert-v5")` |
### Description
You are Q*bert. Your goal is to change the color of all the cubes on the pyramid to the pyramid's 'destination' color. To do this, you must hop on each cube on the pyramid one at a time while avoiding nasty creatures that lurk there.
@@ -28,14 +28,14 @@ However, if you use v0 or v4 or specify `full_action_space=False` during initial
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 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
| Num | Action |
|-----|--------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
### Observations
@@ -69,9 +69,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Qbert | `[0]` | `[0, 1]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Qbert | `[0]` | `[0, 1]` | `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

30
docs/environments/atari/riverraid.md
View File

@@ -10,13 +10,13 @@ title: Riverraid
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Riverraid-v5")` |
| | |
|-------------------|--------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Riverraid-v5")` |
### Description
You control a jet that flies over a river: you can move it sideways and fire missiles to destroy enemy objects. Each time an enemy object is destroyed you score points (i.e. rewards).
@@ -55,11 +55,11 @@ Score points are your only reward. You get score points each time you destroy an
| Enemy Object | Score Points |
|--------------|--------------|
| Tanker | 30|
| Helicopter | 60|
| Fuel Depot | 80|
| Jet | 100|
| Bridge | 500|
| Tanker | 30 |
| Helicopter | 60 |
| Fuel Depot | 80 |
| Jet | 100 |
| Bridge | 500 |
For a more detailed documentation, see [the AtariAge page](https://atariage.com/manual_html_page.php?SoftwareLabelID=409).
@@ -73,9 +73,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-----------|--------------------|--------------|
| Riverraid | `[0]` | `[0,1]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Riverraid | `[0]` | `[0,1]` | `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

32
docs/environments/atari/road_runner.md
View File

@@ -10,13 +10,13 @@ title: Road Runner
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/RoadRunner-v0")` |
| | |
|-------------------|---------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/RoadRunner-v0")` |
### Description
You control the Road Runner(TM) in a race; you can control the direction to run in and times to jumps.
@@ -56,12 +56,12 @@ via `gymnasium.make`.
### Rewards
Score points are your only reward. You get score points each time you:
|actions |points|
|-----------------------------------------------------------|-----|
|eat a pile of birdseed |100 |
|eat steel shot |100 |
|get the coyote hit by a mine (cannonball, rock, etc.) |200 |
|get the coyote hit by a truck |1000 |
| actions | points |
|-------------------------------------------------------|--------|
| eat a pile of birdseed | 100 |
| eat steel shot | 100 |
| get the coyote hit by a mine (cannonball, rock, etc.) | 200 |
| get the coyote hit by a truck | 1000 |
For a more detailed documentation, see [the AtariAge page](https://atariage.com/manual_html_page.php?SoftwareLabelID=412).
@@ -75,9 +75,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------------|------|----------|--------------|
| RoadRunner | `[0]`| `[0]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| RoadRunner | `[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

20
docs/environments/atari/robotank.md
View File

@@ -10,13 +10,13 @@ title: Robot Tank
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Robotank-v0")` |
| | |
|-------------------|-------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Robotank-v0")` |
### Description
You control your Robot Tanks to destroy enemies and avoid enemy fire.
@@ -74,9 +74,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------|--------------------|--------------|
| Robotank | `[0]` | `[0]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Robotank | `[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

20
docs/environments/atari/seaquest.md
View File

@@ -10,13 +10,13 @@ title: Seaquest
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Seaquest-v0")` |
| | |
|-------------------|-------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Seaquest-v0")` |
### Description
You control a sub able to move in all directions and fire torpedoes.
@@ -84,9 +84,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|------------------------------|---------------|--------------|
| Seaquest | `[0]` | `[0, 1]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Seaquest | `[0]` | `[0, 1]` | `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

28
docs/environments/atari/skiing.md
View File

@@ -10,13 +10,13 @@ title: Skiing
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Skiing-v0")` |
| | |
|-------------------|-----------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Skiing-v0")` |
### Description
You control a skier who can move sideways.
@@ -37,10 +37,10 @@ on the flavor of the environment (the combination of `mode` and `difficulty`). T
flavor looks like this:
| Num | Action |
|-----|------|
| 0 | NOOP |
| 1 | RIGHT |
| 2 | LEFT |
|-----|--------|
| 0 | NOOP |
| 1 | RIGHT |
| 2 | LEFT |
### Observations
By default, the environment returns the RGB image that is displayed to human players as an observation. However, it is
@@ -75,9 +75,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|------------------------------|---------------|--------------|
| Skiing | `[0]` | `[0]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Skiing | `[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

20
docs/environments/atari/solaris.md
View File

@@ -10,13 +10,13 @@ title: Solaris
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Solaris-v5")` |
| | |
|-------------------|------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Solaris-v5")` |
### Description
You control a spaceship. Blast enemies before they can blast you. You can warp to different sectors. You have to defend Federation planets, and destroy Zylon forces. Keep track of your fuel, if you run out you lose a life. Warp to a Federation planet to refuel. The game ends if all your ships are destroyed or if you reach the Solaris planet. Detailed documentation can be found on [the AtariAge page](https://atariage.com/manual_html_page.php?SoftwareLabelID=450)
@@ -56,9 +56,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Solaris | `[0]` | `[0]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Solaris | `[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

34
docs/environments/atari/space_invaders.md
View File

@@ -10,13 +10,13 @@ title: SpaceInvaders
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/SpaceInvaders-v5")` |
| | |
|-------------------|------------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/SpaceInvaders-v5")` |
### Description
@@ -28,14 +28,14 @@ However, if you use v0 or v4 or specify `full_action_space=False` during initial
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 | FIRE |
| 2 | RIGHT |
| 3 | LEFT |
| Num | Action |
|-----|-----------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | RIGHT |
| 3 | LEFT |
| 4 | RIGHTFIRE |
| 5 | LEFTFIRE |
| 5 | LEFTFIRE |
### Observations
@@ -69,9 +69,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| SpaceInvaders | `[0, ..., 15]` | `[0, 1]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|---------------|----------------|--------------------|--------------|
| SpaceInvaders | `[0, ..., 15]` | `[0, 1]` | `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

36
docs/environments/atari/star_gunner.md
View File

@@ -10,13 +10,13 @@ title: StarGunner
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/StarGunner-v5")` |
| | |
|-------------------|---------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/StarGunner-v5")` |
### Description
@@ -28,14 +28,14 @@ However, if you use v0 or v4 or specify `full_action_space=False` during initial
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 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
| Num | Action |
|-----|--------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
### Observations
@@ -70,9 +70,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| StarGunner | `[0, ..., 3]` | `[0]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|---------------|--------------------|--------------|
| StarGunner | `[0, ..., 3]` | `[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

20
docs/environments/atari/tennis.md
View File

@@ -10,13 +10,13 @@ title: Tennis
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Tennis-v5")` |
| | |
|-------------------|-----------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Tennis-v5")` |
### Description
@@ -59,9 +59,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Tennis | `[0, 2]` | `[0, ..., 3]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Tennis | `[0, 2]` | `[0, ..., 3]` | `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

42
docs/environments/atari/time_pilot.md
View File

@@ -10,13 +10,13 @@ title: TimePilot
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/TimePilot-v5")` |
| | |
|-------------------|--------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/TimePilot-v5")` |
### Description
@@ -28,18 +28,18 @@ However, if you use v0 or v4 or specify `full_action_space=False` during initial
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 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
| 6 | UPFIRE |
| Num | Action |
|-----|-----------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
| 6 | UPFIRE |
| 7 | RIGHTFIRE |
| 8 | LEFTFIRE |
| 9 | DOWNFIRE |
| 8 | LEFTFIRE |
| 9 | DOWNFIRE |
### Observations
@@ -75,9 +75,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| TimePilot | `[0]` | `[0, 1, 2]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| TimePilot | `[0]` | `[0, 1, 2]` | `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.

38
docs/environments/atari/tutankham.md
View File

@@ -10,13 +10,13 @@ title: Tutankham
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Tutankham-v5")` |
| | |
|-------------------|--------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Tutankham-v5")` |
### Description
Your goal is to rack up points by finding treasures in the mazes of the tomb while eliminating its guardians. Detailed documentation can be found on [the AtariAge page](https://atariage.com/manual_thumbs.php?SoftwareLabelID=572).
@@ -24,16 +24,16 @@ Your goal is to rack up points by finding treasures in the mazes of the tomb whi
### 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 | UPFIRE |
| Num | Action |
|-----|-----------|
| 0 | NOOP |
| 1 | UP |
| 2 | RIGHT |
| 3 | LEFT |
| 4 | DOWN |
| 5 | UPFIRE |
| 6 | RIGHTFIRE |
| 7 | LEFTFIRE |
| 7 | LEFTFIRE |
### Observations
By default, the environment returns the RGB image that is displayed to human players as an observation. However, it is
@@ -61,9 +61,9 @@ env = gymnasium.make("ALE/Tutankham-v5")
The various ways to configure the environment are described in detail in the article on Atari environments.
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Tutankham | `[0]` | `[0]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Tutankham | `[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

34
docs/environments/atari/up_n_down.md
View File

@@ -10,13 +10,13 @@ title: Up n' Down
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/UpNDown-v5")` |
| | |
|-------------------|------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/UpNDown-v5")` |
### Description
Your goal is to steer your baja bugger to collect prizes and eliminate opponents. Detailed documentation can be found on [the AtariAge page](https://atariage.com/manual_html_page.php?SoftwareLabelID=574).
@@ -24,13 +24,13 @@ Your goal is to steer your baja bugger to collect prizes and eliminate opponents
### 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 | FIRE |
| 2 | UP |
| 3 | DOWN |
| 4 | UPFIRE |
| Num | Action |
|-----|----------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | UP |
| 3 | DOWN |
| 4 | UPFIRE |
| 5 | DOWNFIRE |
### Observations
@@ -60,9 +60,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| UpNDown | `[0]` | `[0, ..., 3]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| UpNDown | `[0]` | `[0, ..., 3]` | `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

20
docs/environments/atari/venture.md
View File

@@ -10,13 +10,13 @@ title: Venture
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Venture-v5")` |
| | |
|-------------------|------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Venture-v5")` |
### Description
Your goal is to capture the treasure in every chamber of the dungeon while eliminating the monsters. Detailed documentation can be found on [the AtariAge page](https://atariage.com/manual_html_page.php?SoftwareLabelID=576).
@@ -52,9 +52,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Venture | `[0]` | `[0, ..., 3]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Venture | `[0]` | `[0, ..., 3]` | `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

40
docs/environments/atari/video_pinball.md
View File

@@ -10,13 +10,13 @@ title: Video Pinball
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/VideoPinball-v5")` |
| | |
|-------------------|-----------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/VideoPinball-v5")` |
### Description
Your goal is to keep the ball in play as long as possible and to score as many points as possible. Detailed documentation can be found on [the AtariAge page](https://atariage.com/manual_html_page.php?SoftwareLabelID=588).
@@ -24,17 +24,17 @@ Your goal is to keep the ball in play as long as possible and to score as many p
### 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 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
| 6 | UPFIRE |
| Num | Action |
|-----|-----------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
| 6 | UPFIRE |
| 7 | RIGHTFIRE |
| 8 | LEFTFIRE |
| 8 | LEFTFIRE |
### Observations
By default, the environment returns the RGB image that is displayed to human players as an observation. However, it is
@@ -64,9 +64,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| VideoPinball | `[0, ..., 2]` | `[0, 1]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|--------------|---------------|--------------------|--------------|
| VideoPinball | `[0, ..., 2]` | `[0, 1]` | `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

42
docs/environments/atari/wizard_of_wor.md
View File

@@ -10,13 +10,13 @@ title: Wizard of Wor
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/WizardOfWor-v5")` |
| | |
|-------------------|----------------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/WizardOfWor-v5")` |
### Description
Your goal is to beat the Wizard using your laser and radar scanner. Detailed documentation can be found on [the AtariAge page](https://atariage.com/manual_html_page.php?SoftwareLabelID=598).
@@ -24,18 +24,18 @@ Your goal is to beat the Wizard using your laser and radar scanner. Detailed doc
### 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 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
| 6 | UPFIRE |
| Num | Action |
|-----|-----------|
| 0 | NOOP |
| 1 | FIRE |
| 2 | UP |
| 3 | RIGHT |
| 4 | LEFT |
| 5 | DOWN |
| 6 | UPFIRE |
| 7 | RIGHTFIRE |
| 8 | LEFTFIRE |
| 9 | DOWNFIRE |
| 8 | LEFTFIRE |
| 9 | DOWNFIRE |
### Observations
By default, the environment returns the RGB image that is displayed to human players as an observation. However, it is
@@ -65,9 +65,9 @@ The various ways to configure the environment are described in detail in the art
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 |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| VideoPinball | `[0]` | `[0, 1]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|--------------|-------------|--------------------|--------------|
| VideoPinball | `[0]` | `[0, 1]` | `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

20
docs/environments/atari/zaxxon.md
View File

@@ -11,13 +11,13 @@ lastpage:
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 | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Zaxxon-v5")` |
| | |
|-------------------|-----------------------------------|
| Action Space | Discrete(18) |
| Observation Space | (210, 160, 3) |
| Observation High | 255 |
| Observation Low | 0 |
| Import | `gymnasium.make("ALE/Zaxxon-v5")` |
### Description
Your goal is to stop the evil robot Zaxxon and its armies from enslaving the galaxy by piloting your fighter and shooting enemies. Detailed documentation can be found on [the AtariAge page](https://atariage.com/manual_html_page.php?SoftwareLabelID=606).
@@ -51,9 +51,9 @@ env = gymnasium.make("ALE/Zaxxon-v5")
The various ways to configure the environment are described in detail in the article on Atari environments.
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|--------------|
| Zaxxon | `[0]` | `[0]` | `0` |
| Environment | Valid Modes | Valid Difficulties | Default Mode |
|-------------|-------------|--------------------|--------------|
| Zaxxon | `[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