Цвета
Для визуального представления цветовых карт 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()) или в шестнадцатеричную строку 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'или'#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]) | Вспомогательная функция для генерации цветовой карты и объекта нормализации, которые ведут себя аналогично аргументам levels и colors функции 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 в массив 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.0.0/api/colors_api.html