Home

Awesome

Point Cloud Labeling Tool

Tool for labeling of a single point clouds or a stream of point clouds.

<img src="https://user-images.githubusercontent.com/11506664/63230808-340d5680-c212-11e9-8902-bc08f0f64dc8.png" width=500>

Given the poses of a KITTI point cloud dataset, we load tiles of overlapping point clouds. Thus, multiple point clouds are labeled at once in a certain area.

Features

Dependencies

Build

On Ubuntu 22.04/20.04, the dependencies can be installed from the package manager:

sudo apt install git libeigen3-dev libboost-all-dev qtbase5-dev libglew-dev

Additionally, make sure you have catkin-tools and the fetch verb installed:

sudo apt install python-pip
sudo pip install catkin_tools catkin_tools_fetch empy

Then, build the project, change to the cloned directory and use the following commands:

cmake -S . -B build
cmake --build build

Alternatively, you can also use the "classical" cmake build procedure:

mkdir build && cd build
cmake ..
make -j5

Now the project root directory (e.g. ~/catkin_ws/src/point_labeler) should contain a bin directory containing the labeler.

Usage

In the bin directory, just run ./labeler to start the labeling tool.

The labeling tool allows to label a sequence of point clouds in a tile-based fashion, i.e., the tool loads all scans overlapping with the current tile location. Thus, you will always label the part of the scans that overlaps with the current tile.

In the settings.cfg files you can change the followings options:

<pre> tile size: 100.0 # size of a tile (the smaller the less scans get loaded.) max scans: 500 # number of scans to load for a tile. (should be maybe 1000), but this currently very memory consuming. min range: 0.0 # minimum distance of points to consider. max range: 50.0 # maximum distance of points in the point cloud. add car points: true # add points at the origin of the sensor possibly caused by the car itself. Default: false. </pre>

Folder structure

When loading a dataset, the data must be organized as follows:

<pre> point cloud folder ├── velodyne/ -- directory containing ".bin" files with Velodyne point clouds. ├── labels/ [optional] -- label directory, will be generated if not present. ├── image_2/ [optional] -- directory containing ".png" files from the color camera. ├── calib.txt -- calibration of velodyne vs. camera. needed for projection of point cloud into camera. └── poses.txt -- file containing the poses of every scan. </pre>

Documentation

See the wiki for more information on the usage and other details.

Citation

If you're using the tool in your research, it would be nice if you cite our paper:

@inproceedings{behley2019iccv,
    author = {J. Behley and M. Garbade and A. Milioto and J. Quenzel and S. Behnke and C. Stachniss and J. Gall},
     title = {{SemanticKITTI: A Dataset for Semantic Scene Understanding of LiDAR Sequences}},
 booktitle = {Proc. of the IEEE/CVF International Conf.~on Computer Vision (ICCV)},
      year = {2019}
}

We used the tool to label SemanticKITTI, which contains overall over 40.000 scans organized in 20 sequences.