OpenCV  3.0.0
Open Source Computer Vision
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
Pose Estimation

Goal

In this section,

Basics

This is going to be a small section. During the last session on camera calibration, you have found the camera matrix, distortion coefficients etc. Given a pattern image, we can utilize the above information to calculate its pose, or how the object is situated in space, like how it is rotated, how it is displaced etc. For a planar object, we can assume Z=0, such that, the problem now becomes how camera is placed in space to see our pattern image. So, if we know how the object lies in the space, we can draw some 2D diagrams in it to simulate the 3D effect. Let's see how to do it.

Our problem is, we want to draw our 3D coordinate axis (X, Y, Z axes) on our chessboard's first corner. X axis in blue color, Y axis in green color and Z axis in red color. So in-effect, Z axis should feel like it is perpendicular to our chessboard plane.

First, let's load the camera matrix and distortion coefficients from the previous calibration result.

1 import cv2
2 import numpy as np
3 import glob
4 
5 # Load previously saved data
6 with np.load('B.npz') as X:
7  mtx, dist, _, _ = [X[i] for i in ('mtx','dist','rvecs','tvecs')]

Now let's create a function, draw which takes the corners in the chessboard (obtained using cv2.findChessboardCorners()) and axis points to draw a 3D axis.

1 def draw(img, corners, imgpts):
2  corner = tuple(corners[0].ravel())
3  img = cv2.line(img, corner, tuple(imgpts[0].ravel()), (255,0,0), 5)
4  img = cv2.line(img, corner, tuple(imgpts[1].ravel()), (0,255,0), 5)
5  img = cv2.line(img, corner, tuple(imgpts[2].ravel()), (0,0,255), 5)
6  return img

Then as in previous case, we create termination criteria, object points (3D points of corners in chessboard) and axis points. Axis points are points in 3D space for drawing the axis. We draw axis of length 3 (units will be in terms of chess square size since we calibrated based on that size). So our X axis is drawn from (0,0,0) to (3,0,0), so for Y axis. For Z axis, it is drawn from (0,0,0) to (0,0,-3). Negative denotes it is drawn towards the camera.

1 criteria = (cv2.TERM_CRITERIA_EPS + cv2.TERM_CRITERIA_MAX_ITER, 30, 0.001)
2 objp = np.zeros((6*7,3), np.float32)
3 objp[:,:2] = np.mgrid[0:7,0:6].T.reshape(-1,2)
4 
5 axis = np.float32([[3,0,0], [0,3,0], [0,0,-3]]).reshape(-1,3)

Now, as usual, we load each image. Search for 7x6 grid. If found, we refine it with subcorner pixels. Then to calculate the rotation and translation, we use the function, cv2.solvePnPRansac(). Once we those transformation matrices, we use them to project our axis points to the image plane. In simple words, we find the points on image plane corresponding to each of (3,0,0),(0,3,0),(0,0,3) in 3D space. Once we get them, we draw lines from the first corner to each of these points using our draw() function. Done !!!

1 for fname in glob.glob('left*.jpg'):
2  img = cv2.imread(fname)
3  gray = cv2.cvtColor(img,cv2.COLOR_BGR2GRAY)
4  ret, corners = cv2.findChessboardCorners(gray, (7,6),None)
5 
6  if ret == True:
7  corners2 = cv2.cornerSubPix(gray,corners,(11,11),(-1,-1),criteria)
8 
9  # Find the rotation and translation vectors.
10  rvecs, tvecs, inliers = cv2.solvePnPRansac(objp, corners2, mtx, dist)
11 
12  # project 3D points to image plane
13  imgpts, jac = cv2.projectPoints(axis, rvecs, tvecs, mtx, dist)
14 
15  img = draw(img,corners2,imgpts)
16  cv2.imshow('img',img)
17  k = cv2.waitKey(0) & 0xff
18  if k == 's':
19  cv2.imwrite(fname[:6]+'.png', img)
20 
21 cv2.destroyAllWindows()

See some results below. Notice that each axis is 3 squares long.:

pose_1.jpg
image

Render a Cube

If you want to draw a cube, modify the draw() function and axis points as follows.

Modified draw() function:

1 def draw(img, corners, imgpts):
2  imgpts = np.int32(imgpts).reshape(-1,2)
3 
4  # draw ground floor in green
5  img = cv2.drawContours(img, [imgpts[:4]],-1,(0,255,0),-3)
6 
7  # draw pillars in blue color
8  for i,j in zip(range(4),range(4,8)):
9  img = cv2.line(img, tuple(imgpts[i]), tuple(imgpts[j]),(255),3)
10 
11  # draw top layer in red color
12  img = cv2.drawContours(img, [imgpts[4:]],-1,(0,0,255),3)
13 
14  return img

Modified axis points. They are the 8 corners of a cube in 3D space:

1 axis = np.float32([[0,0,0], [0,3,0], [3,3,0], [3,0,0],
2  [0,0,-3],[0,3,-3],[3,3,-3],[3,0,-3] ])

And look at the result below:

pose_2.jpg
image

If you are interested in graphics, augmented reality etc, you can use OpenGL to render more complicated figures.

Additional Resources

Exercises