mpl_toolkits.mplot3d.art3d.Poly3DCollection

classmpl_toolkits.mplot3d.art3d.Poly3DCollection(verts, *args, zsort='average', shade=False, lightsource=None, axlim_clip=False, **kwargs)[исходный код]

Базовые классы: PolyCollection

Коллекция 3D-многоугольников.

Примечание

Заливка 3D-многоугольников

Простого определения ограниченной поверхности 3D-многоугольника не существует, если только многоугольник не является плоским.

На практике Matplotlib выполняет заливку 2D-проекции многоугольника. Корректный вид заливки получается только для плоских многоугольников. Для всех остальных многоугольников найдутся такие ориентации, при которых рёбра многоугольника пересекаются в проекции. Это приведёт к некорректной визуализации 3D-области.

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

Параметры:

vertsсписок объектов, подобных массивам, формы (N, 3)

Последовательность многоугольников [verts0, verts1, ...], в которой каждый элемент verts_i задаёт вершины многоугольника i как двумерный объект, подобный массиву, формы (N, 3).

zsort{'average', 'min', 'max'}, по умолчанию: 'average'

Способ вычисления порядка по z. Подробности см. в set_zsort.

shadebool, по умолчанию: False

Нужно ли затенять facecolors и edgecolors. При включении shade необходимо задать facecolors и/или edgecolors.

Добавлено в версии 3.7.

lightsourceLightSource, необязательно

Источник света, используемый, если shade имеет значение True.

Добавлено в версии 3.7.

axlim_clipbool, по умолчанию: False

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

*args, **kwargs

Все остальные параметры передаются в PolyCollection.

Примечания

Обратите внимание, что этот класс особым образом обрабатывает свойства _facecolors и _edgecolors.

do_3d_projection()[исходный код]

Выполнить 3D-проекцию этого объекта.

get_edgecolor()[исходный код]

get_facecolor()[исходный код]

get_vector(segments3d)[исходный код]

[Устарел]

Примечания

Устарел начиная с версии 3.10:

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, array=<UNSET>, capstyle=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, gid=<UNSET>, hatch=<UNSET>, hatch_linewidth=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, offset_transform=<UNSET>, offsets=<UNSET>, path_effects=<UNSET>, paths=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, sizes=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, sort_zpos=<UNSET>, transform=<UNSET>, url=<UNSET>, urls=<UNSET>, verts=<UNSET>, verts_and_codes=<UNSET>, visible=<UNSET>, zorder=<UNSET>, zsort=<UNSET>)[исходный код]

Задать несколько свойств одновременно.

Поддерживаются следующие свойства:

Свойство	Описание
3d_properties	неизвестно
agg_filter	функция фильтра, принимающая массив чисел с плавающей запятой формы (m, n, 3) и значение dpi и возвращающая массив формы (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	неизвестно
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	неизвестно
facecolor или facecolors или fc	неизвестно
figure	Figure или SubFigure
gid	str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	неизвестно
in_layout	bool
joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
label	object
linestyle или dashes или linestyles или ls	str, кортеж или список из таких элементов
linewidth или linewidths или lw	float или список значений float
mouseover	bool
norm	Normalize или str или None
offset_transform или transOffset	Transform
offsets	объект, подобный массиву, формы (N, 2) или (2,)
path_effects	список объектов AbstractPathEffect
paths	список объектов, подобных массивам
picker	None, bool, float или вызываемый объект
pickradius	float
rasterized	bool
sizes	numpy.ndarray или None
sketch_params	(scale: float, length: float, randomness: float)
snap	bool или None
sort_zpos	неизвестно
transform	Transform
url	str
urls	список значений str или None
verts	список объектов, подобных массивам, формы (N, 3)
verts_and_codes	неизвестно
visible	bool
zorder	float
zsort	{'average', 'min', 'max'}

set_3d_properties(axlim_clip=False)[исходный код]

set_alpha(alpha)[исходный код]

Задать значение альфа-канала, используемое для смешивания; поддерживается не всеми графическими бэкендами.

Параметры:

alphaобъект, подобный массиву, или float, или None

Все значения должны находиться в диапазоне от 0 до 1 включительно. Маскированные значения и NaN не поддерживаются.

set_edgecolor(colors)[исходный код]

Задать цвет(а) границ коллекции.

Параметры:

cцвет или список значений цвет или 'face'

Цвет(а) границ коллекции. Если задана последовательность, заливки перебирают её элементы по циклу. Если задано 'face', используется цвет заливки.

set_facecolor(colors)[исходный код]

Задать цвет(а) заливки коллекции. c может быть цветом (все заливки будут одного цвета) или последовательностью цветов; если задана последовательность, заливки будут перебирать её элементы по циклу.

Если c имеет значение 'none', заливка не будет выполнена.

Параметры:

cцвет или список значений цвет

set_sort_zpos(val)[исходный код]

Задать положение, используемое для сортировки по z.

set_verts(verts, closed=True)[исходный код]

Задать 3D-вершины.

Параметры:

vertsсписок объектов, подобных массивам, формы (N, 3)

Последовательность многоугольников [verts0, verts1, ...], в которой каждый элемент verts_i задаёт вершины многоугольника i как двумерный объект, подобный массиву, формы (N, 3).

closedbool, по умолчанию: True

Нужно ли замкнуть многоугольник, добавив в конце соединение CLOSEPOLY.

set_verts_and_codes(verts, codes)[исходный код]

Задать 3D-вершины с кодами пути.

set_zsort(zsort)[исходный код]

Задать способ вычисления порядка по z.

Параметры:

zsort{'average', 'min', 'max'}

Функция, применяемая к координатам z вершин в системе координат наблюдателя для определения порядка по z.

Примеры использования mpl_toolkits.mplot3d.art3d.Poly3DCollection

Пользовательское затенение рельефа на трёхмерном графике поверхности

Пользовательское затенение рельефа на трёхмерном графике поверхности

Двумерные и трёхмерные оси на одном рисунке

Двумерные и трёхмерные оси на одном рисунке

Создание трёхмерных многоугольников

Создание трёхмерных многоугольников

Трёхмерные графики в качестве подграфиков

Трёхмерные графики в качестве подграфиков

Трёхмерная поверхность (цветовая карта)

Трёхмерная поверхность (цветовая карта)

Трёхмерная поверхность (шахматная доска)

Трёхмерная поверхность (шахматная доска)