Skip to content

Commit

Permalink
Merge pull request #79 from Unity-Technologies/develop-13
Browse files Browse the repository at this point in the history
Update to v1.3 of Obstacle Tower
  • Loading branch information
awjuliani authored Apr 10, 2019
2 parents 4cad607 + f9fb8ac commit 02fe65f
Show file tree
Hide file tree
Showing 4 changed files with 13 additions and 9 deletions.
12 changes: 8 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,10 @@ To learn more, please read our AAAI Workshop paper:
* Adds realtime_mode parameter to launch Unity environment from API at real-time speed and render to the window.
* Updates Windows and Linux binaries to address launching issues.
* Updated v1.2 binary includes fixes for agent collision detection issues.
* v1.3 Hotfix release.
* Resolves memory leak when running in Docker.
* Fixes issue where environment could freeze on certain higher floors.


## Installation

Expand All @@ -44,11 +48,11 @@ Python dependencies (also in [setup.py](https://github.com/Unity-Technologies/ob

| *Platform* | *Download Link* |
| --- | --- |
| Linux (x86_64) | https://storage.googleapis.com/obstacle-tower-build/v1.2/obstacletower_v1.2_linux.zip |
| Mac OS X | https://storage.googleapis.com/obstacle-tower-build/v1.2/obstacletower_v1.2_osx.zip |
| Windows | https://storage.googleapis.com/obstacle-tower-build/v1.2/obstacletower_v1.2_windows.zip |
| Linux (x86_64) | https://storage.googleapis.com/obstacle-tower-build/v1.3/obstacletower_v1.3_linux.zip |
| Mac OS X | https://storage.googleapis.com/obstacle-tower-build/v1.3/obstacletower_v1.3_osx.zip |
| Windows | https://storage.googleapis.com/obstacle-tower-build/v1.3/obstacletower_v1.3_windows.zip |

For checksums on these files, see [here](https://storage.googleapis.com/obstacle-tower-build/v1.2/ote-v1.2-checksums.txt).
For checksums on these files, see [here](https://storage.googleapis.com/obstacle-tower-build/v1.3/ote-v1.3-checksums.txt).

### Install the Gym interface

Expand Down
6 changes: 3 additions & 3 deletions examples/gcp_training.md
Original file line number Diff line number Diff line change
Expand Up @@ -107,8 +107,8 @@ cd ../
This page lists the URLs for downloading Obstacle Tower for various platforms. [https://github.com/Unity-Technologies/obstacle-tower-env](https://github.com/Unity-Technologies/obstacle-tower-env). For GCP, run

```bash
wget https://storage.googleapis.com/obstacle-tower-build/v1.2/obstacletower_v1.2_linux.zip
unzip obstacletower_v1.2_linux.zip
wget https://storage.googleapis.com/obstacle-tower-build/v1.3/obstacletower_v1.3_linux.zip
unzip obstacletower_v1.3_linux.zip
```

### Install Dopamine
Expand Down Expand Up @@ -157,7 +157,7 @@ cp dopamine_otc/unity_lib.py dopamine/dopamine/discrete_domains/unity_lib.py
cp dopamine_otc/rainbow_otc.gin dopamine/dopamine/agents/rainbow/configs/rainbow_otc.gin
```

If you didn’t extract the `obstacletower_v1.2_linux.zip` to the home directory, you will need to edit `rainbow_otc.gin`, specifically `create_otc_environment.environment_path` should correspond to the path to your extracted OTC executable file.
If you didn’t extract the `obstacletower_v1.3_linux.zip` to the home directory, you will need to edit `rainbow_otc.gin`, specifically `create_otc_environment.environment_path` should correspond to the path to your extracted OTC executable file.

Furthermore, within this file you will find settings on how long to train for, and how often to evaluate your agent. Each iteration, Dopamine will train for `Runner.training_steps`, evaluate (i.e. run in inference mode) for `Runner.evaluation_steps`, record these results, and checkpoint the agent. It will repeat this process `Runner.num_iterations` number of times before quitting. For instance, you can change `Runner.num_iterations` to 40 to train for 10 million steps. You can also reduce `Runner.evaluation_steps` to reduce the time spent not training. There are other hyperparameters found in this file, which you can modify to improve performance. But for the sake of this exercise, you may leave them as-is.

Expand Down
2 changes: 1 addition & 1 deletion obstacle_tower_env.py
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ class UnityGymException(error.Error):


class ObstacleTowerEnv(gym.Env):
ALLOWED_VERSIONS = ['1', '1.1', '1.2']
ALLOWED_VERSIONS = ['1', '1.1', '1.2', '1.3']

def __init__(self, environment_filename=None, docker_training=False, worker_id=0, retro=True,
timeout_wait=30, realtime_mode=False):
Expand Down
2 changes: 1 addition & 1 deletion setup.py
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@

setup(
name='obstacle_tower_env',
version='1.2',
version='1.3',
author='Unity Technologies',
url='https://github.com/Unity-Technologies/obstacle-tower-env',
py_modules=["obstacle_tower_env"],
Expand Down

0 comments on commit 02fe65f

Please sign in to comment.