Calibration

Posted 2022-03-09 larry-xia

Calibration

 First, choose the description file for your calibration plate and the calibration plate Thickness (in mm). The name of the description file indicates the size of the plate and the file extension indicates the type of the calibration plate. In particular, the file ending .cpd is used for calibration plates with hexagonally arranged marks and the file extension .descr is used for calibration plates with rectangularly arranged marks. Note that calibration plates with hexagonally arranged marks usually have light marks on a dark background. Nevertheless, also calibration plates with dark marks on a light background are available. Then, you have to choose a description file with the filename ending "_dark_on_light". Calibration plates with rectangularly arranged marks always have dark marks on a light background. With the parameter Thickness, you can modify the position of the world coordinate system and the measurement plane, which is located beneath the calibration plate surface by the value of Thickness in the

Reference Image (page 195).

gen_caltab()　　Generate a calibration plate description file and a corresponding PostScript file for a calibration plate with rectangularly arranged marks.

生成的标定板的坐标系为：原点位于所有mark点的质心，z轴指向标定板内部，x轴向右，y轴向下。

生成的描述文件默认后缀名为descr,以#开始的行为注释行

create_caltab()　　Generate a calibration plate description file and a corresponding PostScript file for a calibration plate with hexagonally arranged marks.

The calibration plate contains one to five finder patterns. A finder pattern is a special mark hexagon (i.e. a mark and its six neighbors) where either four or six marks contain a hole. Each of these up to five finder patterns is unique such that it can be used to determine the orientation of the calibration plate and the position of the finder pattern on the calibration plate. As a consequence, the calibration plate can only be found by find_calib_object if at least one of these finder patterns is completely visible. The position of the central mark of each finder pattern is given in FinderRow and FinderColumn. Thus, the length of the tuples given in FinderRow and FinderColumn, respectively determine the number of finder patterns on the calibration plate. Be aware that two finder patterns must not overlap. It is recommended to keep a certain distance between the finder patterns. As a rule of thumb, if the calibration plate contains too little marks to place all finder patterns in distinct positions, it is better to reduce the number of finder patterns so that they can be distributed more evenly.

The coordinate system of the calibration plate is located at the center of the central mark of the first finder pattern.

Depending on Polarity the marks are either light on dark background (for ‘light_on_dark‘, which is the default) or dark on light background (for ‘dark_on_light‘).

caltab_points()　　Read the mark center points from the calibration plate description file.

create_calib_data()　　创建一个halcon标定数据模型

set_calib_data_cam_param()　　设置标定模型的初始参数值

set_calib_data_calib_object()　　指定标定数据模型的标定板描述文件

find_calib_object()　　Find the halcon calibration plate and set the extracted points and contours in a calibration data model.

get_calib_data()　　Query data stored or computed in a calibration data model.

get_calib_data_observ_points()　　Get point-based observation data from a calibration data model.

get_calib_data_observ_contours()　　Get contour-based observation data from a calibration data model.

calibrate_cameras()　　计算标定数据模型的相机内外参数，The root mean square error (RMSE) of the back projection of the optimization is returned in Error (in pixels). The error gives a general indication whether the optimization was successful.