colour.characterisation.colour_correction_matrix_Cheung2004

colour.characterisation.colour_correction_matrix_Cheung2004(M_T, M_R, terms=3)[source]

Computes a colour correction from given \(M_T\) colour array to \(M_R\) colour array using Cheung et al. (2004) method.

Parameters:
  • M_T (array_like, (3, n)) – Test array \(M_T\) to fit onto array \(M_R\).
  • M_R (array_like, (3, n)) – Reference array the array \(M_T\) will be colour fitted against.
  • terms (int, optional) – Number of terms of the expanded polynomial, must be one of [3, 5, 7, 8, 10, 11, 14, 16, 17, 19, 20, 22].
Returns:

Colour correction matrix.

Return type:

ndarray, (3, n)

References

[Cheung2004], [Westland2004]

Examples

>>> prng = np.random.RandomState(2)
>>> M_T = prng.random_sample((24, 3))
>>> M_R = M_T + (prng.random_sample((24, 3)) - 0.5) * 0.5
>>> colour_correction_matrix(M_T, M_R)  # doctest: +ELLIPSIS
array([[ 1.0526376...,  0.1378078..., -0.2276339...],
       [ 0.0739584...,  1.0293994..., -0.1060115...],
       [ 0.0572550..., -0.2052633...,  1.1015194...]])