matplotlib.colors
Для визуального представления цветовых палитр Matplotlib, см.:
- Примеры цветов для примеров управления цветом с помощью Matplotlib.
- Учебник Цвета для подробного руководства по управлению цветом.
Модуль для преобразования чисел или аргументов цвета в RGB или RGBA.
RGB и RGBA — это последовательности соответственно из 3 или 4 чисел с плавающей точкой в диапазоне от 0 до 1.
Этот модуль включает функции и классы для преобразования спецификаций цвета и для сопоставления чисел с цветами в одномерном массиве цветов, называемом цветовой палитрой.
Сопоставление данных с цветами, используя цветовую палитру, обычно включает два шага: массив данных сначала сопоставляется с диапазоном от 0 до 1 с использованием подкласса Normalize, а затем это число сопоставляется с цветом, используя подкласс Colormap. Здесь предоставляются два: LinearSegmentedColormap, который использует кусочно-линейную интерполяцию для определения цветовых палитр, и ListedColormap, который создаёт цветовую палитру из списка цветов.
См. также
Создание цветовых палитр в Matplotlib для примеров создания цветовых палитр и
Выбор цветовых палитр в Matplotlib для списка встроенных цветовых палитр.
Нормализация цветовых палитр для получения дополнительной информации о нормализации данных
Дополнительные цветовые палитры доступны на сайте palettable.
Модуль также предоставляет функции для проверки того, может ли объект интерпретироваться как цвет (is_color_like()), для преобразования такого объекта в кортеж RGBA (to_rgba()) или в шестнадцатеричную строку в формате #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'; регистр не учитывается); - строковое представление значения с плавающей точкой в
[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(vcenter[, vmin, vmax]) | Нормализация данных с заданным центром. |
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, ...]) | Симметричный логарифмический масштаб — логарифмический как в положительном, так и в отрицательном направлениях от начала координат. |
Функции
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.1.1/api/colors_api.html