1 Colour - Checker Detection

A Python package implementing various colour checker detection algorithms and related utilities.

It is open source and freely available under the BSD-3-Clause terms.

1.1 Features

The following colour checker detection algorithms are implemented:

• Segmentation

1.1.1 Examples

Various usage examples are available from the examples directory.

1.2 User Guide

User Guide

The user guide provides an overview of Colour - Checker Detection and explains important concepts and features, details can be found in the API Reference.

Installation Guide

Because of their size, the resources dependencies needed to run the various examples and unit tests are not provided within the Pypi package. They are separately available as Git Submodules when cloning the repository.

Primary Dependencies

Colour - Checker Detection requires various dependencies in order to run:

• python >= 3.8, < 4

• colour-science >= 4.3

• imageio >= 2, < 3

• numpy >= 1.22, < 2

• opencv-python >= 4, < 5

• scipy >= 1.8, < 2

Pypi

Once the dependencies are satisfied, Colour - Checker Detection can be installed from the Python Package Index by issuing this command in a shell:

pip install --user colour-checker-detection

The tests suite dependencies are installed as follows:

pip install --user 'colour-checker-detection[tests]'

The documentation building dependencies are installed as follows:

pip install --user 'colour-checker-detection[docs]'

The overall development dependencies are installed as follows:

pip install --user 'colour-checker-detection[development]'

Bibliography

Abe11

Felix Abecassis. Opencv - rotation (deskewing). 2011. URL: http://felix.abecassis.me/2011/10/opencv-rotation-deskewing/ (visited on 2018-10-27).

1.3 API Reference

API Reference

Colour - Checker Detection

Colour Checker Detection

Segmentation

colour_checker_detection

SETTINGS_SEGMENTATION_COLORCHECKER_CLASSIC	Settings for the segmentation of the X-Rite ColorChecker Classic and X-Rite ColorChecker Passport.
SETTINGS_SEGMENTATION_COLORCHECKER_SG	Settings for the segmentation of the X-Rite ColorChecker SG*.
colour_checkers_coordinates_segmentation(image)	Detect the colour checkers coordinates in given image \(image\) using segmentation.
extract_colour_checkers_segmentation(image, ...)	Extract the colour checkers sub-images in given image using segmentation.
detect_colour_checkers_segmentation(image[, ...])	Detect the colour checkers swatches in given image using segmentation.

Indices and tables

• Index

• Search Page

1.4 Code of Conduct

The Code of Conduct, adapted from the Contributor Covenant 1.4, is available on the Code of Conduct page.

1.5 Contact & Social

The Colour Developers can be reached via different means:

• Email

• Facebook

• Github Discussions

• Gitter

• Twitter

1.6 About

Colour - Checker Detection by Colour Developers

Copyright 2018 Colour Developers – colour-developers@colour-science.org

This software is released under terms of BSD-3-Clause: https://opensource.org/licenses/BSD-3-Clause

colour-science/colour-checker-detection