get_stereo_model_paramT_get_stereo_model_paramget_stereo_model_paramGetStereoModelParamGetStereoModelParam (Operator)

Name

get_stereo_model_paramT_get_stereo_model_paramget_stereo_model_paramGetStereoModelParamGetStereoModelParam — Get stereo model parameters.

Signature

Description

The operator get_stereo_model_paramget_stereo_model_paramget_stereo_model_paramGetStereoModelParamGetStereoModelParam can be used to inspect diverse parameters of the stereo model StereoModelIDStereoModelIDStereoModelIDStereoModelIDstereoModelID by specifying their names in ParamNameParamNameParamNameParamNameparamName and getting their values in ParamValueParamValueParamValueParamValueparamValue. Two types of parameters can be inspected with this operator - general and specific for surface reconstruction. Note that no specific parameters are provided for 3D point stereo reconstruction.

All parameters that can be set with set_stereo_model_paramset_stereo_model_paramset_stereo_model_paramSetStereoModelParamSetStereoModelParam can also be queried with get_stereo_model_paramget_stereo_model_paramget_stereo_model_paramGetStereoModelParamGetStereoModelParam - for a description see the former operator. In constrast, the following parameters are set by other operators and cannot be modified afterwards.

General parameters

'type'"type""type""type""type":

Type of the stereo model (currently either 'surface_pairwise'"surface_pairwise""surface_pairwise""surface_pairwise""surface_pairwise" or 'points_3d'"points_3d""points_3d""points_3d""points_3d").

'camera_setup_model'"camera_setup_model""camera_setup_model""camera_setup_model""camera_setup_model":

Handle to a copy of the camera setup model set in the stereo model. Changing properties of the copy does not affect the camera setup model stored in the stereo model. Once the copy is not needed anymore, you must release its memory with clear_camera_setup_modelclear_camera_setup_modelclear_camera_setup_modelClearCameraSetupModelClearCameraSetupModel.

These parameters are set when creating the stereo model with create_stereo_modelcreate_stereo_modelcreate_stereo_modelCreateStereoModelCreateStereoModel.

Surface reconstruction parameters

'min_disparity'"min_disparity""min_disparity""min_disparity""min_disparity",'max_disparity'"max_disparity""max_disparity""max_disparity""max_disparity":

Tuple of minimum or maximum disparity settings, respectively, for each image pair. This settings are computed internally from the bounding box specified for the stereo model (see set_stereo_model_paramset_stereo_model_paramset_stereo_model_paramSetStereoModelParamSetStereoModelParam) and are then used as the parameters MinDisparity and MaxDisparity, respectively, in the internal call to binocular_disparitybinocular_disparitybinocular_disparityBinocularDisparityBinocularDisparity for the corresonding image pair. The indices of the image pairs can be queried by get_stereo_model_image_pairsget_stereo_model_image_pairsget_stereo_model_image_pairsGetStereoModelImagePairsGetStereoModelImagePairs. Note that this information is only available if the 'persistence'"persistence""persistence""persistence""persistence" mode was switched on during surface reconstruction (see reconstruct_surface_stereoreconstruct_surface_stereoreconstruct_surface_stereoReconstructSurfaceStereoReconstructSurfaceStereo). Note furthermore that the returned values are tuple-valued and cannot be queried together with other parameters (more on this in the the paragraph "A note on tuple-valued model parameters" below).

A note on tuple-valued model parameters

Most of the stereo model parameters are single-valued. Thus, you can provide a list (i.e., tuple) of parameter names and get a list (tuple) of values that has the same length as the output tuple. In contrast, when querying a tuple-valued parameter, a tuple of values is returned. When querying such a parameter together with other parameters, the value-to-parameter-name correspondence is not obvious anymore. Thus, tuple-valued parameters like 'min_disparity'"min_disparity""min_disparity""min_disparity""min_disparity" or and 'max_disparity'"max_disparity""max_disparity""max_disparity""max_disparity" should always be queried in a separate call to get_stereo_model_paramget_stereo_model_paramget_stereo_model_paramGetStereoModelParamGetStereoModelParam.

Parallelization

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

Parameters

Module

3D Metrology