colour.difference.delta_E_HyAB#

colour.difference.delta_E_HyAB(Lab_1: Domain100, Lab_2: Domain100, *, additional_data: Literal[False] = False) NDArrayFloat[source]#
colour.difference.delta_E_HyAB(Lab_1: Domain100, Lab_2: Domain100, *, additional_data: Literal[True]) DeltaE_Specification_HyAB

Compute the colour difference between two CIE L*a*b* colourspace arrays using a combination of a Euclidean metric in hue and chroma with a city-block metric to incorporate lightness differences.

This metric is intended for large colour differences, on the order of 10 CIE L*a*b* units or greater.

Parameters:
  • Lab_1 (Domain100) – CIE L*a*b* colourspace array 1.

  • Lab_2 (Domain100) – CIE L*a*b* colourspace array 2.

  • additional_data (bool) – Whether to output additional data.

Returns:

Colour difference \(\Delta E_{HyAB}\).

Return type:

numpy.ndarray or DeltaE_Specification_HyAB

Notes

Domain

Scale - Reference

Scale - 1

Lab_1

100

1

Lab_2

100

1

References

[AATF20]

Examples

>>> Lab_1 = np.array([39.91531343, 51.16658481, 146.12933781])
>>> Lab_2 = np.array([53.12207516, -39.92365056, 249.54831278])
>>> delta_E_HyAB(Lab_1, Lab_2)
np.float64(151.0215481...)
>>> delta_E_HyAB(
...     Lab_1,
...     Lab_2,
...     additional_data=True,
... )
DeltaE_Specification_HyAB(dE=np.float64(151.0215481...), dL=np.float64(-13.2067617...), da=np.float64(91.0902353...), db=np.float64(-103.4189749...))