essential_to_fundamental_matrixessential_to_fundamental_matrixEssentialToFundamentalMatrixEssentialToFundamentalMatrixessential_to_fundamental_matrixT_essential_to_fundamental_matrix
Short description
essential_to_fundamental_matrixessential_to_fundamental_matrixEssentialToFundamentalMatrixEssentialToFundamentalMatrixessential_to_fundamental_matrixT_essential_to_fundamental_matrix — Compute the fundamental matrix from an essential matrix.
Signature
essential_to_fundamental_matrix( hom_mat2d EMatrix, number CovEMat, hom_mat2d CamMat1, hom_mat2d CamMat2, out hom_mat2d FMatrix, out real CovFMat )essential_to_fundamental_matrix( : : EMatrix, CovEMat, CamMat1, CamMat2 : FMatrix, CovFMat )void EssentialToFundamentalMatrix( const HTuple& EMatrix, const HTuple& CovEMat, const HTuple& CamMat1, const HTuple& CamMat2, HTuple* FMatrix, HTuple* CovFMat )static void HOperatorSet.EssentialToFundamentalMatrix( HTuple EMatrix, HTuple covEMat, HTuple camMat1, HTuple camMat2, out HTuple FMatrix, out HTuple covFMat )def essential_to_fundamental_matrix( ematrix: Sequence[Union[float, int]], cov_emat: Sequence[Union[float, int]], cam_mat_1: Sequence[Union[float, int]], cam_mat_2: Sequence[Union[float, int]] ) -> Tuple[Sequence[float], Sequence[float]]
Herror T_essential_to_fundamental_matrix( const Htuple EMatrix, const Htuple CovEMat, const Htuple CamMat1, const Htuple CamMat2, Htuple* FMatrix, Htuple* CovFMat )
HHomMat2D HHomMat2D::EssentialToFundamentalMatrix( const HTuple& CovEMat, const HHomMat2D& CamMat1, const HHomMat2D& CamMat2, HTuple* CovFMat ) const
HHomMat2D HHomMat2D.EssentialToFundamentalMatrix( HTuple covEMat, HHomMat2D camMat1, HHomMat2D camMat2, out HTuple covFMat )
Description
The fundamental matrix is the entity describing the epipolar constraint
in image coordinates (C,R) and the essential matrix is its counterpart
for 3D direction vectors (X,Y,1):
\[\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 \quad \textrm{and} \quad
\left(\begin{array}{c} X_{2} \\ Y_{2} \\ 1 \end{array} \right)^T
\cdot \textrm{EMatrix} \cdot
\left(\begin{array}{c} X_{1} \\ Y_{1} \\ 1 \end{array} \right)
= 0 \quad .
\end{eqnarray*}\]
Image coordinates result from 3D direction vectors by
multiplication with the camera matrix \(CamMat\):
\[\begin{eqnarray*}
\left(\begin{array}{c} col \\ row \\ 1 \end{array} \right)
\quad = \quad CamMat \cdot
\left(\begin{array}{c} X \\ Y \\ 1 \end{array} \right)
\quad .
\end{eqnarray*}\]
Therefore, the fundamental matrix FMatrixFMatrixfmatrix is calculated from the
essential matrix EMatrixEMatrixematrix and the camera matrices CamMat1camMat1cam_mat_1,
CamMat2camMat2cam_mat_2 by the following formula:
\[\begin{eqnarray*}
\textrm{FMatrix} \quad = \quad \textrm{CamMat2}^{-T} \cdot
\textrm{EMatrix} \cdot \textrm{CamMat1}^{-1}
\quad .
\end{eqnarray*}\]
The transformation of the essential matrix to the fundamental matrix
goes along with the propagation of the covariance matrices CovEMatcovEMatcov_emat
to CovFMatcovFMatcov_fmat. If CovEMatcovEMatcov_emat is empty CovFMatcovFMatcov_fmat will be
empty too.
The conversion operator essential_to_fundamental_matrixEssentialToFundamentalMatrix is used
especially for a subsequent visualization of the epipolar line structure
via the fundamental matrix, which depicts the underlying stereo geometry.
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
EMatrixEMatrixematrix (input_control) hom_mat2d → (real / integer)(real / integer)HTuple (double / Hlong)HHomMat2D, HTuple (double / int / long)Sequence[Union[float, int]]Htuple (double / Hlong)
Essential matrix.
CovEMatcovEMatcov_emat (input_control) number-array → (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)Sequence[Union[float, int]]Htuple (double / Hlong)
9x9 covariance matrix of the
essential matrix.
Default: [][]
CamMat1camMat1cam_mat_1 (input_control) hom_mat2d → (real / integer)(real / integer)HTuple (double / Hlong)HHomMat2D, HTuple (double / int / long)Sequence[Union[float, int]]Htuple (double / Hlong)
Camera matrix of the 1. camera.
CamMat2camMat2cam_mat_2 (input_control) hom_mat2d → (real / integer)(real / integer)HTuple (double / Hlong)HHomMat2D, HTuple (double / int / long)Sequence[Union[float, int]]Htuple (double / Hlong)
Camera matrix of the 2. camera.
FMatrixFMatrixfmatrix (output_control) hom_mat2d → (real)(real)HTuple (double)HHomMat2D, HTuple (double)Sequence[float]Htuple (double)
Computed fundamental matrix.
CovFMatcovFMatcov_fmat (output_control) real-array → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)
9x9 covariance matrix of the
fundamental matrix.
Combinations with other operators
Combinations
Possible predecessors
vector_to_essential_matrixVectorToEssentialMatrix
Alternatives
rel_pose_to_fundamental_matrixRelPoseToFundamentalMatrix
Module
3D Metrology