Skip to content
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

docs: update sensor calibration documentation #448

Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
8dfc979
init manual calibration
ismetatabay Sep 6, 2023
c2f46d1
Merge branch 'main' into ismet/doc/create-sensor-calibration
ismetatabay Sep 7, 2023
ac9dd34
fix typo
ismetatabay Sep 7, 2023
3e7a5c1
add pages
ismetatabay Sep 7, 2023
85228ce
init lidar-lidar calibration
ismetatabay Sep 7, 2023
dec6115
start with explaining mapping-based calibrator
ismetatabay Sep 8, 2023
5b31f7d
update generic_calibration with new video
ismetatabay Sep 8, 2023
e5af741
finalize mapping-based lidar-lidar calibration process
ismetatabay Sep 8, 2023
d0eda19
init ground-lidar calibration document
ismetatabay Sep 8, 2023
435d5b5
Merge branch 'main' into ismet/doc/create-sensor-calibration
ismetatabay Sep 11, 2023
c34c4d1
finalize ground-plane calibration
ismetatabay Sep 12, 2023
cf4bab9
init interactive calibration document
ismetatabay Sep 13, 2023
c3dd6a8
finalize interactive lidar-camera calibration
ismetatabay Sep 18, 2023
79b81dd
init intrinsic camera calibration
ismetatabay Sep 19, 2023
e43c732
finalize intrinsic camera calibration
ismetatabay Sep 22, 2023
cf5d3f9
correct some sentences
ismetatabay Oct 6, 2023
55e9690
refactor calibration documentation structure
ismetatabay Oct 6, 2023
7b3490a
refactor calibration page structure
ismetatabay Oct 6, 2023
14368ec
some improvements for calibration documentation
ismetatabay Oct 9, 2023
8e6a0dd
update document according to the tester
ismetatabay Oct 13, 2023
ff4c568
some readability improvements
ismetatabay Oct 24, 2023
e4e29d3
Merge branch 'main' into ismet/doc/create-sensor-calibration
ismetatabay Nov 3, 2023
52aee52
fix broken links
ismetatabay Nov 3, 2023
2685955
Merge branch 'main' into ismet/doc/create-sensor-calibration
ismetatabay Nov 17, 2023
9dbce8f
solve conflicts
ismetatabay Nov 17, 2023
361f994
Merge branch 'main' into ismet/doc/create-sensor-calibration
ismetatabay Nov 17, 2023
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
Original file line number Diff line number Diff line change
@@ -1,2 +1,8 @@
nav:
- index.md
- Starting with TIER IV's CalibrationTools: calibration-tools
- Extrinsic manual calibration: extrinsic-manual-calibration
- Lidar-lidar calibration: lidar-lidar-calibration
- Ground plane-lidar calibration: ground-lidar-calibration
- Intrinsic camera calibration: intrinsic-camera-calibration
- Lidar-camera calibration: lidar-camera-calibration
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
@@ -0,0 +1,84 @@
# Starting with TIER IV's CalibrationTools

## Overview

Autoware expects to have multiple sensors attached to the vehicle as input to perception,
localization,
and planning stack.
These sensors must be calibrated correctly,
and their positions must be defined at `sensor_kit_description` and `individual_params` packages.
In this tutorial,
we will use TIER IV's [CalibrationTools](https://github.com/tier4/CalibrationTools) repository for the calibration.

## Setting of sensor_kit_base_link position with respect to the base_link

In previous section (creating the vehicle and sensor model),
we mentioned about `sensors_calibration.yaml`.
This file stores `sensor_kit_base_link` (child frame) position and orientation with respect to the
`base_link` (parent frame).
We need to update this relative position
(all values were initially set equal to zero when file is created)
with using CAD data of our vehicle.

<figure markdown>
![ackermann_link](images/tutorial_vehicle_sensor_kit_base_link.png){ align=center }
<figcaption>
Our tutorial_vehicle base_link to sensor_kit_base_link transformation.
</figcaption>
</figure>

So, our `sensors_calibration.yaml` file for our tutorial_vehicle should be like this:

```yaml
base_link:
sensor_kit_base_link:
x: 1.600000 # meter
y: 0.0
z: 1.421595 # 1.151595m + 0.270m
roll: 0.0
pitch: 0.0
yaw: 0.0
```

You need to update this transformation value with respect to the `sensor_kit_base_link` frame.
You can also use CAD values for GNSS/INS and IMU position in `sensor_kit_calibration.yaml` file.
(Please don't forget
to update the sensor_kit_calibration.yaml file in both the sensor_kit_launch and individual_params packages)

## Installing TIER IV's CalibrationTools repositories on autoware

After completing previous steps (creating your own autoware,
creating a vehicle and sensor model etc.)
we are ready to calibrate sensors which prepared their pipeline in creating the sensor model section.

Firstly, we will clone CalibrationTools repositories in own autoware.

```bash
cd <YOUR-OWN-AUTOWARE-DIRECTORY> # for example: cd autoware.tutorial_vehicle
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
```

Then build the all packages
after the all necessary changes are made on sensor model and vehicle model.

```bash
colcon build --symlink-install --cmake-args -DCMAKE_BUILD_TYPE=Release
```

## Usage of CalibrationTools

The CalibrationTools repository has several packages
for calibrating different sensor pairs such as lidar-lidar,
camera-lidar, ground-lidar etc. In order to calibrate our sensors,
we will modify `extrinsic_calibration_package` for our sensor kit.

For tutorial_vehicle,
completed launch files when created following tutorial sections can be found [here](https://github.com/leo-drive/calibration_tools_tutorial_vehicle/tree/tutorial_vehicle/sensor/extrinsic_calibration_manager/launch/tutorial_vehicle_sensor_kit).

- [Manual Calibration](../extrinsic-manual-calibration)
- [Lidar-Lidar Calibration](../lidar-lidar-calibration)
- [Ground Plane-Lidar Calibration](../ground-lidar-calibration)
- [Intrinsic Camera Calibration](../intrinsic-camera-calibration)
- [Lidar-Camera Calibration](../lidar-camera-calibration)
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Loading