Skip to content

reconst3d_from_fundamental_matrixreconst3d_from_fundamental_matrixReconst3dFromFundamentalMatrixReconst3dFromFundamentalMatrixreconst3d_from_fundamental_matrixT_reconst3d_from_fundamental_matrixπŸ”—

Short descriptionπŸ”—

reconst3d_from_fundamental_matrixreconst3d_from_fundamental_matrixReconst3dFromFundamentalMatrixReconst3dFromFundamentalMatrixreconst3d_from_fundamental_matrixT_reconst3d_from_fundamental_matrix β€” Compute the projective 3d reconstruction of points based on the fundamental matrix.

SignatureπŸ”—

reconst3d_from_fundamental_matrix( number Rows1, number Cols1, number Rows2, number Cols2, number CovRR1, number CovRC1, number CovCC1, number CovRR2, number CovRC2, number CovCC2, hom_mat2d FMatrix, real CovFMat, out real X, out real Y, out real Z, out real W, out real CovXYZW )reconst3d_from_fundamental_matrix( : : Rows1, Cols1, Rows2, Cols2, CovRR1, CovRC1, CovCC1, CovRR2, CovRC2, CovCC2, FMatrix, CovFMat : X, Y, Z, W, CovXYZW )void Reconst3dFromFundamentalMatrix( 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& FMatrix, const HTuple& CovFMat, HTuple* X, HTuple* Y, HTuple* Z, HTuple* W, HTuple* CovXYZW )static void HOperatorSet.Reconst3dFromFundamentalMatrix( HTuple rows1, HTuple cols1, HTuple rows2, HTuple cols2, HTuple covRR1, HTuple covRC1, HTuple covCC1, HTuple covRR2, HTuple covRC2, HTuple covCC2, HTuple FMatrix, HTuple covFMat, out HTuple x, out HTuple y, out HTuple z, out HTuple w, out HTuple covXYZW )def reconst3d_from_fundamental_matrix( rows_1: MaybeSequence[Union[float, int]], cols_1: MaybeSequence[Union[float, int]], rows_2: MaybeSequence[Union[float, int]], cols_2: MaybeSequence[Union[float, int]], cov_rr1: MaybeSequence[Union[float, int]], cov_rc1: MaybeSequence[Union[float, int]], cov_cc1: MaybeSequence[Union[float, int]], cov_rr2: MaybeSequence[Union[float, int]], cov_rc2: MaybeSequence[Union[float, int]], cov_cc2: MaybeSequence[Union[float, int]], fmatrix: Sequence[float], cov_fmat: Sequence[float] ) -> Tuple[Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float]]

def reconst3d_from_fundamental_matrix_s( rows_1: MaybeSequence[Union[float, int]], cols_1: MaybeSequence[Union[float, int]], rows_2: MaybeSequence[Union[float, int]], cols_2: MaybeSequence[Union[float, int]], cov_rr1: MaybeSequence[Union[float, int]], cov_rc1: MaybeSequence[Union[float, int]], cov_cc1: MaybeSequence[Union[float, int]], cov_rr2: MaybeSequence[Union[float, int]], cov_rc2: MaybeSequence[Union[float, int]], cov_cc2: MaybeSequence[Union[float, int]], fmatrix: Sequence[float], cov_fmat: Sequence[float] ) -> Tuple[float, float, float, float, float]Herror T_reconst3d_from_fundamental_matrix( 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 FMatrix, const Htuple CovFMat, Htuple* X, Htuple* Y, Htuple* Z, Htuple* W, Htuple* CovXYZW )

void HHomMat2D::Reconst3dFromFundamentalMatrix( 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& CovFMat, HTuple* X, HTuple* Y, HTuple* Z, HTuple* W, HTuple* CovXYZW ) const

void HHomMat2D::Reconst3dFromFundamentalMatrix( double Rows1, double Cols1, double Rows2, double Cols2, double CovRR1, double CovRC1, double CovCC1, double CovRR2, double CovRC2, double CovCC2, const HTuple& CovFMat, double* X, double* Y, double* Z, double* W, double* CovXYZW ) const

void HHomMat2D.Reconst3dFromFundamentalMatrix( HTuple rows1, HTuple cols1, HTuple rows2, HTuple cols2, HTuple covRR1, HTuple covRC1, HTuple covCC1, HTuple covRR2, HTuple covRC2, HTuple covCC2, HTuple covFMat, out HTuple x, out HTuple y, out HTuple z, out HTuple w, out HTuple covXYZW )

void HHomMat2D.Reconst3dFromFundamentalMatrix( double rows1, double cols1, double rows2, double cols2, double covRR1, double covRC1, double covCC1, double covRR2, double covRC2, double covCC2, HTuple covFMat, out double x, out double y, out double z, out double w, out double covXYZW )

DescriptionπŸ”—

A pair of stereo images is called weakly calibrated if the fundamental matrix, which defines the geometric relation between the two images, is known. Given such a fundamental matrix FMatrixFMatrixfmatrix and a set of corresponding points (Rows1rows1rows_1,Cols1cols1cols_1) and (Rows2rows2rows_2,Cols2cols2cols_2) the operator reconst3d_from_fundamental_matrixReconst3dFromFundamentalMatrix determines the three-dimensional space points projecting onto these image points. This 3D reconstruction is purely projective and the projective coordinates are returned by the four-vector (Xxx,Yyy,Zzz,Www). This type of reconstruction is also known as projective triangulation. If additionally the covariances CovRR1covRR1cov_rr1, CovRC1covRC1cov_rc1, CovCC1covCC1cov_cc1 and CovRR2covRR2cov_rr2, CovRC2covRC2cov_rc2, CovCC2covCC2cov_cc2 of the image points are given the covariances of the reconstructed points CovXYZWcovXYZWcov_xyzw are computed too. Let n be the number of points. Then the concatenated covariances are stored in a 16xn tuple. The computation of the covariances is more precise if the covariance of the fundamental matrix CovFMatcovFMatcov_fmat is provided.

The operator reconst3d_from_fundamental_matrixReconst3dFromFundamentalMatrix is typically used after match_fundamental_matrix_ransacMatchFundamentalMatrixRansac to perform 3d reconstruction. This will save computational cost compared with the deployment of vector_to_fundamental_matrixVectorToFundamentalMatrix.

reconst3d_from_fundamental_matrixReconst3dFromFundamentalMatrix is the projective equivalent to the Euclidean reconstruction operator intersect_lines_of_sightIntersectLinesOfSight.

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) number(-array) β†’ (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)

Input points in image 1 (row coordinate).

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

Input points in image 1 (column coordinate).

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

Input points in image 2 (row coordinate).

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

Input points in image 2 (column coordinate).

CovRR1covRR1cov_rr1 (input_control) number(-array) β†’ (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[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)MaybeSequence[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)MaybeSequence[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)MaybeSequence[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)MaybeSequence[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)MaybeSequence[Union[float, int]]Htuple (double / Hlong)

Column coordinate variance of the points in image 2.

Default: [][]

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

Fundamental matrix.

CovFMatcovFMatcov_fmat (input_control) real-array β†’ (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

9x9 covariance matrix of the fundamental matrix.

Default: [][]

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.

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

Covariance matrices of the reconstructed points.

Combinations with other operatorsπŸ”—

Combinations

Possible predecessors

match_fundamental_matrix_ransacMatchFundamentalMatrixRansac

Alternatives

vector_to_fundamental_matrixVectorToFundamentalMatrix, intersect_lines_of_sightIntersectLinesOfSight

ReferencesπŸ”—

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

ModuleπŸ”—

3D Metrology