matplotlib.axes.Axes.tripcolor

Axes.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.

cподобный массиву объект

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

facecolorsподобный массиву объект, необязательный

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

shading{'flat', 'gouraud'}, по умолчанию: 'flat'

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

cmapстрока или Colormap, по умолчанию: rcParams["image.cmap"] (значение по умолчанию: 'viridis')

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

normстрока или Normalize, необязательный

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

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

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

vmin, vmaxчисло с плавающей точкой, необязательный

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

colorizerColorizer или None, по умолчанию: None

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

Возвращает:

PolyCollection или TriMesh

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

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

**kwargsсвойства Collection

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

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

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

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

tripcolor(x, y, z)

tripcolor(x, y, z)