mpl_toolkits.mplot3d.axes3d.Axes3D

classmpl_toolkits.mplot3d.axes3d.Axes3D(fig, rect=None, *args, azim=- 60, elev=30, sharez=None, proj_type='persp', box_aspect=None, computed_zorder=True, **kwargs)[source]

Bases: matplotlib.axes._axes.Axes

Объект 3D-оси.

Параметры

figFigure

Родительская фигура.

rect(float, float, float, float)

Положение оси.

azimfloat, по умолчанию: -60

Угол азимутального обзора.

elevfloat, по умолчанию: 30

Угол возвышения обзора.

sharezAxes3D, необязательно

Другая ось для совместного использования пределов по оси z.

proj_type{'persp', 'ortho'}

Тип проекции, по умолчанию 'persp'.

computed_zorderbool, по умолчанию: True

Если True, порядок рисования вычисляется на основе среднего положения Artist вдоль направления обзора. Установите в значение False, если хотите вручную управлять порядком рисования элементов на экране, используя их атрибут zorder. Это может потребоваться для точной настройки, если автоматический порядок не даёт желаемого результата. Однако имейте в виду, что ручное значение zorder будет верным только для ограниченного угла обзора. Если пользователь повернёт изображение, оно будет выглядеть неправильно под некоторыми углами.

auto_add_to_figurebool, по умолчанию: True

До Matplotlib 3.4 Axes3D добавляли себя в родительскую фигуру при инициализации. Другие классы осей этого не делают.

Это поведение устарело в версии 3.4, по умолчанию будет установлено в False в версии 3.5. Это ключевое слово будет недокументировано, а ненулевое значение помимо False будет ошибкой в версии 3.6.

**kwargs

Другие необязательные ключевые аргументы:

Свойство	Описание
`adjustable`	{'box', 'datalim'}
`agg_filter`	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
`alpha`	скаляр или None
`anchor`	(float, float) или {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
`animated`	bool
`aspect`	{'auto'}
`autoscale_on`	неизвестно
`autoscalex_on`	bool
`autoscaley_on`	bool
`autoscalez_on`	bool
`axes_locator`	Callable[[Axes, Renderer], Bbox]
`axisbelow`	bool или 'line'
`box_aspect`	тройка чисел float или None
`clip_box`	`Bbox`
`clip_on`	bool
`clip_path`	Patch или (Path, Transform) или None
`facecolor` или fc	цвет
`figure`	`Figure`
`frame_on`	bool
`gid`	строка
`in_layout`	bool
`label`	объект
`navigate`	bool
`navigate_mode`	неизвестно
`path_effects`	`AbstractPathEffect`
`picker`	None или bool или float или вызываемый объект
`position`	[левый, нижний, ширина, высота] или `Bbox`
`proj_type`	{'persp', 'ortho'}
`prop_cycle`	неизвестно
`rasterization_zorder`	число float или None
`rasterized`	bool
`sketch_params`	(масштаб: float, длина: float, случайность: float)
`snap`	bool или None
`title`	неизвестно
`transform`	`Transform`
`url`	строка
`visible`	bool
`xbound`	неизвестно
`xlabel`	строка
`xlim3d` или xlim	неизвестно
`xmargin`	неизвестно
`xscale`	{"линейный"}
`xticklabels`	неизвестно
`xticks`	неизвестно
`ybound`	неизвестно

`ylabel`	строка
`ylim3d` или ylim	неизвестно
`ymargin`	неизвестно
`yscale`	{"линейный"}
`yticklabels`	неизвестно
`yticks`	неизвестно
`zbound`	неизвестно
`zlabel`	неизвестно
`zlim3d` или zlim	неизвестно
`zmargin`	неизвестно
`zorder`	вещественное число
`zscale`	{"линейный"}
`zticklabels`	неизвестно
`zticks`	неизвестно

add_collection3d(col, zs=0, zdir='z')[source]

Добавление объекта 3D-коллекции к графику.

Типы 2D-коллекций преобразуются в 3D-версию путем изменения объекта и добавления координат z.

Поддерживаются:

PolyCollection
LineCollection
PatchCollection

add_contour_set(cset, extend3d=False, stride=5, zdir='z', offset=None)[source]

add_contourf_set(cset, zdir='z', offset=None)[source]

apply_aspect(position=None)[source]

Настройка осей для заданного соотношения сторон данных.

В зависимости от get_adjustable это изменит либо область осей (позицию), либо пределы просмотра. В первом случае, get_anchor повлияет на положение.

См. также

matplotlib.axes.Axes.set_aspect: Для описания обработки соотношения сторон.
matplotlib.axes.Axes.set_adjustable: Установите способ корректировки осей для достижения требуемого соотношения сторон.
matplotlib.axes.Axes.set_anchor: Установите положение в случае наличия дополнительного пространства.

Примечания

Это вызывается автоматически, когда каждый график рисуется. Возможно, вам придется вызвать его самостоятельно, если вам нужно обновить положение и/или пределы просмотра осей до того, как нарисовать рисунок.

auto_scale_xyz(X, Y, Z=None, had_data=None)[source]

autoscale(enable=True, axis='both', tight=None)[source]: Удобный метод для простого автоматического масштабирования осей. См. matplotlib.axes.Axes.autoscale() для полного объяснения. Обратите внимание, что эта функция ведет себя так же, но для всех трех осей. Поэтому 'z' можно передать для axis, а 'both' применяется ко всем трем осям.

autoscale_view(tight=None, scalex=True, scaley=True, scalez=True)[source]: Автоматическое масштабирование пределов просмотра с использованием пределов данных. См. matplotlib.axes.Axes.autoscale_view() для документации. Обратите внимание, что эта функция применяется к 3D осям и, как следствие, добавляет scalez к аргументам функции.

bar(left, height, zs=0, zdir='z', *args, data=None, **kwargs)[source]

Добавить 2D столбец(ы).

Параметры

left1D массив-подобный: Координаты x левых сторон столбцов.
height1D массив-подобный: Высота столбцов.
zsчисло или 1D массив-подобный: Координата z столбцов; если указано одно значение, оно будет использовано для всех столбцов.
zdir{'x', 'y', 'z'}, по умолчанию: 'z': При построении 2D данных направление, которое следует использовать как z ('x', 'y' или 'z').
dataиндексируемый объект, необязательно: Если задан, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключения).
**kwargs: Другие аргументы передаются в matplotlib.axes.Axes.bar.

Возвращает

mpl_toolkits.mplot3d.art3d.Patch3DCollection

bar3d(x, y, z, dx, dy, dz, color=None, zsort='average', shade=True, lightsource=None, *args, data=None, **kwargs)[source]

Генерация 3D гистограммы.

Этот метод создаёт трёхмерную гистограмму, где ширину, глубину, высоту и цвет столбцов можно устанавливать индивидуально.

Параметры

x, y, zмассив-подобный

Координаты точки привязки столбцов.

dx, dy, dzчисло или массив-подобный

Ширина, глубина и высота столбцов соответственно.

colorпоследовательность цветов, необязательно

Цвет столбцов может быть задан глобально или индивидуально. Этот параметр может быть:

Один цвет, чтобы окрасить все столбцы в один цвет.
Массив цветов длиной N столбцов, чтобы окрасить каждый столбец независимо.
Массив цветов длиной 6, чтобы окрасить грани столбцов аналогично.
Массив цветов длиной 6 * N столбцов, чтобы окрасить каждую грань независимо.

При конкретном раскрашивании граней ящиков порядок раскраски такой:

-Z (низ ящика)
+Z (верх ящика)
-Y
+Y
-X
+X

zsortстрока, необязательно

Схема сортировки оси z, переданная в Poly3DCollection

shadeбулево, по умолчанию: True

При значении True затеняет тёмные стороны столбцов (относительно источника света графика).

lightsourceLightSource

Источник света, используемый, когда shade равен True.

dataиндексируемый объект, необязательно

Если задан, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключения).

**kwargs

Любые дополнительные ключевые аргументы передаются в Poly3DCollection.

Возвращает

collectionPoly3DCollection: Коллекция трёхмерных многоугольников, представляющих столбцы.

can_pan()[source]

Возвращает, поддерживает ли данная ось функцию панорамирования/приближения.

Объекты осей 3D не используют функцию панорамирования/приближения.

can_zoom()[source]

Возвращает, поддерживает ли данная ось функцию зума прямоугольником.

Объекты осей 3D не используют функцию зума прямоугольником.

cla()[source]: Очистить ось.

clabel(*args, **kwargs)[source]: В настоящее время не реализовано для осей 3D и возвращает None.

contour(X, Y, Z, *args, extend3d=False, stride=5, zdir='z', offset=None, data=None, **kwargs)[source]

Создать 3D контурный график.

Параметры

X, Y, Zмассив-подобный объект,: Входные данные. См. contour для допустимых форм данных.
extend3dbool, по умолчанию: False: Расширять контур в 3D.
strideint: Шаг для расширения контура.
zdir{'x', 'y', 'z'}, по умолчанию: 'z': Направление для использования.
offsetfloat, необязательно: Если задано, нарисовать проекцию линий контура в этой позиции в плоскости, нормальной к zdir.
dataиндексируемый объект, необязательно: Если задан, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключения).
*args, **kwargs: Другие аргументы передаются в matplotlib.axes.Axes.contour.

Возвращает

matplotlib.contour.QuadContourSet

contour3D(X, Y, Z, *args, extend3d=False, stride=5, zdir='z', offset=None, data=None, **kwargs)[source]

Создать 3D контурный график.

Параметры

X, Y, Zмассив-подобный объект,: Входные данные. См. contour для допустимых форм данных.
extend3dbool, по умолчанию: False: Расширять контур в 3D.
strideint: Шаг для расширения контура.
zdir{'x', 'y', 'z'}, по умолчанию: 'z': Направление для использования.
offsetfloat, необязательно: Если задано, нарисовать проекцию линий контура в этой позиции в плоскости, нормальной к zdir.
dataиндексируемый объект, необязательно: Если задан, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключения).
*args, **kwargs: Другие аргументы передаются в matplotlib.axes.Axes.contour.

Возвращает

matplotlib.contour.QuadContourSet

contourf(X, Y, Z, *args, zdir='z', offset=None, data=None, **kwargs)[source]

Создать 3D заполненный контурный график.

Параметры

X, Y, Zмассив-подобный объект: Входные данные. См. contourf для допустимых форм данных.
zdir{'x', 'y', 'z'}, по умолчанию: 'z': Направление для использования.
offsetfloat, необязательно: Если задано, нарисовать проекцию линий контура в этой позиции в плоскости, нормальной к zdir.
dataиндексируемый объект, необязательно: Если задан, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключения).
*args, **kwargs: Другие аргументы передаются в matplotlib.axes.Axes.contourf.

Возвращает

matplotlib.contour.QuadContourSet

contourf3D(X, Y, Z, *args, zdir='z', offset=None, data=None, **kwargs)[source]

Создать 3D заполненный контурный график.

Параметры

X, Y, Zмассив-подобный объект: Входные данные. См. contourf для допустимых форм данных.
zdir{'x', 'y', 'z'}, по умолчанию: 'z': Направление для использования.
offsetfloat, необязательно: Если задано, нарисовать проекцию линий контура в этой позиции в плоскости, нормальной к zdir.
dataиндексируемый объект, необязательно: Если задан, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключения).
*args, **kwargs: Другие аргументы передаются в matplotlib.axes.Axes.contourf.

Возвращает

matplotlib.contour.QuadContourSet

convert_zunits(z)[source]: Для элементов в осях, если z-ось поддерживает единицы измерения, преобразовать z с помощью типа единиц z-оси

disable_mouse_rotation()[source]: Отключить нажатия кнопок мыши для вращения и масштабирования 3D-объектов.

draw(renderer)[source]

Отобразить элемент графического интерфейса (и его дочерние элементы) с помощью заданного рендерера.

Это не оказывает никакого эффекта, если элемент графического интерфейса не отображается (Artist.get_visible возвращает False).

Параметры

rendererRendererBase подкласс.

Примечания

Этот метод переопределён в подклассах элементов графического интерфейса.

errorbar(x, y, z, zerr=None, yerr=None, xerr=None, fmt='', barsabove=False, errorevery=1, ecolor=None, elinewidth=None, capsize=None, capthick=None, xlolims=False, xuplims=False, ylolims=False, yuplims=False, zlolims=False, zuplims=False, *, data=None, **kwargs)[source]

Строит линии и/или маркеры с областями погрешности вокруг них.

x/y/z определяют положение данных, а xerr/yerr/zerr определяют размеры областей погрешности. По умолчанию это рисует маркеры/линии данных, а также области погрешности. Используйте fmt='none', чтобы нарисовать только области погрешности.

Параметры

x, y, zfloat или array-like

Положения данных.

xerr, yerr, zerrfloat или array-like, форма (N,) или (2, N), необязательно

Размеры областей погрешности:

скаляр: Симметричные +/- значения для всех точек данных.
форма (N,): Симметричные +/- значения для каждой точки данных.
форма (2, N): Отдельные - и + значения для каждой области погрешности. Первая строка содержит нижние ошибки, вторая строка содержит верхние ошибки.
None: Нет области погрешности.

Обратите внимание, что все массивы ошибок должны иметь положительные значения.

fmtстрока, по умолчанию: ''

Формат для точек данных/линий данных. Подробнее см. plot.

Используйте 'none' (регистронезависимо), чтобы нарисовать области погрешности без маркеров данных.

ecolorцвет, по умолчанию: None

Цвет линий области погрешности. Если None, используется цвет линии, соединяющей маркеры.

elinewidthfloat, по умолчанию: None

Толщина линий области погрешности. Если None, используется толщина линии текущего стиля.

capsizefloat, по умолчанию: rcParams["errorbar.capsize"] (по умолчанию: 0.0)

Длина колпачков области погрешности в пунктах.

capthickfloat, по умолчанию: None

Псевдоним к ключевому аргументу markeredgewidth (он же mew). Это более осмысленное имя для свойства, которое управляет толщиной колпачка области погрешности в пунктах. Для обратной совместимости, если заданы mew или markeredgewidth, они переопределят capthick. В будущих выпусках это может измениться.

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

Если True, области погрешности будут нарисованы над символами графика. По умолчанию — под ними.

xlolims, ylolims, zlolimsbool, по умолчанию: False

Эти аргументы могут быть использованы для указания того, что значение даёт только нижние пределы. В этом случае используется символ каретки для указания этого. Аргументы lims могут быть скалярами или массивами с тем же размером, что и ошибки. Для использования пределов с инвертированными осями, необходимо вызвать set_xlim или set_ylim до вызова errorbar(). Обратите внимание на сложные имена параметров: например, установка ylolims в True означает, что значение y — нижний предел истинного значения, поэтому будет нарисована только стрелка, направленная вверх!

xuplims, yuplims, zuplimsbool, по умолчанию: False

Аналогично вышеперечисленному, но для управления верхними пределами.

erroreveryint или (int, int), по умолчанию: 1

рисует области погрешности для подмножества данных. errorevery =N рисует области погрешности для точек (x[::N], y[::N], z[::N]). errorevery =(start, N) рисует области погрешности для точек (x[start::N], y[start::N], z[start::N]). например, errorevery=(6, 3) добавляет области погрешности к данным в (x[6], x[9], x[12], x[15], ...). Используется для предотвращения наложения областей погрешности при наложении двух рядов на одну ось.

Возвращаемое значение

errlinesсписок: Список экземпляров Line3DCollection каждый из которых содержит линию области погрешности.
caplinesсписок: Список экземпляров Line3D каждый из которых содержит объект колпачка.
limmarksсписок: Список экземпляров Line3D каждый из которых содержит маркер с верхним или нижним пределом.

Другие параметры

dataиндексируемый объект, необязательно

Если задано, следующие параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение):

x, y, z, xerr, yerr, zerr

**kwargs

Все остальные ключевые аргументы для стилизации линий областей погрешности передаются Line3DCollection.

Примеры

(Исходный код, png, pdf)

format_coord(xd, yd)[source]: Попытка определить 3D-координаты по заданным 2D-координатам просмотра. Находит ближайшее ребро к точке и предполагает, что точка находится на той же высоте z, что и ближайшая точка на ребре.

format_zdata(z)[source]: Возвращает отформатированную строку z. Эта функция будет использовать атрибут fmt_zdata, если он вызываемый, иначе она вернётся к основному форматировщику z-оси.

get_autoscale_on()[source]: Возвращает True, если каждый из осей автомасштабируется, иначе False.

get_autoscalez_on()[source]: Возвращает, автомасштабируется ли z-ось.

get_axis_position()[source]

get_frame_on()[source]: Получить, отображаются ли панели 3D-осей.

get_proj()[source]: Создаёт матрицу проекции из текущей позиции просмотра.

get_tightbbox(renderer, call_axes_locator=True, bbox_extra_artists=None, *, for_layout_only=False)[source]

Возвращает плотное охватывающее прямоугольник осей, включая оси и их декорации (метка оси x, заголовок и т. д.).

Объекты, у которых есть artist.set_in_layout(False), не включаются в прямоугольник.

Parameters

rendererподкласс RendererBase: рендерер, который будет использоваться для рисования фигур (т. е. fig.canvas.get_renderer())
bbox_extra_artistsсписок Artist или None: Список объектов, которые следует включить в плотный охватывающий прямоугольник. Если None (по умолчанию), то все дочерние объекты-артисты Axes включаются в плотный охватывающий прямоугольник.
call_axes_locatorbool, по умолчанию: True: Если call_axes_locator False, он не вызывает атрибут _axes_locator, что необходимо для получения правильного охватывающего прямоугольника. call_axes_locator=False можно использовать, если вызывающий код заинтересован только в относительном размере tightbbox по сравнению с прямоугольником Axes.
for_layout_onlyпо умолчанию: False: Охватывающий прямоугольник не будет включать x-расстояние заголовка и метки оси x, или y-расстояние метки оси y.

Returns

BboxBase: Охватывающий прямоугольник в пиксельных координатах фигуры.

См. также

matplotlib.axes.Axes.get_window_extent
matplotlib.axis.Axis.get_tightbbox
matplotlib.spines.Spine.get_window_extent

get_w_lims()[source]: Получить 3D пределы мира.

get_xlim()[source]: Псевдоним для get_xlim3d.

get_xlim3d()[source]

Возвращает пределы просмотра оси x.

Returns

left, right(float, float): Текущие пределы оси x в координатах данных.

См. также

set_xlim
set_xbound, get_xbound
invert_xaxis, xaxis_inverted

Notes

Ось x может быть инвертирована, в этом случае значение left будет больше значения right.

get_ylim()[source]: Псевдоним для get_ylim3d.

get_ylim3d()[source]

Возвращает пределы просмотра оси y.

Returns

bottom, top(float, float): Текущие пределы оси y в координатах данных.

См. также

set_ylim
set_ybound, get_ybound
invert_yaxis, yaxis_inverted

Notes

Ось y может быть инвертирована, в этом случае значение bottom будет больше значения top.

END_OF_DOCUMENT_MARKER

get_zaxis()[source]: Возвращает экземпляр ZAxis (Axis).

get_zbound()[source]: Возвращает нижнюю и верхнюю границы оси z в порядке возрастания.

get_zgridlines()[source]: Возвращает линии сетки оси z в виде списка объектов Line2D.

get_zlabel()[source]: Возвращает строку текста метки оси z.

get_zlim()[source]: Псевдоним для get_zlim3d.

get_zlim3d()[source]: Возвращает пределы оси z в 3D.

get_zmajorticklabels()[source]: Возвращает метки основных делений оси z в виде списка Text.

get_zminorticklabels()[source]: Возвращает метки второстепенных делений оси z в виде списка Text.

get_zscale()[source]

get_zticklabels(minor=False, which=None)[source]

Возвращает метки делений оси z.

Параметры

minorbool

Возвращать метки второстепенных или основных делений.

whichNone, ('minor', 'major', 'both')

Переопределяет minor.

Выбирает возвращаемые метки.

Возвращаемое значение

Список Text

Примечания

Строки меток делений заполняются только после вызова метода draw.

См. также: draw и draw.

get_zticklines(minor=False)[source]: Возвращает линии делений оси z в виде списка объектов Line2D.

get_zticks(*, minor=False)[source]: Возвращает позиции делений оси z в координатах данных.

grid(visible=True, **kwargs)[source]: Включение/выключение 3D сетки.

Примечание

В настоящее время данная функция ведет себя не так, как matplotlib.axes.Axes.grid(), но в будущем она должна поддерживать такое поведение.

invert_zaxis()[source]: Инвертировать ось z.

locator_params(axis='both', tight=None, **kwargs)[source]

Удобный метод для управления размещением делений.

См. matplotlib.axes.Axes.locator_params() для полной документации. Обратите внимание, что это для объектов Axes3D, поэтому установка axis в 'both' приведет к установке параметров для всех трех осей. Также axis может принимать значение 'z' для применения параметров к оси z.

margins(*margins, x=None, y=None, z=None, tight=True)[source]

Удобный метод для задания или получения отступов автоматического масштабирования.

Варианты вызова:

margins()

возвращает xmargin, ymargin, zmargin

margins(margin)

margins(xmargin, ymargin, zmargin)

margins(x=xmargin, y=ymargin, z=zmargin)

margins(..., tight=False)

Все вышеперечисленные формы устанавливают параметры xmargin, ymargin и zmargin. Все ключевые параметры необязательны. Единственный позиционный аргумент задаёт xmargin, ymargin и zmargin. Передача как позиционных, так и ключевых аргументов для xmargin, ymargin и/или zmargin недопустима.

Параметр tight передаётся в autoscale_view(), который выполняется после изменения отступа; значение по умолчанию здесь — True, исходя из предположения, что при указании отступов обычно не требуется дополнительное отступы для соответствия отметкам. Установка tight в None сохранит предыдущее значение.

Указание любых изменений отступа затрагивает только автоматическое масштабирование; например, если xmargin не равен None, то xmargin умноженный на интервал данных X будет добавлен к каждому концу этого интервала перед использованием в автоматическом масштабировании.

mouse_init(rotate_btn=1, zoom_btn=3)[source]

Установите кнопки мыши для вращения и масштабирования в 3D.

Parameters

rotate_btnint или список целых чисел, по умолчанию: 1: Кнопка или кнопки мыши, используемые для вращения осей в 3D.
zoom_btnint или список целых чисел, по умолчанию: 3: Кнопка или кнопки мыши, используемые для масштабирования осей в 3D.

name='3d'

plot(xs, ys, *args, zdir='z', **kwargs)[source]

Строит 2D или 3D данные.

Parameters

xsОдномерный массив-подобный объект: Координаты x вершин.
ysОдномерный массив-подобный объект: Координаты y вершин.
zsЧисло или одномерный массив-подобный объект: Координаты z вершин; либо одно для всех точек, либо одно для каждой точки.
zdir{'x', 'y', 'z'}, по умолчанию: 'z': При построении 2D данных, направление для использования в качестве z ('x', 'y' или 'z').
**kwargs: Другие аргументы передаются в matplotlib.axes.Axes.plot.

plot3D(xs, ys, *args, zdir='z', **kwargs)[source]

Строит 2D или 3D данные.

Parameters

xsОдномерный массив-подобный объект: Координаты x вершин.
ysОдномерный массив-подобный объект: Координаты y вершин.
zsЧисло или одномерный массив-подобный объект: Координаты z вершин; либо одно для всех точек, либо одно для каждой точки.
zdir{'x', 'y', 'z'}, по умолчанию: 'z': При построении 2D данных, направление для использования в качестве z ('x', 'y' или 'z').
**kwargs: Другие аргументы передаются в matplotlib.axes.Axes.plot.

plot_surface(X, Y, Z, *args, norm=None, vmin=None, vmax=None, lightsource=None, **kwargs)[source]

Создать поверхность графика.

По умолчанию он будет окрашен в оттенки одного цвета, но также поддерживает отображение по карте цветов, передавая аргумент cmap.

Примечание

Аргументы rcount и ccount, оба по умолчанию равны 50, определяют максимальное количество образцов, используемых в каждом направлении. Если входные данные больше, они будут уменьшены (путем среза) до этих значений точек.

Примечание

Для максимальной скорости отрисовки можно установить rstride и cstride в делители числа строк минус 1 и столбцов минус 1 соответственно. Например, при 51 строке rstride может быть любым делителем 50.

Аналогично, при установке rstride и cstride равными 1 (или rcount и ccount равными количеству строк и столбцов) можно использовать оптимизированный путь.

Parameters

X, Y, Z2D массивы

Значения данных.

rcount, ccountint

Максимальное количество образцов, используемых в каждом направлении. Если входные данные больше, они будут уменьшены (путем среза) до этих значений точек. По умолчанию 50.

rstride, cstrideint

Шаг уменьшения выборки в каждом направлении. Эти аргументы взаимно исключают rcount и ccount. Если задан только один из rstride или cstride, другой по умолчанию равен 10.

Режим «классика» использует значение по умолчанию rstride = cstride = 10 вместо нового значения по умолчанию rcount = ccount = 50.

colorцвет

Цвет областей поверхности.

cmapКарта цветов

Карта цветов областей поверхности.

facecolorsмассив цветов.

Цвета каждой отдельной области.

normНормализация

Нормализация для карты цветов.

vmin, vmaxчисло с плавающей точкой

Пределы для нормализации.

shadebool, по умолчанию: True

Указывает, нужно ли затемнять цвета граней. Затемнение всегда отключено, когда указана cmap.

lightsourceLightSource

Источник света, используемый, когда shade равен True.

**kwargs

Другие аргументы передаются в Poly3DCollection.

plot_trisurf(*args, color=None, norm=None, vmin=None, vmax=None, lightsource=None, **kwargs)[source]

Построение триангулированной поверхности.

Триангуляцию (необязательную) можно указать двумя способами:

plot_trisurf(triangulation, ...)

где triangulation — объект Triangulation, или:

plot_trisurf(X, Y, ...)
plot_trisurf(X, Y, triangles, ...)
plot_trisurf(X, Y, triangles=triangles, ...)

в этом случае будет создан объект Triangulation. См. Triangulation для объяснения этих возможностей.

Остальные аргументы:

plot_trisurf(..., Z)

где Z — массив значений для построения контура, по одному значению на точку в триангуляции.

Parameters

X, Y, Zarray-like: Значения данных в виде одномерных массивов.
color: Цвет фрагментов поверхности.
cmap: Цветовая карта для фрагментов поверхности.
normNormalize: Экземпляр Normalize для отображения значений в цвета.
vmin, vmaxfloat, по умолчанию: None: Минимальное и максимальное значение для отображения.
shadebool, по умолчанию: True: Определяет, будут ли затенены цвета граней. Затенение всегда отключено, когда указана cmap.
lightsourceLightSource: Источник света для использования, когда shade равно True.
**kwargs: Все остальные аргументы передаются в Poly3DCollection

Примеры

(Исходный код, png, pdf)

(Исходный код, png, pdf)

plot_wireframe(X, Y, Z, *args, **kwargs)[source]

Построение 3D каркасной поверхности.

Примечание

Аргументы rcount и ccount, по умолчанию равные 50, определяют максимальное количество выборок, используемых в каждом направлении. Если входные данные больше, они будут уменьшены (путем среза) до этих значений.

Parameters

X, Y, Z2D массивы

Значения данных.

rcount, ccountint

Максимальное количество выборок, используемых в каждом направлении. Если входные данные больше, они будут уменьшены (путем среза) до этих значений. Установка счётчика в ноль приводит к тому, что данные не будут выбираться в соответствующем направлении, создавая график 3D линии, а не каркасной поверхности. По умолчанию 50.

rstride, cstrideint

Шаг уменьшения выборки в каждом направлении. Эти аргументы взаимоисключающие с rcount и ccount. Если установлен только один из rstride или cstride, другой по умолчанию равен 1. Установка шага в ноль приводит к тому, что данные не будут выбираться в соответствующем направлении, создавая график 3D линии, а не каркасной поверхности.

В режиме 'classic' используется значение по умолчанию rstride = cstride = 1 вместо нового значения по умолчанию rcount = ccount = 50.

**kwargs

Другие аргументы передаются в Line3DCollection.

quiver(X, Y, Z, U, V, W, /, length=1, arrow_length_ratio=.3, pivot='tail', normalize=False, **kwargs)[source]

Построение 3D поля векторов.

Аргументы могут быть массивами или скалярами, при условии, что они могут быть объединены по ширине. Аргументы также могут быть массивами с пропускаемыми элементами. Если какой-либо элемент в любом аргументе пропущен, соответствующий элемент вектора не будет нарисован.

Parameters

X, Y, Zarray-like: Координаты x, y и z расположения вектора (по умолчанию хвост вектора; см. аргумент pivot).
U, V, Warray-like: Компоненты x, y и z векторов.
lengthfloat, по умолчанию: 1: Длина каждого вектора.
arrow_length_ratiofloat, по умолчанию: 0.3: Соотношение длины стрелки к вектору.
pivot{'tail', 'middle', 'tip'}, по умолчанию: 'tail': Часть вектора, которая находится в точке сетки; вектор вращается вокруг этой точки, поэтому и название pivot.
normalizebool, по умолчанию: False: Определяет, будут ли все векторы нормализованы для одинаковой длины, или длины будут определяться u, v и w.
dataиндексируемый объект, необязательно: Если указано, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение).
**kwargs: Дополнительные ключевые аргументы передаются в LineCollection

quiver3D(X, Y, Z, U, V, W, /, length=1, arrow_length_ratio=.3, pivot='tail', normalize=False, **kwargs)[source]

Построение 3D поля стрелок.

Аргументы могут быть массивоподобными или скалярными, до тех пор, пока они могут быть совместно распространены. Аргументы также могут быть массивами с пропускаемыми элементами. Если какой-либо элемент в любом аргументе пропущен, соответствующий элемент стрелки не будет отображён.

Параметры

X, Y, Zмассивоподобный: Координаты x, y и z точек начала стрелок (по умолчанию — начало стрелки; см. аргумент pivot).
U, V, Wмассивоподобный: Компоненты x, y и z векторов стрелок.
lengthfloat, по умолчанию: 1: Длина каждой стрелки.
arrow_length_ratiofloat, по умолчанию: 0.3: Соотношение длины головки стрелки к длине стрелки.
pivot{'tail', 'middle', 'tip'}, по умолчанию: 'tail': Часть стрелки, которая находится в точке сетки; стрелка вращается вокруг этой точки, отсюда и название pivot.
normalizebool, по умолчанию: False: Определяет, будут ли все стрелки нормализованы (иметь одинаковую длину) или длины будут определяться значениями u, v и w.
dataиндексируемый объект, необязательно: Если задан, все параметры также принимают строку s, которая интерпретируется как s (если это не вызывает исключения).
**kwargs: Любые дополнительные ключевые аргументы передаются в LineCollection

scatter(xs, ys, zs=0, zdir='z', s=20, c=None, depthshade=True, *args, data=None, **kwargs)[source]

Создаёт точечный график.

Параметры

xs, ysмассивоподобный

Данные для позиций.

zsfloat или массивоподобный, по умолчанию: 0

Позиции z. Либо массив той же длины, что и xs и ys, либо одно значение для размещения всех точек в одной плоскости.

zdir{'x', 'y', 'z', '-x', '-y', '-z'}, по умолчанию: 'z'

Направление оси для zs. Это полезно при построении 2D данных на 3D оси. Данные должны быть переданы как xs, ys. Установка zdir в 'y' затем строит данные на плоскости x-z.

См. также График 2D данных на 3D графике.

sfloat или массивоподобный, по умолчанию: 20

Размер маркера в точках**2. Либо массив той же длины, что и xs и ys, либо одно значение для задания одинакового размера всех маркеров.

cцвет, последовательность или последовательность цветов, необязательно

Цвет маркера. Возможные значения:

Одно строковое представление цвета.
Последовательность цветов длиной n.
Последовательность n чисел, которые будут отображаться в цвета с помощью cmap и norm.
2D массив, в котором строки являются RGB или RGBA.

Подробнее см. аргумент c в scatter.

depthshadebool, по умолчанию: True

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

dataиндексируемый объект, необязательно

Если задан, следующие параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключения):

xs, ys, zs, s, edgecolors, c, facecolor, facecolors, color

**kwargs

Все остальные аргументы передаются в scatter.

Возвращает

pathsPathCollection

scatter3D(xs, ys, zs=0, zdir='z', s=20, c=None, depthshade=True, *args, data=None, **kwargs)[source]

Создать диаграмму рассеяния.

Параметры

xs, ysпоследовательность

Положения данных.

zsчисло или последовательность, по умолчанию: 0

Положения z. Либо массив такой же длины, как xs и ys, либо одно значение для размещения всех точек в одной плоскости.

zdir{'x', 'y', 'z', '-x', '-y', '-z'}, по умолчанию: 'z'

Направление оси для zs. Это полезно при построении 2D-данных на 3D-оси. Данные должны передаваться как xs, ys. Установка zdir в 'y' затем отображает данные на плоскости x-z.

См. также Построение 2D-данных на 3D-графике.

sчисло или последовательность, по умолчанию: 20

Размер маркера в пунктах**2. Либо массив такой же длины, как xs и ys, либо одно значение для создания всех маркеров одинакового размера.

cцвет, последовательность или последовательность цветов, необязательно

Цвет маркера. Возможные значения:

Строка формата одного цвета.
Последовательность цветов длиной n.
Последовательность n чисел для сопоставления с цветами с использованием cmap и norm.
Двумерный массив, в котором строки являются RGB или RGBA.

Для получения более подробной информации см. аргумент c в scatter.

depthshadeлогическое значение, по умолчанию: True

Включить ли затенение маркеров рассеяния, чтобы создать видимость глубины. Каждый вызов scatter() будет выполнять своё затенение независимо.

dataиндексируемый объект, необязательно

xs, ys, zs, s, edgecolors, c, facecolor, facecolors, color

**kwargs

Все остальные аргументы передаются в scatter.

Возвращает

pathsPathCollection

set(*, adjustable=<UNSET>, agg_filter=<UNSET>, alpha=<UNSET>, anchor=<UNSET>, animated=<UNSET>, aspect=<UNSET>, autoscale_on=<UNSET>, autoscalex_on=<UNSET>, autoscaley_on=<UNSET>, autoscalez_on=<UNSET>, axes_locator=<UNSET>, axisbelow=<UNSET>, box_aspect=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, facecolor=<UNSET>, frame_on=<UNSET>, gid=<UNSET>, in_layout=<UNSET>, label=<UNSET>, navigate=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, position=<UNSET>, proj_type=<UNSET>, prop_cycle=<UNSET>, rasterization_zorder=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, title=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, xbound=<UNSET>, xlabel=<UNSET>, xlim=<UNSET>, xlim3d=<UNSET>, xmargin=<UNSET>, xscale=<UNSET>, xticklabels=<UNSET>, xticks=<UNSET>, ybound=<UNSET>, ylabel=<UNSET>, ylim=<UNSET>, ylim3d=<UNSET>, ymargin=<UNSET>, yscale=<UNSET>, yticklabels=<UNSET>, yticks=<UNSET>, zbound=<UNSET>, zlabel=<UNSET>, zlim3d=<UNSET>, zmargin=<UNSET>, zorder=<UNSET>, zscale=<UNSET>, zticklabels=<UNSET>, zticks=<UNSET>)[source]

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

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

Свойство	Описание
`adjustable`	{'box', 'datalim'}
`agg_filter`	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
`alpha`	скаляр или None
`anchor`	(float, float) или {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
`animated`	bool
`aspect`	{'auto'}
`autoscale_on`	неизвестно
`autoscalex_on`	bool
`autoscaley_on`	bool
`autoscalez_on`	bool
`axes_locator`	Callable[[Axes, Renderer], Bbox]
`axisbelow`	bool или 'line'
`box_aspect`	кортеж из 3 чисел с плавающей точкой или None
`clip_box`	`Bbox`
`clip_on`	bool
`clip_path`	Patch или (Path, Transform) или None
`facecolor` или fc	цвет
`figure`	`Figure`
`frame_on`	bool
`gid`	str
`in_layout`	bool
`label`	объект
`navigate`	bool
`navigate_mode`	неизвестно
`path_effects`	`AbstractPathEffect`
`picker`	None или bool или float или вызываемый объект
`position`	[левое, нижнее, ширина, высота] или `Bbox`
`proj_type`	{'persp', 'ortho'}
`prop_cycle`	неизвестно
`rasterization_zorder`	число с плавающей точкой или None
`rasterized`	bool
`sketch_params`	(масштаб: float, длина: float, случайность: float)
`snap`	bool или None
`title`	неизвестно
`transform`	`Transform`
`url`	str
`visible`	bool
`xbound`	неизвестно
`xlabel`	str
`xlim`	(нижняя граница: float, верхняя граница: float)
`xlim3d`	неизвестно
`xmargin`	неизвестно
`xscale`	{"linear"}
`xticklabels`	неизвестно
`xticks`	неизвестно

`ybound`	неизвестно
`ylabel`	строка
`ylim`	(нижняя граница: число, верхняя граница: число)
`ylim3d`	неизвестно
`ymargin`	неизвестно
`yscale`	{"линейный"}
`yticklabels`	неизвестно
`yticks`	неизвестно
`zbound`	неизвестно
`zlabel`	неизвестно
`zlim3d`	неизвестно
`zmargin`	неизвестно
`zorder`	число с плавающей точкой
`zscale`	{"линейный"}
`zticklabels`	неизвестно
`zticks`	неизвестно

set_aspect(aspect, adjustable=None, anchor=None, share=False)[source]

Установить соотношение сторон.

В настоящее время Axes 3D не поддерживает другие значения, кроме 'auto', которые заполняют ось данными.

Чтобы смоделировать равные соотношения сторон в пространстве данных, установите отношение пределов данных так, чтобы оно соответствовало значению get_box_aspect. Для управления соотношениями сторон области используйте set_box_aspect.

Parameters

aspect{'auto'}

Возможные значения:

значение	описание
'auto'	автоматический; заполняет прямоугольник положения данными.

adjustableNone

В настоящее время игнорируется Axes3D

Если не None, это определяет, какой параметр будет изменён для соблюдения требуемого соотношения сторон. Дополнительные сведения см. в set_adjustable.

anchorNone или строка или 2-кортеж чисел с плавающей точкой, необязательно

Если не None, это определяет, где будут отображаться оси, если из-за ограничений соотношения сторон есть дополнительное место. Наиболее распространённый способ указать привязку — это сокращения сторон света:

значение	описание
'C'	по центру
'SW'	левый нижний угол
'S'	середина нижнего края
'SE'	правый нижний угол
и т.д.

Дополнительные сведения см. в set_anchor.

shareлогическое значение, по умолчанию: False

Если True, применяет настройки ко всем связанным осям.

См. также

mpl_toolkits.mplot3d.axes3d.Axes3D.set_box_aspect

set_autoscale_on(b)[source]

Устанавливает, будет ли применяться автоматическое масштабирование к каждой оси при следующем отрисовке или вызове Axes.autoscale_view.

Parameters

bbool

set_autoscalez_on(b)[source]

Установить, будет ли ось z автоматически масштабироваться при следующем рисовании или вызове Axes.autoscale_view.

Parameters

bbool

set_axis_off()[source]

Отключить оси x и y.

Это влияет на линии оси, деления, метки делений, сетку и подписи осей.

set_axis_on()[source]

Включить оси x и y.

Это влияет на линии оси, деления, метки делений, сетку и подписи осей.

set_box_aspect(aspect, *, zoom=1)[source]

Устанавливает соотношение сторон оси.

Соотношение сторон — это отношение высоты к ширине в единицах отображения для каждой грани куба, когда на неё смотрят перпендикулярно. Это не следует путать с соотношением сторон данных (для Axes3D оно всегда равно 'auto'). Значения по умолчанию составляют 4:4:3 (x:y:z).

Чтобы смоделировать одинаковое соотношение сторон в пространстве данных, установите соотношение сторон так, чтобы оно соответствовало диапазону данных в каждом измерении.

zoom управляет общим размером Axes3D на рисунке.

Параметры

aspectкортеж из 3 чисел с плавающей точкой или None

Изменяет физические размеры Axes3D таким образом, что отношение длин осей в единицах отображения равно x:y:z.

Если None, по умолчанию устанавливается 4:4:3

zoomчисло с плавающей точкой

Управление общим размером Axes3D на рисунке.

set_frame_on(b)[source]

Установить, выводятся ли панели 3D осей.

Параметры

bbool

set_proj_type(proj_type)[source]

Установить тип проекции.

Параметры

proj_type{'persp', 'ortho'}

set_title(label, fontdict=None, loc='center', **kwargs)[source]

Установить заголовок для области построения.

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

Параметры

labelstr

Текст для заголовка

fontdictdict

Словарь, контролирующий внешний вид текста заголовка, по умолчанию fontdict:

{'fontsize': rcParams['axes.titlesize'],
 'fontweight': rcParams['axes.titleweight'],
 'color': rcParams['axes.titlecolor'],
 'verticalalignment': 'baseline',
 'horizontalalignment': loc}

loc{'center', 'left', 'right'}, по умолчанию: rcParams["axes.titlelocation"] (по умолчанию: 'center')

Какой заголовок установить.

yчисло с плавающей точкой, по умолчанию: rcParams["axes.titley"] (по умолчанию: None)

Вертикальное положение заголовка на оси (1.0 — верхняя часть). Если None (по умолчанию), y определяется автоматически, чтобы избежать декораций на оси.

padчисло с плавающей точкой, по умолчанию: rcParams["axes.titlepad"] (по умолчанию: 6.0)

Отступ заголовка от верхней части области построения в пунктах.

Возвращает

Text: Экземпляр matplotlib text, представляющий заголовок

Другие параметры

**kwargsText свойства: Другие ключевые параметры — это свойства текста, см. Text для списка допустимых свойств текста.

set_top_view()[source]

set_xlim(left=None, right=None, emit=True, auto=False, *, xmin=None, xmax=None)[source]: Псевдоним для set_xlim3d.

set_xlim3d(left=None, right=None, emit=True, auto=False, *, xmin=None, xmax=None)[source]

Установка 3D пределов x.

См. matplotlib.axes.Axes.set_xlim() для полного описания.

set_xmargin(m)[source]

Установка отступов границ данных X перед автоматическим масштабированием.

К каждому концу интервала будет добавлено m раз интервал данных, прежде чем он будет использован в автоматическом масштабировании. Например, если ваши данные находятся в диапазоне [0, 2], множитель m = 0.1 приведет к диапазону [-0.2, 2.2].

Отрицательные значения -0.5 < m < 0 приведут к обрезанию диапазона данных. Например, для диапазона данных [0, 2], множитель m = -0.1 приведет к диапазону [0.2, 1.8].

Параметры

mчисло с плавающей точкой, больше чем -0.5

set_xscale(value, **kwargs)[source]

Установить масштаб оси x.

Параметры

value{"linear"}: Тип масштаба оси для применения. 3D оси в настоящее время поддерживают только линейные масштабы; другие масштабы дают бессмысленные результаты.
**kwargs: Ключевые параметры, номинально передаются в класс масштаба, но ни один из них не применим для линейных масштабов.

set_ylim(bottom=None, top=None, emit=True, auto=False, *, ymin=None, ymax=None)[source]: Псевдоним для set_ylim3d.

set_ylim3d(bottom=None, top=None, emit=True, auto=False, *, ymin=None, ymax=None)[source]

Установить пределы по оси y в 3D.

См. matplotlib.axes.Axes.set_ylim() для полной документации.

set_ymargin(m)[source]

Установить отступ для пределов данных по оси Y перед автоматическим масштабированием.

К каждому концу интервала данных будет добавлено значение, равное m умноженному на интервал данных, перед тем как он будет использован в автоматическом масштабировании. Например, если ваши данные находятся в диапазоне [0, 2], коэффициент m = 0.1 приведет к диапазону [-0.2, 2.2].

Отрицательные значения -0.5 < m < 0 приведут к обрезке диапазона данных. Например, для диапазона данных [0, 2], коэффициент m = -0.1 приведет к диапазону [0.2, 1.8].

Параметры

mчисловое значение, большее чем -0.5

set_yscale(value, **kwargs)[source]

Установить масштаб оси y.

Параметры

value{"linear"}: Тип масштаба оси для применения. 3D оси в настоящее время поддерживают только линейные масштабы; другие масштабы приведут к бессмысленным результатам.
**kwargs: Ключевые аргументы номинально передаются классу масштаба, но ни один из них не применим для линейных масштабов.

set_zbound(lower=None, upper=None)[source]

Установить нижнюю и верхнюю числовые границы оси z.

Этот метод будет учитывать инверсию осей независимо от порядка параметров. Он не изменит настройку автоматического масштабирования (get_autoscalez_on()).

set_zlabel(zlabel, fontdict=None, labelpad=None, **kwargs)[source]: Установить подпись оси z. Смотрите документацию для set_ylabel для описания.

set_zlim(bottom=None, top=None, emit=True, auto=False, *, zmin=None, zmax=None)[source]: Псевдоним для set_zlim3d.

set_zlim3d(bottom=None, top=None, emit=True, auto=False, *, zmin=None, zmax=None)[source]

Установить пределы по оси z в 3D.

См. matplotlib.axes.Axes.set_ylim() для полной документации

set_zmargin(m)[source]

Установить отступ для пределов данных по оси Z перед автоматическим масштабированием.

Значение m будет умножено на интервал данных, чтобы добавить его к каждому концу интервала перед использованием в автоматическом масштабировании.

принимает: числовое значение в диапазоне от 0 до 1

set_zscale(value, **kwargs)[source]

Установить масштаб оси z.

Параметры

value{"linear"}: Тип масштаба оси для применения. 3D оси в настоящее время поддерживают только линейные масштабы; другие масштабы приведут к бессмысленным результатам.
**kwargs: Ключевые аргументы номинально передаются классу масштаба, но ни один из них не применим для линейных масштабов.

set_zticklabels(labels, *, fontdict=None, minor=False, **kwargs)[source]

Установите метки оси z с помощью списка строковых меток.

Предупреждение

Этот метод следует использовать только после изменения позиций делений с помощью Axes3D.set_zticks. В противном случае метки могут оказаться в неожиданных позициях.

Параметры

labelsсписок str

Тексты меток.

fontdictdict, необязательно

Словарь, контролирующий внешний вид меток делений. По умолчанию fontdict имеет вид:

{'fontsize': rcParams['axes.titlesize'],
 'fontweight': rcParams['axes.titleweight'],
 'verticalalignment': 'baseline',
 'horizontalalignment': loc}

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

Устанавливать ли метки для второстепенных делений, а не основных.

Возвращаемые значения

список Text: Метки.

Другие параметры

**kwargsText свойства.

set_zticks(ticks, labels=None, *, minor=False, **kwargs)[source]

Установите позиции делений оси z и, необязательно, метки.

При необходимости пределы отображения оси расширяются, чтобы все заданные деления были видны.

Параметры

ticksсписок чисел с плавающей точкой: Список позиций делений.
labelsсписок str, необязательно: Список меток делений. Если не задан, метки показывают значение данных.
minorbool, по умолчанию: False: Если False, устанавливаются основные деления; если True, второстепенные деления.
**kwargs: Text свойства для меток. Эти параметры применяются только при передаче labels. В других случаях используйте tick_params.

Примечания

Принудительное расширение пределов отображения — это осознанное решение проектирования, чтобы избежать неожиданного отсутствия видимых делений. Если вам нужны другие пределы, необходимо явно установить пределы после установки делений.

stem(x, y, z, *, linefmt='C0-', markerfmt='C0o', basefmt='C3-', bottom=0, label=None, orientation='z', data=None)[source]

Создание 3D графика стебля.

График стебля рисует линии, перпендикулярные базовой линии, и размещает маркеры в головах. По умолчанию базовая линия определяется координатами x и y, а стебли рисуются вертикально от bottom до z.

Параметры

x, y, zмассивоподобные

Позиции голов стеблей. Стебли нарисованы по направлению orientation от базовой линии в bottom (в orientation-координатах) до голов. По умолчанию x и y используются для базовой линии, а z — для положения головы, но это можно изменить с помощью orientation.

linefmtstr, по умолчанию: 'C0-'

Строка, определяющая свойства вертикальных линий. Обычно это цвет или цвет и стиль линии:

Символ	Стиль линии
`'-'`	сплошная линия
`'--'`	штриховая линия
`'-.'`	штрихпунктирная линия
`':'`	пунктирная линия

Примечание: хотя технически возможно указать форматы, отличные от цвета или цвета и стиля линии (например, 'rx' или '-.'), это выходит за рамки намерения метода и, скорее всего, не приведет к разумному графику.

markerfmtstr, по умолчанию: 'C0o'

Строка, определяющая свойства маркеров в головах стеблей.

basefmtstr, по умолчанию: 'C3-'

Строка формата, определяющая свойства базовой линии.

bottomчисло с плавающей точкой, по умолчанию: 0

Положение базовой линии в orientation-координатах.

labelstr, по умолчанию: None

Метка для использования стеблей в легендах.

orientation{'x', 'y', 'z'}, по умолчанию: 'z'

Направление, по которому рисуются стебли.

dataиндексируемый объект, необязательно

Если задано, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключения).

Возвращаемые значения

StemContainer: Контейнер можно рассматривать как кортеж (markerline, stemlines, baseline)

Примеры

(Исходный код, png, pdf)

(png, pdf)

(png, pdf)

stem3D(x, y, z, *, linefmt='C0-', markerfmt='C0o', basefmt='C3-', bottom=0, label=None, orientation='z', data=None)[source]

Построение 3D графика стебля.

График стебля отображает линии, перпендикулярные базовой линии, и размещает маркеры на их концах. По умолчанию, базовая линия определяется координатами x и y, а стебли рисуются вертикально от bottom до z.

Параметры

x, y, zмассив-подобный объект

Позиции вершин стеблей. Стебли рисуются вдоль направления orientation от базовой линии в координатах bottom (в координатах orientation) до вершин. По умолчанию координаты x и y используются для базовой линии, а z для вершин, но это может быть изменено параметром orientation.

linefmtстрока, по умолчанию: 'C0-'

Строка, определяющая свойства вертикальных линий. Обычно это цвет или цвет и стиль линии:

Символ	Стиль линии
`'-'`	сплошная линия
`'--'`	штриховая линия
`'-.'`	штрихпунктирная линия
`':'`	пунктирная линия

Примечание: Хотя технически можно задавать форматы, отличные от цвета или цвета и стиля линии (например, 'rx' или '-.'), это выходит за рамки предназначения метода и, скорее всего, не приведет к разумному графику.

markerfmtстрока, по умолчанию: 'C0o'

Строка, определяющая свойства маркеров на вершинах стеблей.

basefmtстрока, по умолчанию: 'C3-'

Строка формата, определяющая свойства базовой линии.

bottomчисло, по умолчанию: 0

Позиция базовой линии в координатах orientation.

labelстрока, по умолчанию: None

Метка для отображения стеблей на легенде.

orientation{'x', 'y', 'z'}, по умолчанию: 'z'

Направление, вдоль которого рисуются стебли.

dataиндексируемый объект, необязательно

Возвращает

StemContainer: Контейнер может обрабатываться как кортеж (markerline, stemlines, baseline)

Примеры

(Исходный код, png, pdf)

(png, pdf)

text(x, y, z, s, zdir=None, **kwargs)[source]: Добавление текста к графику. Параметры kwargs будут переданы в Axes.text, за исключением ключевого слова zdir, которое задаёт направление, используемое как z-направление.

text2D(x, y, s, fontdict=None, **kwargs)[source]

Добавление текста на график.

Добавление текста s на график в позиции x, y в координатах данных.

Параметры

x, yчисло с плавающей точкой: Позиция для размещения текста. По умолчанию это координаты данных. Система координат может быть изменена с помощью параметра transform.
sстрока: Текст.
fontdictсловарь, по умолчанию: None: Словарь для переопределения свойств текста. Если fontdict равен None, значения по умолчанию определяются параметром rcParams.

Возвращает

Text: Возвращается созданный экземпляр Text.

Другие параметры

**kwargsсвойства Text.: Другие параметры для текста.

Свойство	Описание
`agg_filter`	функция фильтра, которая принимает массив с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
`alpha`	скаляр или None
`animated`	bool
`backgroundcolor`	цвет
`bbox`	словарь свойств для `patches.FancyBboxPatch`
`clip_box`	неизвестно
`clip_on`	неизвестно
`clip_path`	неизвестно
`color` или c	цвет
`figure`	`Figure`
`fontfamily` или family	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
`fontproperties` или font или font_properties	`font_manager.FontProperties` или `str` или `pathlib.Path`
`fontsize` или size	вещественное число или {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
`fontstretch` или stretch	{числовое значение в диапазоне 0-1000, 'ultra-condensed', 'extra-condensed', 'condensed', 'semi-condensed', 'normal', 'semi-expanded', 'expanded', 'extra-expanded', 'ultra-expanded'}
`fontstyle` или style	{'normal', 'italic', 'oblique'}
`fontvariant` или variant	{'normal', 'small-caps'}
`fontweight` или weight	{числовое значение в диапазоне 0-1000, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'bold', 'heavy', 'extra bold', 'black'}
`gid`	str
`horizontalalignment` или ha	{'center', 'right', 'left'}
`in_layout`	bool
`label`	объект
`linespacing`	вещественное число (кратное размеру шрифта)
`math_fontfamily`	str
`multialignment` или ma	{'left', 'right', 'center'}
`parse_math`	bool
`path_effects`	`AbstractPathEffect`
`picker`	None или bool или float или вызываемая функция
`position`	(вещественное число, вещественное число)
`rasterized`	bool
`rotation`	вещественное число или {'vertical', 'horizontal'}
`rotation_mode`	{None, 'default', 'anchor'}
`sketch_params`	(масштаб: вещественное число, длина: вещественное число, случайность: вещественное число)
`snap`	bool или None
`text`	объект
`transform`	`Transform`
`transform_rotates_text`	bool
`url`	str
`usetex`	bool или None
`verticalalignment` или va	{'center', 'top', 'bottom', 'baseline', 'center_baseline'}
`visible`	bool
`wrap`	bool
`x`	вещественное число
`y`	вещественное число

zorder

число с плавающей точкой

Примеры

Индивидуальные ключевые аргументы могут быть использованы для переопределения любого заданного параметра:

>>> text(x, y, s, fontsize=12)

По умолчанию преобразование задаёт, что текст находится в координатах данных, альтернативно, вы можете указать, что текст находится в координатах осей ((0, 0) — нижний левый угол, (1, 1) — верхний правый угол). Приведённый ниже пример размещает текст в центре оси:

>>> text(0.5, 0.5, 'matplotlib', horizontalalignment='center',
...      verticalalignment='center', transform=ax.transAxes)

Вы можете поместить прямоугольную рамку вокруг текста (например, для задания цвета фона), используя ключевое слово bbox. bbox — это словарь свойств Rectangle. Например:

>>> text(x, y, s, bbox=dict(facecolor='red', alpha=0.5))

text3D(x, y, z, s, zdir=None, **kwargs)[source]: Добавление текста на график. Аргументы kwargs будут переданы в Axes.text, за исключением ключевого слова zdir, которое задаёт направление, используемое как направление z.

tick_params(axis='both', **kwargs)[source]

Удобный метод для изменения внешнего вида делений и меток делений.

См. matplotlib.axes.Axes.tick_params() для более подробной документации.

Единственное отличие состоит в том, что установка axis в 'both' означает, что настройки применяются ко всем трём осям. Кроме того, параметр axis также принимает значение 'z', что означает применение настроек только к оси z.

Также, из-за того, как объекты Axes3D отображаются очень по-другому, чем обычные 2D оси, некоторые из этих настроек могут иметь неоднозначное значение. Для простоты ось 'z' будет принимать настройки, как если бы она была как ось 'y'.

Примечание

Axes3D в настоящее время игнорирует некоторые из этих настроек.

tricontour(*args, extend3d=False, stride=5, zdir='z', offset=None, data=None, **kwargs)[source]

Создание 3D контурного графика.

Примечание

В настоящее время этот метод генерирует неверный вывод из-за давно известной ошибки в отрисовке 3D PolyCollection.

Параметры

X, Y, Zпоследовательность: Входные данные. См. tricontour для допустимых форм данных.
extend3dbool, по умолчанию: False: Расширять ли контур в 3D.
strideint: Шаг для расширения контура.
zdir{'x', 'y', 'z'}, по умолчанию: 'z': Направление для использования.
offsetчисло с плавающей точкой, необязательно: Если указано, отобразить проекцию контурных линий в этой позиции в плоскости, нормальной к zdir.
dataиндексируемый объект, необязательно: Если задан, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение).
*args, **kwargs: Другие аргументы передаются в matplotlib.axes.Axes.tricontour.

Возвращает

matplotlib.tri.tricontour.TriContourSet

tricontourf(*args, zdir='z', offset=None, data=None, **kwargs)[source]

Создание 3D заполненного контурного графика.

Примечание

В настоящее время этот метод генерирует неверный вывод из-за давно известной ошибки в отрисовке 3D PolyCollection.

Параметры

X, Y, Zпоследовательность: Входные данные. См. tricontourf для допустимых форм данных.
zdir{'x', 'y', 'z'}, по умолчанию: 'z': Направление для использования.
offsetчисло с плавающей точкой, необязательно: Если указано, отобразить проекцию контурных линий в этой позиции в плоскости, нормальной к zdir.
dataиндексируемый объект, необязательно: Если задан, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение).
*args, **kwargs: Другие аргументы передаются в matplotlib.axes.Axes.tricontourf.

Возвращает

matplotlib.tri.tricontour.TriContourSet

tunit_cube(vals=None, M=None)[source]

tunit_edges(vals=None, M=None)[source]

unit_cube(vals=None)[source]

update_datalim(xys, **kwargs)[source]

Расширить dataLim Bbox, чтобы включить заданные точки.

Если в настоящее время данные не заданы, Bbox проигнорирует свои пределы и установит границу равной границам xydata (xys). В противном случае он вычислит границы объединения текущих данных и данных в xys.

Параметры

xysДвумерный массив: Точки, которые нужно включить в Bbox границ данных. Это может быть список кортежей (x, y) или двумерный массив Nx2.
updatex, updateybool, по умолчанию: True: Определяет, нужно ли обновлять пределы по осям x/y.

view_init(elev=None, azim=None, vertical_axis='z')[source]

Установить высоту и азимут осей в градусах (не радианах).

Это можно использовать для программируемого вращения осей.

Параметры

elevfloat, по умолчанию: None: Угол наклона в вертикальной плоскости в градусах. Если None, используется начальное значение, заданное в конструкторе Axes3D.
azimfloat, по умолчанию: None: Угол азимута в горизонтальной плоскости в градусах. Если None, используется начальное значение, заданное в конструкторе Axes3D.
vertical_axis{"z", "x", "y"}, по умолчанию: "z": Ось, которая выравнивается вертикально. azim вращается вокруг этой оси.

voxels([x, y, z, ]/, filled, facecolors=None, edgecolors=None, **kwargs)[source]

Построение набора заполненных объёмных элементов.

Все объёмные элементы отображаются как кубики 1x1x1 на оси, с filled[0, 0, 0] размещённые с нижним углом в начале координат. Затенённые грани не отображаются.

Параметры

filled3D np.array bool

3D массив значений, где истинные значения указывают на заполнение объёмных элементов.

x, y, z3D np.array, необязательно

Координаты углов объёмных элементов. Они должны быть совместимы по размерности с размером filled. Эти параметры можно использовать для построения некубических объёмных элементов.

Если не указаны, по умолчанию используются последовательность возрастающих целых чисел по каждой оси, подобная той, что возвращается indices(). Как показано в / в сигнатуре функции, эти аргументы могут быть переданы только позиционно.

facecolors, edgecolorsмассив, необязательно

Цвет для отрисовки граней и рёбер объёмных элементов. Могут передаваться только как ключевые параметры. Эти параметры могут быть:

Единственное значение цвета, чтобы все объёмные элементы были одного цвета. Это может быть строка или одномерный массив rgb/rgba.
None, по умолчанию, чтобы использовать один цвет для граней и стиль по умолчанию для рёбер.
3D массив имён цветов, где каждый элемент - цвет соответствующего объёмного элемента. Размер должен совпадать с объёмными элементами.
4D массив данных rgb/rgba с компонентами по последней оси.

shadebool, по умолчанию: True

Определяет, применять ли затенение к facecolors. Затенение всегда отключено, когда задано cmap.

lightsourceLightSource

Источник света, который нужно использовать, когда shade равно True.

**kwargs

Дополнительные ключевые параметры для передачи Poly3DCollection.

Возвращает

facesdict: Словарь, индексированный по координатам, где faces[i, j, k] - Poly3DCollection нарисованных граней для filled[i, j, k] объёмного элемента. Если для объёмного элемента не было нарисованы грани, либо потому что он не должен отображаться, либо потому что он полностью скрыт, то (i, j, k) not in faces.

Примеры

(Исходный код, png, pdf)

(Исходный код, png, pdf)

(Исходный код, png, pdf)

(Исходный код, png, pdf)

свойствоw_xaxis[source]

свойствоw_yaxis[source]

свойствоw_zaxis[source]

zaxis_date(tz=None)[source]

Настроить отметки и метки оси для обработки данных по оси z как дат.

Параметры

tzстрока или datetime.tzinfo, по умолчанию: rcParams["timezone"] (по умолчанию: 'UTC'): Часовой пояс, используемый для создания меток дат.

Примечания

Эта функция просто добавлена для полноты, но оси 3D не поддерживают даты для меток, и поэтому она может работать не так, как ожидается.

zaxis_inverted()[source]: Возвращает True, если ось z инвертирована.