### Navigation

- index
- next |
- previous |
- OpenCV 3.0.0-dev documentation »
- OpenCV Tutorials »
- calib3d module. Camera calibration and 3D reconstruction »

# Camera calibration with square chessboard

The goal of this tutorial is to learn how to calibrate a camera given a set of chessboard images.

Test data: use images in your data/chess folder.

1. Compile opencv with samples by setting `BUILD_EXAMPLES` to `ON` in cmake configuration.
2. Go to `bin` folder and use `imagelist_creator` to create an `XML/YAML` list of your images.
3. Then, run `calibration` sample to get camera parameters. Use square size equal to 3cm.

## Pose estimation

Now, let us write a code that detects a chessboard in a new image and finds its distance from the camera. You can apply the same method to any object with known 3D geometry that you can detect in an image.

Test data: use chess_test*.jpg images from your data folder.

1. Create an empty console project. Load a test image:

       Mat img = imread(argv[1], IMREAD_GRAYSCALE);

2. Detect a chessboard in this image using findChessboard function.

       bool found = findChessboardCorners( img, boardSize, ptvec, CALIB_CB_ADAPTIVE_THRESH );

3. Now, write a function that generates a `vector<Point3f>` array of 3d coordinates of a chessboard in any coordinate system. For simplicity, let us choose a system such that one of the chessboard corners is in the origin and the board is in the plane z = 0.

4. Read camera parameters from XML/YAML file:

       FileStorage fs(filename, FileStorage::READ);
       Mat intrinsics, distortion;
       fs["camera_matrix"] >> intrinsics;
       fs["distortion_coefficients"] >> distortion;

5. Now we are ready to find chessboard pose by running `solvePnP`:

       vector<Point3f> boardPoints;
       // fill the array
       ...

       solvePnP(Mat(boardPoints), Mat(foundBoardCorners), cameraMatrix,
                            distCoeffs, rvec, tvec, false);

6. Calculate reprojection error like it is done in `calibration` sample (see `opencv/samples/cpp/calibration.cpp`, function `computeReprojectionErrors`).

Question: how to calculate the distance from the camera origin to any of the corners?

## Help and Feedback

You did not find what you were looking for?

- Ask a question on the Q&A forum.
- If you think something is missing or wrong in the documentation, please file a bug report.

### Navigation

- index
- next |
- previous |
- OpenCV 3.0.0-dev documentation »
- OpenCV Tutorials »
- calib3d module. Camera calibration and 3D reconstruction »