Click or drag to resize

Cv2EstimateAffine2D Method

Computes an optimal affine transformation between two 2D point sets.

Namespace:  OpenCvSharp
Assembly:  OpenCvSharp (in OpenCvSharp.dll) Version: 1.0.0
Syntax
public static Mat EstimateAffine2D(
	InputArray from,
	InputArray to,
	OutputArray inliers = null,
	RobustEstimationAlgorithms method = RobustEstimationAlgorithms.RANSAC,
	double ransacReprojThreshold = 3,
	ulong maxIters = 2000,
	double confidence = 0.99,
	ulong refineIters = 10
)

Parameters

from
Type: OpenCvSharpInputArray
First input 2D point set containing (X,Y).
to
Type: OpenCvSharpInputArray
Second input 2D point set containing (x,y).
inliers (Optional)
Type: OpenCvSharpOutputArray
Output vector indicating which points are inliers (1-inlier, 0-outlier).
method (Optional)
Type: OpenCvSharpRobustEstimationAlgorithms
Robust method used to compute transformation.
ransacReprojThreshold (Optional)
Type: SystemDouble
Maximum reprojection error in the RANSAC algorithm to consider a point as an inlier.Applies only to RANSAC.
maxIters (Optional)
Type: SystemUInt64
The maximum number of robust method iterations.
confidence (Optional)
Type: SystemDouble
Confidence level, between 0 and 1, for the estimated transformation. Anything between 0.95 and 0.99 is usually good enough.Values too close to 1 can slow down the estimation significantly.Values lower than 0.8-0.9 can result in an incorrectly estimated transformation.
refineIters (Optional)
Type: SystemUInt64
Maximum number of iterations of refining algorithm (Levenberg-Marquardt). Passing 0 will disable refining, so the output matrix will be output of robust method.

Return Value

Type: Mat
Output 2D affine transformation matrix \f$2 \times 3\f$ or empty matrix if transformation could not be estimated.
See Also