proj_hom_mat2d_to_poseT_proj_hom_mat2d_to_poseProjHomMat2dToPoseProjHomMat2dToPoseproj_hom_mat2d_to_pose (Operator)
Name
proj_hom_mat2d_to_poseT_proj_hom_mat2d_to_poseProjHomMat2dToPoseProjHomMat2dToPoseproj_hom_mat2d_to_pose — Compute a pose out of a homography describing the relation between world
and image coordinates.
Signature
Description
proj_hom_mat2d_to_poseproj_hom_mat2d_to_poseProjHomMat2dToPoseProjHomMat2dToPoseProjHomMat2dToPoseproj_hom_mat2d_to_pose computes a pose out of a homography
HomographyHomographyHomographyHomographyhomographyhomography that describes the relation between 2D world-
(unit meters) and 2D image coordinates. The homography can be
obtained by the use of vector_to_proj_hom_mat2dvector_to_proj_hom_mat2dVectorToProjHomMat2dVectorToProjHomMat2dVectorToProjHomMat2dvector_to_proj_hom_mat2d. To compute
a pose, a camera matrix (obtained by cam_par_to_cam_matcam_par_to_cam_matCamParToCamMatCamParToCamMatCamParToCamMatcam_par_to_cam_mat, for
example) has to be passed in CameraMatrixCameraMatrixCameraMatrixCameraMatrixcameraMatrixcamera_matrix. By setting the
Parameter MethodMethodMethodMethodmethodmethod, it is possible to choose which
computation algorithm is used. Currently a direct decomposition
(MethodMethodMethodMethodmethodmethod = 'decomposition') and a singular value
decomposition based method (MethodMethodMethodMethodmethodmethod = 'decomposition_svd')
are supported. In general due to numeric reasons, the direct
decomposition method returns more stable results.
The subsequent calls of vector_to_proj_hom_mat2dvector_to_proj_hom_mat2dVectorToProjHomMat2dVectorToProjHomMat2dVectorToProjHomMat2dvector_to_proj_hom_mat2d and
proj_hom_mat2d_to_poseproj_hom_mat2d_to_poseProjHomMat2dToPoseProjHomMat2dToPoseProjHomMat2dToPoseproj_hom_mat2d_to_pose are similar to vector_to_posevector_to_poseVectorToPoseVectorToPoseVectorToPosevector_to_pose
for 2D objects, whereas no refinement due to redundancy is
possible.
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
HomographyHomographyHomographyHomographyhomographyhomography (input_control) hom_mat2d → HHomMat2D, HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
The homography from world- to image coordinates.
CameraMatrixCameraMatrixCameraMatrixCameraMatrixcameraMatrixcamera_matrix (input_control) hom_mat2d → HHomMat2D, HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
The camera calibration matrix K.
MethodMethodMethodMethodmethodmethod (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Type of pose computation.
Default:
'decomposition'
"decomposition"
"decomposition"
"decomposition"
"decomposition"
"decomposition"
List of values:
'decomposition'"decomposition""decomposition""decomposition""decomposition""decomposition", 'decomposition_svd'"decomposition_svd""decomposition_svd""decomposition_svd""decomposition_svd""decomposition_svd"
PosePosePosePoseposepose (output_control) pose → HPose, HTupleSequence[Union[float, int]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Pose of the 2D object.
Result
proj_hom_mat2d_to_poseproj_hom_mat2d_to_poseProjHomMat2dToPoseProjHomMat2dToPoseProjHomMat2dToPoseproj_hom_mat2d_to_pose returns 2 (
H_MSG_TRUE)
if all parameter values
are correct.
Possible Predecessors
image_points_to_world_planeimage_points_to_world_planeImagePointsToWorldPlaneImagePointsToWorldPlaneImagePointsToWorldPlaneimage_points_to_world_plane,
vector_to_proj_hom_mat2dvector_to_proj_hom_mat2dVectorToProjHomMat2dVectorToProjHomMat2dVectorToProjHomMat2dvector_to_proj_hom_mat2d
See also
vector_to_proj_hom_mat2dvector_to_proj_hom_mat2dVectorToProjHomMat2dVectorToProjHomMat2dVectorToProjHomMat2dvector_to_proj_hom_mat2d,
image_points_to_world_planeimage_points_to_world_planeImagePointsToWorldPlaneImagePointsToWorldPlaneImagePointsToWorldPlaneimage_points_to_world_plane,
vector_to_posevector_to_poseVectorToPoseVectorToPoseVectorToPosevector_to_pose,
camera_calibrationcamera_calibrationCameraCalibrationCameraCalibrationCameraCalibrationcamera_calibration
Module
Calibration