Spec-Zone.ru › Matplotlib 3.4

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 распознает следующие форматы для задания цвета:

  • кортеж RGB или RGBA (красный, зеленый, синий, альфа) из чисел с плавающей точкой в замкнутом интервале [0, 1] (например, (0.1, 0.2, 0.5) или (0.1, 0.2, 0.5, 0.3));
  • шестнадцатеричная строка RGB или RGBA (например, '#0f0f0f' или '#0f0f0f80'; регистр не учитывается);
  • краткая шестнадцатеричная строка RGB или RGBA, эквивалентная шестнадцатеричной строке RGB или RGBA, полученной путем дублирования каждого символа (например, '#abc', эквивалентная '#aabbcc', или '#abcd', эквивалентная '#aabbccdd'; регистр не учитывается);
  • строковое представление числового значения с плавающей точкой в [0, 1] включительно для уровня серого (например, '0.5');
  • один из символов {'b', 'g', 'r', 'c', 'm', 'y', 'k', 'w'}, которые являются сокращениями для оттенков синего, зеленого, красного, сине-зеленого, пурпурного, желтого, черного и белого. Обратите внимание, что цвета 'g', 'c', 'm', 'y' не совпадают с цветами X11/CSS4. Их конкретные оттенки были выбраны для лучшей видимости цветных линий на типичных фонах.
  • имя цвета 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', за которым следует число, являющееся индексом в стандартном цикле свойств (rcParams["axes.prop_cycle"] (по умолчанию: cycler('color', ['#1f77b4', '#ff7f0e', '#2ca02c', '#d62728', '#9467bd', '#8c564b', '#e377c2', '#7f7f7f', '#bcbd22', '#17becf']))); индексация выполняется во время отрисовки, и по умолчанию устанавливается в черный, если цикл не включает цвет.

Классы

BoundaryNorm(boundaries, ncolors[, clip, extend]) Генерация индекса цветовой карты на основе дискретных интервалов.
Colormap(name[, N]) Базовый класс для всех отображений скаляра в RGBA.
CenteredNorm([vcenter, halfrange, clip]) Нормализация симметричных данных вокруг центра (по умолчанию 0).
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, ...]) Симметричная логарифмическая шкала является логарифмической как в положительном, так и в отрицательном направлениях от начала координат.
TwoSlopeNorm(vcenter[, vmin, vmax]) Нормализация данных с заданным центром.
FuncNorm(functions[, vmin, vmax, clip]) Произвольная нормализация с использованием функций для прямого и обратного преобразований.

Функции

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).
same_color(c1, c2) Возвращает, являются ли цвета c1 и c2 одинаковыми.
get_named_colors_mapping() Возвращает глобальное отображение имен к именованным цветам.

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

Spec-Zone.ru

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