Spec-Zone.ru › Matplotlib 2.2

Цвета

Для визуального представления цветовых палитр 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

Spec-Zone.ru

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