Spec-Zone.ru › Matplotlib

matplotlib.colors

Примечание

Руководства по цветам и примеры демонстрируют, как задавать цвета и цветовые карты. Возможно, вам будет полезнее ознакомиться с ними.

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

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

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

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

См. также

Создание цветовых карт в Matplotlib — примеры создания цветовых карт, а также

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

Нормализация цветовой карты — подробные сведения о нормализации данных.

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

Модуль также предоставляет функции для проверки, можно ли интерпретировать объект как цвет (is_color_like), для преобразования такого объекта в кортеж RGBA (to_rgba) или в шестнадцатеричную строку в формате "#rrggbb", аналогичном HTML (to_hex), а также для преобразования последовательности цветов в массив RGBA формы (n, 4) (to_rgba_array). Для повышения эффективности используется кэширование.

Цвета, распознаваемые Matplotlib, перечислены в разделе Задание цветов.

Нормализация цветов

Normalize([vmin, vmax, clip])

Класс, который при вызове линейно отображает значения интервала [vmin, vmax] на интервал [0.0, 1.0].

NoNorm([vmin, vmax, clip])

Заглушка вместо Normalize для случаев, когда требуется напрямую использовать индексы в ScalarMappable.

AsinhNorm([linear_width, vmin, vmax, clip])

Масштаб обратного гиперболического синуса приблизительно линеен вблизи начала координат, но при больших положительных или отрицательных значениях становится логарифмическим.

BoundaryNorm(boundaries, ncolors[, clip, extend])

Создать индекс цветовой карты на основе дискретных интервалов.

CenteredNorm([vcenter, halfrange, clip])

Нормализовать симметричные данные относительно центра (по умолчанию 0).

FuncNorm(functions[, vmin, vmax, clip])

Произвольная нормализация с использованием функций прямого и обратного преобразования.

LogNorm([vmin, vmax, clip])

Нормализовать заданное значение до диапазона 0–1 по логарифмической шкале.

PowerNorm(gamma[, vmin, vmax, clip])

Линейно отобразить заданное значение в диапазон 0–1, а затем применить к этому диапазону нормализацию по степенному закону.

SymLogNorm(linthresh[, linscale, vmin, ...])

Симметричная логарифмическая шкала является логарифмической как в положительном, так и в отрицательном направлении от начала координат.

TwoSlopeNorm(vcenter[, vmin, vmax])

Нормализовать данные с заданным центром.

Одномерные цветовые карты

Colormap(name[, N])

Базовый класс для всех отображений скалярных значений в RGBA.

LinearSegmentedColormap(name, segmentdata[, ...])

Объекты цветовых карт на основе таблиц поиска с использованием линейных сегментов.

ListedColormap(colors[, name, N])

Объект цветовой карты, созданный из списка цветов.

Многомерные цветовые карты

BivarColormap([N, M, shape, origin, name])

Базовый класс для всех отображений бивариантных значений в RGBA.

SegmentedBivarColormap(patch[, N, shape, ...])

Объект BivarColormap, созданный методом передискретизации регулярной сетки.

BivarColormapFromImage(lut[, shape, origin, ...])

Объект BivarColormap, созданный методом передискретизации регулярной сетки.

Другие классы

ColorSequenceRegistry()

Контейнер для последовательностей цветов, известных Matplotlib по имени.

LightSource([azdeg, altdeg, hsv_min_val, ...])

Создать источник света с указанными азимутом и высотой.

Функции

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]) в значения 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).

same_color(c1, c2)

Вернуть значение, указывающее, совпадают ли цвета c1 и c2.

get_named_colors_mapping()

Вернуть глобальное сопоставление имен с именованными цветами.

make_norm_from_scale(scale_cls[, ...])

Декоратор для создания подкласса Normalize на основе подкласса ScaleBase.

Экспортируемые цвета

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

matplotlib.colors.BASE_COLORS
matplotlib.colors.TABLEAU_COLORS
matplotlib.colors.CSS4_COLORS
matplotlib.colors.XKCD_COLORS

© 2012–2026 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/stable/api/colors_api.html

Spec-Zone.ru

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