Skip to content
forked from ethz-asl/kalibr

The Kalibr visual-inertial calibration toolbox

License

Notifications You must be signed in to change notification settings

wangyendt/kalibr

 
 

Repository files navigation

Kalibr

ROS1 Ubuntu 20.04 ROS1 Ubuntu 18.04 ROS1 Ubuntu 16.04

OST Calibration

2023.12.25 Update

Kalibr在进行camera-imu标定时,默认是从.bag文件中读取数据,但目前保存图像数据使用的是.bin文件,保存图像时间戳和imu数据都是用的.txt或.csv文件。为了避免不必要又耗时的格式转换,将kalibr直接从.bin、.txt、.csv中读取图像和imu数据。

使用方法

  • 先建立一个catkin workspace,把kalibr clone到其中的src文件夹

  • catkin_make编译kalibr

  • 修改app文件夹中的run_extrinsic_calibration_bin.sh脚本中的数据路径、kalibr路径和要校准哪个相机(0或1)

  • 运行run_extrinsic_calibration_bin.sh脚本

整个过程参考下面的脚本:

cd /path/to/catkin_workspace
mkdir kalibr_ws && cd kalibr_ws
mkdir src && cd src
git clone http://172.16.46.52:7990/scm/fal/ff-kalibr.git
cd .. && catkin_make
cd src/ff-kalibr/app
# 修改路径等参数
bash ./run_extrinsic_calibration_bin.sh

注:一个典型的数据文件夹应该如下图所示:

image-20231225152922430

Introduction

Kalibr is a toolbox that solves the following calibration problems:

  1. Multi-Camera Calibration: Intrinsic and extrinsic calibration of a camera-systems with non-globally shared overlapping fields of view with support for a wide range of camera models.
  2. Visual-Inertial Calibration (CAM-IMU): Spatial and temporal calibration of an IMU w.r.t a camera-system along with IMU intrinsic parameters
  3. Multi-Inertial Calibration (IMU-IMU): Spatial and temporal calibration of an IMU w.r.t a base inertial sensor along with IMU intrinsic parameters (requires 1-aiding camera sensor).
  4. Rolling Shutter Camera Calibration: Full intrinsic calibration (projection, distortion and shutter parameters) of rolling shutter cameras.

To install follow the install wiki page instructions for which you can either use Docker or install from source in a ROS workspace. Please find more information on the wiki pages of this repository. For questions or comments, please open an issue on Github.

News / Events

  • Nov 24, 2022 - Some new visualization of trajectory and IMU rate for the generated report along with fixed support for exporting poses to file (see PR #578,#581,#582)
  • May 3, 2022 - Support for Ubuntu 20.04 along with Docker scripts have been merged into master via PR #515. A large portion was upgrading to Python 3. A special thanks to all the contributors that made this possible. Additionally, contributed fixes for the different validation and visualization scripts have been merged.
  • Febuary 3, 2020 - Initial Ubuntu 18.04 support has been merged via PR #241. Additionally, support for inputting an initial guess for focal length can be provided from the cmd-line on failure to initialize them.
  • August 15, 2018 - Double sphere camera models have been contributed to the repository via PR #210. If you are interested you can refer to the paper for a nice overview of the models in the repository.
  • August 25, 2016 - Rolling shutter camera calibration support was added as a feature via PR #65. The paper provides details for those interested.
  • May 18, 2016 - Support for multiple IMU-to-IMU spacial and IMU intrinsic calibration was released.
  • June 18, 2014 - Initial public release of the repository.

Authors

  • Paul Furgale
  • Hannes Sommer
  • Jérôme Maye
  • Jörn Rehder
  • Thomas Schneider (email)
  • Luc Oth

References

The calibration approaches used in Kalibr are based on the following papers. Please cite the appropriate papers when using this toolbox or parts of it in an academic publication.

  1. Joern Rehder, Janosch Nikolic, Thomas Schneider, Timo Hinzmann, Roland Siegwart (2016). Extending kalibr: Calibrating the extrinsics of multiple IMUs and of individual axes. In Proceedings of the IEEE International Conference on Robotics and Automation (ICRA), pp. 4304-4311, Stockholm, Sweden.
  2. Paul Furgale, Joern Rehder, Roland Siegwart (2013). Unified Temporal and Spatial Calibration for Multi-Sensor Systems. In Proceedings of the IEEE/RSJ International Conference on Intelligent Robots and Systems (IROS), Tokyo, Japan.
  3. Paul Furgale, T D Barfoot, G Sibley (2012). Continuous-Time Batch Estimation Using Temporal Basis Functions. In Proceedings of the IEEE International Conference on Robotics and Automation (ICRA), pp. 2088–2095, St. Paul, MN.
  4. J. Maye, P. Furgale, R. Siegwart (2013). Self-supervised Calibration for Robotic Systems, In Proc. of the IEEE Intelligent Vehicles Symposium (IVS)
  5. L. Oth, P. Furgale, L. Kneip, R. Siegwart (2013). Rolling Shutter Camera Calibration, In Proc. of the IEEE Computer Vision and Pattern Recognition (CVPR)

Acknowledgments

This work is supported in part by the European Union's Seventh Framework Programme (FP7/2007-2013) under grants #269916 (V-Charge), and #610603 (EUROPA2).

License (BSD)

Copyright (c) 2014, Paul Furgale, Jérôme Maye and Jörn Rehder, Autonomous Systems Lab, ETH Zurich, Switzerland
Copyright (c) 2014, Thomas Schneider, Skybotix AG, Switzerland
All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

  1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

  2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

  3. All advertising materials mentioning features or use of this software must display the following acknowledgement: This product includes software developed by the Autonomous Systems Lab and Skybotix AG.

  4. Neither the name of the Autonomous Systems Lab and Skybotix AG nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE AUTONOMOUS SYSTEMS LAB AND SKYBOTIX AG ''AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL the AUTONOMOUS SYSTEMS LAB OR SKYBOTIX AG BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

About

The Kalibr visual-inertial calibration toolbox

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 76.9%
  • Python 14.5%
  • TeX 6.0%
  • CMake 2.0%
  • C 0.3%
  • EmberScript 0.1%
  • Other 0.2%