# Reconstruction in OpenCV

In this tutorial, we will use OpenCV’s built-in functions to perform 3D reconstruction from two images. We’ll be using Python for our examples.

Updated March 25, 2023

Today’s sponsor is Depot. Depot is a remote container build service that’s half the cost of GitHub Actions runners and up to 40x faster than other build services. Try it for free.

Welcome to this comprehensive tutorial on 3D reconstruction using OpenCV! This tutorial is perfect for computer vision enthusiasts, developers, and researchers looking to dive into the world of 3D reconstruction. Let’s get started!

## What is 3D Reconstruction?

3D reconstruction is the process of capturing the shape and appearance of real-world objects using a series of 2D images. The reconstructed 3D models can be used in various applications, such as virtual reality, video games, and computer-aided design (CAD). The main steps involved in 3D reconstruction are:

**Camera calibration**: Estimating the intrinsic and extrinsic parameters of the camera(s).**Feature detection and matching**: Identifying and matching unique features (e.g., corners, edges) across multiple images.**Triangulation**: Estimating the 3D coordinates of the matched features using their 2D positions in the images.**Dense reconstruction**: Estimating the depth for every pixel in the image, resulting in a dense point cloud or a 3D mesh.

## How to Perform 3D Reconstruction with OpenCV: A Step-by-Step Guide

In this tutorial, we will use OpenCV’s built-in functions to perform 3D reconstruction from two images. We’ll be using Python for our examples, but you can also use the OpenCV C++ API.

### Step 1: Install OpenCV and Other Dependencies

First, let’s install OpenCV and other required libraries:

```
pip install opencv-python opencv-python-headless numpy
```

### Step 2: Load Input Images and Camera Parameters

Let’s start by loading the input images and the camera parameters (intrinsic and extrinsic) using OpenCV:

```
import cv2
import numpy as np
img1 = cv2.imread('path/to/image1.jpg')
img2 = cv2.imread('path/to/image2.jpg')
K = np.array([[fx, 0, cx], [0, fy, cy], [0, 0, 1]]) # Camera intrinsic matrix
```

Replace fx, fy, cx, and cy with the focal length and principal point of your camera. You can obtain these values through camera calibration.

### Step 3: Feature Detection and Matching

Now, let’s detect and match features across the input images using OpenCV’s ORB feature detector and BFMatcher:

```
orb = cv2.ORB_create()
bf = cv2.BFMatcher(cv2.NORM_HAMMING, crossCheck=True)
kp1, des1 = orb.detectAndCompute(img1, None)
kp2, des2 = orb.detectAndCompute(img2, None)
matches = bf.match(des1, des2)
matches = sorted(matches, key=lambda x: x.distance)
```

### Step 4: Estimate the Essential Matrix

With the matched features, we can now estimate the essential matrix E and the relative camera pose (rotation R and translation t) using OpenCV’s findEssentialMat() and recoverPose() functions:

```
pts1 = np.float32([kp1[m.queryIdx].pt for m in matches]).reshape(-1, 1, 2)
pts2 = np.float32([kp2[m.trainIdx].pt for m in matches]).reshape(-1, 1, 2)
E, mask = cv2.findEssentialMat(pts1, pts2, K, method=cv2.RANSAC, prob=0.999, threshold=1.0)
_, R, t, _ = cv2.recoverPose(E, pts1, pts2, K, mask=mask)
```

In this step, we first convert the matched keypoints into numpy arrays (`pts1`

and `pts2`

) and then estimate the essential matrix `E`

using the `findEssentialMat()`

function. The function employs the RANSAC algorithm to handle outliers and requires the camera’s intrinsic matrix `K`

. The `prob`

parameter denotes the desired probability of finding the correct essential matrix, while the `threshold`

parameter represents the maximum allowed reprojection error.

After obtaining the essential matrix, we recover the relative camera pose (rotation `R`

and translation `t`

) using the `recoverPose()`

function. The function takes the essential matrix `E`

, the matched points `pts1`

and `pts2`

, and the camera’s intrinsic matrix `K`

. The mask parameter is used to filter out the outliers from the matches based on the essential matrix estimation.

### Step 5: Triangulate 3D Points

Now that we have the relative camera pose, we can triangulate the 3D coordinates of the matched features using OpenCV’s `triangulatePoints()`

function:

```
# Build the projection matrices for the two cameras
P1 = np.hstack((np.eye(3), np.zeros((3, 1))))
P2 = np.hstack((R, t))
# Convert the projection matrices to the camera coordinate system
P1 = K @ P1
P2 = K @ P2
# Triangulate the 3D points
points_4D = cv2.triangulatePoints(P1, P2, pts1, pts2)
points_3D = points_4D / points_4D[3] # Convert from homogeneous to Cartesian coordinates
points_3D = points_3D[:3, :].T
```

### Step 6: Visualize the 3D Reconstruction

To visualize the resulting 3D point cloud, we can use a library like Matplotlib or Open3D. In this example, we’ll use Matplotlib:

```
pip install matplotlib
python
Copy code
import matplotlib.pyplot as plt
fig = plt.figure()
ax = fig.add_subplot(111, projection='3d')
# Plot the 3D points
ax.scatter(points_3D[:, 0], points_3D[:, 1], points_3D[:, 2], marker='o', s=5, c='r', alpha=0.5)
# Configure the plot
ax.set_xlabel('X')
ax.set_ylabel('Y')
ax.set_zlabel('Z')
plt.show()
```

And there you have it! You’ve successfully performed 3D reconstruction using OpenCV. By understanding the underlying theory and leveraging OpenCV’s powerful built-in functions, you can now create detailed 3D models from a series of 2D images. Keep exploring the fascinating world of computer vision and enjoy bringing real-world objects to life in the digital realm! Happy coding!