colour.XYZ_to_Kim2009#

colour.XYZ_to_Kim2009(XYZ: ArrayLike, XYZ_w: ArrayLike, L_A: FloatingOrArrayLike, media: colour.appearance.kim2009.MediaParameters_Kim2009 = MEDIA_PARAMETERS_KIM2009['CRT Displays'], surround: colour.appearance.kim2009.InductionFactors_Kim2009 = VIEWING_CONDITIONS_KIM2009['Average'], discount_illuminant: bool = False, n_c: float = 0.57) colour.appearance.kim2009.CAM_Specification_Kim2009[source]#

Compute the Kim, Weyrich and Kautz (2009) colour appearance model correlates from given CIE XYZ tristimulus values.

Parameters
  • XYZ (ArrayLike) – CIE XYZ tristimulus values of test sample / stimulus.

  • XYZ_w (ArrayLike) – CIE XYZ tristimulus values of reference white.

  • L_A (FloatingOrArrayLike) – Adapting field luminance \(L_A\) in \(cd/m^2\), (often taken to be 20% of the luminance of a white object in the scene).

  • media (colour.appearance.kim2009.MediaParameters_Kim2009) – Media parameters.

  • surround (colour.appearance.kim2009.InductionFactors_Kim2009) – Surround viewing conditions induction factors.

  • discount_illuminant (bool) – Truth value indicating if the illuminant should be discounted.

  • n_c (float) – Cone response sigmoidal curve modulating factor \(n_c\).

Returns

Kim, Weyrich and Kautz (2009) colour appearance model specification.

Return type

colour.CAM_Specification_Kim2009

Notes

Domain

Scale - Reference

Scale - 1

XYZ

[0, 100]

[0, 1]

XYZ_w

[0, 100]

[0, 1]

Range

Scale - Reference

Scale - 1

CAM_Specification_Kim2009.J

[0, 100]

[0, 1]

CAM_Specification_Kim2009.C

[0, 100]

[0, 1]

CAM_Specification_Kim2009.h

[0, 360]

[0, 1]

CAM_Specification_Kim2009.s

[0, 100]

[0, 1]

CAM_Specification_Kim2009.Q

[0, 100]

[0, 1]

CAM_Specification_Kim2009.M

[0, 100]

[0, 1]

CAM_Specification_Kim2009.H

[0, 400]

[0, 1]

References

[KWK09]

Examples

>>> XYZ = np.array([19.01, 20.00, 21.78])
>>> XYZ_w = np.array([95.05, 100.00, 108.88])
>>> L_A = 318.31
>>> media = MEDIA_PARAMETERS_KIM2009['CRT Displays']
>>> surround = VIEWING_CONDITIONS_KIM2009['Average']
>>> XYZ_to_Kim2009(XYZ, XYZ_w, L_A, media, surround)
... 
CAM_Specification_Kim2009(J=28.8619089..., C=0.5592455..., h=219.0480667..., s=9.3837797..., Q=52.7138883..., M=0.4641738..., H=278.0602824..., HC=None)