colour.adaptation.chromatic_adaptation_forward_CMCCAT2000¶
-
colour.adaptation.
chromatic_adaptation_forward_CMCCAT2000
(XYZ, XYZ_w, XYZ_wr, L_A1, L_A2, surround=CMCCAT2000_InductionFactors(F=1))[source]¶ Adapts given stimulus CIE XYZ tristimulus values from test viewing conditions to reference viewing conditions using CMCCAT2000 forward chromatic adaptation model.
Parameters: - XYZ (array_like) – CIE XYZ tristimulus values of the stimulus to adapt.
- XYZ_w (array_like) – Test viewing condition CIE XYZ tristimulus values of the whitepoint.
- XYZ_wr (array_like) – Reference viewing condition CIE XYZ tristimulus values of the whitepoint.
- L_A1 (numeric or array_like) – Luminance of test adapting field \(L_{A1}\) in \(cd/m^2\).
- L_A2 (numeric or array_like) – Luminance of reference adapting field \(L_{A2}\) in \(cd/m^2\).
- surround (CMCCAT2000_InductionFactors, optional) – Surround viewing conditions induction factors.
Returns: CIE XYZ_c tristimulus values of the stimulus corresponding colour.
Return type: ndarray
Warning
The input domain and output range of that definition are non standard!
Notes
- Input CIE XYZ, CIE XYZ_w and CIE XYZ_wr tristimulus values are in domain [0, 100].
- Output CIE XYZ_c tristimulus values are in range [0, 100].
References
Examples
>>> XYZ = np.array([22.48, 22.74, 8.54]) >>> XYZ_w = np.array([111.15, 100.00, 35.20]) >>> XYZ_wr = np.array([94.81, 100.00, 107.30]) >>> L_A1 = 200 >>> L_A2 = 200 >>> chromatic_adaptation_forward_CMCCAT2000(XYZ, XYZ_w, XYZ_wr, L_A1, L_A2) ... array([ 19.5269832..., 23.0683396..., 24.9717522...])