Intel开源增强学习框架：Coach

Intel开源增强学习框架：Coach

Coach

Coach is a python reinforcement learning framework containing implementation of many state-of-the-art algorithms.

It exposes a set of easy-to-use APIs for experimenting with new RL algorithms, and allows simple integration of new environments to solve. Basic RL components (algorithms, environments, neural network architectures, exploration policies, ...) are well decoupled, so that extending and reusing existing components is fairly painless.

Training an agent to solve an environment is as easy as running:

coach -p CartPole_DQN -r

Release 0.8.0 (initial release)Release 0.9.0Release 0.10.0Release 0.11.0Release 0.12.0Release 1.0.0 (current release)

Table of Contents

BenchmarksInstallationGetting StartedTutorials and DocumentationBasic UsageRunning CoachRunning Coach Dashboard (Visualization) Distributed Multi-Node CoachBatch Reinforcement Learning Supported EnvironmentsSupported AlgorithmsCitationContactDisclaimer

Benchmarks

One of the main challenges when building a research project, or a solution based on a published algorithm, is getting a concrete and reliable baseline that reproduces the algorithm's results, as reported by its authors. To address this problem, we are releasing a set of benchmarks that shows Coach reliably reproduces many state of the art algorithm results.

Installation

Note: Coach has only been tested on Ubuntu 16.04 LTS, and with Python 3.5.

For some information on installing on Ubuntu 17.10 with Python 3.6.3, please refer to the following issue: https://github.com/NervanaSystems/coach/issues/54

In order to install coach, there are a few prerequisites required. This will setup all the basics needed to get the user going with running Coach on top of OpenAI Gym environments:

# Generalsudo -E apt-get install python3-pip cmake zlib1g-dev python3-tk python-opencv -y# Boost librariessudo -E apt-get install libboost-all-dev -y# Scipy requirementssudo -E apt-get install libblas-dev liblapack-dev libatlas-base-dev gfortran -y# PyGamesudo -E apt-get install libsdl-dev libsdl-image1.2-dev libsdl-mixer1.2-dev libsdl-ttf2.0-devlibsmpeg-dev libportmidi-dev libavformat-dev libswscale-dev -y# Dashboardsudo -E apt-get install dpkg-dev build-essential python3.5-dev libjpeg-dev libtiff-dev libsdl1.2-dev libnotify-dev freeglut3 freeglut3-dev libsm-dev libgtk2.0-dev libgtk-3-dev libwebkitgtk-dev libgtk-3-dev libwebkitgtk-3.0-devlibgstreamer-plugins-base1.0-dev -y# Gymsudo -E apt-get install libav-tools libsdl2-dev swig cmake -y

We recommend installing coach in a virtualenv:

sudo -E pip3 install virtualenvvirtualenv -p python3 coach_env. coach_env/bin/activate

Finally, install coach using pip:

pip3 install rl_coach

Or alternatively, for a development environment, install coach from the cloned repository:

cd coachpip3 install -e .

If a GPU is present, Coach's pip package will install tensorflow-gpu, by default. If a GPU is not present, an Intel-Optimized TensorFlow, will be installed.

In addition to OpenAI Gym, several other environments were tested and are supported. Please follow the instructions in the Supported Environments section below in order to install more environments.

Getting Started

Tutorials and Documentation

Jupyter notebooks demonstrating how to run Coach from command line or as a library, implement an algorithm, or integrate an environment.

Framework documentation, algorithm description and instructions on how to contribute a new agent/environment.

Basic Usage

Running Coach

To allow reproducing results in Coach, we defined a mechanism called preset. There are several available presets under the presets directory. To list all the available presets use the -l flag.

To run a preset, use:

coach -r -p

For example:

CartPole environment using Policy Gradients (PG):coach -r -p CartPole_PG Basic level of Doom using Dueling network and Double DQN (DDQN) algorithm:coach -r -p Doom_Basic_Dueling_DDQN

Some presets apply to a group of environment levels, like the entire Atari or Mujoco suites for example. To use these presets, the requeseted level should be defined using the -lvl flag.

For example:

Pong using the Neural Episodic Control (NEC) algorithm:coach -r -p Atari_NEC -lvl pong

There are several types of agents that can benefit from running them in a distributed fashion with multiple workers in parallel. Each worker interacts with its own copy of the environment but updates a shared network, which improves the data collection speed and the stability of the learning process. To specify the number of workers to run, use the -n flag.

For example:

Breakout using Asynchronous Advantage Actor-Critic (A3C) with 8 workers:coach -r -p Atari_A3C -lvl breakout -n 8

It is easy to create new presets for different levels or environments by following the same pattern as in presets.py

More usage examples can be found here.

Running Coach Dashboard (Visualization)

Training an agent to solve an environment can be tricky, at times.

In order to debug the training process, Coach outputs several signals, per trained algorithm, in order to track algorithmic performance.

While Coach trains an agent, a csv file containing the relevant training signals will be saved to the 'experiments' directory. Coach's dashboard can then be used to dynamically visualize the training signals, and track algorithmic behavior.

To use it, run:

dashboard

Distributed Multi-Node Coach

As of release 0.11.0, Coach supports horizontal scaling for training RL agents on multiple nodes. In release 0.11.0 this was tested on the ClippedPPO and DQN agents. For usage instructions please refer to the documentation here.

Batch Reinforcement Learning

Training and evaluating an agent from a dataset of experience, where no simulator is available, is supported in Coach. There are example presets and a tutorial.

Supported Environments

OpenAI Gym: Installed by default by Coach's installer ViZDoom: Follow the instructions described in the ViZDoom repository - https://github.com/mwydmuch/ViZDoom Additionally, Coach assumes that the environment variable VIZDOOM_ROOT points to the ViZDoom installation directory. Roboschool: Follow the instructions described in the roboschool repository - https://github.com/openai/roboschool GymExtensions: Follow the instructions described in the GymExtensions repository - https://github.com/Breakend/gym-extensions Additionally, add the installation directory to the PYTHONPATH environment variable. PyBullet: Follow the instructions described in the Quick Start Guide (basically just - 'pip install pybullet') CARLA: Download release 0.8.4 from the CARLA repository - https://github.com/carla-simulator/carla/releases Install the python client and dependencies from the release tarball: pip3 install -r PythonClient/requirements.txtpip3 install PythonClient Create a new CARLA_ROOT environment variable pointing to CARLA's installation directory. A simple CARLA settings file (CarlaSettings.ini) is supplied with Coach, and is located in the environments directory. Starcraft: Follow the instructions described in the PySC2 repository - https://github.com/deepmind/pysc2 DeepMind Control Suite: Follow the instructions described in the DeepMind Control Suite repository - https://github.com/deepmind/dm_control

Supported Algorithms

Value Optimization Agents

Deep Q Network (DQN) (code)Double Deep Q Network (DDQN) (code)Dueling Q NetworkMixed Monte Carlo (MMC) (code)Persistent Advantage Learning (PAL) (code)Categorical Deep Q Network (C51) (code)Quantile Regression Deep Q Network (QR-DQN) (code)N-Step Q Learning | Multi Worker Single Node (code)Neural Episodic Control (NEC) (code)Normalized Advantage Functions (NAF) | Multi Worker Single Node (code)Rainbow (code)

Policy Optimization Agents

Policy Gradients (PG) | Multi Worker Single Node (code)Asynchronous Advantage Actor-Critic (A3C) | Multi Worker Single Node (code)Deep Deterministic Policy Gradients (DDPG) | Multi Worker Single Node (code)Proximal Policy Optimization (PPO) (code)Clipped Proximal Policy Optimization (CPPO) | Multi Worker Single Node (code)Generalized Advantage Estimation (GAE) (code)Sample Efficient Actor-Critic with Experience Replay (ACER) | Multi Worker Single Node (code)Soft Actor-Critic (SAC) (code)Twin Delayed Deep Deterministic Policy Gradient (TD3) (code)

General Agents

Direct Future Prediction (DFP) | Multi Worker Single Node (code)

Imitation Learning Agents

Behavioral Cloning (BC) (code)Conditional Imitation Learning (code)

Hierarchical Reinforcement Learning Agents

Hierarchical Actor Critic (HAC) (code)

Memory Types

Hindsight Experience Replay (HER) (code)Prioritized Experience Replay (PER) (code)

Exploration Techniques

E-Greedy (code)Boltzmann (code)Ornstein–Uhlenbeck process (code)Normal Noise (code)Truncated Normal Noise (code)Bootstrapped Deep Q Network (code)UCB Exploration via Q-Ensembles (UCB) (code)Noisy Networks for Exploration (code)

Citation

If you used Coach for your work, please use the following citation:

@misc{caspi_itai_2017_1134899, author = {Caspi, Itai and Leibovich, Gal and Novik, Gal and Endrawis, Shadi}, title = {Reinforcement Learning Coach}, month = dec, year = 2017, doi = {10.5281/zenodo.1134899}, url = {https://doi.org/10.5281/zenodo.1134899}}

Contact

We'd be happy to get any questions or contributions through GitHub issues and PRs.

Please make sure to take a look here before filing an issue or proposing a PR.

The Coach development team can also be contacted over email

Disclaimer

Coach is released as a reference code for research purposes. It is not an official Intel product, and the level of quality and support may not be as expected from an official product. Additional algorithms and environments are planned to be added to the framework. Feedback and contributions from the open source and RL research communities are more than welcome.

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。