# color.py¶

Sub-module providing color functions.

References,

`rgb_to_xyz`(red, green, blue)[source]

Convert standard RGB color to XYZ color.

Parameters: red (int) – RGB value of Red. green (int) – RGB value of Green. blue (int) – RGB value of Blue. Tuple (X, Y, Z) representing XYZ color tuple

D65/2° standard illuminant

`xyz_to_lab`(x_val, y_val, z_val)[source]

Convert XYZ color to CIE-Lab color.

Parameters: x_val (float) – XYZ value of X. y_val (float) – XYZ value of Y. z_val (float) – XYZ value of Z. Tuple (L, a, b) representing CIE-Lab color tuple

D65/2° standard illuminant

`rgb_to_lab`[source]

Convert RGB color to CIE-Lab color.

Parameters: red (int) – RGB value of Red. green (int) – RGB value of Green. blue (int) – RGB value of Blue. Tuple (L, a, b) representing CIE-Lab color tuple

D65/2° standard illuminant

`dist_rgb`(rgb1, rgb2)[source]

Determine distance between two rgb colors.

Parameters: rgb1 (tuple) – RGB color definition rgb2 (tuple) – RGB color definition Square of the distance between provided colors float

This works by treating RGB colors as coordinates in three dimensional space and finding the closest point within the configured color range using the formula:

```d^2 = (r2 - r1)^2 + (g2 - g1)^2 + (b2 - b1)^2
```

For efficiency, the square of the distance is returned which is sufficient for comparisons

`dist_rgb_weighted`(rgb1, rgb2)[source]

Determine the weighted distance between two rgb colors.

Parameters: rgb1 (tuple) – RGB color definition rgb2 (tuple) – RGB color definition Square of the distance between provided colors float

Similar to a standard distance formula, the values are weighted to approximate human perception of color differences

For efficiency, the square of the distance is returned which is sufficient for comparisons

`dist_cie76`(rgb1, rgb2)[source]

Determine distance between two rgb colors using the CIE94 algorithm.

Parameters: rgb1 (tuple) – RGB color definition rgb2 (tuple) – RGB color definition Square of the distance between provided colors float

For efficiency, the square of the distance is returned which is sufficient for comparisons

`dist_cie94`(rgb1, rgb2)[source]

Determine distance between two rgb colors using the CIE94 algorithm.

Parameters: rgb1 (tuple) – RGB color definition rgb2 (tuple) – RGB color definition Square of the distance between provided colors float

For efficiency, the square of the distance is returned which is sufficient for comparisons

`dist_cie2000`(rgb1, rgb2)[source]

Determine distance between two rgb colors using the CIE2000 algorithm.

Parameters: rgb1 (tuple) – RGB color definition rgb2 (tuple) – RGB color definition Square of the distance between provided colors float

For efficiency, the square of the distance is returned which is sufficient for comparisons