colour.difference.delta_E_DIN99

colour.difference.delta_E_DIN99(Lab_1: Annotated[_Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str], 100], Lab_2: Annotated[_Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str], 100], textiles: bool = False, *, additional_data: Literal[False] = False, method: str = 'DIN99') → NDArrayFloat

colour.difference.delta_E_DIN99(Lab_1: Annotated[_Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str], 100], Lab_2: Annotated[_Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str], 100], textiles: bool = False, *, additional_data: Literal[True], method: str = 'DIN99') → DeltaE_Specification_DIN99

Compute the colour difference \(\Delta E_{DIN99}\) between two specified CIE L*a*b* colourspace arrays using the DIN99 formula.

Parameters:

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

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

• textiles (bool) – Textiles application specific parametric factors, \(k_E=2,\ k_{CH}=0.5\) weights are used instead of \(k_E=1,\ k_{CH}=1\).

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

• method (Literal['ASTMD2244-07', 'DIN99', 'DIN99b', 'DIN99c', 'DIN99d'] | str) – Computation method to convert from CIE L*a*b* colourspace to DIN99 colourspace. See colour.models.din99.DIN99_METHODS for supported values.

Returns:

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

Return type:

numpy.ndarray or DeltaE_Specification_DIN99

Notes

Domain	Scale - Reference	Scale - 1
Lab_1	100	1
Lab_2	100	1

References

[ASTMInternational07]

Examples

>>> import numpy as np
>>> Lab_1 = np.array([60.2574, -34.0099, 36.2677])
>>> Lab_2 = np.array([60.4626, -34.1751, 39.4387])
>>> delta_E_DIN99(Lab_1, Lab_2)
np.float64(1.1772166...)
>>> delta_E_DIN99(
...     Lab_1,
...     Lab_2,
...     additional_data=True,
... )
DeltaE_Specification_DIN99(dE=np.float64(1.1772166...), dL=np.float64(-0.1750930...), da=np.float64(-0.5804045...), db=np.float64(-1.0091144...))
>>> delta_E_DIN99(Lab_1, Lab_2, method="DIN99b")
np.float64(1.7113129...)