colour.characterisation.apply_matrix_colour_correction_Finlayson2015#

colour.characterisation.apply_matrix_colour_correction_Finlayson2015(RGB: ArrayLike, CCM: ArrayLike, degree: Literal[1, 2, 3, 4] = 1, root_polynomial_expansion: bool = True) NDArrayFloat[source]#

Apply given colour correction matrix \(CCM\) computed using Finlayson et al. (2015) method 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\).

  • degree (Literal[1, 2, 3, 4]) – Expanded polynomial degree.

  • root_polynomial_expansion (bool) – Whether to use the root-polynomials set for the expansion.

Returns:

Colour corrected RGB colourspace array.

Return type:

numpy.ndarray

References

[FMH15]

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_Finlayson2015(RGB, CCM)  
array([ 0.1793456...,  0.1003392...,  0.0617218...])