colour.plotting.lines_planckian_locus#

colour.plotting.lines_planckian_locus(labels: Sequence | None = None, mireds: bool = False, iso_temperature_lines_D_uv: float = 0.05, method: Literal['CIE 1931', 'CIE 1960 UCS', 'CIE 1976 UCS'] | str = 'CIE 1931') Tuple[ndarray[Any, dtype[_ScalarType_co]], ndarray[Any, dtype[_ScalarType_co]]][source]#

Return the Planckian Locus line vertices, i.e. positions, normals and colours, according to given method.

Parameters:
  • labels (Sequence | None) – Array of labels used to customise which iso-temperature lines will be drawn along the Planckian Locus. Passing an empty array will result in no iso-temperature lines being drawn.

  • mireds (bool) – Whether to use micro reciprocal degrees for the iso-temperature lines.

  • iso_temperature_lines_D_uv (float) – Iso-temperature lines \(\Delta_{uv}\) length on each side of the Planckian Locus.

  • method (Literal['CIE 1931', 'CIE 1960 UCS', 'CIE 1976 UCS'] | str) – Planckian Locus method.

Returns:

Tuple of Planckian Locus vertices and wavelength labels vertices.

Return type:

tuple

Examples

>>> lines = lines_planckian_locus()
>>> len(lines)
2
>>> lines[0].dtype
dtype([('position', '<f8', (2,)), ('normal', '<f8', (2,)), ('colour', '<f8', (3,))])
>>> lines[1].dtype
dtype([('position', '<f8', (2,)), ('normal', '<f8', (2,)), ('colour', '<f8', (3,))])