colour_hdri.camera_neutral_to_xy

colour_hdri.camera_neutral_to_xy(camera_neutral, 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, epsilon=2.2204460492503131e-16)

Converts given Camera Neutral coordinates to xy white balance chromaticity coordinates.

Parameters:

• camera_neutral (array_like) – Camera Neutral 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.
• epsilon (numeric, optional) – Threshold value for computation convergence.

Returns:

xy white balance chromaticity coordinates.

Return type:

ndarray

Raises:

RuntimeError – If the given Camera Neutral coordinates did not converge to xy white balance chromaticity coordinates.

References

[AdobeSystems12c], [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)
>>> camera_neutral_to_xy(  # doctest: +ELLIPSIS
...     np.array([0.413070, 1.000000, 0.646465]),
...     2850,
...     6500,
...     M_color_matrix_1,
...     M_color_matrix_2,
...     M_camera_calibration_1,
...     M_camera_calibration_2,
...     analog_balance)
array([ 0.3281624...,  0.3469816...])