tianqi-wang1996/deeprobustdroneracing

In this repository, we modularize the whole navigation drone system, and utilize imitation learning to train the perception module.

Robust Drone Racing based on Imitation Learning and Modularization

In this repository, we modularize the whole navigation drone system, and utilize imitation learning to train the perception module. This kind of modularazation enables us to combine the robustness provided by data-based approaches and the precision provided by model-based approaches.

Our navigation system was only trained using synthetic textures but is able to navigate in environment with randomly-chosen photorealistic textures.

Video: YouTube

Installation

Requirements

The code was tested with Ubuntu 18.04 and ROS Melodic (Python2.7). Different OS and ROS versions are possible but with the possibility of potential conflict.

Installation Process

Use the following commands to create a new catkin workspace and a virtual environment with all the required dependencies.

# first create a new ros workspace
cd ~
mkdir -p drone_racing_worksapce/src
cd ~/drone_racing_worksapce/src
catkin init
catkin build

# download the ros packages included in this repository
cd ~/drone_racing_worksapce/src
git clone https://github.com/tianqi-wang1996/DeepRobustDroneRacing.git

# install Anaconda in your computer for using virtual environments
# then create a new environment with python2.7 option
conda create -n virtual_env python=2.7.17
# activate this environment
conda activate virtual_env

# install required packages
cd ~/drone_racing_worksapce/src/DeepRobustDroneRacing/sim2real_drone_racing
pip install -r python_dependencies.txt
# install tensoflow using anaconda
conda install tensorflow-gpu==1.12.0

# Build and re-source the workspace
cd ~/drone_racing_worksapce/src
catkin build
source ../devel/setup.bash

# add this line to bash.rc file in order to automatically source this workspace next time
echo "source ~/drone_racing_worksapce/devel/setup.bash" >> ~/.bashrc

Race with Trained Network

We have provided our final trained checkpoint file in this repository. If you want to change the checkpoint file used for testing once you have trained a new one, go to net_controller_launch.launch and change the this line:

<arg name="ckpt_file" default="$(find deep_drone_racing_learner)/src/ddr_learner/results/best_model_without_warmup_1.5/model_latest"/>

Before testing, there are several parameters in main.yaml that you can play with:

# the following two maximum velocity settings (preferably set to be the same)
global_traj_max_v: 6.0             # max velocity of precomputed global trajectory
max_velocity: 6.0                   # max velocity

# perturb the gate positions before each experiment
gates_static_amplitude: 1.5       # max amplitude for statically replacing the gates at new runs

# even make the gates keep moving while testing
moving_gates: true                 # triggers dynamically moving gates
# if moving_gates is set to be false, then the two parameters below would be ignored
gates_dyn_amplitude: 1.0           # max amplitude for moving at test time
speed_moving_gates: 0.3             # max speed moving gates

Open a terminal and type:

conda activate virtual_env
roslaunch deep_drone_racing_learning  net_controller_launch.launch

Open an other terminal and type:

conda activate virtual_env
roslaunch test_racing test_racing.launch

One thing to be noticed is that, sometimes pressing ctrl + c in the terminal couldn't kill all the processes involved. In order to terminate it and make your next try errorless, you should either close the terminals, or open the Sytem Monitor (for Ubuntu) and search ros, and kill all the processes related to ros.

Train Your Own Drone Racing Model on Our Collected Data

You can also generate data in simulation and train your model on it.

In this paper, we use a customized DAgger policy to alleviate the drawback of pure imitation learning. If you want skip the time-consuming procedure of data collection and intermediate training process, our final colllected data is shared in this link. Unzip the files into folder ./sim2real_drone_racing/learning/deep_drone_racing_learner/data and then train the network

conda activate virtual_env
roscd deep_drone_racing_learner/src/ddr_learner
# under this folder, first modify the training bash file - train_model.sh,
# change the training data directory
train_data=../../data/Training_final_test (just as an example)
# change the checkpoint directory where you want to store the trained checkpoints
--checkpoint_dir=./results/best_final_1024 (just as an example)
# then, run the training bash file
./train_model.sh

After training finishes, following the aforementioned commands in Race with Trained Network to test your newly trained network.




If you want to follow the whole procedures of how we got our final accumulated training data, read the following section:

Our Customized Data Collection and Training Strategy

Before start, first modify simulation_no_quad_gui.launch to change the diretory that you store the traning data.

<param name="root_dir" value="$(find deep_drone_racing_learner)/data/Traning_data_my"/>

Each DAgger step consist of two sub-steps: generating new data & train on accumulated data.

DAgger Step 1: Generate data

If we don't have any trained checkpoint yet, refer to the following instructions:

Sine we don't have any trained network initially, we only use the expert policy to collect data by setting use_DAgger to false in main.yaml

use_DAgger : false

Open one terminal and type

conda activate virtual_env
roscore

Open another terminal and type

conda activate virtual_env
roscd drone_racing/resources/scripts
python collect_data.py

If we have trained checkpoints, refer to the following instructions:

Set use_DAgger to true in main.yaml

use_DAgger : true

Change DAgger_threshold to a value that we'll described in detail below.

rospy.set_param("/DAgger_threshold", 0.5) (just as an example)

Normally, the partialy-trained network is used to fly the drone but if the drone flies away from the global trajectory (bigger than this threshold), the expert policy is used to recover it. As the training progresses, we can allow bigger DAgger_threshold to collect more diverse data. We initially set DAgger_threshold to be 0.5 m, and increase it by 0.5 m once we have gone through DAgger Step 1 & DAgger Step 2 for one time.

Modify net_controller_launch.launch and change the checkpoint file to the latest one we got from the previous DAgger Step 2:

<arg name="ckpt_file" default="$(find deep_drone_racing_learner)/src/ddr_learner/results/best_model_checkpoint/model_latest"/>

Open one terminal and type

conda activate virtual_env
roslaunch deep_drone_racing_learning  net_controller_launch.launch

Open another terminal and type

conda activate virtual_env
roscd drone_racing/resources/scripts
python collect_data.py

DAgger Step 2: Train the Network

Modify the file train_model.sh

# change the training data directory
train_data=../../data/Training_final_test (just as an example)
# change the checkpoint directory where you want to store the trained checkpoints
--checkpoint_dir=./results/best_model_checkpoint (just as an example)
# you can also change the number of training epochs, ours should be fine
--max_epochs=100
# we found that for each DAgger Step 2, traning from scratch performs better, as a result we set resume_train to false
--resume_train=False

Then, run the training bash file, open one terminal and type

conda activate virtual_env
roscd deep_drone_racing_learner/src/ddr_learner
./train_model.sh

We view DAgger Step 1 plus DAgger Step 2 as one DAgger step. After you finish one DAgger step, you can test the trained network's performance by following the instructions under section Race with Trained Network. In our case, we found that, after three DAgger steps (DAgger_threshold increases to 1.5 m now), the trained network's performance is good enough and further repeat of DAgger step does not improve the performance. You can try yours as well, maybe you'll train a better network!

deeprobustdroneracing's Issues

在build的过程中，http://bitbucket.org/eigen/eigen/get/3.3.4.tar.bz2无法访问，请问是否有压缩包分享