PerceptuallyUniformColormap.from_hsl

classmethod PerceptuallyUniformColormap.from_hsl(name, *, ratios=None, **kwargs)[source]

Make a PerceptuallyUniformColormap by specifying the hue, saturation, and luminance transitions individually.

Parameters

  • name (str) – The colormap name.

  • h, s, l, a, c – Shorthands for hue, saturation, luminance, alpha, and chroma.

  • hue (float, color-spec, or list thereof, optional) – Hue channel value or list of values. The shorthand keyword h is also acceptable. Values can be any of the following.

    1. Numbers, within the range 0 to 360 for hue and 0 to 100 for saturation and luminance.

    2. Color string names or hex strings, in which case the channel value for that color is looked up.

    If scalar, the hue does not change across the colormap. Default is 0 (i.e., red).

  • saturation, luminance, alpha (float, color-spec, or list thereof, optional) – As with hue, but for the saturation, luminance, and alpha (opacity) channels, respectively. The default saturation is 50, luminance is (100, 20), and alpha is 1 (i.e., no transparency).

  • chroma – Alias for saturation.

  • ratios (list of float, optional) – Relative extents of each color transition. Must have length len(colors) - 1. Larger numbers indicate a slower transition, smaller numbers indicate a faster transition.

    For example, luminance=(100, 50, 0) with ratios=(2, 1) results in a colormap with the transition from luminance 100 to 50 taking twice as long as the transition from luminance 50 to 0.

  • space ({‘hsl’, ‘hpl’, ‘hcl’}, optional) – The colorspace in which hue, luminance, and/or saturation are varied.

Other Parameters

**kwargs – Passed to PerceptuallyUniformColormap.

Returns

PerceptuallyUniformColormap – The colormap.

See also

PerceptuallyUniformColormap.from_color, PerceptuallyUniformColormap.from_list