Main Content

Estimate 2-D geometric transformation from matching point pairs

estimates a 2-D geometric transformation between two images by mapping the
inliers in the matched points from one image `tform`

= estimateGeometricTransform2D(`matchedPoints1`

,`matchedPoints2`

,`transformType`

)`matchedPoints1`

to the inliers in the matched points from another image
`matchedPoints2`

.

`[`

additionally returns a vector specifying each matched point pair as either an
inlier or an outlier using the input arguments from the previous syntax.`tform`

,`inlierIndex`

]
= estimateGeometricTransform2D(___)

`[`

additionally returns a status code indicating whether or not the function could
estimate a transformation and, if not, why it failed. If you do not specify the
`tform`

,`inlierIndex`

,`status`

] = estimateGeometricTransform2D(___)`status`

output, the function instead returns an error
for conditions that cannot produce results.

`[___] = estimateGeometricTransform2D(___, `

specifies additional options using one or more name-value pair arguments in
addition to any combination of arguments from previous syntaxes. For example,
`Name,Value`

)`'Confidence',99`

sets the confidence value for finding the
maximum number of inliers to `99`

.

The function excludes outliers using the M-estimator sample consensus (MSAC) algorithm. The MSAC algorithm is a variant of the random sample consensus (RANSAC) algorithm. Results may not be identical between runs due to the randomized nature of the MSAC algorithm.

[1] Hartley, Richard, and Andrew Zisserman. *Multiple View
Geometry in Computer Vision*. 2nd ed. Cambridge, UK ; New York: Cambridge
University Press, 2003.

[2] Torr, P.H.S., and A. Zisserman. “MLESAC: A New Robust Estimator with
Application to Estimating Image Geometry.” *Computer Vision and
Image Understanding* 78, no. 1 (April 2000): 138–56.
https://doi.org/10.1006/cviu.1999.0832.

`detectFASTFeatures`

|`detectMinEigenFeatures`

|`detectMSERFeatures`

|`detectORBFeatures`

|`detectSURFFeatures`

|`estimateFundamentalMatrix`

|`estimateGeometricTransform3D`

|`extractFeatures`

|`fitgeotrans`

|`matchFeatures`

|`rgb2gray`