Skip to main content
Public camera intrinsics types and convenience constructors.

SimpleIntrinsics Objects

Simple camera intrinsics (focal length + principal point). Prefer the dedicated constructors (intrinsics_pinhole(), intrinsics_radial(), intrinsics_plumb_bob(), intrinsics_fisheye()) or the generic intrinsics_simple() rather than instantiating this class directly. The extra dict holds distortion coefficients and optional fields. Distortion coefficients are model-specific. The following optional fields apply to all models: dfx, dfy, dox, doy, skew.

AdvancedIntrinsics Objects

Advanced camera intrinsics (full calibration matrices). .. warning:: In most cases SimpleIntrinsics (via intrinsics_simple() or one of the dedicated constructors) is sufficient and much easier to work with. Only use advanced intrinsics when you have pre-computed full K / R / P calibration matrices and genuinely need to supply them directly. Prefer intrinsics_advanced() rather than instantiating this class directly. Arguments:
  • k - 9-element intrinsic camera matrix (row-major 3x3). Validated to have exactly 9 elements at build time.
  • r - 9-element rectification matrix (row-major 3x3). Validated to have exactly 9 elements at build time.
  • p - 12-element projection matrix (row-major 3x4). Validated to have exactly 12 elements at build time.
  • model - Optional distortion model name.

intrinsics_simple

Build simple camera intrinsics (focal length + principal point). For models without a dedicated constructor, pass the model name and its coefficients as keyword arguments:: intrinsics_simple(fx, fy, ox, oy, model=“division”, k=0.01) intrinsics_simple(fx, fy, ox, oy, model=“ucm”, xi=0.5, k1=0.1, k2=0.0, k3=0.0) Arguments:
  • fx - Focal length along the x-axis (pixels).
  • fy - Focal length along the y-axis (pixels).
  • ox - Principal-point x offset (pixels).
  • oy - Principal-point y offset (pixels).
  • model - Optional distortion model name.
  • **kwargs - Distortion coefficients and optional extra fields.

intrinsics_advanced

Build advanced camera intrinsics using full calibration matrices. .. warning:: In most cases intrinsics_simple() (or one of the dedicated constructors) is sufficient. Only reach for advanced intrinsics when you have pre-computed K / R / P matrices. Arguments:
  • k - 9-element intrinsic camera matrix (row-major 3x3).
  • r - 9-element rectification matrix (row-major 3x3).
  • p - 12-element projection matrix (row-major 3x4).
  • model - Optional distortion model name.

intrinsics_pinhole

Build pinhole intrinsics (no distortion coefficients). Arguments:
  • fx - Focal length along the x-axis (pixels).
  • fy - Focal length along the y-axis (pixels).
  • ox - Principal-point x offset (pixels).
  • oy - Principal-point y offset (pixels).

intrinsics_radial

Build intrinsics with a radial distortion model. Arguments:
  • fx - Focal length along the x-axis (pixels).
  • fy - Focal length along the y-axis (pixels).
  • ox - Principal-point x offset (pixels).
  • oy - Principal-point y offset (pixels).
  • k1 - First radial distortion coefficient.
  • k2 - Second radial distortion coefficient.
  • k3 - Third radial distortion coefficient.

intrinsics_plumb_bob

Build intrinsics with a plumb-bob (Brown-Conrady) distortion model. Arguments:
  • fx - Focal length along the x-axis (pixels).
  • fy - Focal length along the y-axis (pixels).
  • ox - Principal-point x offset (pixels).
  • oy - Principal-point y offset (pixels).
  • k1 - First radial distortion coefficient.
  • k2 - Second radial distortion coefficient.
  • k3 - Third radial distortion coefficient.
  • t1 - First tangential distortion coefficient.
  • t2 - Second tangential distortion coefficient.

intrinsics_fisheye

Build intrinsics with a fisheye (Kannala-Brandt) distortion model. Arguments:
  • fx - Focal length along the x-axis (pixels).
  • fy - Focal length along the y-axis (pixels).
  • ox - Principal-point x offset (pixels).
  • oy - Principal-point y offset (pixels).
  • k1 - First distortion coefficient.
  • k2 - Second distortion coefficient.
  • k3 - Third distortion coefficient.
  • k4 - Fourth distortion coefficient.

intrinsics_rational_polynomial

Build intrinsics with a rational-polynomial distortion model. Arguments:
  • fx - Focal length along the x-axis (pixels).
  • fy - Focal length along the y-axis (pixels).
  • ox - Principal-point x offset (pixels).
  • oy - Principal-point y offset (pixels).
  • k1 - First radial distortion coefficient.
  • k2 - Second radial distortion coefficient.
  • k3 - Third radial distortion coefficient.
  • k4 - Fourth radial distortion coefficient.
  • k5 - Fifth radial distortion coefficient.
  • k6 - Sixth radial distortion coefficient.
  • t1 - First tangential distortion coefficient.
  • t2 - Second tangential distortion coefficient.

intrinsics_cylindrical

Build intrinsics with a cylindrical distortion model (no coefficients). Arguments:
  • fx - Focal length along the x-axis (pixels).
  • fy - Focal length along the y-axis (pixels).
  • ox - Principal-point x offset (pixels).
  • oy - Principal-point y offset (pixels).