From 2b5d1dabe6390d66893fdb58af1744cdded0d365 Mon Sep 17 00:00:00 2001
From: shadiendrawis <40395873+shadiendrawis@users.noreply.github.com>
Date: Wed, 20 Feb 2019 23:52:34 +0200
Subject: [PATCH] ACER algorithm (#184)
* initial ACER commit
* Code cleanup + several fixes
* Q-retrace bug fix + small clean-ups
* added documentation for acer
* ACER benchmarks
* update benchmarks table
* Add nightly running of golden and trace tests. (#202)
Resolves #200
* comment out nightly trace tests until values reset.
* remove redundant observe ignore (#168)
* ensure nightly test env containers exist. (#205)
Also bump integration test timeout
* wxPython removal (#207)
Replacing wxPython with Python's Tkinter.
Also removing the option to choose multiple files as it is unused and causes errors, and fixing the load file/directory spinner.
* Create CONTRIBUTING.md (#210)
* Create CONTRIBUTING.md. Resolves #188
* run nightly golden tests sequentially. (#217)
Should reduce resource requirements and potential CPU contention but increases
overall execution time.
* tests: added new setup configuration + test args (#211)
- added utils for future tests and conftest
- added test args
* new docs build
* golden test update
---
benchmarks/README.md | 1 +
benchmarks/acer/README.md | 28 ++
benchmarks/acer/breakout_acer_16_workers.png | Bin 0 -> 67661 bytes
benchmarks/acer/pong_acer_16_workers.png | Bin 0 -> 61713 bytes
.../acer/space_invaders_acer_16_workers.png | Bin 0 -> 66142 bytes
docs/_images/acer.png | Bin 0 -> 40352 bytes
docs/_images/algorithms.png | Bin 51160 -> 51768 bytes
docs/_modules/index.html | 6 +-
docs/_modules/rl_coach/agents/acer_agent.html | 431 ++++++++++++++++++
.../rl_coach/agents/actor_critic_agent.html | 3 +-
docs/_modules/rl_coach/agents/agent.html | 78 ++--
docs/_modules/rl_coach/agents/bc_agent.html | 3 +-
.../agents/categorical_dqn_agent.html | 3 +-
docs/_modules/rl_coach/agents/cil_agent.html | 3 +-
.../rl_coach/agents/clipped_ppo_agent.html | 5 +-
docs/_modules/rl_coach/agents/ddpg_agent.html | 3 +-
docs/_modules/rl_coach/agents/dfp_agent.html | 6 +-
docs/_modules/rl_coach/agents/dqn_agent.html | 3 +-
docs/_modules/rl_coach/agents/mmc_agent.html | 3 +-
.../rl_coach/agents/n_step_q_agent.html | 3 +-
docs/_modules/rl_coach/agents/naf_agent.html | 3 +-
docs/_modules/rl_coach/agents/nec_agent.html | 3 +-
docs/_modules/rl_coach/agents/pal_agent.html | 3 +-
.../agents/policy_gradients_agent.html | 3 +-
docs/_modules/rl_coach/agents/ppo_agent.html | 3 +-
.../rl_coach/agents/qr_dqn_agent.html | 3 +-
.../rl_coach/agents/rainbow_dqn_agent.html | 3 +-
.../agents/value_optimization_agent.html | 3 +-
.../rl_coach/architectures/architecture.html | 3 +-
.../architectures/network_wrapper.html | 30 +-
docs/_modules/rl_coach/base_parameters.html | 3 +-
docs/_modules/rl_coach/core_types.html | 17 +-
.../rl_coach/data_stores/nfs_data_store.html | 3 +-
.../rl_coach/data_stores/s3_data_store.html | 3 +-
.../environments/carla_environment.html | 3 +-
.../control_suite_environment.html | 3 +-
.../environments/doom_environment.html | 3 +-
.../rl_coach/environments/environment.html | 10 +-
.../environments/gym_environment.html | 8 +-
.../environments/starcraft2_environment.html | 3 +-
.../exploration_policies/additive_noise.html | 5 +-
.../exploration_policies/boltzmann.html | 3 +-
.../exploration_policies/bootstrapped.html | 3 +-
.../exploration_policies/categorical.html | 3 +-
.../continuous_entropy.html | 3 +-
.../exploration_policies/e_greedy.html | 3 +-
.../exploration_policy.html | 3 +-
.../rl_coach/exploration_policies/greedy.html | 3 +-
.../exploration_policies/ou_process.html | 3 +-
.../exploration_policies/parameter_noise.html | 4 +-
.../truncated_normal.html | 5 +-
.../rl_coach/exploration_policies/ucb.html | 3 +-
.../action/attention_discretization.html | 3 +-
.../filters/action/box_discretization.html | 3 +-
.../rl_coach/filters/action/box_masking.html | 3 +-
.../full_discrete_action_space_map.html | 3 +-
.../filters/action/linear_box_to_box_map.html | 3 +-
.../partial_discrete_action_space_map.html | 3 +-
.../observation_clipping_filter.html | 3 +-
.../observation/observation_crop_filter.html | 3 +-
.../observation_move_axis_filter.html | 3 +-
.../observation_normalization_filter.html | 4 +-
...on_reduction_by_sub_parts_name_filter.html | 3 +-
...rvation_rescale_size_by_factor_filter.html | 3 +-
.../observation_rescale_to_size_filter.html | 3 +-
.../observation_rgb_to_y_filter.html | 3 +-
.../observation_squeeze_filter.html | 3 +-
.../observation_stacking_filter.html | 3 +-
.../observation_to_uint8_filter.html | 3 +-
.../reward/reward_clipping_filter.html | 3 +-
.../reward/reward_normalization_filter.html | 3 +-
.../filters/reward/reward_rescale_filter.html | 3 +-
.../rl_coach/memories/backend/redis.html | 3 +-
.../episodic/episodic_experience_replay.html | 20 +-
.../episodic_hindsight_experience_replay.html | 3 +-
...sodic_hrl_hindsight_experience_replay.html | 3 +-
.../episodic/single_episode_buffer.html | 3 +-
.../balanced_experience_replay.html | 3 +-
.../differentiable_neural_dictionary.html | 3 +-
.../non_episodic/experience_replay.html | 3 +-
.../prioritized_experience_replay.html | 3 +-
.../non_episodic/transition_collection.html | 3 +-
.../kubernetes_orchestrator.html | 3 +-
docs/_modules/rl_coach/spaces.html | 39 +-
docs/_sources/components/agents/index.rst.txt | 1 +
.../components/agents/other/dfp.rst.txt | 4 +-
.../agents/policy_optimization/acer.rst.txt | 60 +++
.../value_optimization/double_dqn.rst.txt | 2 +-
.../agents/value_optimization/dqn.rst.txt | 2 +-
docs/_sources/selecting_an_algorithm.rst.txt | 8 +
docs/_static/basic.css | 2 +-
docs/_static/doctools.js | 2 +-
docs/_static/documentation_options.js | 288 +-----------
docs/_static/language_data.js | 297 ++++++++++++
docs/_static/searchtools.js | 3 +-
docs/_static/websupport.js | 2 +-
docs/components/additional_parameters.html | 3 +-
docs/components/agents/imitation/bc.html | 8 +-
docs/components/agents/imitation/cil.html | 4 +-
docs/components/agents/index.html | 30 +-
docs/components/agents/other/dfp.html | 14 +-
.../agents/policy_optimization/ac.html | 8 +-
.../agents/policy_optimization/acer.html | 379 +++++++++++++++
.../agents/policy_optimization/cppo.html | 4 +-
.../agents/policy_optimization/ddpg.html | 4 +-
.../agents/policy_optimization/hac.html | 3 +-
.../agents/policy_optimization/pg.html | 4 +-
.../agents/policy_optimization/ppo.html | 4 +-
.../agents/value_optimization/bs_dqn.html | 4 +-
.../value_optimization/categorical_dqn.html | 4 +-
.../agents/value_optimization/double_dqn.html | 6 +-
.../agents/value_optimization/dqn.html | 6 +-
.../value_optimization/dueling_dqn.html | 4 +-
.../agents/value_optimization/mmc.html | 4 +-
.../agents/value_optimization/n_step.html | 4 +-
.../agents/value_optimization/naf.html | 4 +-
.../agents/value_optimization/nec.html | 4 +-
.../agents/value_optimization/pal.html | 4 +-
.../agents/value_optimization/qr_dqn.html | 4 +-
.../agents/value_optimization/rainbow.html | 4 +-
docs/components/architectures/index.html | 3 +-
docs/components/core_types.html | 7 +-
docs/components/data_stores/index.html | 3 +-
docs/components/environments/index.html | 3 +-
.../exploration_policies/index.html | 3 +-
docs/components/filters/index.html | 3 +-
docs/components/filters/input_filters.html | 3 +-
docs/components/filters/output_filters.html | 3 +-
docs/components/memories/index.html | 3 +-
docs/components/memory_backends/index.html | 3 +-
docs/components/orchestrators/index.html | 3 +-
docs/components/spaces.html | 165 +++----
docs/contributing/add_agent.html | 3 +-
docs/contributing/add_env.html | 3 +-
docs/dashboard.html | 3 +-
docs/design/control_flow.html | 3 +-
docs/design/horizontal_scaling.html | 3 +-
docs/design/network.html | 3 +-
docs/dist_usage.html | 3 +-
docs/features/algorithms.html | 3 +-
docs/features/benchmarks.html | 3 +-
docs/features/environments.html | 3 +-
docs/features/index.html | 3 +-
docs/genindex.html | 33 +-
docs/index.html | 3 +-
docs/objects.inv | Bin 3571 -> 3579 bytes
docs/search.html | 3 +-
docs/searchindex.js | 2 +-
docs/selecting_an_algorithm.html | 11 +-
docs/test.html | 28 +-
docs/usage.html | 3 +-
docs_raw/source/_static/img/algorithms.png | Bin 51160 -> 51768 bytes
.../source/_static/img/design_imgs/acer.png | Bin 0 -> 40352 bytes
docs_raw/source/components/agents/index.rst | 1 +
.../source/components/agents/other/dfp.rst | 4 +-
.../agents/policy_optimization/acer.rst | 60 +++
.../agents/value_optimization/double_dqn.rst | 2 +-
.../agents/value_optimization/dqn.rst | 2 +-
docs_raw/source/diagrams.xml | 2 +-
docs_raw/source/selecting_an_algorithm.rst | 8 +
img/algorithms.png | Bin 51160 -> 51768 bytes
rl_coach/agents/acer_agent.py | 198 ++++++++
rl_coach/agents/agent.py | 2 +-
rl_coach/agents/policy_optimization_agent.py | 2 +-
rl_coach/architectures/head_parameters.py | 10 +
.../tensorflow_components/architecture.py | 2 +-
.../tensorflow_components/heads/__init__.py | 4 +-
.../heads/acer_policy_head.py | 126 +++++
rl_coach/core_types.py | 6 +-
.../episodic/episodic_experience_replay.py | 17 +-
rl_coach/presets/Atari_ACER.py | 45 ++
rl_coach/presets/CartPole_ACER.py | 49 ++
rl_coach/presets/Doom_Basic_ACER.py | 55 +++
rl_coach/spaces.py | 5 +-
rl_coach/tests/test_spaces.py | 2 +-
175 files changed, 2327 insertions(+), 664 deletions(-)
create mode 100644 benchmarks/acer/README.md
create mode 100644 benchmarks/acer/breakout_acer_16_workers.png
create mode 100644 benchmarks/acer/pong_acer_16_workers.png
create mode 100644 benchmarks/acer/space_invaders_acer_16_workers.png
create mode 100644 docs/_images/acer.png
create mode 100644 docs/_modules/rl_coach/agents/acer_agent.html
create mode 100644 docs/_sources/components/agents/policy_optimization/acer.rst.txt
create mode 100644 docs/_static/language_data.js
create mode 100644 docs/components/agents/policy_optimization/acer.html
create mode 100644 docs_raw/source/_static/img/design_imgs/acer.png
create mode 100644 docs_raw/source/components/agents/policy_optimization/acer.rst
create mode 100644 rl_coach/agents/acer_agent.py
create mode 100644 rl_coach/architectures/tensorflow_components/heads/acer_policy_head.py
create mode 100644 rl_coach/presets/Atari_ACER.py
create mode 100644 rl_coach/presets/CartPole_ACER.py
create mode 100644 rl_coach/presets/Doom_Basic_ACER.py
diff --git a/benchmarks/README.md b/benchmarks/README.md
index 33f113b..603e882 100644
--- a/benchmarks/README.md
+++ b/benchmarks/README.md
@@ -34,6 +34,7 @@ The environments that were used for testing include:
|**[Bootstrapped DQN](bootstrapped_dqn)**|  |Atari | |
|**[QR-DQN](qr_dqn)** |  |Atari | |
|**[A3C](a3c)** |  |Atari, Mujoco | |
+|**[ACER](acer)** |  |Atari | |
|**[Clipped PPO](clipped_ppo)** |  |Mujoco | |
|**[DDPG](ddpg)** |  |Mujoco | |
|**[NEC](nec)** |  |Atari | |
diff --git a/benchmarks/acer/README.md b/benchmarks/acer/README.md
new file mode 100644
index 0000000..e9f9535
--- /dev/null
+++ b/benchmarks/acer/README.md
@@ -0,0 +1,28 @@
+# ACER
+
+Each experiment uses 3 seeds.
+The parameters used for ACER are the same parameters as described in the [original paper](https://arxiv.org/abs/1611.01224), except for the optimizer (changed to ADAM) and learning rate (1e-4) used.
+
+### Breakout ACER - 16 workers
+
+```bash
+coach -p Atari_ACER -lvl breakout -n 16
+```
+
+
+
+### Space Invaders ACER - 16 workers
+
+```bash
+coach -p Atari_ACER -lvl space_invaders -n 16
+```
+
+
+
+### Pong ACER - 16 workers
+
+```bash
+coach -p Atari_ACER -lvl pong -n 16
+```
+
+
diff --git a/benchmarks/acer/breakout_acer_16_workers.png b/benchmarks/acer/breakout_acer_16_workers.png
new file mode 100644
index 0000000000000000000000000000000000000000..ed5c12fe29e120c88f3a070a18fe1ea0f63692fe
GIT binary patch
literal 67661
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 yWmcAh2eV*xC)B7M#KnDew-V+-Gb8_fqo&sY=
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