lensboy 1.0.0

lensboy for camera calibrations

lensboy

Camera calibration for vision engineers. Extremely simple to use, and maximally powerful.

Supports OpenCV camera models and spline-based distortion models for lenses that OpenCV can't handle.

Why lensboy

Even for standard OpenCV models, lensboy gives you better calibrations than raw cv2.calibrateCamera:

• Automatic outlier filtering removes bad detections
• Target warp estimation compensates for non-flat calibration boards
• Analysis tools to verify your calibration is actually good

For wide-angle lenses where OpenCV's polynomial distortion model isn't enough, lensboy offers spline-based distortion models that can capture arbitrary distortion patterns. This approach is inspired by mrcal, but lensboy is designed to be easier to use and trivial to install.

Install

For calibration time, includes analysis and plotting tools:

pip install lensboy[analysis]

For loading and using the camera models:

pip install lensboy

Getting started

See the quickstart notebook for a full walkthrough covering both OpenCV and spline models.

Spline models

When OpenCV residuals show systematic patterns at the edges, switch to a spline model. These use B-spline grids instead of polynomial coefficients, and can capture arbitrary distortion patterns. The calibrated spline model can be converted to a pinhole model with undistortion maps for use in your application.