mpl_toolkits.mplot3d.art3d.Poly3DCollection

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

Bases: matplotlib.collections.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(renderer=<deprecated parameter>)[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>, 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 или (Путь, Преобразование) или None
`cmap`	`Colormap` или str или None
`color`	цвет или список кортежей rgba
`edgecolor` или ec или edgecolors	неизвестно
`facecolor` или facecolors или fc	неизвестно
`figure`	`Figure`
`gid`	str
`hatch`	{'/', '\', '\|', '-', '+', 'x', 'o', 'O', '.', '*'}
`in_layout`	bool
`joinstyle`	`JoinStyle` или {'miter', 'round', 'bevel'}
`label`	объект
`linestyle` или dashes или linestyles или ls	строка или кортеж или список из них
`linewidth` или linewidths или lw	число с плавающей точкой или список чисел с плавающей точкой
`norm`	`Normalize` или None
`offset_transform`	`Transform`
`offsets`	(N, 2) или (2,) массив-подобный объект
`path_effects`	`AbstractPathEffect`
`paths`	список массивов-подобных объектов
`picker`	None или bool или float или вызываемый объект
`pickradius`	число с плавающей точкой
`rasterized`	bool
`sizes`	массив NumPy или 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`	{'average', 'min', 'max'}

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', фигура не будет закрашена.

Параметры