Colour Characterisation

ACES Spectral Conversion

colour

sd_to_ACES2065_1(sd[, illuminant, ...])	Convert spectral distribution to ACES2065-1 colourspace relative exposure values.
sd_to_aces_relative_exposure_values(sd[, ...])	Convert spectral distribution to ACES2065-1 colourspace relative exposure values.

Ancillary Objects

colour.characterisation

MSDS_ACES_RICD

Define a container for camera RGB spectral sensitivities.

ACES Input Transform Computation

colour

camera_RGB_to_ACES2065_1(RGB, B, b[, k, clip])	Convert camera RGB colourspace array to ACES2065-1 colourspace using the specified Input Device Transform (IDT) matrix \(B\), white balance multipliers \(b\), and exposure factor \(k\) according to the P-2013-001 procedure.
matrix_idt(-> Tuple[NDArrayFloat, ...)	Compute an Input Device Transform (IDT) matrix for 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.

Ancillary Objects

colour.characterisation

best_illuminant(RGB_w, sensitivities, ...)	Select the best illuminant for the specified RGB white balance multipliers from a series of candidate illuminants based on camera sensitivities.
generate_illuminants_rawtoaces_v1()	Generate a series of illuminants according to RAW to ACES v1:
normalise_illuminant(illuminant, sensitivities)	Normalise the specified illuminant with camera RGB spectral sensitivities.
optimisation_factory_Jzazbz()	Generate 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()	Generate the objective function and CIE XYZ colourspace to optimisation colourspace/colour model function based on the Oklab colourspace.
optimisation_factory_rawtoaces_v1()	Generate the objective function and CIE XYZ colourspace to optimisation colourspace/colour model function based according to RAW to ACES v1.
read_training_data_rawtoaces_v1()	Read the RAW to ACES v1 training data comprising 190 reflectance patches.
training_data_sds_to_RGB(training_data, ...)	Convert training data to RGB tristimulus values using the specified illuminant and camera RGB spectral sensitivities.
training_data_sds_to_XYZ(training_data, ...)	Convert training data to CIE XYZ tristimulus values using the specified illuminant and standard observer colour matching functions.
white_balance_multipliers(sensitivities, ...)	Compute RGB white balance multipliers for camera RGB spectral sensitivities and the specified illuminant spectral distribution.
whitepoint_preserving_matrix(M[, RGB_w])	Normalise the specified matrix \(M\) to preserve the white point \(RGB_w\).

Colour Fitting

colour

apply_matrix_colour_correction(RGB, CCM[, ...])	Apply colour correction matrix \(CCM\) to the specified RGB colourspace array.
APPLY_MATRIX_COLOUR_CORRECTION_METHODS	Supported methods to apply a colour correction matrix.
colour_correction(RGB, M_T, M_R[, method])	Perform colour correction of RGB colourspace array using the colour correction matrix from \(M_T\) colour array to \(M_R\) colour array.
COLOUR_CORRECTION_METHODS	Define the supported colour correction methods.
matrix_colour_correction(M_T, M_R[, method])	Compute a colour correction matrix from \(M_T\) colour array to \(M_R\) colour array.
MATRIX_COLOUR_CORRECTION_METHODS	Supported colour correction matrix computation methods.
polynomial_expansion(a[, method])	Perform polynomial expansion of the \(a\) array.
POLYNOMIAL_EXPANSION_METHODS	Supported polynomial expansion methods.

Ancillary Objects

colour.characterisation

apply_matrix_colour_correction_Cheung2004(...)	Apply colour correction matrix \(CCM\) computed using Cheung et al. (2004) method to the specified RGB colourspace array.
apply_matrix_colour_correction_Finlayson2015(...)	Apply colour correction matrix \(CCM\) computed using Finlayson et al. (2015) method to the specified RGB colourspace array.
apply_matrix_colour_correction_Vandermonde(...)	Apply colour correction matrix \(CCM\) computed using the Vandermonde method to the specified RGB colourspace array.
colour_correction_Cheung2004(RGB, M_T, M_R)	Perform colour correction of the specified RGB colourspace array using the colour correction matrix derived from test array \(M_T\) to reference array \(M_R\) using the Cheung et al. (2004) method.
colour_correction_Finlayson2015(RGB, M_T, M_R)	Perform colour correction of RGB colourspace array using the colour correction matrix from test array \(M_T\) to reference array \(M_R\) using the Finlayson et al. (2015) method.
colour_correction_Vandermonde(RGB, M_T, M_R)	Perform colour correction of RGB colourspace array using the colour correction matrix from \(M_T\) colour array to \(M_R\) colour array using Vandermonde method.
colour_correction_TPS3D(RGB, M_T, M_R, *[, ...])	Perform colour correction using TPS-3D warping in RGB space.
apply_tps3d(RGB, W, A, ctrl, *[, kernel, ...])	Apply pre-fitted TPS-3D to an arbitrary RGB array (… , 3).
tps3d_parameters(source_points, ...[, ...])	Fit TPS-3D parameters that warp RGB source_points -> destination_points.
matrix_augmented_Cheung2004(RGB[, terms])	Perform polynomial expansion of RGB colourspace array using Cheung et al. (2004) method.
matrix_colour_correction_Cheung2004(M_T, M_R)	Compute a colour correction matrix from test array \(M_T\) to reference array \(M_R\) using the Cheung et al. (2004) polynomial expansion method.
matrix_colour_correction_Finlayson2015(M_T, M_R)	Compute a colour correction matrix from test colour array \(M_T\) to reference colour array \(M_R\) using Finlayson et al. (2015) root-polynomial colour correction method.
matrix_colour_correction_Vandermonde(M_T, M_R)	Compute a colour correction matrix from \(M_T\) test colour array to \(M_R\) reference colour array using the Vandermonde method.
polynomial_expansion_Finlayson2015(RGB[, ...])	Perform polynomial expansion of the specified RGB colourspace array using the Finlayson et al. (2015) method.
polynomial_expansion_Vandermonde(a[, degree])	Perform polynomial expansion of the specified \(a\) array using the Vandermonde method.

Colour Rendition Charts

Dataset

colour

CCS_COLOURCHECKERS	Chromaticity coordinates of the colour checkers.
SDS_COLOURCHECKERS	Spectral distributions of available colour checkers.

Ancillary Objects

colour.characterisation

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

Colour Checker data.

Cameras

colour.characterisation

RGB_CameraSensitivities([data, domain, labels])

Define a container for camera RGB spectral sensitivities.

Dataset

colour

MSDS_CAMERA_SENSITIVITIES

Multi-spectral distributions of camera sensitivities.

Displays

colour.characterisation

RGB_DisplayPrimaries([data, domain, labels])

Define a container for RGB display primaries as multi-spectral distributions.

Dataset

colour

MSDS_DISPLAY_PRIMARIES

Multi-spectral distributions of display primaries.

Filters

Dataset

colour

SDS_FILTERS

Spectral distributions of filters.

Lenses

Dataset

colour

SDS_LENSES

Spectral distributions of lenses.