matplotlib.colors

В разделе учебники и примеры показано, как задавать цвета и цветовые карты.

Модуль для преобразования чисел или аргументов цвета в RGB или RGBA.

RGB и RGBA представляют собой последовательности соответственно 3 или 4 чисел с плавающей точкой в диапазоне от 0 до 1.

Этот модуль включает функции и классы для преобразований спецификаций цвета и для сопоставления чисел с цветами в одномерном массиве цветов, называемом цветовой картой.

Сопоставление данных с цветами с помощью цветовой карты обычно включает два шага: сначала массив данных сопоставляется с диапазоном от 0 до 1 с помощью подкласса Normalize, а затем это число сопоставляется с цветом с помощью подкласса Colormap. Здесь представлены два подкласса Colormap: LinearSegmentedColormap, который использует кусочно-линейную интерполяцию для определения цветовых карт, и ListedColormap, который создает цветовую карту из списка цветов.

Модуль также предоставляет функции для проверки, можно ли интерпретировать объект как цвет (is_color_like), преобразования такого объекта в кортеж RGBA (to_rgba) или в шестнадцатеричную строку в формате "#rrggbb" (to_hex) и последовательность цветов в массив RGBA (n, 4) (to_rgba_array). Для повышения эффективности используется кэширование.

Matplotlib распознаёт следующие форматы для задания цвета:

• кортеж RGB или RGBA (красный, зелёный, синий, альфа) из чисел с плавающей точкой в замкнутом интервале [0, 1] (например, (0.1, 0.2, 0.5) или (0.1, 0.2, 0.5, 0.3));
• шестнадцатеричная строка RGB или RGBA (например, '#0f0f0f' или '#0f0f0f80'; регистр не учитывается);
• сокращённая шестнадцатеричная строка RGB или RGBA, эквивалентная шестнадцатеричной строке RGB или RGBA, полученной путём удвоения каждого символа (например, '#abc', эквивалентная '#aabbcc', или '#abcd', эквивалентная '#aabbccdd'; регистр не учитывается);
• строковое представление числового значения с плавающей точкой в [0, 1] включительно для уровня серого (например, '0.5');
• один из символов {'b', 'g', 'r', 'c', 'm', 'y', 'k', 'w'}, которые являются сокращёнными обозначениями оттенков синего, зелёного, красного, сине-зелёного, пурпурного, жёлтого, чёрного и белого. Обратите внимание, что цвета 'g', 'c', 'm', 'y' не совпадают с цветами X11/CSS4. Их специфические оттенки были выбраны для лучшей видимости цветных линий на типичных фонах.
• название цвета X11/CSS4 (регистр не учитывается);
• название из обзора цветов xkcd, префикс 'xkcd:' (например, 'xkcd:sky blue'; регистр не учитывается);
• один из цветов Tableau из категорической палитры 'T10' (по умолчанию цикл цветов): {'tab:blue', 'tab:orange', 'tab:green', 'tab:red', 'tab:purple', 'tab:brown', 'tab:pink', 'tab:gray', 'tab:olive', 'tab:cyan'} (регистр не учитывается);
• спецификация цвета "CN", т. е. 'C', за которым следует число, которое является индексом в цикл свойств по умолчанию (rcParams["axes.prop_cycle"] (по умолчанию: cycler('color', ['#1f77b4', '#ff7f0e', '#2ca02c', '#d62728', '#9467bd', '#8c564b', '#e377c2', '#7f7f7f', '#bcbd22', '#17becf']))); индексирование предполагается выполнить во время рендеринга, по умолчанию — чёрный, если цикл не включает цвет.

Классы

Функции