colour_visuals.common.XYZ_to_colourspace_model#

class colour_visuals.common.XYZ_to_colourspace_model(XYZ: ArrayLike, illuminant: ArrayLike, model: LiteralColourspaceModel | str = 'CIE xyY', **kwargs)[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 (Literal['CAM02LCD', 'CAM02SCD', 'CAM02UCS', 'CAM16LCD', 'CAM16SCD', 'CAM16UCS', 'CIE Lab', 'CIE Luv', 'CIE UCS', 'CIE UVW', 'CIE XYZ', 'CIE xyY', 'DIN99', 'Hunter Lab', 'Hunter Rdab', 'ICaCb', 'ICtCp', 'IPT', 'IPT Ragoo 2021', 'IgPgTg', 'Jzazbz', 'OSA UCS', 'Oklab', 'Yrg', 'hdr-CIELAB', 'hdr-IPT'] | str) – Colourspace model, see colour.COLOURSPACE_MODELS attribute for the list of supported colourspace models.

Return type:

ndarray[Any, dtype[_ScalarType_co]]