matplotlib.colors
В учебниках и примерах по цветам показано, как задавать цвета и цветовые карты.
Модуль для преобразования чисел или аргументов цвета в RGB или RGBA.
RGB и RGBA представляют собой последовательности соответственно 3 или 4 чисел с плавающей точкой в диапазоне от 0 до 1.
Этот модуль включает функции и классы для преобразований спецификаций цвета и для сопоставления чисел с цветами в одномерном массиве цветов, называемом цветовой картой.
Для отображения данных с использованием цветовой карты обычно выполняют два шага: массив данных сначала отображается в диапазон 0-1 с помощью подкласса Normalize, а затем это число отображается в цвет с помощью подкласса Colormap. Здесь предоставляются два подкласса Colormap: LinearSegmentedColormap, который использует кусочно-линейную интерполяцию для определения цветовых карт, и ListedColormap, который создает цветовую карту из списка цветов.
См. также
Создание цветовых карт в Matplotlib для примеров создания цветовых карт и
Выбор цветовых карт в Matplotlib для списка встроенных цветовых карт.
Нормализация цветовых карт для получения более подробной информации о нормализации данных
Другие цветовые карты доступны на сайте palettable.
Модуль также предоставляет функции для проверки, можно ли интерпретировать объект как цвет (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']))); индексация выполняется во время отрисовки, и по умолчанию устанавливается в черный, если цикл не включает цвет.
Классы
BoundaryNorm(boundaries, ncolors[, clip, extend]) | Генерация индекса цветовой карты на основе дискретных интервалов. |
Colormap(name[, N]) | Базовый класс для всех отображений скаляра в RGBA. |
CenteredNorm([vcenter, halfrange, clip]) | Нормализация симметричных данных вокруг центра (по умолчанию 0). |
LightSource([azdeg, altdeg, hsv_min_val, ...]) | Создание источника света, исходящего из указанного азимута и углубления. |
LinearSegmentedColormap(name, segmentdata[, ...]) | Цветовые карты, основанные на таблицах поиска, использующих линейные сегменты. |
ListedColormap(colors[, name, N]) | Объект цветовой карты, созданный из списка цветов. |
LogNorm([vmin, vmax, clip]) | Нормализация заданного значения в диапазоне 0-1 в логарифмической шкале. |
NoNorm([vmin, vmax, clip]) | Заглушка для Normalize в случае, когда мы хотим использовать индексы непосредственно в ScalarMappable. |
Normalize([vmin, vmax, clip]) | Класс, который при вызове линейно нормализует данные в интервал [0.0, 1.0]. |
PowerNorm(gamma[, vmin, vmax, clip]) | Линейно отображает заданное значение в диапазон 0-1, а затем применяет нормализацию по степенному закону к этому диапазону. |
SymLogNorm(linthresh[, linscale, vmin, ...]) | Симметричная логарифмическая шкала является логарифмической как в положительном, так и в отрицательном направлениях от начала координат. |
TwoSlopeNorm(vcenter[, vmin, vmax]) | Нормализация данных с заданным центром. |
FuncNorm(functions[, vmin, vmax, clip]) | Произвольная нормализация с использованием функций для прямого и обратного преобразований. |
Функции
from_levels_and_colors(levels, colors[, extend]) | Вспомогательная функция для создания cmap и экземпляра norm, которые ведут себя аналогично аргументам levels и colors в contourf. |
hsv_to_rgb(hsv) | Преобразование значений hsv в rgb. |
rgb_to_hsv(arr) | Преобразование значений rgb с плавающей запятой (в диапазоне [0, 1]) в массиве numpy в значения hsv. |
to_hex(c[, keep_alpha]) | Преобразование c в шестнадцатеричный цвет. |
to_rgb(c) | Преобразование c в цвет RGB, молча игнорируя альфа-канал. |
to_rgba(c[, alpha]) | Преобразование c в цвет RGBA. |
to_rgba_array(c[, alpha]) | Преобразование c в массив RGBA размера (n, 4). |
is_color_like(c) | Возвращает, можно ли интерпретировать c как цвет RGB(A). |
same_color(c1, c2) | Возвращает, являются ли цвета c1 и c2 одинаковыми. |
get_named_colors_mapping() | Возвращает глобальное отображение имен к именованным цветам. |
© 2012–2021 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.4.3/api/colors_api.html