colour_hdri.XYZ_to_camera_space_matrix¶
-
colour_hdri.
XYZ_to_camera_space_matrix
(xy, CCT_calibration_illuminant_1, CCT_calibration_illuminant_2, M_color_matrix_1, M_color_matrix_2, M_camera_calibration_1, M_camera_calibration_2, analog_balance)[source]¶ Returns the CIE XYZ to Camera Space matrix for given xy white balance chromaticity coordinates.
Parameters: - xy (array_like) – xy white balance chromaticity coordinates.
- CCT_calibration_illuminant_1 (numeric) – Correlated colour temperature of CalibrationIlluminant1.
- CCT_calibration_illuminant_2 (numeric) – Correlated colour temperature of CalibrationIlluminant2.
- M_color_matrix_1 (array_like) – ColorMatrix1 tag matrix.
- M_color_matrix_2 (array_like) – ColorMatrix2 tag matrix.
- M_camera_calibration_1 (array_like) – CameraCalibration1 tag matrix.
- M_camera_calibration_2 (array_like) – CameraCalibration2 tag matrix.
- analog_balance (array_like) – AnalogBalance tag vector.
Returns: CIE XYZ to Camera Space matrix.
Return type: ndarray
Notes
- The reference illuminant is D50 as defined per
colour_hdri.models.dataset.dng.ADOBE_DNG_XYZ_ILLUMINANT
attribute.
References
[AdobeSystems12b], [AdobeSystems15c], [McG12]
Examples
>>> M_color_matrix_1 = np.array( ... [[0.5309, -0.0229, -0.0336], ... [-0.6241, 1.3265, 0.3337], ... [-0.0817, 0.1215, 0.6664]]) >>> M_color_matrix_2 = np.array( ... [[0.4716, 0.0603, -0.0830], ... [-0.7798, 1.5474, 0.2480], ... [-0.1496, 0.1937, 0.6651]]) >>> M_camera_calibration_1 = np.identity(3) >>> M_camera_calibration_2 = np.identity(3) >>> analog_balance = np.ones(3) >>> XYZ_to_camera_space_matrix( # doctest: +ELLIPSIS ... np.array([0.34510414, 0.35162252]), ... 2850, ... 6500, ... M_color_matrix_1, ... M_color_matrix_2, ... M_camera_calibration_1, ... M_camera_calibration_2, ... analog_balance) array([[ 0.4854908..., 0.0408106..., -0.0714282...], [-0.7433278..., 1.4956549..., 0.2680749...], [-0.1336946..., 0.1767874..., 0.6654045...]])