mpl_toolkits.mplot3d.art3d.Poly3DCollection

classmpl_toolkits.mplot3d.art3d.Poly3DCollection(verts, *args, zsort='average', **kwargs)[source]

Bases: PolyCollection

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

Примечание

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

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

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

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

Параметры:

vertsсписок (N, 3) массивоподобных: Каждый элемент описывает многоугольник как последовательность N_i точек (x, y, z).
zsort{'average', 'min', 'max'}, по умолчанию: 'average': Метод вычисления z-порядка. Подробнее см. set_zsort.
*args, **kwargs: Все остальные параметры передаются в PolyCollection.

Примечания

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

do_3d_projection()[source]: Выполнение 3D-проекции для этого объекта.

get_edgecolor()[source]

get_facecolor()[source]

get_vector(segments3d)[source]: Оптимизация точек для проекции.

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>, 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>)[source]

Установка нескольких свойств сразу.

Поддерживаемые свойства:

Свойство	Описание
`agg_filter`	функция фильтра, принимающая массив float (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`	`Bbox`
`clip_on`	bool
`clip_path`	Patch или (Path, Transform) или None
`cmap`	`Colormap` или строка или None
`color`	цвет или список кортежей rgba
`edgecolor` или ec или edgecolors	неизвестно
`facecolor` или facecolors или fc	неизвестно
`figure`	`Figure`
`gid`	строка
`hatch`	{'/', '\', '\|', '-', '+', 'x', 'o', 'O', '.', '*'}
`in_layout`	bool
`joinstyle`	`JoinStyle` или {'miter', 'round', 'bevel'}
`label`	объект
`linestyle` или dashes или linestyles или ls	строка или кортеж или список
`linewidth` или linewidths или lw	число с плавающей точкой или список чисел с плавающей точкой
`mouseover`	bool
`norm`	`Normalize` или строка или None
`offset_transform` или transOffset	неизвестно
`offsets`	(N, 2) или (2,) массив-подобный
`path_effects`	`AbstractPathEffect`
`paths`	список массивов-подобных
`picker`	None или bool или число с плавающей точкой или вызываемый объект
`pickradius`	неизвестно
`rasterized`	bool
`sizes`	ndarray или None
`sketch_params`	(scale: float, length: float, randomness: float)
`snap`	bool или None
`sort_zpos`	неизвестно
`transform`	`Transform`
`url`	строка
`urls`	список строк или None
`verts`	неизвестно
`verts_and_codes`	неизвестно
`visible`	bool
`zorder`	число с плавающей точкой

zsort

{'среднее', 'мин', 'макс'}

set_3d_properties()[source]

set_alpha(alpha)[source]

Устанавливает значение альфа-канала для смешивания - не поддерживается во всех бэкендах.

Параметры:

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

set_edgecolor(colors)[source]

Устанавливает цвет(цвета) обводки коллекции.

Параметры:

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

set_facecolor(colors)[source]

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

Если c равно 'none', фигура не будет закрашена.

Параметры: