Patchwork
Official page of "Patchwork: Concentric Zone-based Region-wise Ground Segmentation with Ground Likelihood Estimation Using a 3D LiDAR Sensor", which is accepted by RA-L with IROS'21 option
[Video] [Preprint Paper] [Project Wiki]
| Patchwork | Concept of our method (CZM & GLE) |
|---|---|
 |
 |
It's an overall updated version of R-GPF of ERASOR [Code] [Paper].
Demo
KITTI 00
Rough Terrain
Characteristics
-
Single hpp file (
include/patchwork/patchwork.hpp) -
Robust ground consistency
As shown in the demo videos and below figure, our method shows the most promising robust performance compared with other state-of-the-art methods, especially, our method focuses on the little perturbation of precision/recall.
Please kindly note that the concept of traversable area and ground is quite different! Please refer to our paper.
Contents
Test Env.
The code is tested successfully at
- Linux 18.04 LTS
- ROS Melodic
Requirements
ROS Setting
-
- Install ROS on a machine.
-
- Thereafter, jsk-visualization is required to visualize Ground Likelihood Estimation status.
sudo apt-get install ros-melodic-jsk-recognition
sudo apt-get install ros-melodic-jsk-common-msgs
sudo apt-get install ros-melodic-jsk-rviz-plugins
-
- Compile compile this package. We use catkin tools,
mkdir -p ~/catkin_ws/src
cd ~/catkin_ws/src
git clone https://github.com/LimHyungTae/patchwork.git
cd .. && catkin build patchwork
How to Run Patchwork
We provide three examples
- Offline KITTI dataset
- Online (ROS Callback) KITTI dataset
- Own dataset using pcd files
Offline KITTI dataset
-
Download SemanticKITTI Odometry dataset (We also need labels since we also open the evaluation code! :)
-
Set the
data_pathinlaunch/offline_kitti.launchfor your machine.
The data_path consists of velodyne folder and labels folder as follows:
data_path (e.g. 00, 01, ..., or 10)
_____velodyne
|___000000.bin
|___000001.bin
|___000002.bin
|...
_____labels
|___000000.label
|___000001.label
|___000002.label
|...
_____...
- Run launch file
roslaunch patchwork offline_kitti.launch
You can directly feel the speed of Patchwork!
Online (ROS Callback) KITTI dataset
We also provide rosbag example. If you run our patchwork via rosbag, please refer to this example.
- Download readymade rosbag
wget https://urserver.kaist.ac.kr/publicdata/patchwork/kitti_00_xyzilid.bag
- After building this package, run the roslaunch as follows:
roslaunch patchwork rosbag_kitti.launch
- Then play the rosbag file in another command
rosbag play kitti_00_xyzilid.bag
Own dataset using pcd files
To be updated (In fact, we already set the data loader in include/tools/pcd_loader.hpp)
Citation
If you use our code or method in your work, please consider citing the following:
@article{lim2021patchwork,
title={Patchwork: Concentric Zone-based Region-wise Ground Segmentation with Ground Likelihood Estimation Using a 3D LiDAR Sensor},
author={Lim, Hyungtae and Minho, Oh and Myung, Hyun},
journal={IEEE Robotics and Automation Letters},
year={2021}
}
Description
All explanations of parameters and other experimental results will be uploaded in wiki
Contact
If you have any questions, please let me know:
- Hyungtae Lim {[email protected]}
TODO List
- Add ROS support
- Add preprint paper
- Add demo videos
- Add demo examples
- Update wiki
76 Jan 2, 2023
109 Dec 23, 2022
157 Dec 26, 2022
1 Nov 7, 2021
2 Nov 19, 2021
68 Nov 15, 2022
100 Dec 28, 2022
225 Dec 29, 2022
14 Nov 2, 2022
17 Oct 11, 2022
31 Dec 8, 2022
2 Oct 29, 2021
9 Dec 8, 2022
23 Dec 20, 2022
4 Feb 19, 2022
3 Feb 5, 2022
26 Dec 18, 2022
5 Feb 19, 2022
3 Dec 28, 2022