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

ACES_RICD

Implements support for a camera RGB spectral sensitivities.

ACES Input Transform Computation

colour

idt_matrix(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.

COLOUR_CORRECTION_MATRIX_METHODS

Supported colour correction matrix methods.

colour_correction_matrix(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

augmented_matrix_Cheung2004(RGB[, terms])

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

polynomial_expansion_Finlayson2015(RGB[, …])

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

polynomial_expansion_Vandermonde(a[, degree])

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

colour_correction_matrix_Cheung2004(M_T, M_R)

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

colour_correction_matrix_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.(2015) method..

colour_correction_matrix_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.(2004) method..

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.(2015) method..

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

COLOURCHECKERS

Aggregated Colour Checker chromaticity coordinates.

COLOURCHECKER_SDS

Aggregated Colour Checker spectral distributions.

Ancillary Objects

colour.characterisation

ColourChecker(name, data, illuminant)

Colour Checker data.

Cameras

colour.characterisation

RGB_SpectralSensitivities([data, domain, labels])

Implements support for a camera RGB spectral sensitivities.

Dataset

colour

CAMERA_RGB_SPECTRAL_SENSITIVITIES

Camera RGB spectral 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

DISPLAY_RGB_PRIMARIES

Display RGB primaries multi-spectral distributions.

Filters

Dataset

colour

FILTER_SDS

Aggregated filter spectral distributions.

Lenses

Dataset

colour

LENS_SDS

Aggregated lens spectral distributions.