colour.XYZ_to_DIN99

colour.XYZ_to_DIN99(XYZ, illuminant=array([0.3127, 0.329]), k_E=1, k_CH=1, method='DIN99')[source]

Converts from CIE XYZ tristimulus values to DIN99 colourspace or one of the DIN99b, DIN99c, DIN99d refined formulas according to Cui et al. (2002).

Parameters
  • XYZ (array_like) – CIE XYZ tristimulus values.

  • illuminant (array_like, optional) – Reference illuminant CIE xy chromaticity coordinates or CIE xyY colourspace array.

  • k_E (numeric, optional) – Parametric factor \(K_E\) used to compensate for texture and other specimen presentation effects.

  • k_CH (numeric, optional) – Parametric factor \(K_{CH}\) used to compensate for texture and other specimen presentation effects.

  • method (str, optional) – {‘DIN99’, ‘ASTMD2244-07’, ‘DIN99b’, ‘DIN99c’, ‘DIN99d’}, Computation method to choose between the [ASTMInternational07] formula and the refined formulas according to Cui et al. (2002).

Returns

DIN99 colourspace array.

Return type

ndarray

Notes

Domain

Scale - Reference

Scale - 1

XYZ

[0, 1]

[0, 1]

illuminant

[0, 1]

[0, 1]

Range

Scale - Reference

Scale - 1

Lab_99

L_99 : [0, 100]

a_99 : [-100, 100]

b_99 : [-100, 100]

L_99 : [0, 1]

a_99 : [-1, 1]

b_99 : [-1, 1]

References

[ASTMInternational07]

Examples

>>> import numpy as np
>>> XYZ = np.array([0.20654008, 0.12197225, 0.05136952])
>>> XYZ_to_DIN99(XYZ)  
array([ 53.2282198...,  28.4163465...,   3.8983955...])