set_calib_data_calib_objectT_set_calib_data_calib_objectSetCalibDataCalibObjectSetCalibDataCalibObjectset_calib_data_calib_object (Operator)

Name

set_calib_data_calib_objectT_set_calib_data_calib_objectSetCalibDataCalibObjectSetCalibDataCalibObjectset_calib_data_calib_object — Define a calibration object in a calibration model.

Signature

Description

The operator set_calib_data_calib_objectset_calib_data_calib_objectSetCalibDataCalibObjectSetCalibDataCalibObjectSetCalibDataCalibObjectset_calib_data_calib_object defines the calibration object with the index CalibObjIdxCalibObjIdxCalibObjIdxCalibObjIdxcalibObjIdxcalib_obj_idx in the camera calibration data model CalibDataIDCalibDataIDCalibDataIDCalibDataIDcalibDataIDcalib_data_id. The index must be between 0 and NumCalibObjects-1 (NumCalibObjects is specified during model creation with create_calib_datacreate_calib_dataCreateCalibDataCreateCalibDataCreateCalibDatacreate_calib_data and can be queried with get_calib_dataget_calib_dataGetCalibDataGetCalibDataGetCalibDataget_calib_data).

If a calibration object description with index CalibObjIdxCalibObjIdxCalibObjIdxCalibObjIdxcalibObjIdxcalib_obj_idx is already defined, then the current object description overwrites it (the description is 'substituted'). Note that all NumCalibObjects calibration objects must be set to perform calibrate_camerascalibrate_camerasCalibrateCamerasCalibrateCamerasCalibrateCamerascalibrate_cameras.

The parameter CalibObjDescrCalibObjDescrCalibObjDescrCalibObjDescrcalibObjDescrcalib_obj_descr can be used in two ways:

as a file name:

it specifies a calibration plate description file as created with create_caltabcreate_caltabCreateCaltabCreateCaltabCreateCaltabcreate_caltab or gen_caltabgen_caltabGenCaltabGenCaltabGenCaltabgen_caltab.

as a numerical tuple:

it specifies the 3D coordinates of all points of the calibration object. All X, Y, and Z coordinates, respectively, of all points must be packed sequentially in the tuple in form: [X, Y, Z], i.e., [X1, ..., Xn, Y1, ..., Yn, Z1, ..., Zn], where |X| = |Y| = |Z| and all coordinates are in meters.

To query the calibration objects parameters stored earlier in a calibration data model, use get_calib_dataget_calib_dataGetCalibDataGetCalibDataGetCalibDataget_calib_data.

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

Execution Information

• 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:

• CalibDataIDCalibDataIDCalibDataIDCalibDataIDcalibDataIDcalib_data_id

During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.

Parameters

Possible Predecessors

create_calib_datacreate_calib_dataCreateCalibDataCreateCalibDataCreateCalibDatacreate_calib_data, set_calib_data_cam_paramset_calib_data_cam_paramSetCalibDataCamParamSetCalibDataCamParamSetCalibDataCamParamset_calib_data_cam_param

Possible Successors

set_calib_data_cam_paramset_calib_data_cam_paramSetCalibDataCamParamSetCalibDataCamParamSetCalibDataCamParamset_calib_data_cam_param, set_calib_data_observ_pointsset_calib_data_observ_pointsSetCalibDataObservPointsSetCalibDataObservPointsSetCalibDataObservPointsset_calib_data_observ_points, find_calib_objectfind_calib_objectFindCalibObjectFindCalibObjectFindCalibObjectfind_calib_object

Module

Calibration