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 как двумерный массив-подобный объект формы (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	Bbox
clip_on	логическое значение
clip_path	Объект Patch или (объект Path, преобразование) или 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	неизвестно
offsets	(N, 2) или (2,) массивоподобный объект
path_effects	AbstractPathEffect
paths	список массивоподобных объектов
picker	None или логическое значение или число с плавающей точкой или вызываемый объект
pickradius	неизвестно
rasterized	логическое значение
sizes	numpy.ndarray или None
sketch_params	(scale: число с плавающей точкой, length: число с плавающей точкой, randomness: число с плавающей точкой)
snap	логическое значение или None
sort_zpos	неизвестно
transform	Transform
url	строка
urls	список строк или None
verts	список (N, 3) массивоподобных объектов
verts_and_codes	неизвестно
visible	логическое значение

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', фигура не будет заливаться.

Параметры:

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 поверхность (шахматная доска)