Skip to content

Latest commit

 

History

History
 
 

AirSimE2EDeepLearning

README.md

Autonomous Driving using End-to-End Deep Learning: an AirSim tutorial

Authors:

Mitchell Spryn, Software Engineer II, Microsoft

Aditya Sharma, Program Manager, Microsoft

Overview

In this tutorial, you will learn how to train and test an end-to-end deep learning model for autonomous driving using data collected from the AirSim simulation environment. You will train a model to learn how to steer a car through a portion of the Mountain/Landscape map in AirSim using a single front facing webcam for visual input. Such a task is usually considered the "hello world" of autonomous driving, but after finishing this tutorial you will have enough background to start exploring new ideas on your own. Through the length of this tutorial, you will also learn some practical aspects and nuances of working with end-to-end deep learning methods.

Here's a short sample of the model in action:

car-driving

Structure of this tutorial

The code presented in this tutorial is written in Keras, a high-level deep learning Python API capable of running on top of CNTK, TensorFlow or Theano. The fact that Keras lets you work with the deep learning framework of your choice, along with its simplicity of use, makes it an ideal choice for beginners, eliminating the learning curve that comes with most popular frameworks.

This tutorial is presented to you in the form of Python notebooks. Python notebooks make it easy for you to read instructions and explanations, and write and run code in the same file, all with the comfort of working in your browser window. You will go through the following notebooks in order:

DataExplorationAndPreparation

TrainModel

TestModel

If you have never worked with Python notebooks before, we highly recommend checking out the documentation.

Prerequisites and setup

Background needed

You should be familiar with the basics of neural networks and deep learning. You are not required to know advanced concepts like LSTMs or Reinforcement Learning but you should know how Convolutional Neural Networks work. A really good starting point to get a strong background in a short amount of time is this highly recommended book on the topic written by Michael Nielsen. It is free, very short and available online. It can provide you a solid foundation in less than a week's time.

You should also be comfortable with Python. At the very least, you should be able to read and understand code written in Python.

Environment Setup

  1. Install Anaconda with Python 3.5 or higher.
  2. Install CNTK or install Tensorflow
  3. Install h5py
  4. Install Keras and configure the Keras backend to work with TensorFlow (default) or CNTK.
  5. Install AzCopy. Be sure to add the location for the AzCopy executable to your system path.
  6. 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 landscape

to start the simulator in the landscape environment.

Hardware

It is highly recommended that a GPU is available for running the code in this tutorial. While it is possible to train the model using just a CPU, it will take a very long time to complete training. This tutorial was developed with an Nvidia GTX970 GPU, which resulted in a training time of ~45 minutes.

If you do not have a GPU available, you can spin up a Deep Learning VM on Azure, which comes with all the dependencies and libraries installed (use the provided py35 environment if you are using this VM).

Dataset

The dataset for the model is quite large. You can download it from here. The first notebook will provide guidance on how to access the data once you have downloaded it. The final uncompressed data set size is approximately 3.25GB (which although is nothing compared to the petabytes of data needed to train an actual self-driving car, should be enough for the purpose of this tutorial).

A note from the curators

We have made our best effort to ensure this tutorial can help you get started with the basics of autonomous driving and get you to the point where you can start exploring new ideas independently. We would love to hear your feedback on how we can improve and evolve this tutorial. We would also love to know what other tutorials we can provide you that will help you advance your career goals. Please feel free to use the GitHub issues section for all feedback. All feedback will be monitored closely. If you have ideas you would like to collaborate on, please feel free to reach out to us and we will be happy to work with you.