get_stereo_model_objectGetStereoModelObjectGetStereoModelObjectget_stereo_model_objectT_get_stereo_model_object🔗

Short description🔗

get_stereo_model_objectGetStereoModelObjectGetStereoModelObjectget_stereo_model_objectT_get_stereo_model_object — Get intermediate iconic results of a stereo reconstruction.

Signature🔗

get_stereo_model_object( out object Object, stereo_model StereoModelID, number PairIndex, string ObjectName )

Description🔗

With the operator get_stereo_model_objectGetStereoModelObject you can access and inspect intermediate iconic results of a surface reconstruction performed with reconstruct_surface_stereoReconstructSurfaceStereo for the stereo model StereoModelIDstereoModelIDstereo_model_id. In particular, this is useful for troubleshooting the reconstruction process. Note that to collect the iconic results, you must enable the 'persistence'"persistence" mode for the stereo model (see set_stereo_model_paramSetStereoModelParam) before performing the reconstruction. Iconic results are then associated with each image pair that was processed during the reconstruction (see get_stereo_model_image_pairsGetStereoModelImagePairs).

You select the image pair of interest by specifying the corresponding camera indices [From, To] in PairIndexpairIndexpair_index. By setting one of the following values in ObjectNameobjectNameobject_name, the corresponding iconic objects are then returned in ObjectobjectValobject:

'from_image_rect'"from_image_rect", 'to_image_rect'"to_image_rect": Rectified image corresponding to the from and to camera, respectively. Both images can be used to inspect the quality of the internal binocular stereo image rectification.
'disparity_image'"disparity_image": Disparity image for this pair. The quality of the disparity image has a direct impact on the final surface reconstruction.
'score_image'"score_image": Score image assigned to the disparity image for this pair.

A mismatch between the rectified images, i.e., features appearing in different rows in the two images, or errors in the disparity or the score image have direct impact on the quality of the final surface reconstruction. Therefore, we recommend to correct any detected imperfections by adjusting the stereo model parameters (see set_stereo_model_paramSetStereoModelParam), in particular those which control the internal usage of gen_binocular_rectification_mapGenBinocularRectificationMap and binocular_disparityBinocularDisparity (see set_stereo_model_image_pairsSetStereoModelImagePairs and reconstruct_surface_stereoReconstructSurfaceStereo for further details).

Execution information🔗

Execution information

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

Parameters🔗

ObjectobjectValobject (output_object) object(-array) → objectHObjectHObjectHObjectHobject *

Iconic result.

StereoModelIDstereoModelIDstereo_model_id (input_control) stereo_model → (handle)HTuple (HHandle)HStereoModel, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the stereo model.

PairIndexpairIndexpair_index (input_control) number(-array) → (integer / string / real)HTuple (Hlong / HString / double)HTuple (int / long / string / double)MaybeSequence[Union[int, str, float]]Htuple (Hlong / char* / double)

Camera indices of the pair ([From, To]).

Suggested values: 0, 1, 20, 1, 2

ObjectNameobjectNameobject_name (input_control) string → (string)HTuple (HString)HTuple (string)strHtuple (char*)

Name of the iconic result to be returned.

Suggested values: 'from_image_rect', 'to_image_rect', 'disparity_image', 'score_image'

Combinations with other operators🔗

Combinations

Possible predecessors

reconstruct_surface_stereoReconstructSurfaceStereo

Module🔗

3D Metrology