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]

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

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

END_OF_DOCUMENT_MARKER ```

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

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

Параметры:

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

set_sort_zpos(val)[source]: Установите позицию для сортировки по z.

set_verts(verts, closed=True)[source]

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

Параметры:

vertsсписок (N, 3) массивов-подобных объектов: Последовательность многоугольников [verts0, verts1, ...] где каждый элемент verts_i определяет вершины многоугольника i как 2D массив-подобный объект формы (N, 3).
closedbool, по умолчанию: True: Закрывать ли многоугольник, добавив соединение CLOSEPOLY в конце.

set_verts_and_codes(verts, codes)[source]: Установите 3D вершины с кодами пути.

set_zsort(zsort)[source]

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

Параметры:

zsort{'average', 'min', 'max'}: Функция, применяемая к координатам z вершин в системе координат зрителя, для определения порядка по z.

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

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

2D и 3D оси на одной фигуре

Создание многоугольников для заполнения под 3D графиком

3D графики как подграфики

3D поверхность (цветовая карта)

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

mpl_toolkits.mplot3d.art3d.Poly3DCollection

Примечания

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

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