Name
set_calib_data_observ_poseT_set_calib_data_observ_poseSetCalibDataObservPoseset_calib_data_observ_poseSetCalibDataObservPoseSetCalibDataObservPose — Set observed calibration object poses in a calibration data model.
For a calibration data model of type
CalibSetup='hand_eye_moving_cam'"hand_eye_moving_cam""hand_eye_moving_cam""hand_eye_moving_cam""hand_eye_moving_cam""hand_eye_moving_cam",
'hand_eye_stationary_cam'"hand_eye_stationary_cam""hand_eye_stationary_cam""hand_eye_stationary_cam""hand_eye_stationary_cam""hand_eye_stationary_cam", 'hand_eye_scara_moving_cam'"hand_eye_scara_moving_cam""hand_eye_scara_moving_cam""hand_eye_scara_moving_cam""hand_eye_scara_moving_cam""hand_eye_scara_moving_cam", or
'hand_eye_scara_stationary_cam'"hand_eye_scara_stationary_cam""hand_eye_scara_stationary_cam""hand_eye_scara_stationary_cam""hand_eye_scara_stationary_cam""hand_eye_scara_stationary_cam" with no calibration object (see
create_calib_datacreate_calib_dataCreateCalibDatacreate_calib_dataCreateCalibDataCreateCalibData), the hand-eye calibration is based on so-called
observations of an arbitrary object in the camera coordinate system.
In the following this object will be called calibration object.
Additionally, the corresponding poses of the robot tool in the robot base
coordinate system must be known.
With set_calib_data_observ_poseset_calib_data_observ_poseSetCalibDataObservPoseset_calib_data_observ_poseSetCalibDataObservPoseSetCalibDataObservPose, you store an
observation of the calibration object pose in the calibration data model
CalibDataIDCalibDataIDCalibDataIDCalibDataIDCalibDataIDcalibDataID. An observation of the calibration object pose
consists of the following data:
- CameraIdxCameraIdxCameraIdxCameraIdxCameraIdxcameraIdx:
Index of the observing camera
- CalibObjIdxCalibObjIdxCalibObjIdxCalibObjIdxCalibObjIdxcalibObjIdx:
Index of the observed calibration object
- CalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxcalibObjPoseIdx:
Index of the observed pose of the
calibration object. You can choose it freely, without following a strict
order. If you specify an index that already exists for the calibration
object CalibObjIdxCalibObjIdxCalibObjIdxCalibObjIdxCalibObjIdxcalibObjIdx, the corresponding observation data is
replaced by the new one.
- ObjInCameraPoseObjInCameraPoseObjInCameraPoseObjInCameraPoseObjInCameraPoseobjInCameraPose:
Pose of the observed calibration
object relative to observing camera.
Note that, since the model CalibDataIDCalibDataIDCalibDataIDCalibDataIDCalibDataIDcalibDataID uses a general
sensor and no calibration object (i.e., the model was created by
create_calib_datacreate_calib_dataCreateCalibDatacreate_calib_dataCreateCalibDataCreateCalibData with NumCameras=0 and
NumCalibObjects=0), both CameraIdxCameraIdxCameraIdxCameraIdxCameraIdxcameraIdx and
CalibObjIdxCalibObjIdxCalibObjIdxCalibObjIdxCalibObjIdxcalibObjIdx must be set to 0. If the model uses a camera
and an calibration object (i.e., NumCameras=1 and
NumCalibObjects=1), then find_calib_objectfind_calib_objectFindCalibObjectfind_calib_objectFindCalibObjectFindCalibObject or
set_calib_data_observ_pointsset_calib_data_observ_pointsSetCalibDataObservPointsset_calib_data_observ_pointsSetCalibDataObservPointsSetCalibDataObservPoints must be used.
The observation pose data can be accessed later by calling
get_calib_data_observ_poseget_calib_data_observ_poseGetCalibDataObservPoseget_calib_data_observ_poseGetCalibDataObservPoseGetCalibDataObservPose using the same values for the
arguments CameraIdxCameraIdxCameraIdxCameraIdxCameraIdxcameraIdx, CalibObjIdxCalibObjIdxCalibObjIdxCalibObjIdxCalibObjIdxcalibObjIdx, and
CalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxCalibObjPoseIdxcalibObjPoseIdx.
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
This operator modifies the state of the following input parameter:
The value of this parameter may not be shared across multiple threads without external synchronization.
Handle of a calibration data model.
Index of the observing camera.
Default value: 0
Suggested values: 0, 1, 2
Index of the calibration object.
Default value: 0
Suggested values: 0, 1, 2
Index of the observed calibration object.
Default value: 0
Suggested values: 0, 1, 2
Restriction: CalibObjPoseIdx >= 0
Pose of the observed calibration
object relative to the observing camera.
Number of elements: 7
find_marks_and_posefind_marks_and_poseFindMarksAndPosefind_marks_and_poseFindMarksAndPoseFindMarksAndPose,
set_calib_data_cam_paramset_calib_data_cam_paramSetCalibDataCamParamset_calib_data_cam_paramSetCalibDataCamParamSetCalibDataCamParam,
set_calib_data_calib_objectset_calib_data_calib_objectSetCalibDataCalibObjectset_calib_data_calib_objectSetCalibDataCalibObjectSetCalibDataCalibObject
set_calib_dataset_calib_dataSetCalibDataset_calib_dataSetCalibDataSetCalibData,
calibrate_camerascalibrate_camerasCalibrateCamerascalibrate_camerasCalibrateCamerasCalibrateCameras
find_calib_objectfind_calib_objectFindCalibObjectfind_calib_objectFindCalibObjectFindCalibObject
Calibration