Skip to content

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🔗

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