find_caltabfind_caltabfind_caltabFindCaltabFindCaltab (Operator)

Name

find_caltabfind_caltabfind_caltabFindCaltabFindCaltab — Segment the standard calibration plate region in the image.

Signature

Description

find_caltabfind_caltabfind_caltabFindCaltabFindCaltab is used to determine the region of a plane calibration plate with circular marks in the input image ImageImageImageImageimage. First the input image is smoothed (see gauss_imagegauss_imagegauss_imageGaussImageGaussImage); the size of the used filter mask is given by SizeGaussSizeGaussSizeGaussSizeGausssizeGauss. Afterwards, a thresholding operator (see thresholdthresholdthresholdThresholdThreshold) with minimum gray value MarkThreshMarkThreshMarkThreshMarkThreshmarkThresh is applied. Among the extracted connected regions the most convex region with almost correct number of holes (corresponding to the dark marks of the calibration plate) is selected. Holes with a diameter smaller than the expected size of the marks MinDiamMarksMinDiamMarksMinDiamMarksMinDiamMarksminDiamMarks are eliminated to reduce the impact of noise. The number of marks is read from the calibration plate description file CalTabDescrFileCalTabDescrFileCalTabDescrFileCalTabDescrFilecalTabDescrFile. The complete explanation of this file can be found within the description of gen_caltabgen_caltabgen_caltabGenCaltabGenCaltab.

Parallelization

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

* read calibration image
read_image(Image, 'calib-01')
* find calibration pattern
find_caltab(Image, Caltab, 'caltab.descr', 3, 112, 5)

* read calibration image
read_image(Image, 'calib-01')
* find calibration pattern
find_caltab(Image, Caltab, 'caltab.descr', 3, 112, 5)

// read calibration image
HImage Image("calib-01") ;
// find calibration pattern
HRegion Caltab = Image.FindCaltab("caltab.descr", 3,112, 5);

* read calibration image
read_image(Image, 'calib-01')
* find calibration pattern
find_caltab(Image, Caltab, 'caltab.descr', 3, 112, 5)

* read calibration image
read_image(Image, 'calib-01')
* find calibration pattern
find_caltab(Image, Caltab, 'caltab.descr', 3, 112, 5)

Result

find_caltabfind_caltabfind_caltabFindCaltabFindCaltab returns 2 (H_MSG_TRUE) if all parameter values are correct and an image region is found. The behavior in case of empty input (no image given) can be set via set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>) and the behavior in case of an empty result region via set_system(::'store_empty_region',<true/false>:)set_system("store_empty_region",<true/false>)set_system("store_empty_region",<true/false>)SetSystem("store_empty_region",<true/false>)SetSystem("store_empty_region",<true/false>). If necessary, an exception is raised.

Possible Predecessors

read_imageread_imageread_imageReadImageReadImage

Possible Successors

find_marks_and_posefind_marks_and_posefind_marks_and_poseFindMarksAndPoseFindMarksAndPose

See also

find_marks_and_posefind_marks_and_posefind_marks_and_poseFindMarksAndPoseFindMarksAndPose, camera_calibrationcamera_calibrationcamera_calibrationCameraCalibrationCameraCalibration, disp_caltabdisp_caltabdisp_caltabDispCaltabDispCaltab, sim_caltabsim_caltabsim_caltabSimCaltabSimCaltab, caltab_pointscaltab_pointscaltab_pointsCaltabPointsCaltabPoints, gen_caltabgen_caltabgen_caltabGenCaltabGenCaltab

Module

Foundation