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`	float или массив float
`agg_filter`	функция фильтра, которая принимает (m, n, 3) массив float и значение dpi, и возвращает (m, n, 3) массив и два смещения от нижнего левого угла изображения
`alpha`	подобный массиву объект, скаляр или None
`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 или (Path, Transform) или None
`cmap`	`Colormap` или str или None
`color`	цвет или список кортежей RGBA
`depthshade`	bool
`edgecolor` или ec или edgecolors	цвет или список цветов или 'face'
`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	неизвестно
`offsets`	(N, 2) или (2,) массив
`path_effects`	`AbstractPathEffect`
`paths`	неизвестно
`picker`	None или bool или float или вызываемая функция
`pickradius`	неизвестно
`rasterized`	bool
`sizes`	неизвестно
`sketch_params`	(scale: float, length: float, randomness: float)
`snap`	bool или None
`sort_zpos`	неизвестно
`transform`	`Transform`
`url`	строка
`urls`	список строк или None
`visible`	bool
`zorder`	float

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.