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
-
Родительская фигура.
- rectкортеж (left, bottom, width, height), по умолчанию: None.
-
Положение осей.
- elevчисло, по умолчанию: 30
-
Угол возвышения в градусах, вращает камеру над и под плоскостью x-y, при положительном угле, камера находится над плоскостью.
- azimчисло, по умолчанию: -60
-
Азимутальный угол в градусах, вращает камеру вокруг оси z, при положительном угле, соответствует правостороннему вращению. Другими словами, положительный азимут вращает камеру вокруг начала координат от ее расположения вдоль оси +x к оси +y.
- rollчисло, по умолчанию: 0
-
Угол поворота в градусах, вращает камеру вокруг оси взгляда. Положительный угол поворачивает камеру по часовой стрелке, что приводит к вращению сцены против часовой стрелки.
- sharezAxes3D, необязательно
-
Другие оси, с которыми нужно совмещать z-пределы.
- proj_type{'persp', 'ortho'}
-
Тип проекции, по умолчанию 'persp'.
- box_aspectтройственный кортеж чисел с плавающей точкой, по умолчанию: None
-
Изменяет физические размеры осей 3D, таким образом, что отношение длин осей в единицах отображения равно x:y:z. Если None, по умолчанию 4:4:3
- computed_zorderbool, по умолчанию: True
-
Если True, порядок рисования вычисляется на основе среднего положения
Artistвдоль направления просмотра. Установите в False, если вы хотите вручную управлять порядком, в котором элементы рисуются друг над другом, используя свойство zorder. Это можно использовать для точной настройки, если автоматический порядок не дает желаемого результата. Однако обратите внимание, что ручной zorder будет верным только для ограниченного угла обзора. Если пользователь повернет фигуру, она будет выглядеть неправильно под определенными углами. - focal_lengthчисло с плавающей точкой, по умолчанию: None
-
Для типа проекции 'persp', фокусное расстояние виртуальной камеры. Должно быть > 0. Если None, по умолчанию 1. Для типа проекции 'ortho', должно быть установлено либо None, либо бесконечность (numpy.inf). Если None, по умолчанию бесконечность. Фокусное расстояние можно вычислить из желаемого поля зрения с помощью уравнения: focal_length = 1/tan(FOV/2)
- shareviewAxes3D, необязательно
-
Другие оси, с которыми нужно совмещать углы обзора.
- **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'
3-кортеж из чисел с плавающей точкой или None
BboxBaseили Nonebool
Patch или (Path, Transform) или None
facecolorили fcцвет
str
bool
объект
bool
bool
неизвестно
список
AbstractPathEffectNone или bool или float или вызываемый объект
[left, bottom, width, height] или
Bbox{'persp', 'ortho'}
число с плавающей точкой или None
bool
(scale: float, length: float, randomness: float)
bool или None
неизвестно
неизвестно
str
bool
(lower: float, upper: float)
str
-
xlimили xlim3d(левый: число, правый: число)
(левый: число, правый: число)
число больше -0,5
неизвестно
неизвестно
неизвестно
(нижнее: число, верхнее: число)
строка
ylimили ylim3d(нижняя: число, верхняя: число)
(нижняя: число, верхняя: число)
число больше -0,5
неизвестно
неизвестно
неизвестно
неизвестно
неизвестно
zlimили zlim3dнеизвестно
число больше -0,5
число с плавающей точкой
неизвестно
неизвестно
неизвестно
Отображение графиков
Построение 2D или 3D данных. | |
Создание диаграммы рассеяния. | |
Добавление 2D столбца(ов). | |
Генерация 3D гистограммы столбцов. | |
Создание поверхности графика. | |
Построение 3D каркасной диаграммы. | |
Построение треугольной поверхности. | |
В настоящее время не реализовано для 3D осей и возвращает None. | |
Создание 3D контурного графика. | |
Создание 3D контурного графика. | |
Создание 3D заполненного контурного графика. | |
Создание 3D заполненного контурного графика. | |
Построение 3D поля стрелок. | |
Построение набора заполненных объемов. | |
Построение линий и/или маркеров с ошибками вокруг них. | |
Создание 3D диаграммы столбцов. |
Текст и аннотации
Добавить текст s на 3D ось в координатах данных в месте x, y, z. | |
Добавление текста на ось. |
Очистка
Очистить ось. |
Внешний вид
Скрыть все визуальные компоненты осей x и y. | |
Не скрывать все визуальные компоненты осей x и y. | |
Установить/убрать 3D сетку. |
Ось
Пределы и направление осей
Возвращает экземпляр | |
Возвращает пределы области видимости оси x. | |
Возвращает пределы области видимости оси y. | |
Возвращает пределы области видимости оси z в 3D. | |
Установить пределы оси z в 3D. | |
Получить 3D мировые пределы. | |
Инвертировать ось z. | |
Возвращает, ориентирована ли ось z в обратном направлении. | |
Возвращает нижнюю и верхнюю границы оси z в возрастающем порядке. | |
Установить нижнюю и верхнюю числовые границы оси z. |
Подписи и заголовок осей
Установить подпись z. | |
Получить текстовую строку подписи z. | |
Установить заголовок для области Axes. |
Масштабы осей
Установить масштаб оси x. | |
Установить масштаб оси y. | |
Установить масштаб оси z. | |
Возвращает масштаб оси z (как строка). |
Автомасштабирование и отступы
Установить отступ пределов данных z перед автомасштабированием. | |
Установить или получить отступы автомасштабирования. | |
Удобный метод для простого автомасштабирования осей. | |
Автомасштабировать пределы области видимости, используя пределы данных. | |
Установить, будет ли ось z масштабироваться автоматически при рисовании или при помощи | |
Возвращает, масштабируется ли ось z автоматически. | |
Соотношение сторон
Установить соотношение сторон. | |
Установить соотношение сторон области Axes. | |
Настроить область Axes для указанного соотношения сторон данных. |
Деления
Удобный метод для изменения внешнего вида делений и меток делений. | |
Устанавливает позиции делений и (необязательно) метки делений оси z. | |
Возвращает позиции делений оси z в координатах данных. | |
[Не рекомендуется] Устанавливает метки делений оси z списком строковых меток. | |
Возвращает линии делений оси z в виде списка объектов | |
Возвращает линии сетки оси z в виде списка объектов | |
Возвращает метки вспомогательных делений оси z в виде списка объектов | |
Возвращает метки основных делений оси z в виде списка объектов | |
Настройка делений и меток оси z для обработки данных как дат. |
Единицы
Для элементов в Axes, если ось z поддерживает единицы, преобразует z с использованием типа единиц оси z |
Добавление элементов
Добавляет объект 3D-коллекции к графику. |
Интерактивное взаимодействие
Возвращает, поддерживает ли данное Axes функцию масштабирования прямоугольником. | |
Возвращает, поддерживает ли данное Axes какие-либо функции панорамирования/масштабирования. | |
Отключает кнопки мыши для вращения, панорамирования и масштабирования в 3D. | |
Устанавливает кнопки мыши для вращения и масштабирования в 3D. | |
Вызывается при перемещении мыши во время операции панорамирования. | |
Возвращает отформатированную строку z. | |
Возвращает строку, содержащую текущие углы вращения вида или координаты x, y, z точки на ближайшей оси, находящейся под курсором мыши, в зависимости от нажатой кнопки мыши. |
Проекция и перспектива
Устанавливает углы возвышения и азимута оси в градусах (а не радианах). | |
Устанавливает тип проекции. | |
Создает матрицу проекции на основе текущей позиции просмотра. | |
Отрисовка
Отрисовывает элемент (и его дочерние элементы) с помощью заданного рендерера. | |
Возвращает прямоугольник обрезки Axes, включая ось и ее декораторы (подпись оси, заголовок и т. д.). |
Псевдонимы и устаревшие методы
Псевдоним для | |
Создать график 3D столбцами. | |
Добавить текст s к 3D оси в позиции x, y, z в координатах данных. | |
[Устарело] | |
[Устарело] | |
[Устарело] |
Другое
Не реализовано в |
Пример данных 3D
Возвращает кортеж X, Y, Z с набором тестовых данных. |
© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.8.4/api/toolkits/mplot3d/axes3d.html