Spec-Zone.ru › Matplotlib 3.2

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API