Colour Characterisation#

ACES Spectral Conversion#

colour

sd_to_aces_relative_exposure_values(sd[, ...])

Convert given spectral distribution to ACES2065-1 colourspace relative exposure values.

sd_to_ACES2065_1(sd[, illuminant, ...])

Convert given spectral distribution to ACES2065-1 colourspace relative exposure values.

Ancillary Objects

colour.characterisation

MSDS_ACES_RICD

Implement support for a camera RGB sensitivities.

ACES Input Transform Computation#

colour

matrix_idt(sensitivities, illuminant[, ...])

Compute an Input Device Transform (IDT) matrix for given camera RGB spectral sensitivities, illuminant, training data, standard observer colour matching functions and optimisation settings according to RAW to ACES v1 and P-2013-001 procedures.

camera_RGB_to_ACES2065_1(RGB, B, b[, k, clip])

Convert given camera RGB colourspace array to ACES2065-1 colourspace using the Input Device Transform (IDT) matrix \(B\), the white balance multipliers \(b\) and the exposure factor \(k\) according to P-2013-001 procedure.

Ancillary Objects

colour.characterisation

read_training_data_rawtoaces_v1()

Read the RAW to ACES v1 190 patches.

generate_illuminants_rawtoaces_v1()

Generate a series of illuminants according to RAW to ACES v1:

white_balance_multipliers(sensitivities, ...)

Compute the RGB white balance multipliers for given camera RGB spectral sensitivities and illuminant.

best_illuminant(RGB_w, sensitivities, ...)

Select the best illuminant for given RGB white balance multipliers, and sensitivities in given series of illuminants.

normalise_illuminant(illuminant, sensitivities)

Normalise given illuminant with given camera RGB spectral sensitivities.

training_data_sds_to_RGB(training_data, ...)

Convert given training data to RGB tristimulus values using given illuminant and given camera RGB spectral sensitivities.

training_data_sds_to_XYZ(training_data, ...)

Convert given training data to CIE XYZ tristimulus values using given illuminant and given standard observer colour matching functions.

whitepoint_preserving_matrix(M[, RGB_w])

Normalise given matrix \(M\) to preserve given white point \(RGB_w\).

optimisation_factory_rawtoaces_v1()

Produce the objective function and CIE XYZ colourspace to optimisation colourspace/colour model function according to RAW to ACES v1.

optimisation_factory_Jzazbz()

Produce the objective function and CIE XYZ colourspace to optimisation colourspace/colour model function based on the \(J_za_zb_z\) colourspace.

optimisation_factory_Oklab_15()

Produce the objective function and CIE XYZ colourspace to optimisation colourspace/colour model function based on the Oklab colourspace.

Colour Fitting#

colour

POLYNOMIAL_EXPANSION_METHODS

Supported polynomial expansion methods.

polynomial_expansion(a[, method])

Perform polynomial expansion of given \(a\) array.

MATRIX_COLOUR_CORRECTION_METHODS

Supported colour correction matrix methods.

matrix_colour_correction(M_T, M_R[, method])

Compute a colour correction matrix from given \(M_T\) colour array to \(M_R\) colour array.

APPLY_MATRIX_COLOUR_CORRECTION_METHODS

Supported methods to apply a colour correction matrix.

apply_matrix_colour_correction(RGB, CCM[, ...])

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

COLOUR_CORRECTION_METHODS

Supported colour correction methods.

colour_correction(RGB, M_T, M_R[, method])

Perform colour correction of given RGB colourspace array using the colour correction matrix from given \(M_T\) colour array to \(M_R\) colour array.

Ancillary Objects

colour.characterisation

matrix_augmented_Cheung2004(RGB[, terms])

Perform polynomial expansion of given RGB colourspace array using Cheung et al. (2004) method.

polynomial_expansion_Finlayson2015(RGB[, ...])

Perform polynomial expansion of given RGB colourspace array using Finlayson et al. (2015) method.

polynomial_expansion_Vandermonde(a[, degree])

Perform polynomial expansion of given \(a\) array using Vandermonde method.

matrix_colour_correction_Cheung2004(M_T, M_R)

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

matrix_colour_correction_Finlayson2015(M_T, M_R)

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

matrix_colour_correction_Vandermonde(M_T, M_R)

Compute a colour correction matrix from given \(M_T\) colour array to \(M_R\) colour array using Vandermonde method.

apply_matrix_colour_correction_Cheung2004(...)

Apply given colour correction matrix \(CCM\) computed using Cheung et al. (2004) method to given RGB colourspace array.

apply_matrix_colour_correction_Finlayson2015(...)

Apply given colour correction matrix \(CCM\) computed using Finlayson et al. (2015) method to given RGB colourspace array.

apply_matrix_colour_correction_Vandermonde(...)

Apply given colour correction matrix \(CCM\) computed using Vandermonde method to given RGB colourspace array.

colour_correction_Cheung2004(RGB, M_T, M_R)

Perform colour correction of given RGB colourspace array using the colour correction matrix from given \(M_T\) colour array to \(M_R\) colour array using Cheung et al. (2004) method.

colour_correction_Finlayson2015(RGB, M_T, M_R)

Perform colour correction of given RGB colourspace array using the colour correction matrix from given \(M_T\) colour array to \(M_R\) colour array using Finlayson et al. (2015) method.

colour_correction_Vandermonde(RGB, M_T, M_R)

Perform colour correction of given RGB colourspace array using the colour correction matrix from given \(M_T\) colour array to \(M_R\) colour array using Vandermonde method.

Colour Rendition Charts#

Dataset

colour

CCS_COLOURCHECKERS

Chromaticity coordinates of the colour checkers.

SDS_COLOURCHECKERS

Spectral distributions of the colour checkers.

Ancillary Objects

colour.characterisation

ColourChecker(name, data, illuminant, rows, ...)

Colour Checker data.

Cameras#

colour.characterisation

RGB_CameraSensitivities([data, domain, labels])

Implement support for a camera RGB sensitivities.

Dataset

colour

MSDS_CAMERA_SENSITIVITIES

Multi-spectral distributions of camera sensitivities.

Displays#

colour.characterisation

RGB_DisplayPrimaries([data, domain, labels])

Implement support for a RGB display (such as a CRT or LCD) primaries multi-spectral distributions.

Dataset

colour

MSDS_DISPLAY_PRIMARIES

Primaries multi-spectral distributions of displays.

Filters#

Dataset

colour

SDS_FILTERS

Spectral distributions of filters.

Lenses#

Dataset

colour

SDS_LENSES

Spectral distributions of lenses.