colour.characterisation.best_illuminant

colour.characterisation.best_illuminant(RGB_w: ArrayLike, sensitivities: RGB_CameraSensitivities, illuminants: Mapping) → SpectralDistribution

Select the best illuminant for the specified RGB white balance multipliers from a series of candidate illuminants based on camera sensitivities.

The best illuminant is determined by finding the illuminant that produces white balance multipliers closest to the specified values, minimizing the sum of squared errors after normalization.

Parameters:

• RGB_w (ArrayLike) – RGB white balance multipliers.

• sensitivities (RGB_CameraSensitivities) – Camera RGB spectral sensitivities.

• illuminants (Mapping) – Illuminant spectral distributions to choose the best illuminant from.

Returns:

Best illuminant spectral distribution.

Return type:

colour.SpectralDistribution

Examples

>>> path = os.path.join(
...     ROOT_RESOURCES_RAWTOACES,
...     "CANON_EOS_5DMark_II_RGB_Sensitivities.csv",
... )
>>> sensitivities = sds_and_msds_to_msds(read_sds_from_csv_file(path).values())
>>> illuminants = generate_illuminants_rawtoaces_v1()
>>> RGB_w = white_balance_multipliers(sensitivities, SDS_ILLUMINANTS["FL2"])
>>> best_illuminant(RGB_w, sensitivities, illuminants).name
'D40'