colour.difference.delta_E_CAM02UCS#

colour.difference.delta_E_CAM02UCS(Jpapbp_1: Annotated[_Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str], 100], Jpapbp_2: Annotated[_Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str], 100], *, additional_data: Literal[False] = False) NDArrayFloat[source]#
colour.difference.delta_E_CAM02UCS(Jpapbp_1: Annotated[_Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str], 100], Jpapbp_2: Annotated[_Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str], 100], *, additional_data: Literal[True]) DeltaE_Specification_Luo2006

Compute the colour difference \(\Delta E'\) between two specified CAM02-UCS colourspace \(J'a'b'\) arrays using the Luo et al. (2006) formula.

Parameters:
  • Jpapbp_1 (Annotated[_Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str], 100]) – Standard / reference CAM02-UCS colourspace \(J'a'b'\) array as computed by the Luo et al. (2006) uniform colour space model.

  • Jpapbp_2 (Annotated[_Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str], 100]) – Sample / test CAM02-UCS colourspace \(J'a'b'\) array as computed by the Luo et al. (2006) uniform colour space model.

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

Returns:

Colour difference \(\Delta E'\).

Return type:

numpy.ndarray or DeltaE_Specification_Luo2006

Warning

The \(J'a'b'\) arrays should have been computed with the Luo et al. (2006) CAM02-UCS colourspace and not with the CIE L*a*b* colourspace.

Notes

Domain

Scale - Reference

Scale - 1

Jpapbp_1

100

1

Jpapbp_2

100

1

References

[LCL06]

Examples

>>> Jpapbp_1 = np.array([54.90433134, -0.08450395, -0.06854831])
>>> Jpapbp_2 = np.array([54.80352754, -3.96940084, -13.57591013])
>>> delta_E_CAM02UCS(Jpapbp_1, Jpapbp_2)
np.float64(14.0552982...)
>>> delta_E_CAM02UCS(
...     Jpapbp_1,
...     Jpapbp_2,
...     additional_data=True,
... )
DeltaE_Specification_Luo2006(dE=np.float64(14.0552982...), dJ=np.float64(0.1008038...), da=np.float64(3.8848968...), db=np.float64(13.5073618...))