README.md

DRLEVN: Deep Reinforcement Learning Embodied Visual Navigation

By Sudharsan Ananth, Taiyi Pan, Pratyaksh Prabhav Rao,

New York University

Table of Contents

1. Introduction
2. Dependencies
3. Experiments in 2d Environment
• The snake game with Navigation RL Agent
• The Car indoor agent with RL Agent
4. Prerequisites
5. Step-by-Step Installation
• Install Anaconda
• Create conda environment
• Install basic packages in environment
• Install Habitat-sim and test
• Install Habitat Lab and Test
• Clone SplitNet repo
• Run Test
6. Experiments
7. Results
8. References
9. License
10. Acknowledgments

Introduction

The main goal of the embodied navigation task is to allow an agent to find a target location by perceiving embodied visual inputs. In this project, we hope to tackle some of the challenges discussed above using an end-to-end deep reinforcement learning framework. Our framework will include feature extraction for understanding the perceived visual cue and a reinforcement learning policy for taking necessary actions. Our proposed framework allows for the sharing and reuse of information between different visual environments. Rather than learning the task of visual perception and policy learning independently or completely tied, we build on the work of Kim et al. for learning these embodied visual tasks which benefits both from the scalability and strong in-domain, on-task performance of an end-to-end system and from the generalization and fast adaptability of modular systems.

(back to top)

Dependencies

This project is built with the below given major frameworks and libraries. Some of the libraries and tools support are supported only for Linux and Mac OS. The code is primarily based on python. And the environment is created using Anaconda. All the program is tested in Ubuntu 20.04 LTS with python version 3.7.11 and cmake version 3.14.0. Some of the libraries used are habitat, pytorch, matplotlib, opencv and many libraries are found in requirements.txt.

• Python
• Anaconda
• cmake
• Habitat
• pytorch
• opencv
• matplotlib

(back to top)

Habitat Sim

A high-performance physics-enabled 3D simulator with support for:

• 3D scans of indoor/outdoor spaces (with built-in support for HM3D, MatterPort3D, Gibson, Replica, and other datasets)
• CAD models of spaces and piecewise-rigid objects (e.g. ReplicaCAD, YCB, Google Scanned Objects),
• Configurable sensors (RGB-D cameras, egomotion sensing)
• Robots described via URDF (mobile manipulators like Fetch, fixed-base arms like Franka,quadrupeds like AlienGo),
• Rigid-body mechanics (via Bullet).

habitat2_small.mp4

(back to top)

Habitat Lab

Habitat Lab currently uses Habitat-Sim as the core simulator, but is designed with a modular abstraction for the simulator backend to maintain compatibility over multiple simulators. For documentation refer here.

(back to top)

Experiments in 2d Environment

The project started with a reinforcement learning snake game, and then a 2D agent navigating in a indoor map was created as a starting ground for out project. Both environment was developed in pygame, the agents use Deep-Q-Learning to train and navigate. This can be easily recreated by following the steps below. The snake agent takes around 1 hour to completely train and by using a deeper and much complex model it can navigate better. But to make this section easily reproduceble a faster and much efficient model is used. The car agent which is much complex uses a deeper model and has few glitches, this repo will be continously updated to fix issues since this is a on going research. Also note that this experiments run in Windows, Mac and Ubuntu.

The snake game with Navigation RL Agent

This game is the starting point from which the project was developed, this gives a easy representation of the problem we are solving. This part of the code is easy to recreate and gives result real time, since we will be working on a much smaller model and simpler environment. You will be able to see the agent training and getting better in minutes.

Reproduce this section

Simply clone the repo cd into the right directory and run agent using the below commands. Step-by-Step instructions given below

1. Clone the repository using

   git clone https://github.com/taiyipan/drlevn

2. cd into the directory rl_snake_game

   cd rl_snake_game

3. Recommended: create a conda environment

   # We require python>=3.7
   conda create -n rl_visual_agents python=3.7 numpy matplotlib
   conda activate rl_visual_agents

4. Install opencv-python version 4.5.5

   conda install -c conda-forge opencv

5. Install pygame

   pip install pygame

6. Install pyTorch (CPU verison). Please refer pytorch website to get right version for GPU.

   # https://pytorch.org/get-started/locally/
   conda install pytorch torchvision torchaudio cpuonly -c pytorch

7. Run agent.py from this directory and from inside this environment

   python agent.py

8. To run the environment without Reinforcement Agent and the agent controllable by WASD keys

   python snake_game.py

The Car indoor agent with RL Agent

This game gives much better understanding of how complex the project becomes as soon as we start adding elements. This agent is why we pivoted to habitat sim, and their tools for futer continuation of the project. In this environment the agent can see only a small section around the agent. The agent will learn and remember the environment. Note this is still a Experimental Version and might not run with certain hardware and configurations.

Reproduce this section (agent)

Simply clone the repo cd into the right directory and run agent using the below commands. Step-by-Step instructions given below. Most of the steps are similar to the previous agent above, simply change the directory and run agent.py from the directory RL_car_game. Skip step 1 and 3 if the previous snake agent was reproduced.

1. Clone the repository using

   git clone https://github.com/taiyipan/drlevn

2. cd into the directory rl_snake_game

   cd RL_car_game

3. Recommended: create a conda environment

   # We require python>=3.7
   conda create -n rl_visual_agents python=3.7 numpy matplotlib
   conda activate rl_visual_agents

4. Install opencv-python version 4.5.5

   conda install -c conda-forge opencv

5. Install pygame

   pip install pygame
   pip install IPython

6. Install pyTorch (CPU verison). Please refer pytorch website to get right version for GPU.

   # https://pytorch.org/get-started/locally/
   conda install pytorch torchvision torchaudio cpuonly -c pytorch

7. Run agent.py from this directory and from inside this environment

   python agent.py

8. To run the environment without Reinforcement Agent and the agent controllable by WASD keys

   python baseline_game.py

Prerequisites

This project is not supported in windows. Habitat sim is not available for Windows and is available only on Mac OS and Linux. The procedure for running this experiment in Mac OS is slightly different but the steps are the same. The link for Habitat-sim is given below along with the supported OS.

• aihabitat

Also please note that these results cannot be performed in a virtual machine. The dependencies and the path conflicts and will not work in a virtual machine with any verison of Ubuntu or Linux distributions.

To reproduce the Experiment in Super Computer (NYU HPC)

To reproduce the experiment and to facilitate faster training the use of super computer cluster with good graphics card is required. We have trained our model in NYU's HPC (High Performance Computing) platform. follow the PDF instructions given below to run experiments remotely in a super computer cluster.

HPC Instructions PDF

Step-by-Step Installation (for native Ubuntu 20.04LTS)

To reproduce the results and to run the experiment follow the instructions in this section.

1. Install Anaconda

1. Update Local Package Manager

   sudo apt-get update

2. If your system doesn’t have curl, install it by entering:

   sudo apt-get install curl

3. Retrieving the Latest Version of Anaconda. Copy paste the below link in a web browser and right click the download button and copy the url

   https://www.anaconda.com/distribution/

4. Create a Temporary Directory, and download anaconda using curl. make sure to change the url to the one copied from the above step

   mkdir tmp
   cd /tmp
   curl –O https://repo.anaconda.com/archive/Anaconda3-2020.02-Linux-x86_64.sh
   

5. Running the Anaconda Script. Press yes, accept the terms and aggrements and install anaconda after pasting the below line.

   bash Anaconda3-2019.03-Linux-x86_64.sh
   

6. Activating Installation

   source ~/.bashrc

7. Install Pip

   sudo apt install python3-pip

8. Install Git

   sudo apt install git

2. Create conda environment

9. Preparing Conda Environment

   # We require python>=3.7 and cmake>=3.10
   conda create -n habitat python=3.7 cmake=3.14.0
   conda activate habitat

10. Installing basic package managers for easy installation.

    # We need Git and pip to install requirments. Ensure to install inside the environment. 
    sudo apt install python3-pip
    sudo apt install git

11. Create a Directory for all the dependencies and libraries.

    cd ~
    mkdir drlevn_prj
    cd drlevn_prj

3. Installing Habitat-sim

11. To install habitat-sim with bullet physics (Needed). Should be inside the Environment.

    conda install habitat-sim withbullet -c conda-forge -c aihabitat

12. To check if the installation of habitat was successful

    python
    > import habitat

13. Clone the Habitat-sim from the GitHub

    git clone https://github.com/facebookresearch/habitat-sim

14. Run example.py to check that everything is installed correctly.

    python habitat_sim/examples/examples.py

4. Installing Habitat-Lab

15. Clone a stable version from the github repository and install habitat-lab. And also install habitat_baselines along with all additional requirements using the command below.

    git clone --branch stable https://github.com/facebookresearch/habitat-lab.git
    cd habitat-lab
    pip install -r requirements.txt
    python setup.py develop --all # install habitat and habitat_baselines

16. Run the example script python examples/example.py which in the end should print out number of steps agent took inside an environment (eg: Episode finished after 18 steps.).

    python examples/example.py

5. Cloning and Installing SplitNet

17. Go back to the previous directory drlevn_prj by using cd ..

    cd ..

18. Clone the SplitNet

    git clone https://github.com/facebookresearch/splitnet.git
    cd splitnet

19. deactivate the environment and update the enviroment with configuration file environment.yml. This step will remove all the conflicts and update many libraries. This step might take several minutes.

    conda deactivate
    conda env update -n habitat -f environment.yml
    conda activate habitat

6. Running SplitNet

SplitNet Data. We use the data sources linked from the public habitat-api repository. You will need to individually download MP3D, and Gibson from their sources. habitat-sim and habitat-api share the links to the files. We additionally use the Point-Nav datasets from habitat-api, but we also provide a script for generating new datasets.

20. Create a symlink to where you downloaded the directory containing the scene_datasets asset files for each of the datasets. Call this folder data

    ln -s /path/to/habitat/data data

21. Copy/Move the downloaded datasets into the data folder.

    mv downloaded_data/* data

Evaluation can be performed during training using the --eval-interavl flag, but you may also wish to evaluate an individual file on its own. eval_splitnet.sh makes this possible.

22. Edit the DATASET, TASK, and LOG_LOCATION in eval_splitnet.sh and any other variables you wish.

23. By default, the code restores the most recently modified weights file in the checkpoints folder. If this is not the one you want to evaluate, you will have to edit base_habitat_rl_runner.py restore function to point to the proper file.

24. Run sh eval_splitnet.sh

7. Recreating New DRLEVN results (experimentation version)

24. Clone the repo inside(skip if all the above steps are followed)

    git clone https://github.com/taiyipan/drlevn.git

25. Follow steps to install habitat sim, habitat lab, and requirements.txt from above.

26. Clone the repo inside the drlevn_prj directory

    cd drlevn

27. Train the agent using train_drlevn.py

    python train_drlevn.py

(back to top)

Results

The proposed framework is validated by utilizing the Habitat scene renderer on scenes from the near photo-realistic 3D room datasets, Matterport 3D and Gibson.

Results indicate that the SplitNet framework outperforms all other baselines when validated for both the datasets (refer Table 1). It achieved a SPL of 0.72 and a success rate of 0.84 in the MP3D setup, and a SPL of 0.70 and a success rate of 0.85 in the Gibson environment. It is not surprising to find that the SPL and success rate of the Random baseline are very low because the agent was unable to anticipate the position of the target and relies on chance. The Blind Goal Follower baseline is better than Random, as the agent can anticipate the position of the target since it is provided with an update goal vector. The blind methods are not provided with visual inputs.

Results	MP3D		Gibson
IDK what	SPL	Success	SPL	Success
Random	0.011	0.016	0.046	0.028
Blind Goal Follower	0.199	0.203	0.155	0.158
E2E PPO	0.322	0.477	0.634	0.831
E2E BC, PPO	0.521	0.733	0.606	0.769
SplitNet + BC	0.45	0.73	0.44	0.66
SplitNet BC + PPO	0.72	0.84	0.70	0.85

References

[1] Kim, Juyong, et al. "Splitnet: Learning to semantically split deep networks for parameter reduction and model parallelization." International Conference on Machine Learning. PMLR, 2017.

[2] Savva, Manolis, et al. "Habitat: A platform for embodied ai research." Proceedings of the IEEE/CVF International Conference on Computer Vision 2019.

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact

Taiyi Pan - [email protected]

Pratyaksh Prabhav Rao - [email protected]

Sudharsan Ananth - [email protected]

Project Link: https://github.com/taiyipan/TPSNet

(back to top)

Acknowledgments

We would like to express our thanks to the people who's discussion helped us through the project. We are grateful to Prof. Siddharth Garg, Prof. Arsalan Mosenia and the teaching assistant Ezgi Ozyilkan for their nonstop support. Lastly, we would like to extend our special thanks to the teaching team for giving us this opportunity to work on these assignments and projects. They were extremely helpful and pertinent to understanding the concepts.

Siddharth Garg

Arsalan Mosenia

Ezgi Ozyilkan

(back to top)