mpl_toolkits.mplot3d.art3d.Poly3DCollection

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

Bases: PolyCollection

Коллекция 3D-полигонов.

Примечание

Заполнение 3D-полигонов

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

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

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

Параметры:

vertsсписок (N, 3) массивов

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

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

Метод расчёта порядка z. Подробнее см. set_zsort.

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

Определяет, затенять ли facecolors и edgecolors. При активации shade, необходимо указать facecolors и/или edgecolors.

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

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

Источник света для использования, когда shade = True.

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

*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	функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив чисел с плавающей точкой (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	неизвестно
animated	логическое значение
antialiased или aa или antialiaseds	логическое значение или список логических значений
array	массив или None
capstyle	CapStyle или {'butt', 'projecting', 'round'}
clim	(vmin: число с плавающей точкой, vmax: число с плавающей точкой)
clip_box	BboxBase или None
clip_on	логическое значение
clip_path	Объект Patch или (Путь, Преобразование) или None
cmap	Colormap или строка или None
color	цвет или список кортежей RGBA
edgecolor или ec или edgecolors	неизвестно
facecolor или facecolors или fc	неизвестно
figure	Figure
gid	строка
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
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	логическое значение
sizes	numpy.ndarray или None
sketch_params	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
snap	логическое значение или None
sort_zpos	неизвестно
transform	Transform
url	строка
urls	список строк или None
verts	список массивов (N, 3)
verts_and_codes	неизвестно

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

Параметры:

cцвет или список цветов

set_sort_zpos(val)[source]

Устанавливает позицию для сортировки по z.

set_verts(verts, closed=True)[source]

Устанавливает 3D вершины.

Параметры:

vertsсписок (N, 3) массивов

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

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

Закрыть ли многоугольник, добавив соединение CLOSEPOLY в конце.

set_verts_and_codes(verts, codes)[source]

Устанавливает 3D вершины с кодами пути.

set_zsort(zsort)[source]

Устанавливает метод расчёта порядка z.

Параметры:

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

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

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

Настройка затенения поверхности в 3D-графике

Настройка затенения поверхности в 3D-графике

Оси 2D и 3D на одном графике

Оси 2D и 3D на одном графике

Генерация многоугольников для заполнения области под 3D графиком линии

Генерация многоугольников для заполнения области под 3D графиком линии

3D графики в качестве подграфиков

3D графики в качестве подграфиков

3D поверхность (палитры цветов)

3D поверхность (палитры цветов)

3D поверхность (шахматный узор)

3D поверхность (шахматный узор)