BrownConrady

class sonic.BrownConrady

Bases: sonic.DistortionModel

Constructor Summary
BrownConrady(p1, p2, k1, k2, k3)

Constructs a BrownConrady object, which contains the parameters of the Brown Conrady camera distortion model

Inputs:
  • p1 (1x1 double): Vertical decentering

  • p2 (1x1 double): Horizontal decentering

  • k1 (1x1 double): Order 2 radial distortion

  • k2 (1x1 double): Order 4 radial distortion

  • k3 (1x1 double): Order 6 radial distortion

Outputs:
  • obj (sonic.BrownConrady): BrownConrady object, encoding the parameters of the distortion model

Last revised: 2/21/24 Last author: Ava Thrasher

Property Summary
k1
k2
k3
p1
p2
Method Summary
distort(points)

Takes image plane coordinates and distorts them based on the Brown Conrady model

Inputs:
  • obj (1x1 sonic.BrownConrady)

  • points (1x1 sonic.Points2): image plane coordinates of points to distort

Outputs:
  • pointsd (1x1 sonic.Points2): image plane coordinates of distorted points

Last revised: 2/28/24 Last author: Ava Thrasher

undistort(pointsd)

Takes distorted image plane coordinates and undistorts them using a fixed point iteration and provided Brown Conrady model

Inputs:
  • obj (1x1 sonic.BrownConrady)

  • pointsd (1x1 sonic.Points2): image plane coordinates of distorted points

Outputs:
  • points (1x1 sonic.Points2): image plane coordinates of points to distort

  • convergeMask (1xn boolean): array containing true if the i-th point converged, or false if it did not

Last revised: 2/28/24 Last author: Ava Thrasher