Colour Characterisation

ACES Spectral Conversion

colour

sd_to_aces_relative_exposure_values(sd[, …])

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

Ancillary Objects

colour.characterisation

MSDS_ACES_RICD

Implements support for a camera RGB sensitivities.

ACES Input Transform Computation

colour

matrix_idt(sensitivities, illuminant[, …])

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

Ancillary Objects

colour.characterisation

read_training_data_rawtoaces_v1()

Reads the RAW to ACES v1 190 patches.

generate_illuminants_rawtoaces_v1()

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

white_balance_multipliers(sensitivities, …)

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

normalise_illuminant(illuminant, sensitivities)

Normalises given illuminant with given camera RGB spectral sensitivities.

training_data_sds_to_RGB(training_data, …)

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

training_data_sds_to_XYZ(training_data, …)

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

best_illuminant(RGB_w, sensitivities, …)

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

optimisation_factory_rawtoaces_v1()

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

optimisation_factory_JzAzBz()

Factory that returns the objective function and CIE XYZ colourspace to optimisation colourspace/colour model function based on the \(J_zA_zB_z\) colourspace.

Colour Fitting

colour

POLYNOMIAL_EXPANSION_METHODS

Supported polynomial expansion methods.

polynomial_expansion(a[, method])

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

MATRIX_COLOUR_CORRECTION_METHODS

Supported colour correction matrix methods.

matrix_colour_correction(M_T, M_R[, method])

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

COLOUR_CORRECTION_METHODS

Supported colour correction methods.

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

Performs 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])

Performs polynomial expansion of given RGB colourspace array using *Cheung et al.

polynomial_expansion_Finlayson2015(RGB[, …])

Performs polynomial expansion of given RGB colourspace array using *Finlayson et al.

polynomial_expansion_Vandermonde(a[, degree])

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

matrix_colour_correction_Cheung2004(M_T, M_R)

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

matrix_colour_correction_Finlayson2015(M_T, M_R)

Computes a colour correction matrix from given \(M_T\) colour array to \(M_R\) colour array using *Finlayson et al.

matrix_colour_correction_Vandermonde(M_T, M_R)

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

colour_correction_Cheung2004(RGB, M_T, M_R)

Performs 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.

colour_correction_Finlayson2015(RGB, M_T, M_R)

Performs 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.

colour_correction_Vandermonde(RGB, M_T, M_R)

Performs 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)

Colour Checker data.

Cameras

colour.characterisation

RGB_CameraSensitivities([data, domain, labels])

Implements 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])

Implements 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.