Spec-Zone.ru › Matplotlib 3.8

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" (to_hex) и последовательность цветов в массив RGBA (n, 4) (to_rgba_array). Для повышения эффективности используется кэширование.

Распознаваемые Matplotlib цвета перечислены на странице Указание цветов.

Нормы цветов

Normalize([vmin, vmax, clip])

Класс, который при вызове линейно нормализует данные в диапазон [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])

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

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

ColorSequenceRegistry()

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

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

Создает источник света, исходящий из указанного азимута и возвышения.

END_OF_DOCUMENT_MARKER

Функции

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–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.8.4/api/colors_api.html

Spec-Zone.ru

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