mpl_toolkits.mplot3d.axes3d.Axes3D

class mpl_toolkits.mplot3d.axes3d.Axes3D(fig, rect=None, *args, azim=- 60, elev=30, zscale=None, sharez=None, proj_type='persp', **kwargs) [source]

Bases: matplotlib.axes._axes.Axes

Объект 3D осей.

Параметры:

figFigure Родительская фигура. rect(float, float, float, float) Положение осей (left, bottom, width, height). azimfloat, optional Угол обзора азимута, по умолчанию -60. elevfloat, optional Угол обзора возвышения, по умолчанию 30. zscale{'function', 'functionlog', 'linear', 'log', 'logit', 'symlog'}, optional Масштаб по оси z. В настоящее время поддерживается только линейный масштаб. sharezAxes3D, optional Другие оси, с которыми необходимо совместно использовать пределы по оси z. proj_type{'persp', 'ortho'} Тип проекции, по умолчанию 'persp'.

Примечания

Добавлена в версии 1.2.1: Параметр sharez.

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

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

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

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

• PolyCollection
• LineCollection
• PatchCollection

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

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

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

autoscale(self, enable=True, axis='both', tight=None) [source]

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

Новое в версии 1.1.0.

autoscale_view(self, tight=None, scalex=True, scaley=True, scalez=True) [source]

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

Изменено в версии 1.1.0: Изменена сигнатура функции для лучшего соответствия 2D версии. tight теперь явно является аргументом и размещается первым.

Изменено в версии 1.2.1: Теперь полностью функционально.

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

Добавление 2D столбцов.

Параметры:

left1D array-like Координаты x левых сторон столбцов. height1D array-like Высота столбцов. zsscalar or 1D array-like Координата z столбцов; если указано единственное значение, оно будет использоваться для всех столбцов. zdir{'x', 'y', 'z'} При построении 2D данных, направление для использования в качестве z ('x', 'y' или 'z'); по умолчанию 'z'. **kwargs Другие аргументы передаются в matplotlib.axes.Axes.bar.

Возвращает:

mpl_toolkits.mplot3d.art3d.Patch3DCollection

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

Генерация 3D столбчатой диаграммы.

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

Параметры:

x, y, zarray-like Координаты точки привязки столбцов. dx, dy, dzscalar or array-like Ширина, глубина и высота столбцов, соответственно. colorsequence of colors, optional Цвет столбцов можно указать глобально или индивидуально. Этот параметр может быть: Один цвет для одинакового цвета всех столбцов. Массив цветов длиной N столбцов для раскраски каждого столбца отдельно. Массив цветов длиной 6 для раскраски граней столбцов. Массив цветов длиной 6 * N столбцов для раскраски каждой грани индивидуально. При раскраске граней ящиков, порядок раскраски такой: -Z (дно ящика) +Z (верх ящика) -Y +Y -X +X zsortstr, optional Схема сортировки по оси z, передаваемая в Poly3DCollection shadebool, optional (default = True) Если shade равно True, то затеняются тёмные стороны столбцов (относительно источника света на графике). lightsourceLightSource Источник света для использования, когда shade равно True. **kwargs Все дополнительные ключевые аргументы передаются в Poly3DCollection.

Возвращает:

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

can_pan(self) [source]

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

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

can_zoom(self) [source]

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

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

cla(self) [source]

Очистка текущих осей.

clabel(self, *args, **kwargs) [source]

В настоящее время эта функция не реализована для 3D осей. Возвращает None.

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

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

Параметры:	X, Y, Zarray-likes Входные данные. extend3dbool Расширять контур в 3D; по умолчанию False. strideint Шаг для расширения контура. zdir{'x', 'y', 'z'} Направление; по умолчанию 'z'. offsetscalar Если указано, отобразить проекцию линий контура в этой позиции в плоскости, нормальной к zdir. *args, **kwargs Другие аргументы передаются в matplotlib.axes.Axes.contour.
Возвращает:	matplotlib.contour.QuadContourSet

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

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

Параметры:	X, Y, Zarray-likes Входные данные. extend3dbool Расширять линию контура в 3D; по умолчанию False. strideint Шаг для расширения контура. zdir{'x', 'y', 'z'} Направление; по умолчанию 'z'. offsetscalar Если указано, отобразить проекцию линий контура в этой позиции на плоскости, перпендикулярной zdir *args, **kwargs Другие параметры передаются в matplotlib.axes.Axes.contour.
Возвращает:	matplotlib.contour.QuadContourSet

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

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

Параметры:	X, Y, Zarray-likes Входные данные. zdir{'x', 'y', 'z'} Направление; по умолчанию 'z'. offsetscalar Если указано, отобразить проекцию линий контура в этой позиции на плоскости, перпендикулярной zdir *args, **kwargs Другие параметры передаются в matplotlib.axes.Axes.contourf.
Возвращает:	matplotlib.contour.QuadContourSet

Примечания

Введено в версии 1.1.0: Параметры zdir и offset.

contourf3D(self, X, Y, Z, *args, zdir='z', offset=None, **kwargs)

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

Параметры:	X, Y, Zarray-likes Входные данные. zdir{'x', 'y', 'z'} Направление; по умолчанию 'z'. offsetscalar Если указано, отобразить проекцию линий контура в этой позиции на плоскости, перпендикулярной zdir *args, **kwargs Другие параметры передаются в matplotlib.axes.Axes.contourf.
Возвращает:	matplotlib.contour.QuadContourSet

Примечания

Введено в версии 1.1.0: Параметры zdir и offset.

convert_zunits(self, z) [source]

Для элементов в осях, если z-ось поддерживает единицы измерения, преобразовать z используя тип единиц z-оси

Введено в версии 1.2.1.

disable_mouse_rotation(self) [source]

Отключить обработчики мыши.

draw(self, renderer) [source]

Отобразить все (линии графика, оси, метки)

format_coord(self, xd, yd) [source]

Исходя из 2D координат просмотра, попытаться определить 3D координату. Ищет ближайший край к точке и предполагает, что точка имеет ту же z-координату, что и ближайшая точка на этом краю.

format_zdata(self, z) [source]

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

get_autoscale_on(self) [source]

Получить, применяется ли автоматическое масштабирование для всех осей при командах построения графика

Введено в версии 1.1.0: Эта функция была добавлена, но не протестирована. Пожалуйста, сообщите о любых ошибках.

get_autoscalez_on(self) [source]

Получить, применяется ли автоматическое масштабирование для z-оси при командах построения графика

Введено в версии 1.1.0: Эта функция была добавлена, но не протестирована. Пожалуйста, сообщите о любых ошибках.

get_axis_position(self) [source]

get_frame_on(self) [source]

Получить, нарисованы ли панели 3D осей.

get_proj(self) [source]

Создать матрицу проекции из текущей точки обзора.

elev хранит угол возвышения в плоскости z azim хранит угол азимута в плоскости (x, y)

dist - расстояние от точки наблюдения до точки объекта.

get_w_lims(self) [source]

Получить пределы 3D мира.

get_xlim(self)

Возвращает пределы отображения оси x.

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

См. также

set_xlim

set_xbound, get_xbound

invert_xaxis, xaxis_inverted

Примечания

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

Изменено в версии 1.1.0: Эта функция теперь правильно относится к 3D пределам оси x

get_xlim3d(self) [source]

Возвращает пределы отображения оси x.

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

См. также

set_xlim

set_xbound, get_xbound

invert_xaxis, xaxis_inverted

Примечания

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

Изменено в версии 1.1.0: Эта функция теперь правильно относится к 3D пределам оси x

get_ylim(self)

Возвращает пределы области отображения оси Y.

Возвращает:	bottom, top(float, float) Текущие пределы области отображения оси Y в координатах данных.

См. также

set_ylim

set_ybound, get_ybound

invert_yaxis, yaxis_inverted

Примечания

Ось Y может быть инвертирована, в этом случае нижнее значение будет больше верхнего.

Изменено в версии 1.1.0: Эта функция теперь правильно ссылается на 3D пределы оси Y.

get_ylim3d(self) [source]

Возвращает пределы области отображения оси Y.

Возвращает:	bottom, top(float, float) Текущие пределы области отображения оси Y в координатах данных.

См. также

set_ylim

set_ybound, get_ybound

invert_yaxis, yaxis_inverted

Примечания

Ось Y может быть инвертирована, в этом случае нижнее значение будет больше верхнего.

Изменено в версии 1.1.0: Эта функция теперь правильно ссылается на 3D пределы оси Y.

get_zaxis(self) [source]

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

get_zbound(self) [source]

Возвращает нижнюю и верхнюю границы оси Z в возрастающем порядке.

Добавлен в версии 1.1.0.

get_zlabel(self) [source]

Получает строку текста метки оси Z.

Добавлен в версии 1.1.0: Функция была добавлена, но не протестирована. Пожалуйста, сообщите о любых ошибках.

get_zlim(self)

Получение пределов области отображения оси Z.

get_zlim3d(self) [source]

Получение пределов области отображения оси Z.

get_zmajorticklabels(self) [source]

Получение меток делений оси Z как списка экземпляров Text.

Добавлен в версии 1.1.0.

get_zminorticklabels(self) [source]

Получение меток вспомогательных делений оси Z как списка экземпляров Text.

Примечание

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

Добавлен в версии 1.1.0.

get_zscale(self) [source]

get_zticklabels(self, minor=False) [source]

Получение меток делений оси Z как списка экземпляров Text. См. matplotlib.axes.Axes.get_yticklabels() для более подробной информации.

Примечание

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

Добавлен в версии 1.1.0.

get_zticklines(self) [source]

Возвращает линии делений оси Z как список экземпляров Line2D. Обратите внимание, что эта функция предоставляется только для полноты. Эти линии пересчитываются при изменении отображения.

Добавлен в версии 1.1.0.

get_zticks(self, *, minor=False) [source]

Возвращает деления оси Z как список расположений. См. matplotlib.axes.Axes.get_yticks() для более подробной информации.

Примечание

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

Добавлен в версии 1.1.0.

grid(self, b=True, **kwargs) [source]

Устанавливает/отключает сетку в 3D.

Примечание

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

Добавлен в версии 1.1.0.

invert_zaxis(self) [source]

Инвертирует ось Z.

Добавлен в версии 1.1.0: Функция была добавлена, но не протестирована. Пожалуйста, сообщите о любых ошибках.

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

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

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

Добавлен в версии 1.1.0: Функция была добавлена, но не протестирована. Пожалуйста, сообщите о любых ошибках.

margins(self, *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 и добавляется к каждому концу этого интервала перед использованием его в автоматическом масштабировании.

Введено в версии 1.1.0.

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

Инициализирует обратные вызовы нажатия мыши для включения 3D-вращения осей. Также по желанию устанавливает кнопки мыши для 3D-вращения и масштабирования.

Параметры:	rotate_btnint or list of int Кнопка(и) мыши, используемая(ые) для 3D-вращения осей; по умолчанию 1. zoom_btnint or list of int Кнопка(и) мыши, используемая(ые) для масштабирования 3D-осей; по умолчанию 3.

name = '3d'

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

Построение 2D или 3D данных.

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

plot3D(self, xs, ys, *args, zdir='z', **kwargs)

Построение 2D или 3D данных.

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

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

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

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

Примечание

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

Параметры:

X, Y, Z2d arrays Значения данных. rcount, ccountint Максимальное количество выборок, используемых в каждом направлении. Если входные данные больше, они будут уменьшены (путем среза) до этих чисел точек. По умолчанию 50. Введено в версии 2.0. rstride, cstrideint Шаг уменьшения выборки в каждом направлении. Эти аргументы взаимоисключающие с rcount и ccount. Если задан только один из rstride или cstride, другой по умолчанию равен 10. 'classic' режим использует значение по умолчанию rstride = cstride = 10 вместо нового значения по умолчанию rcount = ccount = 50. colorcolor-like Цвет поверхностных участков. cmapColormap Цветовая карта поверхностных участков. facecolorsarray-like of colors. Цвета каждого отдельного участка. normNormalize Нормализация для цветовой карты. vmin, vmaxfloat Границы для нормализации. shadebool Выполнять затенение цветовых заполнений. По умолчанию True. Затенение всегда отключено, когда указан cmap. lightsourceLightSource Источник света для использования, когда shade равно True. **kwargs Другие аргументы передаются в Poly3DCollection.

plot_trisurf(self, *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 — массив значений для контура, по одному значению на каждую точку в триангуляции.

Параметры:

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

Примеры

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

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

Введено в версии 1.2.0.

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

Построение 3D каркасной диаграммы.

Примечание

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

Параметры:

X, Y, Z2d arrays Значения данных. rcount, ccountint Максимальное количество выборок, используемых в каждом направлении. Если входные данные больше, они будут сэмплированы (с помощью срезов) до указанного числа точек. Установка счётчика в ноль приводит к отсутствию выборки данных в соответствующем направлении, создавая 3D линию, а не каркасную диаграмму. Значение по умолчанию 50. Новое в версии 2.0. 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=0.3, pivot='tail', normalize=False, **kwargs) [source]

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

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

Параметры:

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

set_autoscale_on(self, b) [source]

Установить, применяется ли автоматическое масштабирование к командам построения графиков

Новое в версии 1.1.0: Эта функция была добавлена, но не протестирована. Пожалуйста, сообщите о любых ошибках.

Параметры:	bbool

set_autoscalez_on(self, b) [source]

Установить, применяется ли автоматическое масштабирование для оси z к командам построения графиков

Новое в версии 1.1.0.

Параметры:	bbool

set_axis_off(self) [source]

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

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

set_axis_on(self) [source]

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

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

set_frame_on(self, b) [source]

Установить, отображаются ли панели 3D осей.

Параметры:	bbool

set_proj_type(self, proj_type) [source]

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

Параметры:	proj_type{'persp', 'ortho'}

set_title(self, 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'}, str, optional Заголовок, который нужно установить. Если None, по умолчанию rcParams["axes.titlelocation"] (по умолчанию: 'center'). padfloat Смещение заголовка от верхней части осей в пунктах. Если None, по умолчанию rcParams["axes.titlepad"] (по умолчанию: 6.0).
Возвращает:	textText Экземпляр matplotlib text, представляющий заголовок
Другие параметры:	**kwargsText properties Другие ключевые аргументы — свойства текста, см. Text для списка допустимых свойств текста.

set_top_view(self) [source]

set_xlim(self, left=None, right=None, emit=True, auto=False, *, xmin=None, xmax=None)

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

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

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

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

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

set_xscale(self, value, **kwargs) [source]

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

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

set_ylim(self, bottom=None, top=None, emit=True, auto=False, *, ymin=None, ymax=None)

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

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

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

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

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

set_yscale(self, value, **kwargs) [source]

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

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

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

Установить нижнюю и верхнюю числовые границы оси z. Этот метод будет учитывать инверсию осей независимо от порядка параметров. Он не изменит _autoscaleZon атрибут.

Новое в версии 1.1.0.

set_zlabel(self, zlabel, fontdict=None, labelpad=None, **kwargs) [source]

Установить zlabel. См. документацию set_ylabel() для описания.

set_zlim(self, bottom=None, top=None, emit=True, auto=False, *, zmin=None, zmax=None)

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

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

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

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

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

set_zmargin(self, m) [source]

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

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

Принимает: число с плавающей точкой в диапазоне от 0 до 1

Добавлен в версии 1.1.0.

set_zscale(self, value, **kwargs) [source]

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

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

set_zticklabels(self, *args, **kwargs) [source]

Установить метки делений оси Z. Смотрите matplotlib.axes.Axes.set_yticklabels() для более подробной информации.

Примечание

Меньшие деления не поддерживаются объектами Axes3D.

Добавлен в версии 1.1.0.

set_zticks(self, *args, **kwargs) [source]

Установить позиции делений на оси Z. Смотрите matplotlib.axes.Axes.set_yticks() для более подробной информации.

Примечание

Меньшие деления не поддерживаются.

Добавлен в версии 1.1.0.

text(self, x, y, z, s, zdir=None, **kwargs) [source]

Добавление текста к графику. kwargs будут переданы в Axes.text, за исключением ключевого слова zdir, которое задаёт направление, используемое как ось z.

text2D(self, x, y, s, fontdict=None, withdash=<deprecated parameter>, **kwargs)

Добавление текста на ось.

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

Параметры:	x, yscalars Позиция для размещения текста. По умолчанию, в координатах данных. Система координат может быть изменена с помощью параметра transform. sstr Текст. fontdictdictionary, optional, default: None Словарь для переопределения свойств текста по умолчанию. Если fontdict равен None, значения по умолчанию определяются параметрами rc. withdashboolean, optional, default: False Создаёт экземпляр TextWithDash вместо экземпляра Text.
Возвращает:	textText Созданный экземпляр Text.
Другие параметры:	**kwargsText properties. Другие параметры текста.

Примеры

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

>>> 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(self, x, y, z, s, zdir=None, **kwargs)

Добавление текста к графику. kwargs будут переданы в Axes.text, за исключением ключевого слова zdir, которое задаёт направление, используемое как ось z.

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

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

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

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

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

Примечание

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

Добавлен в версии 1.1.0.

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

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

Изменено в версии 1.3.0: Добавлена поддержка пользовательских триангуляций

Примечание

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

Параметры:	X, Y, Zarray-likes Вводные данные. extend3dbool Расширять контур в 3D; по умолчанию False. strideint Шаг расширения контура. zdir{'x', 'y', 'z'} Направление; по умолчанию 'z'. offsetscalar Если указано, рисует проекцию линий контура в этой позиции в плоскости, перпендикулярной zdir *args, **kwargs Другие аргументы передаются в matplotlib.axes.Axes.tricontour.
Возвращает:	matplotlib.tri.tricontour.TriContourSet

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

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

Примечание

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

Параметры:	X, Y, Zarray-likes Вводные данные. zdir{'x', 'y', 'z'} Направление; по умолчанию 'z'. offsetscalar Если указано, рисует проекцию линий контура в этой позиции в плоскости, перпендикулярной zdir *args, **kwargs Другие аргументы передаются в matplotlib.axes.Axes.tricontourf.
Возвращает:	matplotlib.tri.tricontour.TriContourSet

Примечания

Добавлен в версии 1.1.0: Параметры zdir и offset.

Изменено в версии 1.3.0: Добавлена поддержка пользовательских триангуляций

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

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

unit_cube(self, vals=None) [source]

update_datalim(self, xys, **kwargs) [source]

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

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

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

view_init(self, elev=None, azim=None) [source]

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

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

'elev' хранит угол возвышения в плоскости z (в градусах). 'azim' хранит угол азимута в плоскости (x, y) (в градусах).

Если elev или azim равны None (по умолчанию), используется начальное значение, указанное в конструкторе Axes3D.

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

Отобразить набор заполненных кубиков

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

New in version 2.1.

Параметры:

filled3D np.array of bool Трехмерный массив значений, где истинные значения указывают, какие кубики нужно заполнить x, y, z3D np.array, optional Координаты углов кубиков. Это должно расширяться до формы, на одну позицию больше в каждом измерении, чем форма filled. Их можно использовать для построения кубиков нестандартной формы. Если не указаны, по умолчанию используются возрастающие целые числа вдоль каждой оси, как те, которые возвращает indices(). Как показано в / в сигнатуре функции, эти аргументы могут быть переданы только позиционно. facecolors, edgecolorsarray-like, optional Цвет для рисования граней и ребер кубиков. Можно передавать только как ключевые аргументы. Этот параметр может быть: Единое значение цвета, чтобы окрасить все кубики одинаково. Это может быть строка или одномерный массив rgb/rgba. None, по умолчанию, чтобы использовать один цвет для граней и стиль по умолчанию для ребер. Трехмерный массив имен цветов, где каждый элемент — цвет соответствующего кубика. Размер должен совпадать с размерами кубиков. Четырехмерный массив данных rgb/rgba, с компонентами вдоль последней оси. shadebool Использовать ли затенение facecolors. По умолчанию True. Затенение всегда отключено, когда указан cmap. New in version 3.1. lightsourceLightSource Источник света для использования, когда shade True. New in version 3.1. **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)

property w_xaxis

property w_yaxis

property w_zaxis

zaxis_date(self, tz=None) [source]

Настройка делений и меток оси z, рассматривающих данные z как даты.

tz — строка часового пояса или tzinfo объект. По умолчанию используется значение из rc.

Примечание

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

New in version 1.1.0: Данная функция была добавлена, но не протестирована. Пожалуйста, сообщите о любых ошибках.

zaxis_inverted(self) [source]

Возвращает True, если ось z инвертирована.

New in version 1.1.0.