On the Calibration tab, in the File section, click Add Images, and then select From file. You can add images from multiple folders by clicking Add images for each folder. Enter the location for the images corresponding to camera 1, or select it using the Browse button, and then do the same for camera 2. Specify the calibration pattern by selecting one from the Choose Pattern list, or, in the Custom Pattern section, select Import Pattern Detector. In the Properties section, specify the properties for your detector, and then select OK to add your images.

The calibrator attempts to detect a pattern in each of the added stereo pairs, displaying a progress bar window, indicating detection progress. If any of the images are rejected, the Detection Results dialog box appears, which contains diagnostic information. The results indicate how many total images were processed, and of those processed, how many were accepted, rejected, or skipped. The calibrator skips duplicate images.

To view the rejected images, click View images. The calibrator rejects duplicate images. It also rejects images where the entire pattern could not be detected. Possible reasons for no detection are a blurry image or an extreme angle of the pattern. Detection takes longer with larger images and with patterns that contain a large number of squares.

The Data Browser pane displays a list of image pairs with IDs. These image pairs contain a detected pattern. To view an image, select it from the Data Browser pane.

The Image pane displays the selected image pair with green circles to indicate detected points. You can verify that the corners were detected correctly using the zoom controls. The yellow square indicates the (0,0) origin. The X and Y arrows indicate the pattern axes orientation.

You can choose for the app to compute camera intrinsics, or you can load precomputed, fixed intrinsics. To load intrinsics into the app, on the Calibration tab, in the Intrinsics section, select Use Fixed Intrinsics. The Radial Distortion and Compute options in the Options section are disabled when you load intrinsics.

To load intrinsics as variables from your workspace, select Load Intrinsics. For example, if the wideBaselineStereo structure contains the intrinsics for both cameras, enter this code at the MATLAB command prompt.

ld = load("wideBaselineStereo");
int1 = ld.intrinsics1
int2 = ld.intrinsics2

When the camera has severe lens distortion, the app can fail to compute the initial values for the camera intrinsics. If you have the manufacturer specifications for your camera and know the pixel size, focal length, or lens characteristics, you can manually set initial guesses for the camera intrinsics and radial distortion. To set initial guesses, select Options > Optimization Options.

For more details on calibration parameters, see What Is Camera Calibration?.

The reprojection errors are the distances, in pixels, between the detected and the reprojected points. The Stereo Camera Calibrator app calculates reprojection errors by projecting points from world coordinates, defined by the pattern, into image coordinates. The app then compares the reprojected points to the corresponding detected points. As a general rule, mean reprojection errors of less than one pixel are acceptable.

The Stereo Calibration App displays, in pixels, the reprojection errors as a bar graph. The graph helps you to identify which images that adversely contribute to the calibration. Select the bar graph entry and remove the image from the list of images in the Data Browser pane.

Reprojection Errors Bar Graph
The bar graph displays the mean reprojection error per image, along with the overall mean error. The bar labels correspond to the image pair IDs. The highlighted bars correspond to the selected image pair.

Select an image pair in one of these ways:

The 3-D extrinsic parameters plot provides a camera-centric view of the patterns and a pattern-centric view of the camera. The camera-centric view is helpful if the camera was stationary when the images were captured. The pattern-centric view is helpful if the pattern was stationary. You can click the cursor and hold down the mouse button with the rotate icon to rotate the figure. Click a pattern (or the camera) in the display to select it. The highlighted data in the visualizations correspond to the selected image pair in the list. Examine the relative positions of the pattern and the camera to determine if they match what you expect. For example, a pattern that appears behind the camera indicates a calibration error.

To view the effects of stereo rectification, on the Calibration tab, in the View section, select Show Rectified. If the calibration is accurate, the images become undistorted and row-aligned.

You can specify two or three radial distortion coefficients by selecting the corresponding option from the Options section. Radial distortion occurs when light rays bend more near the edges of a lens than they do at its optical center. The smaller the lens, the greater the distortion.

The radial distortion coefficients model this type of distortion. The distorted points are denoted as (x_distorted, y_distorted):

Typically, two coefficients are sufficient for calibration. For severe distortion, such as in wide-angle lenses, you can select three coefficients to include k₃.

To estimate the skew of the image axes, on the Calibration tab, in the Camera Model section, select Options > Compute > Skew. Some camera sensors contain imperfections that cause the x- and y-axes of the image to not be perpendicular. You can model this defect using a skew parameter. If you do not select this option, the image axes are perpendicular, which is true for most modern cameras.

Tangential distortion occurs when the lens and the image plane are not parallel. The tangential distortion coefficients model this type of distortion.

The distorted points are denoted as (x_distorted, y_distorted):

When you select the Compute Tangential Distortion check box, the calibrator estimates the tangential distortion coefficients. Otherwise, the calibrator sets the tangential distortion coefficients to zero.

Select Export Camera Parameters > Export Parameters to Workspace to create a stereoParameters object in your workspace. The object contains the intrinsic and extrinsic parameters of the camera and its distortion coefficients. You can use this object for various computer vision tasks, such as image undistortion, measuring planar objects, and 3-D reconstruction. For more information on measuring planar objects, see Measuring Planar Objects with a Calibrated Camera. You can optionally export the stereoCalibrationErrors object, which contains the standard errors of estimated stereo camera parameters, by selecting Export estimation errors.

Select Export Camera Parameters > Generate MATLAB script to save your camera parameters to a MATLAB script, enabling you to reproduce the steps from your calibration session.