get_calib_dataT_get_calib_dataGetCalibDataGetCalibDataget_calib_data (Operator)

Name

get_calib_dataT_get_calib_dataGetCalibDataGetCalibDataget_calib_data — Query data stored or computed in a calibration data model.

Signature

get_calib_data( : : CalibDataID, ItemType, ItemIdx, DataName : DataValue)

Herror T_get_calib_data(const Htuple CalibDataID, const Htuple ItemType, const Htuple ItemIdx, const Htuple DataName, Htuple* DataValue)

void GetCalibData(const HTuple& CalibDataID, const HTuple& ItemType, const HTuple& ItemIdx, const HTuple& DataName, HTuple* DataValue)

HTuple HCalibData::GetCalibData(const HString& ItemType, const HTuple& ItemIdx, const HTuple& DataName) const

HTuple HCalibData::GetCalibData(const HString& ItemType, Hlong ItemIdx, const HString& DataName) const

HTuple HCalibData::GetCalibData(const char* ItemType, Hlong ItemIdx, const char* DataName) const

HTuple HCalibData::GetCalibData(const wchar_t* ItemType, Hlong ItemIdx, const wchar_t* DataName) const   (Windows only)

static void HOperatorSet.GetCalibData(HTuple calibDataID, HTuple itemType, HTuple itemIdx, HTuple dataName, out HTuple dataValue)

HTuple HCalibData.GetCalibData(string itemType, HTuple itemIdx, HTuple dataName)

HTuple HCalibData.GetCalibData(string itemType, int itemIdx, string dataName)

def get_calib_data(calib_data_id: HHandle, item_type: str, item_idx: MaybeSequence[Union[int, str]], data_name: MaybeSequence[str]) -> Sequence[Union[float, int, str]]

def get_calib_data_s(calib_data_id: HHandle, item_type: str, item_idx: MaybeSequence[Union[int, str]], data_name: MaybeSequence[str]) -> Union[float, int, str]

Description

With the operator get_calib_dataget_calib_dataGetCalibDataGetCalibDataGetCalibDataget_calib_data, you can query data of the calibration data model CalibDataIDCalibDataIDCalibDataIDCalibDataIDcalibDataIDcalib_data_id.

Note that in the following, all 'pose'-related data is given in relation to the coordinate system of the model's reference camera, which can be set with set_calib_dataset_calib_dataSetCalibDataSetCalibDataSetCalibDataset_calib_data and queried with get_calib_dataget_calib_dataGetCalibDataGetCalibDataGetCalibDataget_calib_data. By default, the first camera (camera index 0) is used as reference camera.

The calibration data model contains various kinds of data. How to query specific data of the calibration data model is described for different categories of data:

Before we describe the individual data you can query in detail, we provide you with an overview on which data is available after the individual steps of the calibration processes. When calibrating cameras or a hand-eye system, several operators are called that step by step fill the calibration data model with content. In the following, for each operator a table lists the data that is added to the model. Additionally, you find information about the combinations of the values for ItemTypeItemTypeItemTypeItemTypeitemTypeitem_type, ItemIdxItemIdxItemIdxItemIdxitemIdxitem_idx, and DataNameDataNameDataNameDataNamedataNamedata_name that are needed to query the information with get_calib_dataget_calib_dataGetCalibDataGetCalibDataGetCalibDataget_calib_data. For the different indices that are used within the tables the following abbreviations (or potential variable names) are used:

Detailed descriptions of the data that can be queried can then be found in the specific sections that handle the different categories of data individually.

To get detailed information about the calibration process of your camera setup see the chapter Calibration.

Content of Calibration Data Model When Calibrating Cameras

For each operator that extends the calibration model, a table is provided to give an overview on the respective data:

For standard HALCON calibration plates, further calibration plate specific information is added to the model, which is not accessible with get_calib_dataget_calib_dataGetCalibDataGetCalibDataGetCalibDataget_calib_data but can be obtained directly from the corresponding calibration plate description files instead (for details about the description files see create_caltabcreate_caltabCreateCaltabCreateCaltabCreateCaltabcreate_caltab for a calibration plate with hexagonally arranged marks and gen_caltabgen_caltabGenCaltabGenCaltabGenCaltabgen_caltab for a calibration plate with rectangularly arranged marks).

Content of Calibration Data Model When Performing Hand-Eye Calibration

For each operator that extends the calibration model when performing hand-eye calibration, a table is provided to give an overview on the respective data:

Model-Related Data

ItemTypeItemTypeItemTypeItemTypeitemTypeitem_type='model'"model""model""model""model""model":

ItemIdxItemIdxItemIdxItemIdxitemIdxitem_idx must be set to 'general'"general""general""general""general""general".

Depending on the selection in DataNameDataNameDataNameDataNamedataNamedata_name, the following model-related data is then returned in DataValueDataValueDataValueDataValuedataValuedata_value:

'type'"type""type""type""type""type":

Type of the calibration data model. Currently, the five types 'calibration_object'"calibration_object""calibration_object""calibration_object""calibration_object""calibration_object", '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_moving_cam'"hand_eye_moving_cam""hand_eye_moving_cam""hand_eye_moving_cam""hand_eye_moving_cam""hand_eye_moving_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""hand_eye_scara_stationary_cam", and '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" are supported.

'reference_camera'"reference_camera""reference_camera""reference_camera""reference_camera""reference_camera":

Index of the reference camera for the calibration model. All poses stored in the calibration data model are specified in the coordinate system of this reference camera.

'num_cameras'"num_cameras""num_cameras""num_cameras""num_cameras""num_cameras":

Number of cameras in the calibration data model (see create_calib_datacreate_calib_dataCreateCalibDataCreateCalibDataCreateCalibDatacreate_calib_data).

'num_calib_objs'"num_calib_objs""num_calib_objs""num_calib_objs""num_calib_objs""num_calib_objs":

Number of calibration objects in the calibration data model (see create_calib_datacreate_calib_dataCreateCalibDataCreateCalibDataCreateCalibDatacreate_calib_data).

'common_motion_vector'"common_motion_vector""common_motion_vector""common_motion_vector""common_motion_vector""common_motion_vector":

For stereo setups with telecentric line scan cameras, a string with a Boolean value (i.e., 'true'"true""true""true""true""true" or 'false'"false""false""false""false""false") that determines whether the cameras have a common motion vector.

'camera_setup_model'"camera_setup_model""camera_setup_model""camera_setup_model""camera_setup_model""camera_setup_model":

A handle to a camera setup model containing the poses and the internal parameters for the calibrated cameras from the current calibration setup.

'camera_calib_error'"camera_calib_error""camera_calib_error""camera_calib_error""camera_calib_error""camera_calib_error":

The root mean square error (RMSE) of the back projection of the optimization of the camera system. Typically, this error is queried after a hand eye calibration (calibrate_hand_eyecalibrate_hand_eyeCalibrateHandEyeCalibrateHandEyeCalibrateHandEyecalibrate_hand_eye) was performed, where internally the camera system is calibrated without returning the error of the camera calibration. The returned error is identical to the error returned by calibrate_camerascalibrate_camerasCalibrateCamerasCalibrateCamerasCalibrateCamerascalibrate_cameras.

'hand_eye_calib_error'"hand_eye_calib_error""hand_eye_calib_error""hand_eye_calib_error""hand_eye_calib_error""hand_eye_calib_error":

After a successful hand_eye calibration, the pose error of the complete chain of transformations is returned. To be more precise, a tuple with four elements is returned, where the first element is the root-mean-square error of the translational part, the second element is the root-mean-square error of the rotational part, the third element is the maximum translational error and the fourth element is the maximum rotational error. The returned errors are identical to the errors returned by calibrate_hand_eyecalibrate_hand_eyeCalibrateHandEyeCalibrateHandEyeCalibrateHandEyecalibrate_hand_eye.

'optimization_method'"optimization_method""optimization_method""optimization_method""optimization_method""optimization_method":

Optimization method that was set for the hand-eye calibration (see set_calib_dataset_calib_dataSetCalibDataSetCalibDataSetCalibDataset_calib_data).

The parameters 'reference_camera'"reference_camera""reference_camera""reference_camera""reference_camera""reference_camera", 'common_motion_vector'"common_motion_vector""common_motion_vector""common_motion_vector""common_motion_vector""common_motion_vector", and 'optimization_method'"optimization_method""optimization_method""optimization_method""optimization_method""optimization_method" can be set with set_calib_dataset_calib_dataSetCalibDataSetCalibDataSetCalibDataset_calib_data. The other parameters are set during the model creation or are a result of the calibration process and cannot be modified.

Camera-Related Data

ItemTypeItemTypeItemTypeItemTypeitemTypeitem_type='camera'"camera""camera""camera""camera""camera":

ItemIdxItemIdxItemIdxItemIdxitemIdxitem_idx determines, if data is queried for all cameras in general or for a specific camera. With ItemIdxItemIdxItemIdxItemIdxitemIdxitem_idx='general'"general""general""general""general""general", the default value of a parameter for all cameras is returned. In contrast, if you pass a valid camera index instead, i.e., a number between 0 and NumCamerasNumCamerasNumCamerasNumCamerasnumCamerasnum_cameras-1 (NumCamerasNumCamerasNumCamerasNumCamerasnumCamerasnum_cameras is specified during model creation with create_calib_datacreate_calib_dataCreateCalibDataCreateCalibDataCreateCalibDatacreate_calib_data), only the parameter value of the specified camera is returned.

By selecting the following parameters in DataNameDataNameDataNameDataNamedataNamedata_name, you can query which camera parameters are (or have been) optimized during the calibration performed by calibrate_camerascalibrate_camerasCalibrateCamerasCalibrateCamerasCalibrateCamerascalibrate_cameras:

'calib_settings'"calib_settings""calib_settings""calib_settings""calib_settings""calib_settings":

List of the camera parameters that are marked for calibration.

'excluded_settings'"excluded_settings""excluded_settings""excluded_settings""excluded_settings""excluded_settings":

List of camera parameters that are excluded from the calibration.

These parameters can be modified by a corresponding call to set_calib_dataset_calib_dataSetCalibDataSetCalibDataSetCalibDataset_calib_data.

The following parameters can only be queried for a specific camera, i.e., you must pass a valid camera index in ItemIdxItemIdxItemIdxItemIdxitemIdxitem_idx:

'type'"type""type""type""type""type":

The camera type that was set with set_calib_data_cam_paramset_calib_data_cam_paramSetCalibDataCamParamSetCalibDataCamParamSetCalibDataCamParamset_calib_data_cam_param.

'init_params'"init_params""init_params""init_params""init_params""init_params":

Initial internal camera parameters (set with set_calib_data_cam_paramset_calib_data_cam_paramSetCalibDataCamParamSetCalibDataCamParamSetCalibDataCamParamset_calib_data_cam_param).

'params'"params""params""params""params""params":

Optimized internal camera parameters.

'params_deviations'"params_deviations""params_deviations""params_deviations""params_deviations""params_deviations":

Standard deviations of the optimized camera parameters, as estimated at the end of the camera calibration. Note that if the tuple returned for 'params'"params""params""params""params""params" contains elements, the tuple returned for 'params_deviations'"params_deviations""params_deviations""params_deviations""params_deviations""params_deviations" contains elements since the camera parameter tuple contains the camera type in the first element of the tuple, whereas the tuple returned for 'params_deviations'"params_deviations""params_deviations""params_deviations""params_deviations""params_deviations" does not contain the camera type.

'params_covariances'"params_covariances""params_covariances""params_covariances""params_covariances""params_covariances":

Covariance matrix of the optimized camera parameters, as estimated at the end of the camera calibration. Note that if the tuple returned for 'params'"params""params""params""params""params" contains elements, the tuple returned for 'params_covariances'"params_covariances""params_covariances""params_covariances""params_covariances""params_covariances" contains elements since the camera parameter tuple contains the camera type in the first element of the tuple, whereas the tuple returned for 'params_covariances'"params_covariances""params_covariances""params_covariances""params_covariances""params_covariances" does not contain the camera type.

'params_labels'"params_labels""params_labels""params_labels""params_labels""params_labels":

A convenience list of labels for the entries returned by 'params'"params""params""params""params""params". This list is camera-type specific. Note that this list contains the label 'camera_type'"camera_type""camera_type""camera_type""camera_type""camera_type" in its first position. If the first element of the tuple is removed, the list refers to the labels of 'params_deviations'"params_deviations""params_deviations""params_deviations""params_deviations""params_deviations" and the labels of the rows and columns of 'params_covariances'"params_covariances""params_covariances""params_covariances""params_covariances""params_covariances".

'init_pose'"init_pose""init_pose""init_pose""init_pose""init_pose":

Initial camera pose, relative to the current reference camera. It is computed internally based on observation poses during the calibration process (see Calibration).

'pose'"pose""pose""pose""pose""pose":

Optimized camera pose, relative to the current reference camera. If one single telecentric camera is calibrated, the translation along the z-axis is set to the value 0.0. If more than one telecentric camera is calibrated, the camera poses are moved in direction of their z-axis until they all lie on a sphere centered at the first observed calibration plate. The radius of the sphere corresponds to the longest distance of a camera to the first observed calibration plate. If this calculated distance is smaller than 1 m, the radius is set to 1 m.

'pose_labels'"pose_labels""pose_labels""pose_labels""pose_labels""pose_labels":

A convenience list of labels for the entries returned by 'pose'"pose""pose""pose""pose""pose".

The calibrated camera parameters ('params'"params""params""params""params""params" and 'pose'"pose""pose""pose""pose""pose") can be queried only after a successful execution of calibrate_camerascalibrate_camerasCalibrateCamerasCalibrateCamerasCalibrateCamerascalibrate_cameras. The initial internal camera parameters 'init_params'"init_params""init_params""init_params""init_params""init_params" can be queried after a successful call to set_calib_data_cam_paramset_calib_data_cam_paramSetCalibDataCamParamSetCalibDataCamParamSetCalibDataCamParamset_calib_data_cam_param.

Data Related to Calibration Objects

ItemTypeItemTypeItemTypeItemTypeitemTypeitem_type='calib_obj'"calib_obj""calib_obj""calib_obj""calib_obj""calib_obj":

ItemIdxItemIdxItemIdxItemIdxitemIdxitem_idx must be set to a valid calibration object index (number between 0 and NumCalibObjectsNumCalibObjectsNumCalibObjectsNumCalibObjectsnumCalibObjectsnum_calib_objects-1). NumCalibObjectsNumCalibObjectsNumCalibObjectsNumCalibObjectsnumCalibObjectsnum_calib_objects is specified during the model creation with create_calib_datacreate_calib_dataCreateCalibDataCreateCalibDataCreateCalibDatacreate_calib_data.

The following parameters can be queried with DataNameDataNameDataNameDataNamedataNamedata_name and are returned in DataValueDataValueDataValueDataValuedataValuedata_value:

'num_marks'"num_marks""num_marks""num_marks""num_marks""num_marks":

Number of calibration marks of the calibration object.

'x'"x""x""x""x""x", 'y'"y""y""y""y""y", 'z'"z""z""z""z""z":

Coordinates of the calibration marks relative to the calibration object coordinate system.

These parameters can be modified with set_calib_data_calib_objectset_calib_data_calib_objectSetCalibDataCalibObjectSetCalibDataCalibObjectSetCalibDataCalibObjectset_calib_data_calib_object.

Data Related to Calibration Object Poses

ItemTypeItemTypeItemTypeItemTypeitemTypeitem_type='calib_obj_pose'"calib_obj_pose""calib_obj_pose""calib_obj_pose""calib_obj_pose""calib_obj_pose":

ItemIdxItemIdxItemIdxItemIdxitemIdxitem_idx determines, if data is queried for all calibration object poses in general or for a specific calibration object pose. With ItemIdxItemIdxItemIdxItemIdxitemIdxitem_idx='general'"general""general""general""general""general", the default value of a parameter for all calibration object poses is returned. In contrast, if you pass a valid calibration object index instead, i.e., a tuple containing a valid index pair [CalibObjIdx, CalibObjPoseIdx], only the parameter value of the specified calibration object pose is returned.

By selecting the following parameters in DataNameDataNameDataNameDataNamedataNamedata_name, you can query which calibration object pose parameters are (or have been) optimized during the calibration performed by calibrate_camerascalibrate_camerasCalibrateCamerasCalibrateCamerasCalibrateCamerascalibrate_cameras:

'calib_settings'"calib_settings""calib_settings""calib_settings""calib_settings""calib_settings":

List of calibration object pose parameters marked for calibration.

'excluded_settings'"excluded_settings""excluded_settings""excluded_settings""excluded_settings""excluded_settings":

List of calibration object pose parameters excluded from calibration.

These parameters can be set with set_calib_dataset_calib_dataSetCalibDataSetCalibDataSetCalibDataset_calib_data.

The following parameters can only be queried for a specific calibration object pose, i.e., you must pass a valid index pair [CalibObjIdx, CalibObjPoseIdx] in ItemIdxItemIdxItemIdxItemIdxitemIdxitem_idx:

'init_pose'"init_pose""init_pose""init_pose""init_pose""init_pose":

Initial calibration object pose. It is computed internally based on observation poses during the calibration process (see Calibration). This pose is relative to the current reference camera.

'pose'"pose""pose""pose""pose""pose":

Optimized calibration object pose, relative to current reference camera.

'pose_labels'"pose_labels""pose_labels""pose_labels""pose_labels""pose_labels":

A convenience list of labels for the entries returned by 'pose'"pose""pose""pose""pose""pose".

These parameters cannot be explicitly modified and can only be queried after calibrate_camerascalibrate_camerasCalibrateCamerasCalibrateCamerasCalibrateCamerascalibrate_cameras was executed.

Hand-Eye Calibration Related Data

After performing a successful hand-eye calibration using calibrate_hand_eyecalibrate_hand_eyeCalibrateHandEyeCalibrateHandEyeCalibrateHandEyecalibrate_hand_eye, the following poses can be queried for a calibration data model of type:

'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_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":

For ItemTypeItemTypeItemTypeItemTypeitemTypeitem_type='camera'"camera""camera""camera""camera""camera" and DataNameDataNameDataNameDataNamedataNamedata_name='tool_in_cam_pose'"tool_in_cam_pose""tool_in_cam_pose""tool_in_cam_pose""tool_in_cam_pose""tool_in_cam_pose", the pose of the robot tool in the camera coordinate system is returned in DataValueDataValueDataValueDataValuedataValuedata_value. For ItemTypeItemTypeItemTypeItemTypeitemTypeitem_type='calib_obj'"calib_obj""calib_obj""calib_obj""calib_obj""calib_obj" and DataNameDataNameDataNameDataNamedataNamedata_name='obj_in_base_pose'"obj_in_base_pose""obj_in_base_pose""obj_in_base_pose""obj_in_base_pose""obj_in_base_pose", the pose of the calibration object in the robot base coordinate system is returned in DataValueDataValueDataValueDataValuedataValuedata_value.

Note that when calibrating SCARA robots, it is not possible to determine the Z translation of 'obj_in_base_pose'"obj_in_base_pose""obj_in_base_pose""obj_in_base_pose""obj_in_base_pose""obj_in_base_pose". To eliminate this ambiguity the Z translation 'obj_in_base_pose'"obj_in_base_pose""obj_in_base_pose""obj_in_base_pose""obj_in_base_pose""obj_in_base_pose" is internally set to 0.0 and the 'tool_in_cam_pose'"tool_in_cam_pose""tool_in_cam_pose""tool_in_cam_pose""tool_in_cam_pose""tool_in_cam_pose" is calculated accordingly. It is necessary to determine the true translation in Z after the calibration (see calibrate_hand_eyecalibrate_hand_eyeCalibrateHandEyeCalibrateHandEyeCalibrateHandEyecalibrate_hand_eye).

The standard deviations and the covariance matrices of the 6 pose parameters of both poses can be queried with 'tool_in_cam_pose_deviations'"tool_in_cam_pose_deviations""tool_in_cam_pose_deviations""tool_in_cam_pose_deviations""tool_in_cam_pose_deviations""tool_in_cam_pose_deviations", 'tool_in_cam_pose_covariances'"tool_in_cam_pose_covariances""tool_in_cam_pose_covariances""tool_in_cam_pose_covariances""tool_in_cam_pose_covariances""tool_in_cam_pose_covariances" (ItemTypeItemTypeItemTypeItemTypeitemTypeitem_type='camera'"camera""camera""camera""camera""camera"), 'obj_in_base_pose_deviations'"obj_in_base_pose_deviations""obj_in_base_pose_deviations""obj_in_base_pose_deviations""obj_in_base_pose_deviations""obj_in_base_pose_deviations", and 'obj_in_base_pose_covariances'"obj_in_base_pose_covariances""obj_in_base_pose_covariances""obj_in_base_pose_covariances""obj_in_base_pose_covariances""obj_in_base_pose_covariances" (ItemTypeItemTypeItemTypeItemTypeitemTypeitem_type='calib_obj'"calib_obj""calib_obj""calib_obj""calib_obj""calib_obj"). Like poses, they are specified in the units [m] and [°].

'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_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":

For ItemTypeItemTypeItemTypeItemTypeitemTypeitem_type='camera'"camera""camera""camera""camera""camera" and DataNameDataNameDataNameDataNamedataNamedata_name='base_in_cam_pose'"base_in_cam_pose""base_in_cam_pose""base_in_cam_pose""base_in_cam_pose""base_in_cam_pose", the pose of the robot base in the camera coordinate system is returned in DataValueDataValueDataValueDataValuedataValuedata_value. For ItemTypeItemTypeItemTypeItemTypeitemTypeitem_type='calib_obj'"calib_obj""calib_obj""calib_obj""calib_obj""calib_obj" and DataNameDataNameDataNameDataNamedataNamedata_name='obj_in_tool_pose'"obj_in_tool_pose""obj_in_tool_pose""obj_in_tool_pose""obj_in_tool_pose""obj_in_tool_pose", the pose of the calibration object in the robot tool coordinate system is returned in DataValueDataValueDataValueDataValuedataValuedata_value.

Note that when calibrating SCARA robots, it is not possible to determine the Z translation of 'obj_in_tool_pose'"obj_in_tool_pose""obj_in_tool_pose""obj_in_tool_pose""obj_in_tool_pose""obj_in_tool_pose". To eliminate this ambiguity the Z translation of 'obj_in_tool_pose'"obj_in_tool_pose""obj_in_tool_pose""obj_in_tool_pose""obj_in_tool_pose""obj_in_tool_pose" is internally set to 0.0 and the 'base_in_cam_pose'"base_in_cam_pose""base_in_cam_pose""base_in_cam_pose""base_in_cam_pose""base_in_cam_pose" is calculated accordingly. It is necessary to determine the true translation in Z after the calibration (see calibrate_hand_eyecalibrate_hand_eyeCalibrateHandEyeCalibrateHandEyeCalibrateHandEyecalibrate_hand_eye).

The standard deviations and the covariance matrices of the 6 pose parameters of both poses can be queried with 'base_in_cam_pose_deviations'"base_in_cam_pose_deviations""base_in_cam_pose_deviations""base_in_cam_pose_deviations""base_in_cam_pose_deviations""base_in_cam_pose_deviations", 'base_in_cam_pose_covariances'"base_in_cam_pose_covariances""base_in_cam_pose_covariances""base_in_cam_pose_covariances""base_in_cam_pose_covariances""base_in_cam_pose_covariances" (ItemTypeItemTypeItemTypeItemTypeitemTypeitem_type='camera'"camera""camera""camera""camera""camera"), 'obj_in_tool_pose_deviations'"obj_in_tool_pose_deviations""obj_in_tool_pose_deviations""obj_in_tool_pose_deviations""obj_in_tool_pose_deviations""obj_in_tool_pose_deviations", and 'obj_in_tool_pose_covariances'"obj_in_tool_pose_covariances""obj_in_tool_pose_covariances""obj_in_tool_pose_covariances""obj_in_tool_pose_covariances""obj_in_tool_pose_covariances" (ItemTypeItemTypeItemTypeItemTypeitemTypeitem_type='calib_obj'"calib_obj""calib_obj""calib_obj""calib_obj""calib_obj"). Like poses, they are specified in the units [m] and [°].

For ItemTypeItemTypeItemTypeItemTypeitemTypeitem_type='tool'"tool""tool""tool""tool""tool" and DataNameDataNameDataNameDataNamedataNamedata_name='tool_in_base_pose'"tool_in_base_pose""tool_in_base_pose""tool_in_base_pose""tool_in_base_pose""tool_in_base_pose", the pose of the robot tool in the robot base coordinate system with Index ItemIdxItemIdxItemIdxItemIdxitemIdxitem_idx is returned in DataValueDataValueDataValueDataValuedataValuedata_value These poses were previously set using set_calib_dataset_calib_dataSetCalibDataSetCalibDataSetCalibDataset_calib_data and served as input for the hand-eye calibration algorithm.

Execution Information

Parameters

CalibDataIDCalibDataIDCalibDataIDCalibDataIDcalibDataIDcalib_data_id (input_control)  calib_data HCalibData, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of a calibration data model.

ItemTypeItemTypeItemTypeItemTypeitemTypeitem_type (input_control)  string HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Type of calibration data item.

Default value: 'camera' "camera" "camera" "camera" "camera" "camera"

List of values: 'calib_obj'"calib_obj""calib_obj""calib_obj""calib_obj""calib_obj", 'calib_obj_pose'"calib_obj_pose""calib_obj_pose""calib_obj_pose""calib_obj_pose""calib_obj_pose", 'camera'"camera""camera""camera""camera""camera", 'model'"model""model""model""model""model", 'tool'"tool""tool""tool""tool""tool"

ItemIdxItemIdxItemIdxItemIdxitemIdxitem_idx (input_control)  integer(-array) HTupleMaybeSequence[Union[int, str]]HTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)

Index of the affected item (depending on the selected ItemTypeItemTypeItemTypeItemTypeitemTypeitem_type).

Default value: 0

Suggested values: 0, 1, 2, 'general'"general""general""general""general""general"

DataNameDataNameDataNameDataNamedataNamedata_name (input_control)  attribute.name(-array) HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)

The name of the inspected data.

Default value: 'params' "params" "params" "params" "params" "params"

List of values: 'base_in_cam_pose'"base_in_cam_pose""base_in_cam_pose""base_in_cam_pose""base_in_cam_pose""base_in_cam_pose", 'base_in_cam_pose_covariances'"base_in_cam_pose_covariances""base_in_cam_pose_covariances""base_in_cam_pose_covariances""base_in_cam_pose_covariances""base_in_cam_pose_covariances", 'base_in_cam_pose_deviations'"base_in_cam_pose_deviations""base_in_cam_pose_deviations""base_in_cam_pose_deviations""base_in_cam_pose_deviations""base_in_cam_pose_deviations", 'calib_settings'"calib_settings""calib_settings""calib_settings""calib_settings""calib_settings", 'camera_calib_error'"camera_calib_error""camera_calib_error""camera_calib_error""camera_calib_error""camera_calib_error", 'camera_setup_model'"camera_setup_model""camera_setup_model""camera_setup_model""camera_setup_model""camera_setup_model", 'common_motion_vector'"common_motion_vector""common_motion_vector""common_motion_vector""common_motion_vector""common_motion_vector", 'excluded_settings'"excluded_settings""excluded_settings""excluded_settings""excluded_settings""excluded_settings", 'hand_eye_calib_error'"hand_eye_calib_error""hand_eye_calib_error""hand_eye_calib_error""hand_eye_calib_error""hand_eye_calib_error", 'init_params'"init_params""init_params""init_params""init_params""init_params", 'init_pose'"init_pose""init_pose""init_pose""init_pose""init_pose", 'num_calib_objs'"num_calib_objs""num_calib_objs""num_calib_objs""num_calib_objs""num_calib_objs", 'num_cameras'"num_cameras""num_cameras""num_cameras""num_cameras""num_cameras", 'num_marks'"num_marks""num_marks""num_marks""num_marks""num_marks", 'obj_in_base_pose'"obj_in_base_pose""obj_in_base_pose""obj_in_base_pose""obj_in_base_pose""obj_in_base_pose", 'obj_in_base_pose_covariances'"obj_in_base_pose_covariances""obj_in_base_pose_covariances""obj_in_base_pose_covariances""obj_in_base_pose_covariances""obj_in_base_pose_covariances", 'obj_in_base_pose_deviations'"obj_in_base_pose_deviations""obj_in_base_pose_deviations""obj_in_base_pose_deviations""obj_in_base_pose_deviations""obj_in_base_pose_deviations", 'obj_in_tool_pose'"obj_in_tool_pose""obj_in_tool_pose""obj_in_tool_pose""obj_in_tool_pose""obj_in_tool_pose", 'obj_in_tool_pose_covariances'"obj_in_tool_pose_covariances""obj_in_tool_pose_covariances""obj_in_tool_pose_covariances""obj_in_tool_pose_covariances""obj_in_tool_pose_covariances", 'obj_in_tool_pose_deviations'"obj_in_tool_pose_deviations""obj_in_tool_pose_deviations""obj_in_tool_pose_deviations""obj_in_tool_pose_deviations""obj_in_tool_pose_deviations", 'optimization_method'"optimization_method""optimization_method""optimization_method""optimization_method""optimization_method", 'params'"params""params""params""params""params", 'params_covariances'"params_covariances""params_covariances""params_covariances""params_covariances""params_covariances", 'params_deviations'"params_deviations""params_deviations""params_deviations""params_deviations""params_deviations", 'params_labels'"params_labels""params_labels""params_labels""params_labels""params_labels", 'pose'"pose""pose""pose""pose""pose", 'pose_labels'"pose_labels""pose_labels""pose_labels""pose_labels""pose_labels", 'reference_camera'"reference_camera""reference_camera""reference_camera""reference_camera""reference_camera", 'tool_in_base_pose'"tool_in_base_pose""tool_in_base_pose""tool_in_base_pose""tool_in_base_pose""tool_in_base_pose", 'tool_in_cam_pose'"tool_in_cam_pose""tool_in_cam_pose""tool_in_cam_pose""tool_in_cam_pose""tool_in_cam_pose", 'tool_in_cam_pose_covariances'"tool_in_cam_pose_covariances""tool_in_cam_pose_covariances""tool_in_cam_pose_covariances""tool_in_cam_pose_covariances""tool_in_cam_pose_covariances", 'tool_in_cam_pose_deviations'"tool_in_cam_pose_deviations""tool_in_cam_pose_deviations""tool_in_cam_pose_deviations""tool_in_cam_pose_deviations""tool_in_cam_pose_deviations", 'type'"type""type""type""type""type", 'x'"x""x""x""x""x", 'y'"y""y""y""y""y", 'z'"z""z""z""z""z"

DataValueDataValueDataValueDataValuedataValuedata_value (output_control)  attribute.value(-array) HTupleSequence[Union[float, int, str]]HTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)

Requested data.

Example (HDevelop)

* Get the camera type of camera 0.
get_calib_data (CalibDataID, 'camera', 0, 'type', CameraType)

* Get the optimized (calibrated) pose of pose 1 of the
* calibration object 2.
get_calib_data (CalibDataID, 'calib_obj_pose', [2,1], 'pose', CalobjPose)

Possible Predecessors

calibrate_camerascalibrate_camerasCalibrateCamerasCalibrateCamerasCalibrateCamerascalibrate_cameras, calibrate_hand_eyecalibrate_hand_eyeCalibrateHandEyeCalibrateHandEyeCalibrateHandEyecalibrate_hand_eye, create_calib_datacreate_calib_dataCreateCalibDataCreateCalibDataCreateCalibDatacreate_calib_data, read_calib_dataread_calib_dataReadCalibDataReadCalibDataReadCalibDataread_calib_data

Module

Calibration