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, **kwargs)[source]
-
Bases:
AxesОбъект осей 3D.
Примечание
Как пользователь, вы не создаёте оси напрямую, а используете методы для создания осей; например, из
pyplotилиFigure:subplots,subplot_mosaicилиFigure.add_axes.- Параметры:
-
- figFigure
-
Родительская фигура.
- recttuple (left, bottom, width, height), default: None.
-
Положение осей.
- elevfloat, default: 30
-
Угол подъёма в градусах, поворачивает камеру над и под плоскостью x-y. Положительный угол соответствует расположению над плоскостью.
- azimfloat, default: -60
-
Азимутальный угол в градусах, поворачивает камеру вокруг оси z. Положительный угол соответствует повороту по часовой стрелке. Другими словами, положительный азимут поворачивает камеру вокруг начала координат из её положения вдоль оси +x к оси +y.
- rollfloat, default: 0
-
Угол вращения в градусах, поворачивает камеру вокруг оси обзора. Положительный угол вращает камеру по часовой стрелке, что приводит к вращению сцены против часовой стрелки.
- sharezAxes3D, optional
-
Другие оси для совместного использования пределов z.
- proj_type{'persp', 'ortho'}
-
Тип проекции, по умолчанию 'persp'.
- box_aspect3-tuple of floats, default: None
-
Изменяет физические размеры осей 3D так, чтобы отношение длин осей в единицах отображения было x:y:z. Если None, по умолчанию 4:4:3
- computed_zorderbool, default: True
-
Если True, порядок рисования вычисляется на основе среднего положения
Artistвдоль направления обзора. Установите в False, если хотите вручную управлять порядком, в котором элементы рисуются друг над другом, используя их атрибут zorder. Это можно использовать для тонкой настройки, если автоматический порядок не даёт желаемого результата. Однако обратите внимание, что ручной zorder будет верен только для ограниченного угла обзора. Если пользователь повернёт фигуру, она будет выглядеть неправильно под некоторыми углами. - focal_lengthfloat, default: None
-
Для типа проекции 'persp' фокусное расстояние виртуальной камеры. Должно быть > 0. Если None, по умолчанию 1. Для типа проекции 'ortho' должно быть установлено либо None, либо бесконечность (numpy.inf). Если None, по умолчанию бесконечность. Фокусное расстояние можно вычислить по желаемому полю зрения по формуле: focal_length = 1/tan(FOV/2)
- **kwargs
-
Другие необязательные ключевые аргументы:
Свойство
Описание
{'box', 'datalim'}
функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от левого нижнего угла изображения
скаляр или None
(float, float) или {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
bool
{'auto', 'equal', 'equalxy', 'equalxz', 'equalyz'}
bool
неизвестно
неизвестно
неизвестно
Callable[[Axes, Renderer], Bbox]
bool или 'line'
тройка из трёх чисел с плавающей точкой или None
bool
Объект Patch или (Path, Transform) или None
facecolorили fcцвет
bool
строка
bool
объект
bool
bool
неизвестно
None или bool или float или вызываемый объект
[левое, нижнее, ширина, высота] или
Bbox{'persp', 'ortho'}
неизвестно
число с плавающей точкой или None
bool
(масштаб: float, длина: float, случайность: float)
bool или None
неизвестно
неизвестно
строка
bool
неизвестно
строка
-
xlimили xlim3d(нижняя граница: float, верхняя граница: float)
(нижняя граница: float, верхняя граница: float)
float больше -0,5
неизвестно
неизвестно
неизвестно
неизвестно
строка (str)
ylimили ylim3d(нижняя граница: float, верхняя граница: float)
(нижняя граница: float, верхняя граница: float)
float больше -0,5
неизвестно
неизвестно
неизвестно
неизвестно
неизвестно
zlimили zlim3dнеизвестно
float больше -0,5
число с плавающей точкой (float)
неизвестно
неизвестно
неизвестно
Отображение графиков
Отображение 2D или 3D данных. | |
Создание диаграммы рассеяния. | |
Добавление 2D столбцов. | |
Генерация 3D гистограммы. | |
Создание поверхности. | |
Построение 3D каркасной модели. | |
Построение треугольной поверхности. | |
В настоящее время не реализовано для 3D осей, возвращает None. | |
Создание 3D контурного графика. | |
Создание 3D контурного графика. | |
Создание 3D заполненного контурного графика. | |
Создание 3D заполненного контурного графика. | |
Построение 3D поля векторов. | |
Построение набора заполненных кубиков (вокселей). | |
Построение линий и/или маркеров с ошибками вокруг них. | |
Создание 3D графика стебля. |
Текст и аннотации
Добавление текста на график. | |
Добавление текста на ось. |
Очистка
Очистка оси. |
Внешний вид
Отключить оси x и y. | |
Включить оси x и y. | |
Установить/снять 3D сетку. | |
Получить, отображаются ли панели 3D осей. | |
Установить, отображаются ли панели 3D осей. |
Ось
Пределы и направление оси
Возвращает экземпляр | |
Возвращает пределы отображения оси x. | |
Возвращает пределы отображения оси y. | |
Получить пределы 3D оси z. | |
Установить пределы 3D оси z. | |
Получить пределы 3D мира. | |
Инвертировать ось z. | |
Возвращает, ориентирована ли ось z в "обратном" направлении. | |
Возвращает нижнюю и верхнюю границы оси z в порядке возрастания. | |
Установить нижнюю и верхнюю числовые границы оси z. |
Подписи и заголовок оси
Установить подпись z. | |
Получить строку текста подписи z. | |
Установить заголовок для осей. |
Масштабы осей
Установить масштаб оси x. | |
Установить масштаб оси y. | |
Установить масштаб оси z. | |
Возвращает масштаб оси z (в виде строки). |
Автомасштабирование и отступы
Установить отступ для пределов данных z перед автомасштабированием. | |
Установить или получить отступы автомасштабирования. | |
Удобный метод для простого автомасштабирования осей. | |
Автомасштабировать пределы отображения, используя пределы данных. | |
Установить, нужно ли автоматически масштабировать ось z при отрисовке или с помощью | |
Возвращает, автоматически ли масштабируется ось z. | |
Соотношение сторон
Установить соотношения сторон. | |
Установить соотношение сторон для рамки осей. | |
Настроить оси для указанного соотношения сторон данных. |
Штрихи
Удобный метод для изменения внешнего вида штрихов и надписей штрихов. | |
Установить позиции штрихов и (необязательно) надписи оси z. | |
Возвращает позиции штрихов оси z в координатах данных. | |
[Не рекомендуется] Установить метки штрихов оси z списком строковых меток. | |
Возвращает линии штрихов оси z в виде списка объектов | |
Возвращает линии сетки оси z в виде списка объектов | |
Возвращает метки вспомогательных штрихов оси z в виде списка объектов | |
Возвращает метки основных штрихов оси z в виде списка объектов | |
Настройка штрихов и меток оси z для обработки данных вдоль оси z как дат. |
Единицы
Для элементов управления на оси, если ось z поддерживает единицы измерения, преобразует z, используя тип единиц измерения оси z. |
Добавление элементов управления
Добавить объект 3D-коллекции на график. |
Интерактивное взаимодействие
Возвращает, поддерживает ли эта ось функцию масштабирования прямоугольником. | |
Возвращает, поддерживает ли эта ось функцию перемещения. | |
Отключить кнопки мыши для вращения, перемещения и масштабирования в 3D. | |
Установить кнопки мыши для вращения и масштабирования в 3D. | |
Вызывается при перемещении мыши во время операции перемещения. | |
Возвращает отформатированную строку z. | |
На основе 2D-координат просмотра пытается определить 3D-координаты. |
Проекция и перспектива
Установить углы подъема и азимута оси в градусах (а не радианах). | |
Установить тип проекции. | |
Создать матрицу проекции из текущей точки обзора. | |
Отрисовка
Отрисовать элемент управления (и его дочерние элементы) с помощью заданного рендерера. | |
Возвращает узкую область обтекания оси, включая ось и ее декораторы (подписи осей, заголовок и т. д.). |
Псевдонимы и устаревшие методы
Псевдоним для | |
Создать 3D диаграмму столбцов. | |
Добавить текст на график. | |
[Устаревшее] | |
[Устаревшее] | |
[Устаревшее] | |
[Устаревшее] | |
[Устаревшее] | |
[Устаревшее] |
Другое
Не реализовано в |
Пример 3D данных
Возвращает кортеж X, Y, Z с набором тестовых данных. |
© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.7.5/api/toolkits/mplot3d/axes3d.html