Skip to content

feat(calibration tool): add description of TIER IV calibration tool #188

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 10 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 44 additions & 0 deletions docs/how-to-guides/calibrating-your-sensors.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,12 +11,30 @@ Autoware expects to have multiple sensors attached to the vehicle as input to pe
- Navigation2 provides a [good tutorial for camera internal calibration](https://navigation.ros.org/tutorials/docs/camera_calibration.html).
- [AutoCore](https://autocore.ai/) provides a [light-weight tool](https://github.com/autocore-ai/calibration_tools/tree/main/camera_intrinsic_calib).

### Camera calibration tool from TIER IV

TIER IV では Camera のキャリブレーションを行うため以下の二種類のキャリブレーションツールを提供しています

- [Camera Calibration based on ROS](https://github.com/tier4/CalibrationTools/tree/tier4/universe/sensor#intrinsic-camera-calibration)
- パラメータ値を直接変更し rviz を見ながら調整をするツールです。
- [Camera Calibration via camera-lidar calibraton](https://github.com/tier4/CalibrationTools/tree/tier4/universe/sensor#intrinsic-camera-calibration)
- camera-lidar キャリブレーションと同時に camera の内パラ推定ができます

## Lidar-lidar calibration

### Lidar-Lidar Calibration tool from Autocore

[LL-Calib on Github](https://github.com/autocore-ai/calibration_tools/tree/main/lidar-lidar-calib), provided by [AutoCore](https://autocore.ai/), is a lightweight toolkit for online/offline 3D LiDAR to LiDAR calibration. It's based on local mapping and "GICP" method to derive the relation between main and sub lidar. Information on how to use the tool, troubleshooting tips and example rosbags can be found at the above link.

### Lidar-lidar calibration tool from TIER IV

TIER IV では LiDAR - LiDAR のキャリブレーションを行うため以下の二種類のキャリブレーションツールを提供しています

- [Extrinsic Manual Calibration](https://github.com/tier4/CalibrationTools/tree/tier4/universe/sensor#generic-calibration)
- パラメータ値を直接変更し rviz を見ながら調整をするツールです。
- [Extrinsic Map-Based Calibration](https://github.com/tier4/CalibrationTools/tree/tier4/universe/sensor#lidar-lidar-calibration)
- 点群地図を使って自動的にキャリブレーションを行うツールです。

## Lidar-camera calibration

Developed by MathWorks, The Lidar Camera Calibrator app enables you to interactively estimate the rigid transformation between a lidar sensor and a camera.
Expand All @@ -32,9 +50,35 @@ Developed by [AutoCore](https://autocore.ai/), an easy-to-use lightweight toolki

<https://github.com/autocore-ai/calibration_tools/tree/main/lidar-cam-calib-related>

### Lidar-camera calibratio from TIER IV

TIER IV では LiDAR - Camera のキャリブレーションを行うため以下の三種類のキャリブレーションツールを提供しています。

- [Extrinsic Manual Calibration](https://github.com/tier4/CalibrationTools/tree/tier4/universe/sensor#generic-calibration)
- パラメータ値を直接変更し rviz を見ながら調整をするツールです。
- [Extrinsic Interactive Calibration](https://github.com/tier4/CalibrationTools/tree/tier4/universe/sensor#camera-lidar-calibration)
- 画像と点群の関係をクリックすることでキャリブレーションを行うツールです。
- [Extrinsic tag-based calibration](https://github.com/tier4/CalibrationTools/tree/tier4/universe/sensor#camera-lidar-calibration)
- キャリブレーションボードを使って自動的にキャリブレーションを行うツールです。

## Lidar-IMU calibration

Developed by [APRIL Lab](https://github.com/APRIL-ZJU) at Zhejiang University in China, the LI-Calib calibration tool is a toolkit for calibrating the 6DoF rigid transformation and the time offset between a 3D LiDAR and an IMU, based on continuous-time batch optimization.
IMU-based cost and LiDAR point-to-surfel (surfel = surface element) distance are minimized jointly, which renders the calibration problem well-constrained in general scenarios.

[AutoCore](https://autocore.ai/) has forked the original LI-Calib tool and overwritten the Lidar input for more general usage. Information on how to use the tool, troubleshooting tips and example rosbags can be found at the [LI-Calib fork on Github](https://github.com/autocore-ai/calibration_tools/tree/main/li_calib).

## Base-lidar calibration

### Base-lidar calibration from TIER IV

TIER IV では Base - LiDAR のキャリブレーションを行うため以下の二種類のキャリブレーションツールを提供しています

- [Extrinsic Manual Calibration](https://github.com/tier4/CalibrationTools/tree/tier4/universe/sensor#generic-calibration)
- パラメータ値を直接変更し rviz を見ながら調整をするツールです。
- [Extrinsic ground-plane Calibration](https://github.com/tier4/CalibrationTools/tree/tier4/universe/sensor#base-lidar-calibration)
- roll, pitch, z を自動でキャリブレーションするツールです。

## Other Calibration Tools from TIER IV
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## Other Calibration Tools from TIER IV
## Other calibration tools from TIER IV


TIER IV では sensor の他に Localization, control のキャリブレーションツールを開発し OSS として公開しています。他のキャリブレーションツールは[こちら](https://github.com/tier4/CalibrationTools)を参照してください
16 changes: 14 additions & 2 deletions docs/installation/related-tools/index.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,17 @@
# Installation of related tools

!!! warning
## Calibration Tool
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## Calibration Tool
## Calibration tools


Under Construction
### Install Calibration of TIER IV
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

better to use from or provided by. I am not sure about the grammar and may be wrong.

Suggested change
### Install Calibration of TIER IV
### Install Calibration tools from TIER IV


After installing [autoware](https://github.com/tier4/autoware) (please see [source-installation](https://autowarefoundation.github.io/autoware-documentation/main/installation/autoware/source-installation/) page), execute the following commands:

```bash
cd autoware
wget https://raw.githubusercontent.com/tier4/CalibrationTools/tier4/universe/calibration_tools.repos
vcs import src < calibration_tools.repos
rosdep install -y --from-paths src --ignore-src --rosdistro $ROS_DISTRO
colcon build --symlink-install --cmake-args -DCMAKE_BUILD_TYPE=Release
```

Check [here](https://github.com/tier4/CalibrationTools/blob/tier4/universe/README.md) for a detailed explanation.
Loading