mpl_toolkits.mplot3d.axes3d.Axes3D

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

Bases: Axes

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

Примечание

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

Параметры:

figFigure: Родительская фигура.
recttuple (left, bottom, width, height), по умолчанию: None.: Положение оси (left, bottom, width, height).
elevfloat, по умолчанию: 30: Угол подъёма в градусах вращает камеру над и под плоскостью x-y, при положительном угле камера расположена над плоскостью.
azimfloat, по умолчанию: -60: Азимутальный угол в градусах вращает камеру вокруг оси z, при положительном угле происходит вращение по часовой стрелке. Другими словами, положительный азимут вращает камеру вокруг начала координат от её положения вдоль оси +x к оси +y.
rollfloat, по умолчанию: 0: Угол вращения в градусах вращает камеру вокруг оси обзора. Положительный угол поворачивает камеру по часовой стрелке, в результате чего сцена поворачивается против часовой стрелки.
sharezAxes3D, необязательно: Другие оси для совместного использования пределов z. Обратите внимание, что разделить оси невозможно.
proj_type{'persp', 'ortho'}: Тип проекции, по умолчанию 'persp'.
box_aspect3-tuple чисел с плавающей запятой, по умолчанию: None: Изменяет физические размеры оси Axes3D таким образом, что отношение длин осей в единицах отображения равно x:y:z. Если None, по умолчанию равно 4:4:3
computed_zorderbool, по умолчанию: True: Если True, порядок рисования вычисляется на основе среднего положения Artist вдоль направления обзора. Установите значение False, если вы хотите вручную управлять порядком, в котором элементы рисуются друг на друге, используя их атрибут zorder. Это может быть использовано для тонкой настройки, если автоматический порядок не даёт нужный результат. Тем не менее, обратите внимание, что ручной порядок z будет верным только для ограниченного угла обзора. Если пользователь поворачивает фигуру, она будет выглядеть неправильно под определёнными углами.
focal_lengthfloat, по умолчанию: None: Для типа проекции 'persp', фокусное расстояние виртуальной камеры. Должно быть > 0. Если None, по умолчанию равно 1. Для типа проекции 'ortho', должно быть либо None, либо бесконечность (numpy.inf). Если None, по умолчанию равно бесконечности. Фокусное расстояние можно рассчитать по желаемому полю зрения по формуле: focal_length = 1/tan(FOV/2)
shareviewAxes3D, необязательно: Другие оси для совместного использования углов обзора. Обратите внимание, что разделить оси невозможно.
**kwargs

END_OF_DOCUMENT_MARKER ```

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

Свойство	Описание
`adjustable`	{'box', 'datalim'}
`agg_filter`	функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив чисел с плавающей точкой (m, n, 3) и два смещения от нижнего левого угла изображения
`alpha`	скаляр или None
`anchor`	(число, число) или {'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-кортеж чисел с плавающей точкой или None
`clip_box`	`BboxBase` или None
`clip_on`	bool
`clip_path`	Объект Patch или (объект Path, Transform) или None
`facecolor` или fc	цвет
`figure`	`Figure`
`forward_navigation_events`	bool или "auto"
`gid`	строка
`in_layout`	bool
`label`	объект
`mouseover`	bool
`navigate`	bool
`navigate_mode`	неизвестно
`path_effects`	список `AbstractPathEffect`
`picker`	None или bool или число с плавающей точкой или вызываемый объект
`position`	[левое, нижнее, ширина, высота] или `Bbox`
`proj_type`	{'persp', 'ortho'}
`prop_cycle`	`Cycler`
`rasterization_zorder`	число с плавающей точкой или None
`rasterized`	bool
`sketch_params`	(масштаб: число, длина: число, случайность: число)
`snap`	bool или None
`subplotspec`	неизвестно
`title`	неизвестно
`transform`	`Transform`
`url`	строка
`visible`	bool

`xbound`	неизвестно
`xlabel`	строка
`xlim` или xlim3d	(левый: число с плавающей запятой, правый: число с плавающей запятой)
`xmargin`	число с плавающей запятой, больше -0,5
`xscale`	неизвестно
`xticklabels`	неизвестно
`xticks`	неизвестно
`ybound`	неизвестно
`ylabel`	строка
`ylim` или ylim3d	(нижний: число с плавающей запятой, верхний: число с плавающей запятой)
`ymargin`	число с плавающей запятой, больше -0,5
`yscale`	неизвестно
`yticklabels`	неизвестно
`yticks`	неизвестно
`zbound`	неизвестно
`zlabel`	неизвестно
`zlim` или zlim3d	(нижний: число с плавающей запятой, верхний: число с плавающей запятой)
`zmargin`	число с плавающей запятой, больше -0,5
`zorder`	число с плавающей запятой
`zscale`	неизвестно
`zticklabels`	неизвестно
`zticks`	неизвестно

Отображение графиков

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

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

`text`	Добавить текст s на 3D ось в местоположении x, y, z в координатах данных.
`text2D`	Добавить текст на ось.

END_OF_DOCUMENT_MARKER

Очистка

clear

Очистить область.

Внешний вид

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

Ось

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

`get_zaxis`	Возвращает экземпляр `ZAxis` (`Axis`).
`get_xlim`	Возвращает пределы отображения оси X.
`set_xlim`	Устанавливает пределы отображения оси X в 3D.
`get_ylim`	Возвращает пределы отображения оси Y.
`set_ylim`	Устанавливает пределы отображения оси Y в 3D.
`get_zlim`	Возвращает пределы отображения оси Z в 3D.
`set_zlim`	Устанавливает пределы отображения оси Z в 3D.
`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`	Установить заголовок для оси.

Масштабы оси

`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`	Установить соотношение сторон области оси.
`apply_aspect`	Настроить область оси для указанного соотношения сторон данных.

Деления

`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

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

Добавление элементов

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`	Рисует элемент (и его потомков) с помощью данного рендерера.
`get_tightbbox`	Возвращает прямоугольник обрезки Axes, включая оси и их декорации (подписи осей, заголовок и т.д.).

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

`set_zlim3d`	Псевдоним для `set_zlim`.
`stem3D`	Создаёт 3D график столбцов.
`text3D`	Добавляет текст s к 3D Axes в позиции 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 гистограммы 2D данных

2D изображения в 3D

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

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

2D и 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)

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`	Поделить углы вида с другой.