System object: vision.GeometricTransformEstimator
Package: vision

Calculate transformation matrix mapping largest number of valid points from input arrays


[TFORM,INLIER_INDEX] = step(H, ...)


TFORM = step(H,MATCHED_POINTS1, MATCHED_POINTS2) calculates the transformation matrix, TFORM. The input arrays, MATCHED_POINTS1 and MATCHED_POINTS2 specify the locations of matching points in two images. The points in the arrays are stored as a set of [x1 y1; x2 y2; ...; xN yN ] coordinates, where N is the number of points. When you set the Transform property to Projective, the step method outputs TFORM as a 3-by-3 matrix. Otherwise, the step method outputs TFORM as a 3-by-2 matrix.

[TFORM,INLIER_INDEX] = step(H, ...) additionally outputs the logical vector, INLIER_INDEX, indicating which points are the inliers.

    Note:   H specifies the System object™ on which to run this step method.

    The object performs an initialization the first time the step method is executed. This initialization locks nontunable properties and input specifications, such as dimensions, complexity, and data type of the input data. If you change a nontunable property or an input specification, the System object issues an error. To change nontunable properties or inputs, you must first call the release method to unlock the object.

Was this topic helpful?