/HeLiMOS-visualizer

A LiDAR visualization tool for HeLiMOS dataset

Primary LanguagePythonMIT LicenseMIT

πŸš— HeLiMOS Visualizer πŸƒ

Forked from the original repository: https://github.com/PRBonn/lidar-visualizer.git

animated

HeLiMOS-visualizer is a tool that visualizes moving objects from heterogeneous LiDAR data.

πŸ”§ How to install

git clone https://github.com/OREOCHIZ/helimos-visualizer.git
cd helimos-visualizer

make install

πŸ’‘ Usage

1. Set the symbolic link

Download the HeLiMOS dataset and create a symbolic link to it at ${HOME}/HeLiMOS

sudo ln -s "/path/to/HeLiMOS/{sequence}" "$HOME/HeLiMOS"
# e.g. sudo ln -s "/path/to/HeLiMOS/KAIST05" "$HOME/HeLiMOS"

After that, we expect the following directory:


${HOME}/HeLiMOS/{sequence}
β”œβ”€β”€Deskewed_LiDAR
    β”œβ”€β”€ train.txt
    β”œβ”€β”€ val.txt
    β”œβ”€β”€ test.txt
    β”œβ”€β”€ Aeva
    β”‚   β”œβ”€β”€ calib.txt
    β”‚   β”œβ”€β”€ velodyne
    β”‚   β”œβ”€β”€ labels
    β”œβ”€β”€ Avia
    β”‚   β”œβ”€β”€ calib.txt
    β”‚   β”œβ”€β”€ velodyne
    β”‚   β”œβ”€β”€ labels
    β”œβ”€β”€ Ouster
    β”‚   β”œβ”€β”€ calib.txt
    β”‚   β”œβ”€β”€ velodyne
    β”‚   β”œβ”€β”€ labels
    └── Velodyne
        β”œβ”€β”€ calib.txt
        β”œβ”€β”€ velodyne
        └── labels

In HeLiMOS, we are currently using only the sequence KAIST05.

2. Visualize Moving objects

If you want to visualize specific sensor,

helimos_visualizer --sensor [Aeva / Avia / Velodyne / Ouster] \
                   --split [train / val / test / all]
# e.g. helimos_visualizer --sensor Aeva --split train
  • Set the --sensor flag to one of the following: Avia, Aeva, Velodyne, or Ouster. The default value is Ouster.
  • Also, set the --split flag to train, val, test or all. The default value is all.

If you would like more detailed information about the --split, please refer to our dataset page.

Help

If you need more information, just type:

helimos_visualizer --help

Citation

If you use this visualizer for any academic work, please cite original kiss-icp and our HeLiMOS.