matplotlib.colors
В учебниках и примерах по цвету показано, как устанавливать цвета и цветовые карты.
Модуль для преобразования чисел или аргументов цвета в RGB или RGBA.
RGB и RGBA — это последовательности соответственно 3 или 4 чисел с плавающей точкой в диапазоне от 0 до 1.
Этот модуль включает функции и классы для преобразования спецификаций цвета и для сопоставления чисел с цветами в одномерном массиве цветов, называемом цветовой картой.
Сопоставление данных с цветами с помощью цветовой карты обычно включает два шага: массив данных сначала отображается на диапазон от 0 до 1 с помощью подкласса Normalize, а затем это число отображается в цвет с помощью подкласса Colormap. Здесь представлены два: LinearSegmentedColormap, который использует кусочно-линейную интерполяцию для определения цветовых карт, и ListedColormap, который создаёт цветовую карту из списка цветов.
См. также
Создание цветовых карт в Matplotlib для примеров создания цветовых карт и
Выбор цветовых карт в Matplotlib для списка встроенных цветовых карт.
Нормализация цветовых карт для получения дополнительных сведений о нормализации данных
Больше цветовых карт доступно на сайте palettable.
Модуль также предоставляет функции для проверки, может ли объект интерпретироваться как цвет (is_color_like()), для преобразования такого объекта в кортеж RGBA (to_rgba()) или в строку шестнадцатеричного цвета, подобную HTML, в формате #rrggbb (to_hex()), и последовательность цветов в массив (n, 4) RGBA (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'}, это односимвольные сокращённые обозначения для синего, зелёного, красного, голубого, пурпурного, жёлтого, чёрного и белого. - название цвета 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'за которым следует число, которое является индексом в стандартном цикле свойств (matplotlib.rcParams['axes.prop_cycle']); индексирование предполагается в момент отрисовки, и по умолчанию устанавливается в чёрный, если цикл не включает цвет.
Классы
BoundaryNorm(boundaries, ncolors[, clip]) | Генерирует индекс цветовой карты на основе дискретных интервалов. |
Colormap(name[, N]) | Базовый класс для всех скалярных отображений в RGBA. |
DivergingNorm(**kwargs) | [Устарело] |
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]) | Нормализует данные с заданным центром. |
Функции
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). |
makeMappingArray(N, data[, gamma]) | [Устарело] Создать одномерную таблицу поиска с N элементами. |
get_named_colors_mapping() | Возвращает глобальное отображение имен на именованные цвета. |
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.2.2/api/colors_api.html