colour.sCAM_to_XYZ

colour.sCAM_to_XYZ(specification: Annotated[CAM_Specification_sCAM, 100, 100, 360, 100, 100, 400, 100, 100, 100, 100], XYZ_w: Annotated[_Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str], 100], L_A: ArrayLike, Y_b: ArrayLike, surround: InductionFactors_sCAM = VIEWING_CONDITIONS_sCAM['Average'], discount_illuminant: bool = False) → Annotated[ndarray[tuple[Any, ...], dtype[float16 | float32 | float64]], 100]

Convert the sCAM colour appearance model specification to CIE XYZ tristimulus values.

Parameters:

• specification (Annotated[CAM_Specification_sCAM, (100, 100, 360, 100, 100, 400, 100, 100, 100, 100)]) – sCAM colour appearance model specification.

• 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).

• Y_b (ArrayLike) – Luminous factor of background \(Y_b\) such as \(Y_b = 100 \times L_b / L_w\) where \(L_w\) is the luminance of the light source and \(L_b\) is the luminance of the background.

• surround (InductionFactors_sCAM) – Surround viewing conditions induction factors.

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

Returns:

CIE XYZ tristimulus values.

Return type:

numpy.ndarray

Notes

Domain	Scale - Reference	Scale - 1
specification.J	100	1
specification.C	100	1
specification.h	360	1
specification.M	100	1
XYZ_w	100	1

Range	Scale - Reference	Scale - 1
XYZ	100	1

References

[LL24]

Examples

>>> specification = CAM_Specification_sCAM(
...     J=49.979566801800047, C=0.014053112120697316, h=328.2724924444729
... )
>>> XYZ_w = np.array([95.05, 100.00, 108.88])
>>> L_A = 318.31
>>> Y_b = 20
>>> sCAM_to_XYZ(specification, XYZ_w, L_A, Y_b)
array([ 19.01...,  20...  ,  21.78...])