Skip to content

vector_to_fundamental_matrix_distortionvector_to_fundamental_matrix_distortionVectorToFundamentalMatrixDistortionVectorToFundamentalMatrixDistortionvector_to_fundamental_matrix_distortionT_vector_to_fundamental_matrix_distortionπŸ”—

Short descriptionπŸ”—

vector_to_fundamental_matrix_distortionvector_to_fundamental_matrix_distortionVectorToFundamentalMatrixDistortionVectorToFundamentalMatrixDistortionvector_to_fundamental_matrix_distortionT_vector_to_fundamental_matrix_distortion β€” Compute the fundamental matrix and the radial distortion coefficient given a set of image point correspondences and reconstruct 3D points.

SignatureπŸ”—

vector_to_fundamental_matrix_distortion( point.y Rows1, point.x Cols1, point.y Rows2, point.x Cols2, number CovRR1, number CovRC1, number CovCC1, number CovRR2, number CovRC2, number CovCC2, integer ImageWidth, integer ImageHeight, string Method, out hom_mat2d FMatrix, out real Kappa, out real Error, out real X, out real Y, out real Z, out real W )vector_to_fundamental_matrix_distortion( : : Rows1, Cols1, Rows2, Cols2, CovRR1, CovRC1, CovCC1, CovRR2, CovRC2, CovCC2, ImageWidth, ImageHeight, Method : FMatrix, Kappa, Error, X, Y, Z, W )void VectorToFundamentalMatrixDistortion( const HTuple& Rows1, const HTuple& Cols1, const HTuple& Rows2, const HTuple& Cols2, const HTuple& CovRR1, const HTuple& CovRC1, const HTuple& CovCC1, const HTuple& CovRR2, const HTuple& CovRC2, const HTuple& CovCC2, const HTuple& ImageWidth, const HTuple& ImageHeight, const HTuple& Method, HTuple* FMatrix, HTuple* Kappa, HTuple* Error, HTuple* X, HTuple* Y, HTuple* Z, HTuple* W )static void HOperatorSet.VectorToFundamentalMatrixDistortion( HTuple rows1, HTuple cols1, HTuple rows2, HTuple cols2, HTuple covRR1, HTuple covRC1, HTuple covCC1, HTuple covRR2, HTuple covRC2, HTuple covCC2, HTuple imageWidth, HTuple imageHeight, HTuple method, out HTuple FMatrix, out HTuple kappa, out HTuple error, out HTuple x, out HTuple y, out HTuple z, out HTuple w )def vector_to_fundamental_matrix_distortion( rows_1: Sequence[Union[float, int]], cols_1: Sequence[Union[float, int]], rows_2: Sequence[Union[float, int]], cols_2: Sequence[Union[float, int]], cov_rr1: Sequence[Union[float, int]], cov_rc1: Sequence[Union[float, int]], cov_cc1: Sequence[Union[float, int]], cov_rr2: Sequence[Union[float, int]], cov_rc2: Sequence[Union[float, int]], cov_cc2: Sequence[Union[float, int]], image_width: int, image_height: int, method: str ) -> Tuple[Sequence[float], float, float, Sequence[float], Sequence[float], Sequence[float], Sequence[float]]

Herror T_vector_to_fundamental_matrix_distortion( const Htuple Rows1, const Htuple Cols1, const Htuple Rows2, const Htuple Cols2, const Htuple CovRR1, const Htuple CovRC1, const Htuple CovCC1, const Htuple CovRR2, const Htuple CovRC2, const Htuple CovCC2, const Htuple ImageWidth, const Htuple ImageHeight, const Htuple Method, Htuple* FMatrix, Htuple* Kappa, Htuple* Error, Htuple* X, Htuple* Y, Htuple* Z, Htuple* W )

double HHomMat2D::VectorToFundamentalMatrixDistortion( const HTuple& Rows1, const HTuple& Cols1, const HTuple& Rows2, const HTuple& Cols2, const HTuple& CovRR1, const HTuple& CovRC1, const HTuple& CovCC1, const HTuple& CovRR2, const HTuple& CovRC2, const HTuple& CovCC2, Hlong ImageWidth, Hlong ImageHeight, const HString& Method, double* Error, HTuple* X, HTuple* Y, HTuple* Z, HTuple* W )

double HHomMat2D::VectorToFundamentalMatrixDistortion( const HTuple& Rows1, const HTuple& Cols1, const HTuple& Rows2, const HTuple& Cols2, const HTuple& CovRR1, const HTuple& CovRC1, const HTuple& CovCC1, const HTuple& CovRR2, const HTuple& CovRC2, const HTuple& CovCC2, Hlong ImageWidth, Hlong ImageHeight, const char* Method, double* Error, HTuple* X, HTuple* Y, HTuple* Z, HTuple* W )

double HHomMat2D::VectorToFundamentalMatrixDistortion( const HTuple& Rows1, const HTuple& Cols1, const HTuple& Rows2, const HTuple& Cols2, const HTuple& CovRR1, const HTuple& CovRC1, const HTuple& CovCC1, const HTuple& CovRR2, const HTuple& CovRC2, const HTuple& CovCC2, Hlong ImageWidth, Hlong ImageHeight, const wchar_t* Method, double* Error, HTuple* X, HTuple* Y, HTuple* Z, HTuple* W ) (Windows only)

double HHomMat2D.VectorToFundamentalMatrixDistortion( HTuple rows1, HTuple cols1, HTuple rows2, HTuple cols2, HTuple covRR1, HTuple covRC1, HTuple covCC1, HTuple covRR2, HTuple covRC2, HTuple covCC2, int imageWidth, int imageHeight, string method, out double error, out HTuple x, out HTuple y, out HTuple z, out HTuple w )

DescriptionπŸ”—

For a stereo configuration with unknown camera parameters, the geometric relation between the two images is defined by the fundamental matrix. vector_to_fundamental_matrix_distortionVectorToFundamentalMatrixDistortion determines the fundamental matrix FMatrixFMatrixfmatrix and the radial distortion coefficient Kappakappakappa\(\kappa\)) from given point correspondences (Rows1rows1rows_1,Cols1cols1cols_1), (Rows2rows2rows_2,Cols2cols2cols_2) that fulfill the epipolar constraint:

\[\begin{eqnarray*} \left(\begin{array}{c} c_{2} \\ r_{2} \\ 1 \end{array} \right)^T \cdot \textrm{FMatrix} \cdot \left(\begin{array}{c} c_{1} \\ r_{1} \\ 1 \end{array} \right) = 0 \enspace . \end{eqnarray*}\]

Here, \((r_{1},c_{1})\) and \((r_{2},c_{2})\) denote image points that are obtained by undistorting the input image points with the division model (see Calibration):

\[\begin{eqnarray*} r = \frac{\tilde{r}}{1+\kappa (\tilde{r}^{2}+\tilde{c}^{2})} \qquad c = \frac{\tilde{c}}{1+\kappa (\tilde{r}^{2}+\tilde{c}^{2})} \end{eqnarray*}\]

Here,

\[\begin{eqnarray*}(\tilde{r}_{1},\tilde{c}_{1}) = (\textrm{Rows1}-0.5(\textrm{ImageHeight}-1), \textrm{Cols1}-0.5(\textrm{ImageWidth}-1))\end{eqnarray*}\]

and

\[\begin{eqnarray*}(\tilde{r}_{2},\tilde{c}_{2}) = (\textrm{Rows2}-0.5(\textrm{ImageHeight}-1), \textrm{Cols2}-0.5(\textrm{ImageWidth}-1))\end{eqnarray*}\]

denote the distorted image points, specified relative to the image center. Thus, vector_to_fundamental_matrix_distortionVectorToFundamentalMatrixDistortion assumes that the principal point of the camera, i.e., the center of the radial distortions, lies at the center of the image.

The returned Kappakappakappa can be used to construct camera parameters that can be used to rectify images or points (see change_radial_distortion_cam_parChangeRadialDistortionCamPar, change_radial_distortion_imageChangeRadialDistortionImage, and change_radial_distortion_pointsChangeRadialDistortionPoints):

\[\begin{eqnarray*} \texttt{CamPar} & = & ['\textit{area\_scan\_telecentric\_division}', 0.0, \textrm{Kappa}, 1.0, 1.0, 0.5(\textrm{ImageWidth}-1),\\ & &0.5(\textrm{ImageHeight}-1), \textrm{ImageWidth},\textrm{ImageHeight}] \end{eqnarray*}\]

Note the column/row ordering in the point coordinates above: since the fundamental matrix encodes the projective relation between two stereo images embedded in 3D space, the x/y notation must be compliant with the camera coordinate system. Therefore, (x,y) coordinates correspond to (column,row) pairs.

For a general relative orientation of the two cameras, the minimum number of required point correspondences is nine. Then, Methodmethodmethod must be set to 'linear'"linear" or 'gold_standard'"gold_standard". If the left and right cameras are identical and the relative orientation between them is a pure translation, Methodmethodmethod must be set to 'trans_linear'"trans_linear" or 'trans_gold_standard'"trans_gold_standard". In this special case, the minimum number of correspondences is only four. The typical application of the motion being a pure translation is a single fixed camera looking onto a moving conveyor belt.

The fundamental matrix is determined by minimizing a cost function. To minimize the respective error, different algorithms are available, and the user can choose between the linear ('linear'"linear") and the gold-standard algorithm ('gold_standard'"gold_standard"). Like the motion type, the algorithm can be selected with the parameter Methodmethodmethod. For Methodmethodmethod = 'linear'"linear" or 'trans_linear'"trans_linear", a linear algorithm that minimizes an algebraic error based on the above epipolar constraint is used. This algorithm is very fast. For the pure translation case (Methodmethodmethod \(=\) 'trans_linear'"trans_linear"), the linear method returns accurate results for small to moderate noise of the point coordinates and for most distortions (except for very small distortions). For a general relative orientation of the two cameras (Methodmethodmethod \(=\) 'linear'"linear"), the linear method only returns accurate results for very small noise of the point coordinates and for sufficiently large distortions. For Methodmethodmethod = 'gold_standard'"gold_standard" or 'trans_gold_standard'"trans_gold_standard", a mathematically optimal but slower optimization is used, which minimizes the geometric reprojection error of reconstructed projective 3D points. In this case, in addition to the fundamental matrix and the distortion coefficient, the projective coordinates (Xxx,Yyy,Zzz,Www) of the reconstructed points are returned. For a general relative orientation of the two cameras, in general Methodmethodmethod \(=\) 'gold_standard'"gold_standard" should be selected.

If an optimal gold-standard algorithm is chosen, the covariances of the image points (CovRR1covRR1cov_rr1, CovRC1covRC1cov_rc1, CovCC1covCC1cov_cc1, CovRR2covRR2cov_rr2, CovRC2covRC2cov_rc2, CovCC2covCC2cov_cc2) can be incorporated into the computation. They can be provided, for example, by the operator points_foerstnerPointsFoerstner. If the point covariances are unknown, which is the default, empty tuples are passed. In this case, the optimization algorithm internally assumes uniform and equal covariances for all points.

The value Errorerrorerror indicates the overall quality of the optimization procedure and is the mean symmetric Euclidean distance in pixels between the points and their corresponding epipolar lines.

If the correspondence between the points is not known, match_fundamental_matrix_distortion_ransacMatchFundamentalMatrixDistortionRansac should be used instead.

Execution informationπŸ”—

Execution information
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Processed without parallelization.

ParametersπŸ”—

Rows1rows1rows_1 (input_control) point.y-array β†’ (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)Sequence[Union[float, int]]Htuple (double / Hlong)

Input points in image 1 (row coordinate).

Restriction: length(Rows1) >= 9 || length(Rows1) >= 4

Cols1cols1cols_1 (input_control) point.x-array β†’ (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)Sequence[Union[float, int]]Htuple (double / Hlong)

Input points in image 1 (column coordinate).

Restriction: length(Cols1) == length(Rows1)

Rows2rows2rows_2 (input_control) point.y-array β†’ (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)Sequence[Union[float, int]]Htuple (double / Hlong)

Input points in image 2 (row coordinate).

Restriction: length(Rows2) == length(Rows1)

Cols2cols2cols_2 (input_control) point.x-array β†’ (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)Sequence[Union[float, int]]Htuple (double / Hlong)

Input points in image 2 (column coordinate).

Restriction: length(Cols2) == length(Rows1)

CovRR1covRR1cov_rr1 (input_control) number-array β†’ (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)Sequence[Union[float, int]]Htuple (double / Hlong)

Row coordinate variance of the points in image 1.

Default: [][]

CovRC1covRC1cov_rc1 (input_control) number-array β†’ (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)Sequence[Union[float, int]]Htuple (double / Hlong)

Covariance of the points in image 1.

Default: [][]

CovCC1covCC1cov_cc1 (input_control) number-array β†’ (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)Sequence[Union[float, int]]Htuple (double / Hlong)

Column coordinate variance of the points in image 1.

Default: [][]

CovRR2covRR2cov_rr2 (input_control) number-array β†’ (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)Sequence[Union[float, int]]Htuple (double / Hlong)

Row coordinate variance of the points in image 2.

Default: [][]

CovRC2covRC2cov_rc2 (input_control) number-array β†’ (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)Sequence[Union[float, int]]Htuple (double / Hlong)

Covariance of the points in image 2.

Default: [][]

CovCC2covCC2cov_cc2 (input_control) number-array β†’ (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)Sequence[Union[float, int]]Htuple (double / Hlong)

Column coordinate variance of the points in image 2.

Default: [][]

ImageWidthimageWidthimage_width (input_control) integer β†’ (integer)(integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Width of the images from which the points were extracted.

Restriction: ImageWidth > 0

ImageHeightimageHeightimage_height (input_control) integer β†’ (integer)(integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Height of the images from which the points were extracted.

Restriction: ImageHeight > 0

Methodmethodmethod (input_control) string β†’ (string)(string)HTuple (HString)HTuple (string)strHtuple (char*)

Estimation algorithm.

Default: 'gold_standard'"gold_standard"
List of values: 'gold_standard', 'linear', 'trans_gold_standard', 'trans_linear'"gold_standard", "linear", "trans_gold_standard", "trans_linear"

FMatrixFMatrixfmatrix (output_control) hom_mat2d β†’ (real)(real)HTuple (double)HHomMat2D, HTuple (double)Sequence[float]Htuple (double)

Computed fundamental matrix.

Kappakappakappa (output_control) real β†’ (real)(real)HTuple (double)HTuple (double)floatHtuple (double)

Computed radial distortion coefficient.

Errorerrorerror (output_control) real β†’ (real)(real)HTuple (double)HTuple (double)floatHtuple (double)

Root-Mean-Square epipolar distance error.

Xxx (output_control) real-array β†’ (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

X coordinates of the reconstructed points in projective 3D space.

Yyy (output_control) real-array β†’ (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Y coordinates of the reconstructed points in projective 3D space.

Zzz (output_control) real-array β†’ (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Z coordinates of the reconstructed points in projective 3D space.

Www (output_control) real-array β†’ (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

W coordinates of the reconstructed points in projective 3D space.

Combinations with other operatorsπŸ”—

Combinations

Possible predecessors

match_fundamental_matrix_distortion_ransacMatchFundamentalMatrixDistortionRansac

Possible successors

change_radial_distortion_cam_parChangeRadialDistortionCamPar, change_radial_distortion_imageChangeRadialDistortionImage, change_radial_distortion_pointsChangeRadialDistortionPoints, gen_binocular_proj_rectificationGenBinocularProjRectification

Alternatives

vector_to_fundamental_matrixVectorToFundamentalMatrix, vector_to_essential_matrixVectorToEssentialMatrix, vector_to_rel_poseVectorToRelPose

See also

calibrate_camerasCalibrateCameras

ReferencesπŸ”—

Richard Hartley, Andrew Zisserman: ``Multiple View Geometry in Computer Visionβ€™β€˜; Cambridge University Press, Cambridge; 2003.

Olivier Faugeras, Quang-Tuan Luong: ``The Geometry of Multiple Images: The Laws That Govern the Formation of Multiple Images of a Scene and Some of Their Applicationsβ€™β€˜; MIT Press, Cambridge, MA; 2001.

ModuleπŸ”—

3D Metrology