colour.characterisation.matrix_colour_correction_Cheung2004

colour.characterisation.matrix_colour_correction_Cheung2004(M_T: ArrayLike, M_R: ArrayLike, terms: Literal[3, 5, 7, 8, 10, 11, 14, 16, 17, 19, 20, 22] = 3) numpy.ndarray[source]

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

Parameters
  • M_T (ArrayLike) – Test array \(M_T\) to fit onto array \(M_R\).

  • M_R (ArrayLike) – Reference array the array \(M_T\) will be colour fitted against.

  • terms (Literal[3, 5, 7, 8, 10, 11, 14, 16, 17, 19, 20, 22]) – Number of terms of the expanded polynomial.

Returns

Colour correction matrix.

Return type

numpy.ndarray

References

[CWCR04], [WR04]

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
>>> matrix_colour_correction_Cheung2004(M_T, M_R)  
array([[ 1.0526376...,  0.1378078..., -0.2276339...],
       [ 0.0739584...,  1.0293994..., -0.1060115...],
       [ 0.0572550..., -0.2052633...,  1.1015194...]])