mpl_toolkits.mplot3d.axes3d.Axes3D

classmpl_toolkits.mplot3d.axes3d.Axes3D(fig, rect=None, *args, elev=30, azim=-60, roll=0, shareview=None, sharez=None, proj_type='persp', focal_length=None, box_aspect=None, computed_zorder=True, **kwargs)[исходный код]

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

Объект трёхмерных осей.

Примечание

Пользователям не следует создавать экземпляры Axes напрямую; вместо этого используйте методы создания Axes, например, из pyplot или Figure: subplots, subplot_mosaic или Figure.add_axes.

Параметры:

figFigure

Родительский объект Figure.

rectкортеж (left, bottom, width, height), по умолчанию: None.

Положение (left, bottom, width, height) Axes.

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

Угол места в градусах поворачивает камеру над плоскостью x-y и под ней; положительный угол соответствует положению над плоскостью.

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

Азимутальный угол в градусах поворачивает камеру вокруг оси z; положительный угол соответствует правостороннему вращению. Иными словами, при положительном азимуте камера поворачивается вокруг начала координат от положения на оси +x в сторону оси +y.

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

Угол крена в градусах поворачивает камеру вокруг оси наблюдения. Положительный угол поворачивает камеру по часовой стрелке, из-за чего сцена вращается против часовой стрелки.

shareviewAxes3D, необязательный

Другие Axes, с которыми следует совместно использовать углы обзора. Обратите внимание, что отменить совместное использование осей невозможно.

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

Другие Axes, с которыми следует совместно использовать пределы z. Обратите внимание, что отменить совместное использование осей невозможно.

proj_type{'persp', 'ortho'}

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

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

Для типа проекции 'persp' — фокусное расстояние виртуальной камеры. Должно быть > 0. Если значение равно None, используется значение 1. Для типа проекции 'ortho' должно быть задано None или бесконечность (numpy.inf). Если значение равно None, используется бесконечность. Фокусное расстояние можно вычислить по заданному полю зрения с помощью уравнения: focal_length = 1/tan(FOV/2)

box_aspectкортеж из 3 значений float, по умолчанию: None

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

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

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

**kwargs

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

Свойство	Описание
`adjustable`	{'box', 'datalim'}
`agg_filter`	функция фильтра, принимающая массив float формы (m, n, 3) и значение dpi и возвращающая массив формы (m, n, 3) и два смещения от левого нижнего угла изображения
`alpha`	float или None
`anchor`	(float, float) или {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
`animated`	bool
`aspect`	{'auto', 'equal', 'equalxy', 'equalxz', 'equalyz'}
`autoscale_on`	bool
`autoscalex_on`	неизвестно
`autoscaley_on`	неизвестно
`autoscalez_on`	неизвестно
`axes_locator`	Callable[[Axes, Renderer], Bbox]
`axisbelow`	bool или 'line'
`box_aspect`	кортеж из 3 значений float или None
`clip_box`	`BboxBase` или None
`clip_on`	bool
`clip_path`	Patch или (Path, Transform) или None
`facecolor` или `fc`	цвет
`figure`	`Figure` или `SubFigure`
`forward_navigation_events`	bool или "auto"
`gid`	str
`in_layout`	bool
`label`	объект
`mouseover`	bool
`navigate`	bool
`navigate_mode`	неизвестно
`path_effects`	список объектов `AbstractPathEffect`
`picker`	None, bool, float или вызываемый объект
`position`	[left, bottom, width, height] или `Bbox`
`proj_type`	{'persp', 'ortho'}
`prop_cycle`	`Cycler`
`rasterization_zorder`	float или None
`rasterized`	bool
`sketch_params`	(scale: float, length: float, randomness: float)
`snap`	bool или None
`subplotspec`	неизвестно
`title`	неизвестно
`transform`	`Transform`
`url`	str
`visible`	bool
`xbound`	неизвестно
`xlabel`	str
`xlim` или `xlim3d`	(left: float, right: float)
`xmargin`	float больше -0.5
`xscale`	неизвестно
`xticklabels`	неизвестно
`xticks`	неизвестно
`ybound`	неизвестно
`ylabel`	str
`ylim` или `ylim3d`	(bottom: float, top: float)
`ymargin`	float больше -0.5
`yscale`	неизвестно
`yticklabels`	неизвестно
`yticks`	неизвестно
`zbound`	неизвестно
`zlabel`	неизвестно
`zlim` или `zlim3d`	(bottom: float, top: float)
`zmargin`	float больше -0.5
`zorder`	float
`zscale`	неизвестно
`zticklabels`	неизвестно
`zticks`	неизвестно

Построение графиков

`plot`	Построить график двумерных или трёхмерных данных.
`scatter`	Создать точечную диаграмму.
`bar`	Добавить двумерный столбец или столбцы.
`bar3d`	Создать трёхмерную столбчатую диаграмму.
`plot_surface`	Создать график поверхности.
`plot_wireframe`	Построить трёхмерный каркасный график.
`plot_trisurf`	Построить триангулированную поверхность.
`fill_between`	Закрасить область между двумя трёхмерными кривыми.
`clabel`	В настоящее время не реализован для трёхмерных осей и возвращает None.
`contour`	Создать трёхмерный контурный график.
`tricontour`	Создать трёхмерный контурный график.
`contourf`	Создать трёхмерный контурный график с заливкой.
`tricontourf`	Создать трёхмерный контурный график с заливкой.
`quiver`	Построить трёхмерное поле стрелок.
`voxels`	Построить набор заполненных вокселей
`errorbar`	Построить линии и/или маркеры с полосами погрешностей.
`stem`	Создать трёхмерную стержневую диаграмму.

Текст и аннотации

`text`	Добавить текст s к трёхмерным осям в точке x, y, z в координатах данных.
`text2D`	Добавить текст к осям.

Очистка

clear

Очистить оси.

Внешний вид

`set_axis_off`	Скрыть все визуальные компоненты осей x и y.
`set_axis_on`	Не скрывать визуальные компоненты осей x и y.
`grid`	Включить или отключить 3D-сетку.

Оси

Пределы и направление осей

`get_zaxis`	Вернуть экземпляр `ZAxis` (`Axis`).
`get_xlim`	Вернуть пределы отображения оси x.
`set_xlim`	Задать пределы отображения 3D-оси x.
`get_ylim`	Вернуть пределы отображения оси y.
`set_ylim`	Задать пределы отображения 3D-оси y.
`get_zlim`	Вернуть пределы отображения 3D-оси z.
`set_zlim`	Задать пределы отображения 3D-оси z.
`get_w_lims`	Получить пределы 3D-мировых координат.
`invert_xaxis`	Инвертировать ось x.
`xaxis_inverted`	Вернуть значение, указывающее, ориентирована ли ось x в «обратном» направлении.
`invert_yaxis`	Инвертировать ось y.
`yaxis_inverted`	Вернуть значение, указывающее, ориентирована ли ось y в «обратном» направлении.
`invert_zaxis`	Инвертировать ось z.
`zaxis_inverted`	Вернуть значение, указывающее, ориентирована ли ось z в «обратном» направлении.
`get_xbound`	Вернуть нижнюю и верхнюю границы оси x в возрастающем порядке.
`set_xbound`	Задать нижнюю и верхнюю числовые границы оси x.
`get_ybound`	Вернуть нижнюю и верхнюю границы оси y в возрастающем порядке.
`set_ybound`	Задать нижнюю и верхнюю числовые границы оси y.
`get_zbound`	Вернуть нижнюю и верхнюю границы оси z в возрастающем порядке.
`set_zbound`	Задать нижнюю и верхнюю числовые границы оси z.

Подписи осей и заголовок

`set_zlabel`	Задать подпись оси z.
`get_zlabel`	Получить текстовую строку подписи оси z.
`set_title`	Задать заголовок для Axes.

Масштабы осей

`set_xscale`	Задать масштаб оси x.
`set_yscale`	Задать масштаб оси y.
`set_zscale`	Задать масштаб оси z.
`get_zscale`	Вернуть масштаб оси z (в виде строки).

Автомасштабирование и отступы

`get_zmargin`	Получить отступ автомасштабирования оси z.
`set_zmargin`	Задать отступ для пределов данных по оси z перед автомасштабированием.
`margins`	Задать или получить отступы автомасштабирования.
`autoscale`	Вспомогательный метод для простого автомасштабирования отображаемых пределов осей.
`autoscale_view`	Автоматически масштабировать пределы отображения на основе пределов данных.
`set_autoscalez_on`	Задать, следует ли автоматически масштабировать ось z при отрисовке или вызове `Axes.autoscale_view`.
`get_autoscalez_on`	Вернуть значение, указывающее, применяется ли автомасштабирование оси z.
`auto_scale_xyz`

Соотношение сторон

`set_aspect`	Задать соотношения сторон.
`set_box_aspect`	Задать соотношение сторон области Axes.
`apply_aspect`	Настроить Axes в соответствии с заданным соотношением сторон данных.

Деления

`tick_params`	Вспомогательный метод для изменения внешнего вида делений и их подписей.
`set_zticks`	Задать положения делений оси z и, при необходимости, их подписи.
`get_zticks`	Вернуть положения делений оси z в координатах данных.
`set_zticklabels`	[Не рекомендуется] Задать подписи делений оси z списком строк.
`get_zticklines`	Вернуть линии делений оси z в виде списка объектов `Line2D`.
`get_zgridlines`	Вернуть линии сетки оси z в виде списка объектов `Line2D`.
`get_zminorticklabels`	Вернуть подписи малых делений оси z в виде списка объектов `Text`.
`get_zmajorticklabels`	Вернуть подписи основных делений оси z в виде списка объектов `Text`.
`zaxis_date`	Настроить деления и подписи оси, чтобы интерпретировать данные вдоль оси z как даты.

Единицы измерения

convert_zunits

Для объектов Artist в Axes при поддержке единиц измерения осью z преобразовать z с использованием типа единиц оси z

Добавление объектов Artist

add_collection3d

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

Интерактивное управление

`can_zoom`	Вернуть значение, указывающее, поддерживает ли этот объект Axes функцию масштабирования рамкой выделения.
`can_pan`	Вернуть значение, указывающее, поддерживает ли этот объект Axes функции панорамирования или масштабирования с помощью кнопок.
`disable_mouse_rotation`	Отключить кнопки мыши для вращения, панорамирования и масштабирования в 3D.
`mouse_init`	Настроить кнопки мыши для вращения и масштабирования в 3D.
`drag_pan`	Вызывается при перемещении мыши во время панорамирования.
`format_zdata`	Вернуть отформатированную строку z.
`format_coord`	Вернуть строку с текущими углами вращения вида или координатами x, y, z точки на ближайшей плоскости осей под курсором мыши — в зависимости от нажатой кнопки мыши.

Проекция и перспектива

`view_init`	Задать угол места и азимут Axes в градусах (не в радианах).
`set_proj_type`	Задать тип проекции.
`get_proj`	Создать матрицу проекции на основе текущего положения наблюдателя.
`set_top_view`

Отрисовка

`draw`	Отрисовать объект Artist (и его дочерние объекты) с помощью заданного средства визуализации.
`get_tightbbox`	Вернуть точную ограничивающую рамку Axes, включая оси и их подписи (название оси x, заголовок и т. д.).

Псевдонимы и устаревшие методы

`set_zlim3d`	Псевдоним для `set_zlim`.
`stem3D`	Создать 3D-график с маркерами и вертикальными линиями.
`text3D`	Добавить текст s на 3D-оси в точке x, y, z в координатах данных.

Прочее

`get_axis_position`
`add_contour_set`
`add_contourf_set`
`update_datalim`	Не реализован в `Axes3D`.

Примеры 3D-данных

axes3d.get_test_data

Возвращает кортеж X, Y, Z с тестовым набором данных.

Примеры использования `mpl_toolkits.mplot3d.axes3d.Axes3D`

Анимированное случайное блуждание в 3D

Отображение 2D-данных на 3D-графике

Пример 3D-столбчатых диаграмм

Отсечение данных по границам отображения осей

Создание 2D-столбчатых диаграмм на разных плоскостях

График поверхности 3D-блока

Построение контурных линий (линий уровня) в 3D

Построение контурных линий (линий уровня) в 3D с параметром extend3d

Проецирование контурных профилей на график

Залитые контуры

Проецирование залитого контура на график

Пользовательское затенение рельефа на графике 3D-поверхности

Полосы погрешностей в 3D

Заполнение пространства между 3D-линиями

Заполнение пространства под 3D-линейными графиками

Построение 3D-гистограммы двумерных данных

Двумерные изображения в 3D

Параметрическая кривая

Аттрактор Лоренца

Двумерные и трёхмерные оси на одном рисунке

Автоматическое смещение текста

Рисование плоских объектов на 3D-графике

Создание многоугольников в 3D

Типы проекций 3D-графиков

Векторное поле в 3D

Диаграмма рассеяния в 3D

Ступенчатая диаграмма в 3D

3D-графики в качестве подграфиков

3D-поверхность (цветовая карта)

3D-поверхность (сплошной цвет)

3D-поверхность (шахматный узор)

3D-поверхность в полярных координатах

Текстовые аннотации в 3D

Треугольный 3D-контурный график

Треугольный 3D-график залитых контуров

Треугольные 3D-поверхности

Дополнительные треугольные 3D-поверхности

3D-график вокселей / объёмных данных

3D-график вокселей с логотипом NumPy

3D-график вокселей / объёмных данных с цветами RGB

3D-график вокселей / объёмных данных в цилиндрических координатах

Каркасный график в 3D

Каркасные графики в 3D в одном направлении

bar3d(x, y, z, dx, dy, dz)

fill_between(x1, y1, z1, x2, y2, z2)

plot(xs, ys, zs)

quiver(X, Y, Z, U, V, W)

scatter(xs, ys, zs)

stem(x, y, z)

plot_surface(X, Y, Z)

plot_trisurf(x, y, z)

voxels([x, y, z], filled)

plot_wireframe(X, Y, Z)

`sharez`	Совместно использовать ось z с другим объектом.
`shareview`	Совместно использовать углы обзора с другим объектом.