colour.apply_matrix_colour_correction#

colour.apply_matrix_colour_correction(RGB: ArrayLike, CCM: ArrayLike, method: Literal['Cheung 2004', 'Finlayson 2015', 'Vandermonde'] | str = 'Cheung 2004', **kwargs: Any) → NDArrayFloat[source]#

Apply given colour correction matrix \(CCM\) to given RGB colourspace array.

Parameters:

RGB (ArrayLike) – RGB colourspace array to apply the colour correction matrix \(CCM\) to.
CCM (ArrayLike) – Colour correction matrix \(CCM\).
method (Literal['Cheung 2004', 'Finlayson 2015', 'Vandermonde'] | str) – Computation method.
degree – {colour.characterisation.polynomial_expansion_Finlayson2015(), colour.characterisation.polynomial_expansion_Vandermonde()}, Expanded polynomial degree, must be one of [1, 2, 3, 4] for colour.characterisation.polynomial_expansion_Finlayson2015() definition.
root_polynomial_expansion – {colour.characterisation.polynomial_expansion_Finlayson2015()}, Whether to use the root-polynomials set for the expansion.
terms – {colour.characterisation.matrix_augmented_Cheung2004()}, Number of terms of the expanded polynomial.
kwargs (Any) –

Returns:

Colour corrected RGB colourspace array.

Return type:

numpy.ndarray

References

[CWCR04], [FMH15], [WR04], [Wikipedia03f]

Examples

>>> RGB = np.array([0.17224810, 0.09170660, 0.06416938])
>>> CCM = np.array(
...     [
...         [1.05263767, 0.13780789, -0.22763399],
...         [0.07395843, 1.02939945, -0.1060115],
...         [0.05725508, -0.20526336, 1.10151945],
...     ]
... )
>>> apply_matrix_colour_correction(RGB, CCM)  
array([ 0.1793456...,  0.1003392...,  0.0617218...])