colour_visuals.common.XYZ_to_colourspace_model#

class colour_visuals.common.XYZ_to_colourspace_model(XYZ: ArrayLike, illuminant: ArrayLike, model: LiteralColourspaceModel | str = 'CIE xyY', normalise_model: bool | None = None, **kwargs: Any)[source]#

Bases:

Convert from CIE XYZ tristimulus values to given colourspace model while normalising some of the absolute models.

Parameters:
  • XYZ (ArrayLike) – CIE XYZ tristimulus values to convert to given colourspace model.

  • illuminant (ArrayLike) – Reference illuminant CIE xy chromaticity coordinates or CIE xyY colourspace array.

  • model (LiteralColourspaceModel | str) – Colourspace model, see colour.COLOURSPACE_MODELS attribute for the list of supported colourspace models.

  • normalise_model (bool | None) – Whether to normalise colourspace models such as \(IC_TC_P\) and \(J_za_zb_z\).

  • kwargs (Any) – See the documentation of the supported conversion definitions.

Returns:

Converted CIE XYZ tristimulus values.

Return type:

Any