Spec-Zone.ru › Matplotlib 3.1

matplotlib.colors

Для визуального представления цветовых палитр Matplotlib, см.:

  • Примеры цветов для примеров управления цветом с помощью Matplotlib.
  • Учебник Цвета для подробного руководства по управлению цветом.

Модуль для преобразования чисел или аргументов цвета в RGB или RGBA.

RGB и RGBA — это последовательности соответственно из 3 или 4 чисел с плавающей точкой в диапазоне от 0 до 1.

Этот модуль включает функции и классы для преобразования спецификаций цвета и для сопоставления чисел с цветами в одномерном массиве цветов, называемом цветовой палитрой.

Сопоставление данных с цветами, используя цветовую палитру, обычно включает два шага: массив данных сначала сопоставляется с диапазоном от 0 до 1 с использованием подкласса Normalize, а затем это число сопоставляется с цветом, используя подкласс Colormap. Здесь предоставляются два: LinearSegmentedColormap, который использует кусочно-линейную интерполяцию для определения цветовых палитр, и ListedColormap, который создаёт цветовую палитру из списка цветов.

См. также

Создание цветовых палитр в Matplotlib для примеров создания цветовых палитр и

Выбор цветовых палитр в Matplotlib для списка встроенных цветовых палитр.

Нормализация цветовых палитр для получения дополнительной информации о нормализации данных

Дополнительные цветовые палитры доступны на сайте palettable.

Модуль также предоставляет функции для проверки того, может ли объект интерпретироваться как цвет (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' или '#0f0f0f80'; регистр не учитывается);
  • строковое представление значения с плавающей точкой в [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(vcenter[, vmin, vmax]) Нормализация данных с заданным центром.
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 в 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.1.1/api/colors_api.html

Spec-Zone.ru

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