Spec-Zone.ru › Matplotlib 3.8

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
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

3-кортеж из чисел с плавающей точкой или None

clip_box

BboxBase или None

clip_on

bool

clip_path

Patch или (Path, Transform) или None

facecolor или fc

цвет

figure

Figure

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

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

rasterized

bool

sketch_params

(scale: float, length: float, randomness: float)

snap

bool или None

subplotspec

неизвестно

title

неизвестно

transform

Transform

url

str

visible

bool

xbound

(lower: float, upper: float)

xlabel

str

xlim или xlim3d

(левый: число, правый: число)

xlim3d

(левый: число, правый: число)

xmargin

число больше -0,5

xscale

неизвестно

xticklabels

неизвестно

xticks

неизвестно

ybound

(нижнее: число, верхнее: число)

ylabel

строка

ylim или ylim3d

(нижняя: число, верхняя: число)

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

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

Очистка

clear

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

END_OF_DOCUMENT_MARKER

Внешний вид

set_axis_off

Скрыть все визуальные компоненты осей x и y.

set_axis_on

Не скрывать все визуальные компоненты осей x и y.

grid

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

Ось

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

get_zaxis

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

get_xlim

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

get_ylim

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

get_zlim

Возвращает пределы области видимости оси z в 3D.

set_zlim

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

get_w_lims

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

invert_zaxis

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

zaxis_inverted

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

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 (как строка).

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

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

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

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

add_collection3d

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

Обмен

sharez

Обмен осью z с другим.

shareview

Обмен углами вида с другим.

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

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

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

set_proj_type

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

get_proj

Создает матрицу проекции на основе текущей позиции просмотра.

set_top_view

Отрисовка

draw

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

get_tightbbox

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

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

set_zlim3d

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

stem3D

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

text3D

Добавить текст s к 3D оси в позиции x, y, z в координатах данных.

tunit_cube

[Устарело]

tunit_edges

[Устарело]

unit_cube

[Устарело]

Другое

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.8.4/api/toolkits/mplot3d/axes3d.html

Spec-Zone.ru

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