Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now

More robust checkerboard detection, similar algorithm to libcbdetect

Project description

Checkerboard

PyPI version GitHub license

I could not find any libraries to find checkerboards robustly in Python, except for OpenCV. However, OpenCV's checkerboard tends to fail when the checkerboard is somewhat blurred or rotated.

Hence, this library was born. It may be slightly slower than OpenCV, but it will find that checkerboard.

Comparison of OpenCV vs this library (OpenCV on the left, checkerboard on the right): comparison

Quickstart

You can install checkerboard easily through pip:

pip install checkerboard

Then you can go ahead and detect checkerboards like so:

from checkerboard import detect_checkerboard

size = (9, 6) # size of checkerboard
image = ... # obtain checkerboard
corners, score = detect_checkerboard(image, size)

The corners returned are in the same format as the findChessboardCorners function from OpenCV, and are already computed to subpixel precision.

The score returned is a metric of the quality of the checkerboard detection. A perfectly detected checkerboard would have a score of 0, whereas a bad detection would have a score of 1.

References

The implementation of checkerboard detection is mainly based on libcbdetect and accompanying paper:

@INPROCEEDINGS{Geiger2012ICRA,
  author = {Andreas Geiger and Frank Moosmann and Oemer Car and Bernhard Schuster},
  title = {Automatic Calibration of Range and Camera Sensors using a single Shot},
  booktitle = {International Conference on Robotics and Automation (ICRA)},
  year = {2012}
} 

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
checkerboard-0.2.3-py3-none-any.whl (6.6 kB) Copy SHA256 hash SHA256 Wheel py3

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page