matplotlib.pyplot.tripcolor

matplotlib.pyplot.tripcolor(*args, alpha=1.0, norm=None, cmap=None, vmin=None, vmax=None, shading='flat', facecolors=None, **kwargs)[исходный код]

Создаёт псевдоцветное изображение неструктурированной треугольной сетки.

Сигнатуры вызова:

tripcolor(triangulation, c, *, ...)
tripcolor(x, y, c, *, [triangles=triangles], [mask=mask], ...)

Треугольную сетку можно задать, передав объект Triangulation в качестве первого параметра либо передав точки x, y и, при необходимости, triangles и mask. Описание этих параметров см. в разделе Triangulation.

Треугольники можно передать позиционно, например tripcolor(x, y, triangles, c, ...). Однако такой способ не рекомендуется. Для большей ясности передавайте triangles с помощью именованного аргумента.

Если не указаны ни triangulation, ни triangles, триангуляция вычисляется на лету. В этом случае нет смысла задавать цвета граней треугольников с помощью c или facecolors, поскольку для группы точек возможно несколько вариантов триангуляции, и заранее неизвестно, какие треугольники будут построены.

Параметры:

triangulationTriangulation

Уже созданная треугольная сетка.

x, y, triangles, mask

Параметры, задающие треугольную сетку. См. раздел Triangulation. Взаимоисключающий параметр по отношению к triangulation.

carray-like

Значения цветов для точек или треугольников. Тип данных определяется автоматически по длине c: она сопоставляется с количеством точек или количеством треугольников. Если в триангуляции количество точек и треугольников одинаково, предполагается, что значения цветов заданы для точек; чтобы принудительно использовать значения цветов для треугольников, примените именованный аргумент facecolors=c вместо простого c. Этот параметр можно задавать только позиционно.

facecolorsarray-like, optional

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

shading{'flat', 'gouraud'}, default: 'flat'

Если задано значение 'flat' и значения цветов c определены для точек, для каждого треугольника используются средние значения c его трёх вершин. Если для shading задано значение 'gouraud', значения цветов должны быть определены для точек.

cmapstr or Colormap, default: rcParams["image.cmap"] (default: 'viridis')

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

normstr or Normalize, optional

Метод нормализации, используемый для масштабирования скалярных данных до диапазона [0, 1] перед преобразованием в цвета с помощью cmap. По умолчанию используется линейное масштабирование: минимальное значение отображается в 0, а максимальное — в 1.

Если этот параметр задан, его значением может быть один из следующих вариантов:

• Экземпляр Normalize или одного из его подклассов (см. раздел Нормализация цветовой карты).
• Имя шкалы, например "linear", "log", "symlog", "logit" и т. д. Список доступных шкал можно получить с помощью вызова matplotlib.scale.get_scale_names(). В этом случае подходящий подкласс Normalize динамически создаётся и инициализируется.

vmin, vmaxfloat, optional

При использовании скалярных данных и отсутствии явного norm, vmin и vmax задают диапазон данных, охватываемый цветовой картой. По умолчанию цветовая карта охватывает полный диапазон значений переданных данных. Использовать vmin/vmax вместе с экземпляром norm нельзя (однако допустимо использовать имя norm типа str вместе с vmin/vmax).

colorizerColorizer or None, default: None

Объект Colorizer, используемый для сопоставления цветов данным. Если задано значение None, объект Colorizer создаётся на основе norm и cmap.

Возвращает:

PolyCollection or TriMesh

Результат зависит от shading: при shading='flat' результатом является PolyCollection, а при shading='gouraud' — TriMesh.

Другие параметры:

**kwargsCollection свойства

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив чисел с плавающей точкой размером (m, n, 3) и значение dpi, а возвращает массив размером (m, n, 3) и два смещения относительно нижнего левого угла изображения
alpha	массивоподобное значение, число с плавающей точкой или None
animated	bool
antialiased или aa или antialiaseds	bool или список значений bool
array	массивоподобное значение или None
capstyle	CapStyle или {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase или None
clip_on	bool
clip_path	Patch или (Path, Transform) или None
cmap	Colormap или str или None
color	цвет или список кортежей RGBA
edgecolor или ec или edgecolors	цвет или список цветов или 'face'
facecolor или facecolors или fc	цвет или список цветов
figure	Figure или SubFigure
gid	str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	неизвестно
in_layout	bool
joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
label	объект
linestyle или dashes или linestyles или ls	str, кортеж или список таких значений
linewidth или linewidths или lw	число с плавающей точкой или список чисел с плавающей точкой
mouseover	bool
norm	Normalize или str или None
offset_transform или transOffset	Transform
offsets	массивоподобное значение размером (N, 2) или (2,)
path_effects	список AbstractPathEffect
paths	неизвестно
picker	None, bool, число с плавающей точкой или вызываемый объект
pickradius	число с плавающей точкой
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool или None
transform	Transform
url	str
urls	список str или None
visible	bool
zorder	число с плавающей точкой

Примечания

Примечание

Это обёртка pyplot для axes.Axes.tripcolor.

Примеры использования matplotlib.pyplot.tripcolor

Демонстрация Tripcolor

Демонстрация Tripcolor