colour.XYZ_to_Kim2009#
- colour.XYZ_to_Kim2009(XYZ: ArrayLike, XYZ_w: ArrayLike, L_A: ArrayLike, media: MediaParameters_Kim2009 = MEDIA_PARAMETERS_KIM2009['CRT Displays'], surround: InductionFactors_Kim2009 = VIEWING_CONDITIONS_KIM2009['Average'], discount_illuminant: bool = False, n_c: float = 0.57) 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 (ArrayLike) – 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 (MediaParameters_Kim2009) – Media parameters.
surround (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:
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)