Fiesta

Incremental ESDF Map for motion planning

Euclidean Signed Distance Field (ESDF) is useful for online motion planning of aerial robots since it can easily query the distance_ and gradient information against obstacles. Fast incrementally built ESDF map is the bottleneck for conducting real-time motion planning. In this paper, we investigate this problem and propose a mapping system called Fiesta to build global ESDF map incrementally. By introducing two independent updating queues for inserting and deleting obstacles separately, and using Indexing Data Structures and Doubly Linked Lists for map maintenance, our algorithm updates as few as possible nodes using a BFS framework. Our ESDF map has high computational performance and produces near-optimal results. We show our method outperforms other up-to-date methods in term of performance and accuracy by both theory and experiments. We integrate Fiesta into a completed quadrotor system and validate it by both simulation and onboard experiments. We release our method as open-source software for the community.

The paper of this method is submitted to the 2019 IEEE/RSJ International Conference on Intelligent Robots and Systems (IROS 2019). The draft is shown on arxiv here.

Installation

Required Library

Eigen3
PCL 1.7
OpenCV
ROS

Note: C++ 17 is required to run FIESTA. Please install and configure C++ 17.

sudo add-apt-repository ppa:ubuntu-toolchain-r/test
sudo apt-get update
sudo apt-get install gcc-7 g++-7

use the following command to check your gcc compilers

$ ls -lh /usr/bin/g++*

for ubuntu 14.04:

$ sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.8 60 --slave /usr/bin/g++ g++ /usr/bin/g++-4.8

for ubuntu 16.04:

$ sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-5 60 --slave /usr/bin/g++ g++ /usr/bin/g++-5

then

$ sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-7 70 --slave /usr/bin/g++ g++ /usr/bin/g++-7

use the folling command to change the default compiler (choose 0 as default)

$ sudo update-alternatives --config gcc

check your current gcc compiler

$ gcc --version

Download & Compile

cd ~/catkin_ws/src
git clone https://github.com/hlx1996/Fiesta.git
cd ../
catkin_make
source ~/catkin_ws/devel/setup.bash

Usage example

roslaunch fiesta cow_and_lady.launch
rosbag play data.bag

Cow and lady data set can be downloaded here. A rviz will be opened with the visualization of occupancy grid map and a slice of esdf map.

_For more examples, usage and FAQ, please refer to the Wiki.

Release History

Prediction: 1.0.0 will be our first elegant version.

0.6.0
- CHANGE: Refactor code according Google C++ Code Style
0.5.3
- CHANGE: Improve the performance of the depth conversion process
0.5.2
- ADD: Support local map
- ADD: Support raw depth image as input, and depth filter of consistency
0.5.1
- CHANGE: Improve performance of raycasting a lot
0.5.0
- ADD: Give Local / global update / visualization options
- ADD: Show Performance visualization directly on rviz
- CHANGE: Deprecate older visualization, will be deleted in next release
0.4.1
- CHANGE: Give better Visualization based on a slice of ESDF and pointcloud of obstacles
0.4.0
- ADD: Support LIDAR Input
- ADD: Support Deterministic Occupancy Grid Map
0.3.2
- ADD: Implement Multi-thread Raycasting for array implementation
0.3.1
- ADD: Implement Hash table with blocks
0.3.0
- ADD: Implement Hash table
0.2.0
- ADD: Support Raycasting from point cloud_
- ADD: Support Probabilistic Occupancy Grid Map Fusion
- CHANGE: Patch code for limited observations
0.1.0
- The first proper release, support ESDF for fully dynamic case and implemented in array
0.0.1
- Support ESDF for insert-only case

Contributing

Fork it (https://github.com/hlx1996/Fiesta/fork)
Create your feature branch (git checkout -b feature/fooBar)
Commit your changes (git commit -am 'Add some fooBar')
Push to the branch (git push origin feature/fooBar)
Create a new Pull Request

HKUST-Aerial-Robotics / FIESTA