# Exercises

- Submission
- đź‘¤ Individual
- đź‘Ą Team

# Submission

In this Lab, there are 5 deliverables throughout the handout. Deliverables 1 and 2 will require pen and paper and are considered individual tasks, while Deliverable 3-5 are a team task which requires coding in the lab6 directory that we will provide.

### Individual

Please push the deliverables into your personal repository, for math-related questions LaTeX (or other typesetting software) is required.

### Team

Please push the source code of the entire `lab6`

package in the folder `lab6`

of the team repository. Include also in your `lab6`

folder a PDF containing non-code deliverables (plots, comments).

### Deadline

**Deadline:** the VNAV staff will clone your repository on **October 20** at midnight ET.

# đź‘¤ Individual

## đź“¨ Deliverable 1 - Nisterâ€™s 5-point Algorithm [20 pts]

### Read the paper and answer the questions below

Read the following paper.

[1] NistĂ©r, David. â€śAn efficient solution to the five-point relative pose problem.â€ť 2003 IEEE Computer Society Conference on Computer Vision and Pattern Recognition, 2003. Vol. 2. 2003. link here.

Questions:

- Outline the main computational steps required to get the relative pose estimate (up to scale) in Nisterâ€™s 5-point algorithm.
- Does the 5-point algorithm exhibit any degeneracy? (degeneracy = special arrangements of the 3D points or the camera poses under which the algorithm fails)
- When used within RANSAC, what is the expected number of iterations the 5-point algorithm requires to find an outlier-free set?
- Hint: take same assumptions of the lecture notes

## đź“¨ Deliverable 2 - Designing a Minimal Solver [15 pts]

**Can you do better than Nister?** Nisterâ€™s method is a minimal solver since it uses 5 point correspondences to compute the 5 degrees of freedom that define the relative pose (up to scale) between the two cameras (recall: each point induces a scalar equation). In the presence of external information (e.g., data from other sensors), we may be able use less point correspondences to compute the relative pose.

Consider a drone flying in an unknown environment, and equipped with a camera and an Inertial Measurement Unit (IMU). We want to use the feature correspondences extracted in the images captured at two consecutive time instants $t_1$ and $t_2$ to estimate the relative pose (up to scale) between the pose at time $t_1$ and the pose at time $t_2$. Besides the camera, we can use the IMU (and in particular the gyroscopes in the IMU) to estimate the relative rotation between the pose of the camera at time $t_1$ and $t_2$.

You are required to solve the following problems:

- Assume the relative camera rotation between time and is known from the IMU. Design a minimal solver that computes the remaining degrees of freedom of the relative pose.
- Hint: we only want to compute the pose up to scale

**OPTIONAL (5 bonus pts)**: Describe the pseudo-code of a RANSAC algorithm using the minimal solver developed in point a) to compute the relative pose in presence of outliers (wrong correspondences).

# đź‘Ą Team

In this section, we will estimate the motion of a (simulated) flying drone in real time and compare the performances of different algorithms.

For the algorithms, we will be using the implementations provided in the OpenGV library (note: Open**G**V).

For the datasets, we will use pre-recorded `rosbag`

files of our simulated drone flying in an indoor environment.

Additionally, for motion estimation:

- We will only focus on two-view (vs multi-camera) pose estimation. In OpenGV, we refer to two-view problems as â€śCentralâ€ť (vs â€śNon-Centralâ€ť) relative pose problems.
- We will focus only on the calibrated case, where the intrinsics matrix K is given, and we assume that the images are rectified (distortion removed) using the parameters that you estimated previously.

## Getting started: code base and datasets

**Prerequisites**: Lab 6 will use the feature matching algorithms developed in Lab 5 (in particular, we use SIFT matching), so make sure you have a working version of Lab 5 already in the VNAV workspace.**Prepare the code base**: Use`git pull`

to update the git repo used to distribute lab codes https://github.com/MIT-SPARK/VNAV-labs, and you should see a new folder named`lab6`

. Copy the entire`lab6`

folder to the`src`

folder of your vnav workspace (e.g.,`~/vnav_ws/src`

). Now we are ready to install OpenGV by doing:`cd ~/vnav_ws/src (path to src of vnav workspace) wstool init wstool merge lab6/install/lab_6.rosinstall -y wstool update -j8`

The above scripts will download OpenGV into your workspace (you will see a folder

`opengv`

under`src`

). Now run:`catkin build lab_6`

to build the

`lab_6`

package (which should build OpenGV first and then build`lab_6`

itself).**Download the datasets**: We will use the following dataset for this lab:`office.bag`

and you can download it here.

After downloading the dataset, we suggest you to put them in the `~/data/vnav`

folder.

The rosbag files include the following topics of the drone:

- Ground-truth pose estimate of the droneâ€™s body frame:
`/tesse/odom`

- RGB image from the left-front camera of the drone:
`/tesse/left_cam/rgb/image_raw`

- Depth image:
`/tesse/depth_cam/mono/image_raw`

You can play these datasets by running (after using `roscore`

to start ROS master first):

```
rosbag play ~/data/vnav/office.bag
```

while in parallel open RVIZ by:

```
rviz -d ~/vnav_ws/src/lab6/rviz/office.rviz
```

You should see on the left the RGB Image and the Depth image.

## Letâ€™s perform motion estimation!

We will use two methods to estimate the motion of the drone:

- Motion estimation from 2D-2D correspondences (Deliverable 4)
- Motion estimation from 3D-3D correspondences (Deliverable 5)

In Deliverable 4, we will perform motion estimation **only** using 2D RGB images taken from the droneâ€™s camera, while in Deliverable 5, we will additionally use the depth measurements to get the sense of 3D.

**NOTE:**

- All your main implementations of the motion estimation algorithms should be in the
`pose_estimation.cpp`

file. In the file, we have also provided many comments to help your implementation, so please go through the comments in details. - For this lab, we provide a number of useful utility functions in
`lab6_utils.h`

. You do not need to use these functions to complete the assignment, but they might help save you some time and frustration.

## đź“¨ Deliverable 3 - Initial Setup [5 pts]

Before we go to motion estimation, an important task is to calibrate the camera of the drone, i.e., to obtain the camera intrinsics and distortion coefficients. Normally you would need to calibrate the camera yourself offline to obtain the parameters.

However, in this lab the camera that the drone is equipped with has been calibrated already, and calibration information is provided to you! (If you are curious about how to calibrate a camera, feel free to check this ROS package)

As part of the starter code, we provide a function `calibrateKeypoints`

to calibrate and undistort the keypoints. Make sure you use this function to calibrate the keypoints before passing them to RANSAC.

## đź“¨ Deliverable 4 - 2D-2D Correspondences [45 pts]

Given a set of keypoint correspondences in a pair of images (2D - 2D image correspondences), as computed in the previous lab 5, we can use 2-view (geometric verification) algorithms to estimate the relative pose (up to scale) from one viewpoint to another.

To do so, we will be using three different algorithms and comparing their performance.

We will first start with the 5-point algorithm of Nister. Then we will test the 8-point method we have seen in class. Finally, we will test the 2-point method you developed in Deliverable 2. For all techniques, we use the feature matching code we developed in Lab 5 (use the provided solution code for lab 5 if you prefer - download it here). In particular, we use SIFT for feature matching in the remaining of this problem set.

We provide you with a skeleton code in `lab6`

folder where we have set-up ROS callbacks to receive the necessary information.

We ask you to complete the code inside the following functions:

### 1. `cameraCallback`

: this is the main function for this lab.

Inside, you will have to use three different algorithms to estimate the relative pose from frame to frame:

- OpenGVâ€™s the 5-point algorithm with RANSAC (see OpenGV API)
- OpenGVâ€™s 8-point algorithm by Longuet-Higgins with RANSAC
- OpenGVâ€™s 2-point algorithm with RANSAC. This algorithm requires you to provide the relative rotation between pairs of frames. This is usually done by integrating the IMUâ€™s gyroscope measurements. Nevertheless, for this lab, we will ask you to compute the relative rotation using the ground-truth pose of the drone between both frames.

For each part, follow the comments written in the source code for further details.

**We strongly recommend you to take a look at how to use OpenGV functions here.**

**OPTIONAL (5 bonus pts)**: if you are curious about how important is to reject outliers via RANSAC, try to use the 5-point method without RANSAC (see OpenGV API), and add the results to the performance evaluation below.

### 2. `evaluateRPE`

: evaluating the relative pose estimates

After implementing the relative pose estimation methods, you are required to evaluate their accuracy and plot their errors over time. Since you also have the ground-truth pose of the drone, it is possible to compute the Relative Pose Error (RPE) between your estimated relative pose from frame to frame and the actual ground-truth movement. Follow the equations below and compute the translation and rotation relative errors on the rosbag we provided.

*The relative pose error is a metric for investigating the local consistency of a trajectory*

RPE compares the relative poses along the estimated and the reference trajectory. Given the ground truth pose $T^W_{ref,t}$ at time $t$ (with respect to the world frame $W$), we can compute the ground truth relative pose between time $t-1$ and $t$ as:

\[ T_{ref,t}^{ref,t-1} = \left(T^W_{ref,t-1}\right)^{-1} T^W_{ref,t} \in \SE{3} \]

Similarly, the 2-view geometry algorithms we test in this lab will provide an estimate for the relative pose between the frame at time $t-1$ and $t$:

\[ T^{est,t-1}_{est,t} \in \SE{3} \]

Therefore, we can compute the mismatch between the ground truth and the estimated relative poses using one of the distances we discussed during lecture.

*When using 2D-2D correspondences, the translation is only computed up to scale (and is conventionally returned as a vector with unit norm). so we recommend scaling the corresponding ground truth translation to have unit norm before computing the errors we describe below.*

**Relative translation error:** This is simply the Euclidean distance between the ground truth and the estimated relative translation:

\[ RPE_{t-1,t}^{tran} = \left\Vert \mathrm{trans}\left(T_{ref,t}^{ref,t-1}\right) - \mathrm{trans}\left(T^{est,t-1}_{est,t}\right) \right\Vert_2 \]

where $\mathrm{trans}(\cdot)$ denotes the translation part of a pose.

**Relative rotation error:** This is the chordal distance between the ground truth and the estimated relative rotation:

\[ RPE_{i,j}^{rot} = \left\Vert \mathrm{rot}\left(T_{ref,t}^{ref,t-1}\right) - \mathrm{rot}\left(T_{est,t}^{est,t-1}\right) \right\Vert_{F} \]

where $\mathrm{rot}(\cdot)$ denotes the rotation part of a pose.

You will need to implement these error metrics, compute them for **consecutive frames in the rosbag**, and plot them as discussed above.

As a deliverable, **provide 2 plots showing the rotation error and the translation error over time** for each of the tested techniques (2 plots with 3 lines for the algorithms using RANSAC). You can write the data to a file and do the plotting with Python if you prefer (upload as well the python script if necessary).

### 3. Publish your relative pose estimate

In order to visualize your relative pose estimate between time $t-1$ and $t$, we postmultiply your estimated relative pose between time $t-1$ and $t$ by the ground truth pose at time $t-1$. This will give you a pose estimate at time $t$ that you can visualize in Rviz. **To do so, we use the ground-truth pose of the previous frame (obtained from ROS messages), â€śplusâ€ť the relative pose between current frame and previous frame (obtained from your algorithms, and then scale the translation using ground-truth), to compute the estimated (absolute) pose of the current frame, and then publish it.**

To run your code, use:

```
roslaunch lab_6 video_tracking.launch
```

but be sure to modify the dataset path and parameters to run the correct method! For example, the `pose_estimator`

parameter determines which algorithm to be used for the motion estimation.

**Note that we are cheating in this visualization since we use the ground truth from the previous time stamp. In practice, we cannot concatenate multiple estimates from 2-view geometry since they are up to scale (so for visualization, we use groundtruth to recover the scale).**

In the next deliverable we will see that 3D-3D correspondences allow us to reconstruct the correct scale for the translation.**

## đź“¨ Deliverable 5 - 3D-3D Correspondences [20 pts]

The rosbag we provide you also contains depth values registered with the RGB camera, this means that each pixel location in the RGB camera has an associated depth value in the Depth image.

In this part, we have provided code to scale to bearing vectors to 3D point clouds, and what you need to do is to use Arunâ€™s algorithm (with RANSAC) to compute the droneâ€™s relative pose from frame to frame.

### 1. `cameraCallback`

: Implement Arunâ€™s algorithm

Implement Arunâ€™s algorithm in this function. Use the evaluateRPE function you used previously to **plot the rotation error and the translation error over time** as well. Mind that, in this case, there is no scale ambiguity, therefore we cannot really compare the translation error of this approach against the previous ones. Implement Arunâ€™s algorithm *with* RANSAC using OpenGV.

To run your code, use:

```
roslaunch lab_6 video_tracking.launch
```

with the `pose_estimator`

parameter set to `3`

so that Arunâ€™s method is used.

**Note that while we can now reconstruct the trajectory by concatenating the relative poses, such a trajectory estimate will quickly diverge due to error accumulation. In future lectures, we will study Visual-Odometry and Loop closure detection as two ways to mitigate the error accumulation.**

## Performance Expectations

What levels of rotation and translation errors should one expect from using these different algorithms? To set the correct expection, we think the following errors are satisfactory:

- Using 5-point or 8-pt with RANSAC, for most of the frames, you can get rotation error below 1 degree and translation error below 0.5 (note that the translation error is between 0 and 2 since both ground-truth translation and estimated translation have unit norm), with 5-pt algorithm slightly outperforming 8-pt algorithm.
- Using 2-point with RANSAC, for most of the frames, you can get the translation error below 0.1 (note that the translation error is between 0 and 2).
- Using 3-point with RANSAC (3D-3D), for most of the frames, you can get rotation error below 0.1 degree, and translation error below 0.1 (if you normalize the translations), and even smaller if you donâ€™t normalize the translations since the frame rate is very high.

## Summary of Team Deliverables

For the given dataset, we require you to run **all algorithms** on it and compare their performances. Therefore, as a summary for Team Deliverables:

- Plots of translation and rotation error for each of the methods (5pt, 8pt, 2pt, Arun 3 pt) using the given rosbag (using RANSAC is required, while without RANSAC is optional).
**OPTIONAL (10 bonus pts)**: repeat the tests using a rosbag you collect during drone racing (your Lab 4 solution). The rosbag must contain stereo RGB images, depth information, and odometry, which are not published by tesse_ros_bridge by default. So, in order to collect a suitable rosbag, you must follow these steps:- Download the updated simulator and run it with these command line arguments:
`-screen-width 720 -screen-height 480`

- Launch the tesse ros bridge with these arguments:
`roslaunch tesse_ros_bridge tesse_quadrotor_bridge.launch publish_stereo_rgb:=true publish_depth:=true publish_odom:=true`

- Collect the rosbag of your trajectory as before (e.g. by launching the appropriate nodes and running
`rosbag record -a`

in another window) - If you experience any errors while following the above steps, please check Piazza and make a new post if your question is not already answered.
**Important:**If you run into an error that you are unable to fix yourself after checking Piazza, you can still receive full bonus points through submitting a**complete and detailed**bug report on Piazza which clearly explains the commands you used and any error messages or unexpected behaviour that occurred, as well as describing attempts youâ€™ve made to understand/fix the bug. Please copy and paste this report into your team writeup to ensure you get the bonus.

- Download the updated simulator and run it with these command line arguments: