6142d176d2 | ||
---|---|---|
.. | ||
Blob | ||
Share | ||
Template | ||
CreateImage.ps1 | ||
ExploreAlgorithm.ipynb | ||
LaunchLocalTrainingJob.ipynb | ||
LaunchTrainingJob.ipynb | ||
ProvisionCluster.ps1 | ||
README.md | ||
RunModel.ipynb | ||
SetupCluster.ipynb | ||
car_driving_1.gif | ||
car_driving_2.gif | ||
car_driving_3.gif | ||
car_driving_4.gif | ||
experiment_architecture.png | ||
notebook_config.json | ||
sample_model.json |
README.md
Distributed Deep Reinforcement Learning for Autonomous Driving
Authors:
Mitchell Spryn, Software Engineer II, Microsoft
Aditya Sharma, Program Manager, Microsoft
Dhawal Parkar, Software Engineer II, Microsoft
Overview
In this tutorial, you will learn how to train a distributed deep reinforcement learning model for autonomous driving leveraging the power of cloud computing. This tutorial serves as an introduction to training deep learning AD models at scale. Through the course of this tutorial you will learn how to set up a cluster of virtual machine nodes running the AirSim simulation environment and then distribute a training job across the nodes to train a model to steer a car through the Neighborhood environment in AirSim using reinforcement learning. A visualization of this process on four such VM nodes can be seen below.
The instructions provided here use virtual machines spun up on Microsoft Azure using the Azure Batch service to schedule the distribution job. The ideas presented however, can be easily extended to the cloud platform and services of your choice. Please also note that you should be able to work through the tutorial without having to actually run the given code and train the model. If you do wish to run the code, you will need an active Azure subscription, and kicking off the training job will incur charges.
Who is this tutorial for?
This tutorial was designed keeping autonomous driving practitioners in mind. Researchers as well as industry professionals working in the field will find this tutorial to be a good starting off point for further work. The focus of the tutorial is on teaching how to create autonomous driving models at scale from simulation data. While we use deep reinforcement learning to demonstrate how to train such models and the tutorial does go into model discussions, it assumes that readers are familiar with the mechanics of reinforcement learning. Beginners in the field, especially those who are new to deep learning, might find certain aspects of this tutorial challenging. Please refer to the Prerequisites section below for more details.
Prerequisites and setup
Background needed
This tutorial was designed with advanced users and practitioners in mind, hence it assumes the reader has a background in deep learning, and is familiar with the basic concepts of reinforcement learning (reward functions, episodes etc.). A helpful introduction to reinforcement learning can be found here.
It is also highly recommended that the reader has familiarity with the AirSim simulation platform. This tutorial builds upon certain concepts introduced in our end-to-end deep learning for autonomous driving tutorial. We therefore recommend going through that tutorial first.
Environment Setup
- Install Anaconda with Python 3.5 or higher.
- Install Tensorflow
- Install h5py
- Install Keras
- Install AzCopy. Be sure to add the location for the AzCopy executable to your system path.
- Install the latest verison of Azure Powershell.
- Install the latest version of the Azure CLI.
- Install the other dependencies. From your anaconda environment, run "InstallPackages.py" as root or administrator. This installs the following packages into your environment:
- jupyter
- matplotlib v. 2.1.2
- image
- keras_tqdm
- opencv
- msgpack-rpc-python
- pandas
- numpy
- scipy
Simulator Package
We have created a standalone build of the AirSim simulation environment for the tutorials in this cookbook. You can download the build package from here. Consider using AzCopy, as the file size is large. After downloading the package, unzip it and run the PowerShell command
.\AD_Cookbook_Start_AirSim.ps1 neighborhood
to start the simulator in the neighborhood environment.
Hardware
This tutorial has been designed to run on Azure Batch using NV6 machines. Training times and charges vary depending on the number of machines that are spun up. Using a cluster size of 4 (i.e. 3 agent nodes and 1 parameter server node), the model took 3 days to train from scratch. Using transfer learning, the model trained in 6 hours. Using a large cluster size will result in a decreased training time, but will also incur additional charges.
For demonstration purposes, the model can also be trained on a single machine (see instructions below). The model can take up to 5 days to train from scratch, but can train in a few hours using transfer learning. To train the model locally, a machine with a GPU is required.
Running the final trained model requires a GPU. This can either be a local machine, or an NV-Series Azure Data Science VM.
Structure of the tutorial
You will follow a series of Jupyter notebooks as you make your way through this tutorial. Please start with the first notebook to set up your cluster and proceed through the notebooks in the following order:
Step 0: Set up the cluster
Step 1: Explore the algorithm
Step 2: Launch the training job
Step 3: Run the model
If you wish to train the model locally, proceed through the notebooks in the following order:
Step 1: Explore the algorithm
Step 2A: Launch the local training job
Step 3: Run the model