colour.XYZ_to_Kim2009

colour.XYZ_to_Kim2009(XYZ: Annotated[_Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str], 100], XYZ_w: Annotated[_Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str], 100], L_A: ArrayLike, media: MediaParameters_Kim2009 = MEDIA_PARAMETERS_KIM2009['CRT Displays'], surround: InductionFactors_Kim2009 = VIEWING_CONDITIONS_KIM2009['Average'], n_c: float = 0.57, discount_illuminant: bool = False, compute_H: bool = True) → Annotated[CAM_Specification_Kim2009, 100, 100, 360, 100, 100, 100, 400]

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

Parameters:

• XYZ (Annotated[_Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str], 100]) – CIE XYZ tristimulus values of test sample / stimulus.

• XYZ_w (Annotated[_Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str], 100]) – 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.

• compute_H (bool) – Whether to compute Hue \(h\) quadrature \(H\). \(H\) is rarely used, and expensive to compute.

• 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	100	1
XYZ_w	100	1

Range	Scale - Reference	Scale - 1
specification.J	100	1
specification.C	100	1
specification.h	360	1
specification.s	100	1
specification.Q	100	1
specification.M	100	1
specification.H	400	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)