machinevisiontoolbox.Camera.CentralCamera.distortion

property CentralCamera.distortion

Set/Get distortion model (base method)

Returns:

distortion model

Return type:

array_like()

The distortion model is a vector of various lengths that can be read or written. It is passed directly to OpenCV functions which define how it is used:

  • 4-element vector, \([k_1, k_2, p_1, p_2]\)

  • 5-element vector, \([k_1, k_2, p_1, p_2, k_3]\)

  • 8-element vector, \([k_1, k_2, p_1, p_2, k_3, k_4, k_5, k_6]\)

  • 12-element vector, \([k_1, k_2, p_1, p_2, k_3, k_4, k_5, k_6, s_1, s_2, s_3, s_4]\),

  • 14-element vector, \([k_1, k_2, p_1, p_2, k_3, k_4, k_5, k_6, s_1, s_2, s_3, s_4, \tau_x, \tau_y]\)

The elements \(k_i\) are radial distortion coefficients, \(p_i\) are tangential distortion coefficients, \(s_i\) are thin prism distortion coefficients, and \(\tau_i\) apply when the camera’s image plane is tilted with respect to the lens.

If the vector is None, then zero distortion (all coefficients are zero) is assumed.

Seealso:

project_point OpenCV distortion model