Цвета
Для визуального представления цветовых палитр Matplotlib, см.:
- Примеры цветов для примеров управления цветом с помощью Matplotlib.
- Учебник цветов для углублённого руководства по управлению цветом.
matplotlib.colors
Модуль для преобразования чисел или аргументов цвета в RGB или RGBA
RGB и RGBA представляют собой последовательности, соответственно, 3 или 4 чисел с плавающей точкой в диапазоне от 0 до 1.
Этот модуль включает функции и классы для преобразований спецификаций цвета и для сопоставления чисел с цветами в одномерном массиве цветов, называемом цветовой палитрой. Обычно цветовое отображение включает два этапа: массив данных сначала отображается на диапазон 0-1 с помощью экземпляра Normalize или его подкласса; затем это число в диапазоне 0-1 отображается в цвет с помощью экземпляра подкласса Colormap. Здесь предоставлены два: LinearSegmentedColormap, который используется для генерации всех встроенных цветовых палитр, но также полезен для создания пользовательских цветовых палитр, и ListedColormap, который используется для генерации пользовательской цветовой палитры из списка спецификаций цвета.
Модуль также предоставляет функции для проверки, может ли объект интерпретироваться как цвет (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'или'#0F0F0F0F'); - строковое представление числа с плавающей точкой в
[0, 1]включительно для уровня серого (например,'0.5'); - один из
{'b', 'g', 'r', 'c', 'm', 'y', 'k', 'w'}; - имя цвета X11/CSS4;
- имя из обзора цветов xkcd; с префиксом
'xkcd:'(например,'xkcd:sky blue'); - один из
{'tab:blue', 'tab:orange', 'tab:green', 'tab:red', 'tab:purple', 'tab:brown', 'tab:pink', 'tab:gray', 'tab:olive', 'tab:cyan'}, которые являются цветами Tableau из категорической палитры 'T10' (по умолчанию используется для цикла цветов); - спецификация цвета "CN", т.е.
'C'за которым следует одна цифра, которая является индексом в цикле свойств по умолчанию (matplotlib.rcParams['axes.prop_cycle']); индексация происходит во время создания объекта и по умолчанию устанавливается в черный, если цикл не включает цвет.
Все строковые спецификации цвета, кроме "CN", регистронезависимы.
Классы
BoundaryNorm(boundaries, ncolors[, clip]) | Генерирует индекс цветовой палитры на основе дискретных интервалов. |
Colormap(name[, N]) | Базовый класс для всех скалярных отображений в RGBA. |
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, которые ведут себя аналогично аргументам уровней и цветов contourf. |
hsv_to_rgb(hsv) | Преобразует значения hsv в массиве numpy в значения rgb. Все значения предполагаются в диапазоне [0, 1] |
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 в массив (n, 4) цветов RGBA. |
is_color_like(c) | Возвращает, является ли c интерпретируемым как цвет RGB(A). |
makeMappingArray(N, data[, gamma]) | Создать 1-мерную таблицу поиска с N элементами. |
get_named_colors_mapping() | Возвращает глобальное отображение имен на именованные цвета. |
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/2.2.3/api/colors_api.html