mpl_toolkits.mplot3d.art3d.Path3DCollection

classmpl_toolkits.mplot3d.art3d.Path3DCollection(*args, zs=0, zdir='z', depthshade=True, axlim_clip=False, **kwargs)[исходный код]

Базовые классы: PathCollection

Коллекция 3D-траекторий.

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

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

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

do_3d_projection()[исходный код]

draw(renderer)[исходный код]

Рисует Artist (и его дочерние элементы) с помощью указанного средства визуализации.

Не оказывает эффекта, если Artist не виден (Artist.get_visible возвращает False).

Параметры:

rendererподкласс RendererBase.

Примечания

Этот метод переопределяется в подклассах Artist.

get_depthshade()[исходный код]

get_edgecolor()[исходный код]

get_facecolor()[исходный код]

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>, hatch_linewidth=<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>)[исходный код]

Задаёт сразу несколько свойств.

Поддерживаются следующие свойства:

Свойство	Описание
3d_properties	float или массив значений float
agg_filter	функция фильтра, принимающая массив float формы (m, n, 3) и значение dpi и возвращающая массив формы (m, n, 3) и два смещения от левого нижнего угла изображения
alpha	массивоподобный объект, float или None
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, str или None
color	цвет или список кортежей RGBA
depthshade	bool
edgecolor или ec или edgecolors	цвет, список значений цвета или 'face'
facecolor или facecolors или fc	цвет или список значений цвета
figure	Figure или SubFigure
gid	str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	неизвестно
in_layout	bool
joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
label	object
linestyle или dashes или linestyles или ls	str, кортеж или список таких значений
linewidth или linewidths или lw	неизвестно
mouseover	bool
norm	Normalize, str или None
offset_transform или transOffset	Transform
offsets	массивоподобный объект формы (N, 2) или (2,)
path_effects	список объектов AbstractPathEffect
paths	неизвестно
picker	None, bool, float или вызываемый объект
pickradius	float
rasterized	bool
sizes	неизвестно
sketch_params	(scale: float, length: float, randomness: float)
snap	bool или None
sort_zpos	неизвестно
transform	Transform
url	str
urls	список значений str или None
visible	bool
zorder	float

set_3d_properties(zs, zdir, axlim_clip=False)[исходный код]

Задаёт координаты z и направление траекторий.

Параметры:

zsfloat или массив значений float

Координата или координаты, на которых следует расположить траектории коллекции вдоль оси zdir.

zdir{'x', 'y', 'z'}

Плоскость, относительно которой траектории следует строить перпендикулярно. Все траектории должны иметь одинаковое направление. Описание значений см. в get_dir_vector.

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

Следует ли скрывать траектории, у которых вершина находится за пределами видимых границ осей.

set_depthshade(depthshade)[исходный код]

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

Параметры:

depthshadebool

Следует ли затенять элементы, чтобы создать иллюзию глубины.

set_linewidth(lw)[исходный код]

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

Параметры:

lwfloat или список значений float

set_sizes(sizes, dpi=72.0)[исходный код]

Задаёт размеры каждого элемента коллекции.

Параметры:

sizesnumpy.ndarray или None

Размер, задаваемый для каждого элемента коллекции. Значение соответствует «площади» элемента.

dpifloat, по умолчанию: 72

Значение dpi холста.

set_sort_zpos(val)[исходный код]

Задаёт координату для сортировки по z.