README.md

July 13, 2024 · View on GitHub

LCE-Calib: Automatic LiDAR-Frame/Event Camera Extrinsic Calibration With A Globally Optimal Solution

Jianhao Jiao · Feiyi Chen · Hexiang Wei · Jin Wu · Ming Liu ·

Accepted to IEEE/ASME Transactions on Mechatronics

Installation

First you have to install the MATLAB (our code has been tested with MATLAB R2019b, but the code of running the baseline method should be tested with >= MATLAB R2021b).

  1. You need to download the preliminary QPEP solver (LCECalib wrapper)
git clone https://github.com/HKUSTGZ-IADC/LibQPEP-LCECalib
  1. Download the repository of LCECalib
git clone https://github.com/HKUSTGZ-IADC/LCECalib
  1. (Optional) You need to download the preliminary E2VID for image reconstruction from events if needed.
git clone https://github.com/HKUSTGZ-IADC/E2Calib-LCECalib
  1. (Optional) I recommend you to use the code in docker.
docker pull iidcramlab/e2vid:cuda10.1-conda-py3
nvidia-docker run -v <your_path>:<docker_path> --it --name e2vid iidcramlab/e2vid:cuda10.1-conda-py3 /bin/bash

Dataset Preparation

We provide data used in our paper from the Google Drive. Please download and store them according to below folder structure

  • simu_data_bias/
    • simu_data_1 - simu_data_10: simulated data at the noise levels from 1-10
  • real_data/
    • real_data_1 - real_data_3: RLFS01 - RLFS03
    • real_data_4 - real_data_9: RLES01-LF, RLES01-LE, RLES02-LF, RLES02-LE, RLES03-LF, RLES03-LE

You can collect data by yourself for practical sensors, two tricks are provided:

  • The checkboard should be far away from its holder (like the human) to make the plane fitting clear
  • The checkboard should be placed as shown in the paper for the successful boundary detection

Run

Calibration on data presented in our paper

  • Please set correct data_type and data_option in run_lcecalib_qpep.m
  • Please set the flag save_result_flag and plot_result_flag in run_lcecalib_qpep.m
  • Run run_lcecalib_qpep.m
    • if plot_result_flag=1, the code will show simiar results to Fig.8, FIg.10, and Fig.12 in our paper.
    • if save_result_flag=1, results provided by inner modules of LCECalib will be stored for analysis.

Calibration on self-collected data

  • Please set correct data_type and data_option in run_lcecalib_qpep_other_data.m

  • Please set the flag save_result_flag and plot_result_flag in run_lcecalib_qpep_other_data.m

  • Follow the params_to_matlab.m to create the params.mat for configuration

    • num_H, num_W: the number of grids at the short side and long side
    • borW, borH: the width [m] (larger) and height [m] (smaller) of the checkerboard
    • pattern_size: the size [m] of each grid
    • num_data: the number of data pairs (image + point cloud) used in calibration
    • imageWidth, image_Height: the pixel width and height of each image
    • use_edge_flag, use_planar_flag: set 1 or 0 whether to use edge and planar constraints or not
    • edge_weight, planar_weight: weights of edge and planar constraints in optimization

  • Run run_lcecalib_qpep_other_data.m

Calibration using the baseline method

We provide the code of running the baseline method, which is based on the MATLAB implementation.

  • Please set correct all_data_type and data_option in run_baseline_zhou.m
  • Run run_baseline_zhou.m

Demo

Calibration device

Reconstructed images from events

Pure Events

Reconstructed Images

Projecting points onto images with calibrated extrinsics


Camera-VLP16 Calibration

Camera-Ouster128 Calibration

## Acknowledgement The authors express their sincere gratitude to Prof. Lujia Wang and Mr. Shuyang Zhang for their insightful comments on this article.

Citation

If you find our code or paper useful, please cite

@article{jiao2023lce,
  title={LCE-Calib: Automatic LiDAR-Frame/Event Camera Extrinsic Calibration With a Globally Optimal Solution},
  author={Jiao, Jianhao and Chen, Feiyi and Wei, Hexiang and Wu, Jin and Liu, Ming},
  journal={IEEE/ASME Transactions on Mechatronics},
  year={2023},
  publisher={IEEE}
}

Contact

Contact Jianhao Jiao for questions, comments and reporting bugs.

Contact [Mr.Jin Wu](mailto:jwucp at connect.ust.hk) or [Prof.Ming Liu](mailto:eelium at ust.hk) for any commercial inquiries.