Spec-Zone.ru › Matplotlib 2.1

цвета

Для визуального представления цветовых карт 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, которые ведут себя аналогично аргументам levels и colors функции contourf.
hsv_to_rgb(hsv) преобразует значения hsv в массиве numpy в 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 в массив (n, 4) цветов RGBA.
is_color_like(c) Возвращает, можно ли интерпретировать c как цвет RGB(A).
makeMappingArray(N, data[, gamma]) Создаёт одномерную таблицу поиска длиной N.
get_named_colors_mapping() Возвращает глобальное отображение имен на именованные цвета.

© 2012–2017 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
http://matplotlib.org/2.1.0/api/colors_api.html

Spec-Zone.ru

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