Spec-Zone.ru › Matplotlib 3.7

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
END_OF_DOCUMENT_MARKER

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

Свойство

Описание

adjustable

{'box', 'datalim'}

agg_filter

функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от левого нижнего угла изображения

alpha

скаляр или 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

тройка из трёх чисел с плавающей точкой или None

clip_box

Bbox

clip_on

bool

clip_path

Объект Patch или (Path, Transform) или None

facecolor или fc

цвет

figure

Figure

frame_on

bool

gid

строка

in_layout

bool

label

объект

mouseover

bool

navigate

bool

navigate_mode

неизвестно

path_effects

AbstractPathEffect

picker

None или bool или float или вызываемый объект

position

[левое, нижнее, ширина, высота] или Bbox

proj_type

{'persp', 'ortho'}

prop_cycle

неизвестно

rasterization_zorder

число с плавающей точкой или None

rasterized

bool

sketch_params

(масштаб: float, длина: float, случайность: float)

snap

bool или None

subplotspec

неизвестно

title

неизвестно

transform

Transform

url

строка

visible

bool

xbound

неизвестно

xlabel

строка

xlim или xlim3d

(нижняя граница: float, верхняя граница: float)

xlim3d

(нижняя граница: float, верхняя граница: float)

xmargin

float больше -0,5

xscale

неизвестно

xticklabels

неизвестно

xticks

неизвестно

ybound

неизвестно

ylabel

строка (str)

ylim или ylim3d

(нижняя граница: float, верхняя граница: float)

ylim3d

(нижняя граница: float, верхняя граница: float)

ymargin

float больше -0,5

yscale

неизвестно

yticklabels

неизвестно

yticks

неизвестно

zbound

неизвестно

zlabel

неизвестно

zlim или zlim3d

неизвестно

zmargin

float больше -0,5

zorder

число с плавающей точкой (float)

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

Добавление текста на график.

text2D

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

Очистка

clear

Очистка оси.

Внешний вид

set_axis_off

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

set_axis_on

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

grid

Установить/снять 3D сетку.

get_frame_on

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

set_frame_on

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

Ось

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

get_zaxis

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

get_xlim

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

get_ylim

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

get_zlim

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

set_zlim

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

get_w_lims

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

invert_zaxis

Инвертировать ось z.

zaxis_inverted

Возвращает, ориентирована ли ось z в "обратном" направлении.

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 (в виде строки).

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

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 для обработки данных вдоль оси z как дат.

Единицы

convert_zunits

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

Добавление элементов управления

add_collection3d

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

Совместно используемые элементы

sharez

Поделить ось z с другим.

Интерактивное взаимодействие

can_zoom

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

can_pan

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

disable_mouse_rotation

Отключить кнопки мыши для вращения, перемещения и масштабирования в 3D.

mouse_init

Установить кнопки мыши для вращения и масштабирования в 3D.

drag_pan

Вызывается при перемещении мыши во время операции перемещения.

format_zdata

Возвращает отформатированную строку z.

format_coord

На основе 2D-координат просмотра пытается определить 3D-координаты.

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

view_init

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

set_proj_type

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

get_proj

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

set_top_view

Отрисовка

draw

Отрисовать элемент управления (и его дочерние элементы) с помощью заданного рендерера.

get_tightbbox

Возвращает узкую область обтекания оси, включая ось и ее декораторы (подписи осей, заголовок и т. д.).

END_OF_DOCUMENT_MARKER

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

set_zlim3d

Псевдоним для set_zlim.

stem3D

Создать 3D диаграмму столбцов.

text3D

Добавить текст на график.

tunit_cube

[Устаревшее]

tunit_edges

[Устаревшее]

unit_cube

[Устаревшее]

w_xaxis

[Устаревшее]

w_yaxis

[Устаревшее]

w_zaxis

[Устаревшее]

Другое

get_axis_position

add_contour_set

add_contourf_set

update_datalim

Не реализовано в Axes3D.

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

axes3d.get_test_data

Возвращает кортеж 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API