calibrate_camerasT_calibrate_camerasCalibrateCamerasCalibrateCameras (Operator)

Name

calibrate_camerasT_calibrate_camerasCalibrateCamerasCalibrateCameras — Determine all camera parameters by a simultaneous minimization process.

Signature

calibrate_cameras( : : CalibDataID : Error)

Description

The operator calibrate_camerascalibrate_camerasCalibrateCamerasCalibrateCamerasCalibrateCameras calculates the internal and external camera parameters of a calibration data model specified in CalibDataIDCalibDataIDCalibDataIDCalibDataIDcalibDataID. The calibration data model describes a setup of one or more cameras and is specified during the creation of the data model. You can find detailed information about the calibration process in the chapter reference Calibration / Multi-View.

The root mean square error (RMSE) of the back projection of the optimization is returned in ErrorErrorErrorErrorerror (in pixels). The error gives a general indication whether the optimization was successful. You can find more details about the RSME in the chapter reference mentioned above.

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:

CalibDataIDCalibDataIDCalibDataIDCalibDataIDcalibDataID

The value of this parameter may not be shared across multiple threads without external synchronization.

Parameters

CalibDataIDCalibDataIDCalibDataIDCalibDataIDcalibDataID (input_control, state is modified) calib_data → (handle)

Handle of a calibration data model.

ErrorErrorErrorErrorerror (output_control) number → (real)

Back projection root mean square error (RMSE) of the optimization.

Possible Predecessors

create_calib_datacreate_calib_dataCreateCalibDataCreateCalibDataCreateCalibData, set_calib_data_cam_paramset_calib_data_cam_paramSetCalibDataCamParamSetCalibDataCamParamSetCalibDataCamParam, set_calib_data_calib_objectset_calib_data_calib_objectSetCalibDataCalibObjectSetCalibDataCalibObjectSetCalibDataCalibObject, set_calib_data_observ_pointsset_calib_data_observ_pointsSetCalibDataObservPointsSetCalibDataObservPointsSetCalibDataObservPoints, find_calib_objectfind_calib_objectFindCalibObjectFindCalibObjectFindCalibObject, set_calib_dataset_calib_dataSetCalibDataSetCalibDataSetCalibData, remove_calib_data_observremove_calib_data_observRemoveCalibDataObservRemoveCalibDataObservRemoveCalibDataObserv

Possible Successors

get_calib_dataget_calib_dataGetCalibDataGetCalibDataGetCalibData

References

Carsten Steger: “A Comprehensive and Versatile Camera Model for Cameras with Tilt Lenses”; International Journal of Computer Vision, vol. 123, no. 2, pp. 121-159, 2017.

Module

Calibration

Operators