mpl_toolkits.mplot3d.art3d.Path3DCollection

classmpl_toolkits.mplot3d.art3d.Path3DCollection(*args, zs=0, zdir='z', depthshade=True, **kwargs)[source]

Bases: PathCollection

Коллекция 3D путей.

Создаёт коллекцию плоских 3D путей с вектором нормали, направленным вдоль оси zdir, и расположенных на оси zdir в точке zs. 'zs' может быть скаляром или массивоподобным объектом, длина которого равна количеству путей в коллекции.

Аргументы конструктора такие же, как и для PathCollection. Дополнительно доступны ключевые аргументы zs=0 и zdir='z'.

Также доступен ключевой аргумент depthshade, указывающий, нужно ли затенять фигуры, чтобы создать впечатление глубины (по умолчанию True). Это обычно требуется в диаграммах рассеяния.

do_3d_projection()[source]

draw(renderer)[source]

Отрисовка элемента-артиста (и его дочерних элементов) с помощью заданного рендерера.

Если элемент-артист не отображается (Artist.get_visible возвращает False), то это действие не имеет эффекта.

Parameters:

rendererRendererBase подкласс.

Примечания

Этот метод переопределён в подклассах элементов-артистов.

get_depthshade()[source]

get_edgecolor()[source]

get_facecolor()[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>, depthshade=<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>, visible=<UNSET>, zorder=<UNSET>)[source]

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

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

Свойство	Описание
`3d_properties`	число с плавающей точкой или массив чисел с плавающей точкой
`agg_filter`	функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3), значение dpi и возвращает массив чисел с плавающей точкой (m, n, 3) и два смещения от нижнего левого угла изображения
`alpha`	подобный массиву объект, скаляр или None
`animated`	булево значение
`antialiased` или aa или antialiaseds	булево значение или список булевых значений
`array`	подобный массиву объект или None
`capstyle`	`CapStyle` или {'butt', 'projecting', 'round'}
`clim`	(vmin: число с плавающей точкой, vmax: число с плавающей точкой)
`clip_box`	`BboxBase` или None
`clip_on`	булево значение
`clip_path`	объект Patch или (Path, Transform) или None
`cmap`	`Colormap` или строка или None
`color`	цвет или список кортежей RGBA
`depthshade`	булево значение
`edgecolor` или ec или edgecolors	цвет или список цветов или 'face'
`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`	неизвестно
`sketch_params`	(scale: число с плавающей точкой, length: число с плавающей точкой, randomness: число с плавающей точкой)
`snap`	булево значение или None
`sort_zpos`	неизвестно
`transform`	`Transform`
`url`	строка
`urls`	список строк или None
`visible`	булево значение

zorder

вещественное число

set_3d_properties(zs, zdir)[source]

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

Параметры:

zsвещественное число или массив вещественных чисел: Расположение или расположения траекторий в коллекции вдоль оси zdir.
zdir{'x', 'y', 'z'}: Плоскость для построения траекторий ортогонально. Все траектории должны иметь одинаковое направление. См. get_dir_vector для описания значений.

set_depthshade(depthshade)[source]

Устанавливает, будет ли производиться затенение глубины для элементов коллекции.

Параметры:

depthshadebool: Признак затенения элементов, чтобы создать иллюзию глубины.

set_linewidth(lw)[source]

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

Параметры:

lwвещественное число или список вещественных чисел

set_sizes(sizes, dpi=72.0)[source]

Устанавливает размеры каждого элемента коллекции.

Параметры:

sizesnumpy.ndarray или None: Размер для каждого элемента коллекции. Значение представляет собой 'площадь' элемента.
dpiвещественное число, по умолчанию: 72: Разрешение холста (dpi).

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