Skip to content

disparity_to_distancedisparity_to_distanceDisparityToDistanceDisparityToDistancedisparity_to_distanceT_disparity_to_distance🔗

Short description🔗

disparity_to_distancedisparity_to_distanceDisparityToDistanceDisparityToDistancedisparity_to_distanceT_disparity_to_distance — Transform a disparity value into a distance value in a rectified binocular stereo system.

Signature🔗

disparity_to_distance( campar CamParamRect1, campar CamParamRect2, pose RelPoseRect, number Disparity, out real Distance )disparity_to_distance( : : CamParamRect1, CamParamRect2, RelPoseRect, Disparity : Distance )void DisparityToDistance( const HTuple& CamParamRect1, const HTuple& CamParamRect2, const HTuple& RelPoseRect, const HTuple& Disparity, HTuple* Distance )static void HOperatorSet.DisparityToDistance( HTuple camParamRect1, HTuple camParamRect2, HTuple relPoseRect, HTuple disparity, out HTuple distance )def disparity_to_distance( cam_param_rect_1: Sequence[Union[int, float, str]], cam_param_rect_2: Sequence[Union[int, float, str]], rel_pose_rect: Sequence[Union[int, float]], disparity: MaybeSequence[Union[int, float]] ) -> Sequence[float]

def disparity_to_distance_s( cam_param_rect_1: Sequence[Union[int, float, str]], cam_param_rect_2: Sequence[Union[int, float, str]], rel_pose_rect: Sequence[Union[int, float]], disparity: MaybeSequence[Union[int, float]] ) -> floatHerror T_disparity_to_distance( const Htuple CamParamRect1, const Htuple CamParamRect2, const Htuple RelPoseRect, const Htuple Disparity, Htuple* Distance )

HTuple HCamPar::DisparityToDistance( const HCamPar& CamParamRect2, const HPose& RelPoseRect, const HTuple& Disparity ) const

double HCamPar::DisparityToDistance( const HCamPar& CamParamRect2, const HPose& RelPoseRect, double Disparity ) const

HTuple HPose::DisparityToDistance( const HCamPar& CamParamRect1, const HCamPar& CamParamRect2, const HTuple& Disparity ) const

double HPose::DisparityToDistance( const HCamPar& CamParamRect1, const HCamPar& CamParamRect2, double Disparity ) const

HTuple HCamPar.DisparityToDistance( HCamPar camParamRect2, HPose relPoseRect, HTuple disparity )

double HCamPar.DisparityToDistance( HCamPar camParamRect2, HPose relPoseRect, double disparity )

HTuple HPose.DisparityToDistance( HCamPar camParamRect1, HCamPar camParamRect2, HTuple disparity )

double HPose.DisparityToDistance( HCamPar camParamRect1, HCamPar camParamRect2, double disparity )

Description🔗

disparity_to_distanceDisparityToDistance transforms a disparity value into a distance of an object point to the binocular stereo system. The cameras of this system must be rectified and are defined by the rectified internal parameters CamParamRect1camParamRect1cam_param_rect_1 of camera 1 and CamParamRect2camParamRect2cam_param_rect_2 of camera 2, and the external parameters RelPoseRectrelPoseRectrel_pose_rect. Latter specifies the relative pose of both cameras to each other by defining a point transformation from rectified camera system 2 to rectified camera system 1. These parameters can be obtained from the operator calibrate_camerasCalibrateCameras and gen_binocular_rectification_mapGenBinocularRectificationMap. The disparity value Disparitydisparitydisparity is defined by the column difference of the image coordinates of two corresponding points on an epipolar line according to the equation \(d = c_{2} - c_{1}\)(see also binocular_disparityBinocularDisparity). This value characterises a set of 3D object points of an equal distance to a plane being parallel to the rectified image plane of the stereo system. The distance to the subset plane z=0 which is parallel to the rectified image plane and contains the optical centers of both cameras is returned in Distancedistancedistance.

Attention🔗

If using cameras with telecentric lenses, the Distancedistancedistance is not defined as the distance of a point to the camera but as the distance from the point to the plane, defined by the y-axes of both cameras and their baseline (see gen_binocular_rectification_mapGenBinocularRectificationMap).

For a stereo setup of mixed type (i.e., for a stereo setup in which one of the original cameras is a perspective camera and the other camera is a telecentric camera; see gen_binocular_rectification_mapGenBinocularRectificationMap), the rectifying plane of the two cameras is in a position with respect to the object that would lead to very unintuitive distances. Therefore, disparity_to_distanceDisparityToDistance does not support stereo setups of mixed type. For stereo setups of mixed type, disparity_to_point_3dDisparityToPoint3d should be used instead.

Additionally, stereo setups that contain cameras with and without hypercentric lenses at the same time are not supported.

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🔗

CamParamRect1camParamRect1cam_param_rect_1 (input_control) campar → (real / integer / string)(real / integer / string)HTuple (double / Hlong / HString)HCamPar, HTuple (double / int / long / string)Sequence[Union[int, float, str]]Htuple (double / Hlong / char*)

Rectified internal camera parameters of camera 1.

CamParamRect2camParamRect2cam_param_rect_2 (input_control) campar → (real / integer / string)(real / integer / string)HTuple (double / Hlong / HString)HCamPar, HTuple (double / int / long / string)Sequence[Union[int, float, str]]Htuple (double / Hlong / char*)

Rectified internal camera parameters of camera 2.

RelPoseRectrelPoseRectrel_pose_rect (input_control) pose → (real / integer)(real / integer)HTuple (double / Hlong)HPose, HTuple (double / int / long)Sequence[Union[int, float]]Htuple (double / Hlong)

Point transformation from the rectified camera 2 to the rectified camera 1.

Number of elements: 7

Disparitydisparitydisparity (input_control) number(-array) → (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[int, float]]Htuple (double / Hlong)

Disparity between the images of the world point.

Distancedistancedistance (output_control) real(-array) → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Distance of a world point to the rectified camera system.

Result🔗

disparity_to_distanceDisparityToDistance returns 2 (H_MSG_TRUE) if all parameter values are correct. If necessary, an exception is raised.

Combinations with other operators🔗

Combinations

Possible predecessors

binocular_calibrationBinocularCalibration, gen_binocular_rectification_mapGenBinocularRectificationMap, map_imageMapImage, binocular_disparityBinocularDisparity

Alternatives

binocular_distanceBinocularDistance

See also

distance_to_disparityDistanceToDisparity, disparity_to_point_3dDisparityToPoint3d

Module🔗

3D Metrology