mpl_toolkits.mplot3d.axes3d.Axes3D

class mpl_toolkits.mplot3d.axes3d.Axes3D(fig, rect=None, *args, azim=-60, elev=30, zscale=None, sharez=None, proj_type='persp', **kwargs) [source]

Bases: matplotlib.axes._axes.Axes

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

add_collection3d(col, zs=0, zdir='z') [source]

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

Типы 2D-коллекций преобразуются в 3D-версии путём изменения объекта и добавления координат z.

Поддерживаются:

• PolyCollection
• LineCollection
• PatchCollection

add_contour_set(cset, extend3d=False, stride=5, zdir='z', offset=None) [source]

add_contourf_set(cset, zdir='z', offset=None) [source]

auto_scale_xyz(X, Y, Z=None, had_data=None) [source]

autoscale(enable=True, axis='both', tight=None) [source]

Удобный метод для автоматического масштабирования вида осей. Подробнее см. matplotlib.axes.Axes.autoscale(). Обратите внимание, что эта функция работает одинаково для всех трёх осей. Поэтому, для axis можно указать 'z', а 'both' применяется ко всем трём осям.

Добавлена в версии 1.1.0: Данная функция была добавлена, но не протестирована. Пожалуйста, сообщите о любых ошибках.

autoscale_view(tight=None, scalex=True, scaley=True, scalez=True) [source]

Автоматически масштабирует пределы просмотра, используя пределы данных. См. matplotlib.axes.Axes.autoscale_view() для документации. Обратите внимание, что данная функция применяется к 3D осям, и добавляет scalez в аргументы функции.

Изменено в версии 1.1.0: Изменена сигнатура функции для лучшего соответствия 2D версии. tight теперь явно является аргументом по умолчанию и указан первым.

Изменено в версии 1.2.1: Функция теперь полностью функциональна.

bar(left, height, zs=0, zdir='z', *args, **kwargs) [source]

Добавить 2D столбец(ы).

Аргумент	Описание
left	Координаты x левых сторон столбцов.
height	Высота столбцов.
zs	Координата z столбцов, если указано одно значение, все столбцы будут размещены на одном z.
zdir	Направление оси z для построения 2D набора ('x', 'y' или 'z').

Ключевые аргументы передаются в bar().

Возвращает Patch3DCollection

bar3d(x, y, z, dx, dy, dz, color=None, zsort='average', shade=True, *args, **kwargs) [source]

Генерация 3D столбчатой диаграммы.

Этот метод создаёт трёхмерную столбчатую диаграмму, где ширину, глубину, высоту и цвет столбцов можно задавать индивидуально.

Параметры:

x, y, z : array-like Координаты точки привязки столбцов. dx, dy, dz : scalar or array-like Ширина, глубина и высота столбцов, соответственно. color : sequence of valid color specifications, optional Цвет столбцов может быть задан глобально или индивидуально. Этот параметр может быть: Единственное значение цвета для всех столбцов. Массив цветов длиной N столбцов для раскраски каждого столбца. Массив цветов длиной 6 для раскраски граней столбцов. Массив цветов длиной 6 * N столбцов для раскраски каждой грани индивидуально. При раскраске граней ящиков, порядок раскраски следующий: -Z (нижняя грань ящика) +Z (верхняя грань ящика) -Y +Y -X +X zsort : str, optional Схема сортировки по оси z, передаваемая в Poly3DCollection() shade : bool, optional (default = True) Если True, то тенируются тёмные стороны столбцов (относительно источника света на графике). Любые дополнительные ключевые аргументы передаются в :func:`~mpl_toolkits.mplot3d.art3d.Poly3DCollection`

Возвращает:

collection : Poly3DCollection Коллекция трёхмерных многоугольников, представляющих столбцы.

can_pan() [source]

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

Объекты 3D осей не используют кнопки перемещения/приближения.

can_zoom() [source]

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

Объекты 3D осей не используют кнопку увеличения/уменьшения.

cla() [source]

Очистить оси

clabel(*args, **kwargs) [source]

В настоящее время данная функция не реализована для 3D осей. Возвращает None.

contour(X, Y, Z, *args, extend3d=False, stride=5, zdir='z', offset=None, **kwargs) [source]

Создать 3D линию уровня.

Аргумент	Описание
X, Y,	Значения данных в виде numpy.массивов
Z
extend3d	Расширить контур в 3D (по умолчанию: False)
stride	Шаг (размер шага) для расширения контура
zdir	Направление для использования: x, y или z (по умолчанию)
offset	Если указано, нарисуйте проекцию линий уровня на это положение в плоскости, перпендикулярной zdir

Позиционные и другие ключевые аргументы передаются в contour()

Возвращает contour

contour3D(X, Y, Z, *args, extend3d=False, stride=5, zdir='z', offset=None, **kwargs)

Создать 3D линию уровня.

Аргумент	Описание
X, Y,	Значения данных в виде numpy.массивов
Z
extend3d	Расширить контур в 3D (по умолчанию: False)
stride	Шаг (размер шага) для расширения контура
zdir	Направление для использования: x, y или z (по умолчанию)
offset	Если указано, нарисуйте проекцию линий уровня на это положение в плоскости, перпендикулярной zdir

Позиционные и другие ключевые аргументы передаются в contour()

Возвращает contour

contourf(X, Y, Z, *args, zdir='z', offset=None, **kwargs) [source]

Создать 3D контурную заполненную диаграмму.

Аргумент	Описание
X, Y,	Значения данных как numpy.arrays
Z
zdir	Направление использования: x, y или z (по умолчанию)
offset	Если указано, отобразить проекцию заполненного контура в этой позиции в плоскости, перпендикулярной zdir

Позиционные и ключевые аргументы передаются в contourf()

Возвращает contourf

Изменено в версии 1.1.0: Были добавлены ключевые параметры zdir и offset.

contourf3D(X, Y, Z, *args, zdir='z', offset=None, **kwargs)

Создать 3D контурную заполненную диаграмму.

Аргумент	Описание
X, Y,	Значения данных как numpy.arrays
Z
zdir	Направление использования: x, y или z (по умолчанию)
offset	Если указано, отобразить проекцию заполненного контура в этой позиции в плоскости, перпендикулярной zdir

Позиционные и ключевые аргументы передаются в contourf()

Возвращает contourf

Изменено в версии 1.1.0: Были добавлены ключевые параметры zdir и offset.

convert_zunits(z) [source]

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

Добавлена в версии 1.2.1.

disable_mouse_rotation() [source]

Отключить обращение к обработчикам событий мыши.

draw(renderer) [source]

Отрисовать всё (линии графика, оси, метки)

format_coord(xd, yd) [source]

Учитывая 2D координаты просмотра, попытаться определить 3D координаты. Ищет ближайший край к точке и предполагает, что точка имеет ту же z-позицию, что и ближайшая точка на этом краю.

format_zdata(z) [source]

Возвратить отформатированную строку z. Эта функция будет использовать атрибут fmt_zdata, если он вызываемый, иначе вернёт форматировщик основных делений оси z.

get_autoscale_on() [source]

Получить, применяется ли автоматическое масштабирование для всех осей при командах построения графика

Добавлена в версии 1.1.0: Эта функция была добавлена, но не протестирована. Пожалуйста, сообщите о любых ошибках.

get_autoscalez_on() [source]

Получить, применяется ли автоматическое масштабирование для z-оси при командах построения графика

Добавлена в версии 1.1.0: Эта функция была добавлена, но не протестирована. Пожалуйста, сообщите о любых ошибках.

get_axis_position() [source]

get_children() [source]

Возвращает список дочерних элементов-графических объектов

get_frame_on() [source]

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

Добавлена в версии 1.1.0.

get_proj() [source]

Создать матрицу проекции из текущего положения просмотра.

elev хранит угол возвышения в плоскости z, azim хранит угол азимута в плоскости x,y

dist — расстояние от точки зрения к объекту.

get_w_lims() [source]

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

get_xlim()

Получить диапазон значений x-оси

Возвращает:	xlimits : tuple Возвращает текущие пределы x-оси как кортеж (left, right).

Примечания

Ось x может быть инвертирована, в этом случае значение left будет больше, чем значение right.

Изменено в версии 1.1.0: Функция теперь правильно ссылается на 3D пределы x-оси

get_xlim3d() [source]

Получить диапазон значений x-оси

Возвращает:	xlimits : tuple Возвращает текущие пределы x-оси как кортеж (left, right).

Примечания

Ось x может быть инвертирована, в этом случае значение left будет больше, чем значение right.

Изменено в версии 1.1.0: Функция теперь правильно ссылается на 3D пределы x-оси

get_ylim()

Получить диапазон значений y-оси

Возвращает:	ylimits : tuple Возвращает текущие пределы y-оси как кортеж (bottom, top).

Примечания

Ось y может быть инвертирована, в этом случае значение bottom будет больше, чем значение top.

Изменено в версии 1.1.0: Функция теперь правильно ссылается на 3D пределы y-оси.

get_ylim3d() [source]

Получить диапазон значений y-оси

Возвращает:	ylimits : tuple Возвращает текущие пределы y-оси как кортеж (bottom, top).

Примечания

Ось y может быть инвертирована, в этом случае значение bottom будет больше, чем значение top.

Изменено в версии 1.1.0: Функция теперь правильно ссылается на 3D пределы y-оси.

get_zbound() [source]

Возвращает числовые границы оси z, где:

lowerBound < upperBound

Введено в версии 1.1.0: Эта функция была добавлена, но не протестирована. Пожалуйста, сообщите о любых ошибках.

get_zlabel() [source]

Получить строку текста метки оси z.

Введено в версии 1.1.0: Эта функция была добавлена, но не протестирована. Пожалуйста, сообщите о любых ошибках.

get_zlim()

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

get_zlim3d() [source]

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

get_zmajorticklabels() [source]

Получить метки основных делений оси z в виде списка объектов Text.

Введено в версии 1.1.0.

get_zminorticklabels() [source]

Получить метки вспомогательных делений оси z в виде списка объектов Text.

Примечание

Вспомогательные деления не поддерживаются. Эта функция добавлена только для полноты.

Введено в версии 1.1.0.

get_zscale() [source]

get_zticklabels(minor=False) [source]

Получить метки делений оси z в виде списка объектов Text. См. matplotlib.axes.Axes.get_yticklabels() для получения более подробной информации.

Примечание

Вспомогательные деления не поддерживаются.

Введено в версии 1.1.0.

get_zticklines() [source]

Получить линии делений оси z в виде списка объектов Line2D. Обратите внимание, что эта функция предоставлена только для полноты. Эти линии пересчитываются по мере изменения отображения.

Введено в версии 1.1.0.

get_zticks(minor=False) [source]

Возвращает деления оси z в виде списка положений. См. matplotlib.axes.Axes.get_yticks() для получения более подробной информации.

Примечание

Вспомогательные деления не поддерживаются.

Введено в версии 1.1.0.

grid(b=True, **kwargs) [source]

Включить/выключить сетку в 3D графике.

Примечание

В настоящее время эта функция ведет себя не так, как matplotlib.axes.Axes.grid(), но предполагается, что в будущем она будет поддерживать такое же поведение.

Изменено в версии 1.1.0: Эта функция была изменена, но не протестирована. Пожалуйста, сообщите о любых ошибках.

have_units() [source]

Возвращает True, если единицы измерения установлены на осях x, y или z

invert_zaxis() [source]

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

Введено в версии 1.1.0: Эта функция была добавлена, но не протестирована. Пожалуйста, сообщите о любых ошибках.

locator_params(axis='both', tight=None, **kwargs) [source]

Удобный метод для управления размещением делений.

См. matplotlib.axes.Axes.locator_params() для полной документации. Обратите внимание, что это для объектов Axes3D, поэтому установка axis в 'both' приведет к установке параметров для всех трёх осей. Также, axis может принимать значение 'z' для применения параметров к оси z.

Введено в версии 1.1.0: Эта функция была добавлена, но не протестирована. Пожалуйста, сообщите о любых ошибках.

margins(*margins, x=None, y=None, z=None, tight=True) [source]

Удобный метод для установки или получения отступов при автоматическом масштабировании.

подписи::

margins()

возвращает xmargin, ymargin, zmargin

margins(margin)

margins(xmargin, ymargin, zmargin)

margins(x=xmargin, y=ymargin, z=zmargin)

margins(..., tight=False)

Все вышеперечисленные формы устанавливают параметры xmargin, ymargin и zmargin. Все параметры необязательны. Одно позиционное значение задаёт xmargin, ymargin и zmargin. Передача как позиционных, так и ключевых аргументов для xmargin, ymargin и/или zmargin недопустима.

Параметр tight передаётся в autoscale_view(), который выполняется после изменения отступа; по умолчанию здесь значение True, исходя из предположения, что когда задаются отступы, дополнительное заполнение для соответствия отметкам обычно не требуется. Установка tight в None сохранит предыдущее значение.

Указание любых изменений отступов влияет только на автоматическое масштабирование; например, если xmargin не равен None, то xmargin умножается на интервал данных X и добавляется к каждому концу этого интервала перед использованием в автоматическом масштабировании.

Введено в версии 1.1.0: Эта функция была добавлена, но не протестирована. Пожалуйста, сообщите о любых ошибках.

mouse_init(rotate_btn=1, zoom_btn=3) [source]

Инициализирует обработчики событий мыши для активации 3D вращения осей. Также необязательно устанавливает кнопки мыши для 3D вращения и масштабирования.

Аргумент	Описание
rotate_btn	Целое число или список целых чисел, определяющих кнопку или кнопки мыши для 3D вращения осей. По умолчанию = 1.
zoom_btn	Целое число или список целых чисел, определяющих кнопку или кнопки мыши для масштабирования 3D осей. По умолчанию = 3.

name = '3d'

plot(xs, ys, *args, zdir='z', **kwargs) [source]

Построение 2D или 3D данных.

Аргумент	Описание
xs, ys	Координаты x, y вершин
zs	Значение(я) z, одно для всех точек или одно для каждой точки.
zdir	Направление, используемое как z ('x', 'y' или 'z') при построении 2D набора данных.

Другие аргументы передаются в plot()

plot3D(xs, ys, *args, zdir='z', **kwargs)

Построение 2D или 3D данных.

Аргумент	Описание
xs, ys	Координаты x, y вершин
zs	Значение z, либо одно для всех точек, либо по одному для каждой точки.
zdir	Направление, используемое как z ('x', 'y' или 'z') при построении 2D набора.

Другие аргументы передаются в plot()

plot_surface(X, Y, Z, *args, norm=None, vmin=None, vmax=None, lightsource=None, **kwargs) [source]

Построение поверхностного графика.

По умолчанию он будет окрашен в оттенки одного цвета, но также поддерживает сопоставление цветов с помощью аргумента cmap.

Примечание

Аргументы rcount и ccount, которые по умолчанию равны 50, определяют максимальное количество выборок, используемых в каждом направлении. Если входные данные больше, они будут уменьшены до этих чисел точек (путем взятия срезов).

Параметры:

X, Y, Z : 2d arrays Значения данных. rcount, ccount : int Максимальное количество выборок, используемых в каждом направлении. Если входные данные больше, они будут уменьшены до этих чисел точек (путем взятия срезов). По умолчанию 50. Введено в версии 2.0. rstride, cstride : int Шаг уменьшения выборки в каждом направлении. Эти аргументы взаимоисключающие с rcount и ccount. Если задан только один из rstride или cstride, другой по умолчанию равен 10. 'Классический' режим использует значение по умолчанию rstride = cstride = 10 вместо нового значения по умолчанию rcount = ccount = 50. color : color-like Цвет поверхностных областей. cmap : Colormap Цветовая карта поверхностных областей. facecolors : array-like of colors. Цвета каждой отдельной области. norm : Normalize Нормализация для цветовой карты. vmin, vmax : float Пределы для нормализации. shade : bool Использовать затенение для цветов граней. **kwargs : Другие аргументы передаются в Poly3DCollection.

plot_trisurf(*args, color=None, norm=None, vmin=None, vmax=None, lightsource=None, **kwargs) [source]

Аргумент	Описание
X, Y, Z	Значения данных как одномерные массивы
color	Цвет поверхностных областей
cmap	Цветовая карта для поверхностных областей.
norm	Экземпляр Normalize для сопоставления значений с цветами
vmin	Минимальное значение для сопоставления
vmax	Максимальное значение для сопоставления
shade	Затенение цветов граней

Треугольная сетка (необязательная) может быть задана двумя способами:

plot_trisurf(triangulation, ...)

где triangulation — объект Triangulation, или:

plot_trisurf(X, Y, ...)
plot_trisurf(X, Y, triangles, ...)
plot_trisurf(X, Y, triangles=triangles, ...)

в этом случае будет создан объект Triangulation. См. Triangulation для объяснения этих возможностей.

Остальные аргументы:

plot_trisurf(..., Z)

где Z — массив значений для контуров, по одному на точку в треугольной сетке.

Другие аргументы передаются в Poly3DCollection

Примеры:

(Исходный код, png, pdf)

(Исходный код, png, pdf)

Введено в версии 1.2.0: Эта функция построения графиков была добавлена для выпуска v1.2.0.

plot_wireframe(X, Y, Z, *args, **kwargs) [source]

Построение 3D каркасного графика.

Примечание

Аргументы rcount и ccount, которые по умолчанию равны 50, определяют максимальное количество выборок, используемых в каждом направлении. Если входные данные больше, они будут уменьшены до этих чисел точек (путем взятия срезов).

Параметры:

X, Y, Z : 2d arrays Значения данных. rcount, ccount : int Максимальное количество выборок, используемых в каждом направлении. Если входные данные больше, они будут уменьшены до этих чисел точек (путем взятия срезов). Установка счётчика в ноль приводит к тому, что данные не будут сэмплироваться в соответствующем направлении, что даст 3D линию, а не каркасный график. По умолчанию 50. Введено в версии 2.0. rstride, cstride : int Шаг уменьшения выборки в каждом направлении. Эти аргументы взаимоисключающие с rcount и ccount. Если задан только один из rstride или cstride, другой по умолчанию равен 1. Установка шага в ноль приводит к тому, что данные не будут сэмплироваться в соответствующем направлении, что даст 3D линию, а не каркасный график. 'Классический' режим использует значение по умолчанию rstride = cstride = 1 вместо нового значения по умолчанию rcount = ccount = 50. **kwargs : Другие аргументы передаются в Line3DCollection.

quiver(*args, length=1, arrow_length_ratio=0.3, pivot='tail', normalize=False, **kwargs) [source]

Построение 3D поля стрелок.

подписи вызова:

quiver(X, Y, Z, U, V, W, **kwargs)

Аргументы:

X, Y, Z:

Координаты x, y и z мест расположения стрелок (по умолчанию — хвост стрелки; см. аргумент pivot)

U, V, W:

Компоненты x, y и z векторов стрелок

Аргументы могут быть массивоподобными или скалярными, до тех пор, пока они могут быть объединены по широковещательному принципу. Аргументы также могут быть массивами с масками. Если элемент в любом из аргументов замаскирован, соответствующий элемент quiver не будет нарисован.

Ключевые аргументы:

length: [1.0 | float]

Длина каждой стрелки, по умолчанию 1.0, единицы измерения совпадают с осями

arrow_length_ratio: [0.3 | float]

Соотношение длины стрелки к длине стрелки, по умолчанию 0.3

pivot: [ 'tail' | 'middle' | 'tip' ]

Часть стрелки, которая находится в точке сетки; стрелка вращается вокруг этой точки, отсюда и название pivot. По умолчанию 'tail'

normalize: bool

Если True, все стрелки будут одинаковой длины. По умолчанию False, где длины стрелок будут разными в зависимости от значений u, v, w.

Любые дополнительные ключевые аргументы передаются в LineCollection

quiver3D(*args, length=1, arrow_length_ratio=0.3, pivot='tail', normalize=False, **kwargs)

Построение 3D поля стрелок.

Подписи вызова:

quiver(X, Y, Z, U, V, W, **kwargs)

Аргументы:

X, Y, Z:

Координаты x, y и z расположения стрелок (по умолчанию — начало стрелки; см. параметр pivot)

U, V, W:

Компоненты вектора стрелок по осям x, y и z

Аргументы могут быть одномерными массивами или скалярами, при условии их совместной трансляции. Аргументы также могут быть массивами с пропусками. Если элемент в любом из аргументов имеет пропуск, соответствующий элемент стрелки не будет нарисован.

Ключевые аргументы:

length: [1.0 | float]

Длина каждой стрелки, по умолчанию 1.0, единицы измерения совпадают с осями

arrow_length_ratio: [0.3 | float]

Соотношение длины головки стрелки к длине стрелки, по умолчанию 0.3

pivot: [ 'tail' | 'middle' | 'tip' ]

Часть стрелки, совпадающая с точкой на сетке; стрелка вращается вокруг этой точки, отсюда и название pivot. По умолчанию — 'tail'

normalize: bool

Если True, все стрелки будут одинаковой длины. По умолчанию False, в этом случае длина стрелок будет зависеть от значений u, v, w.

Все дополнительные ключевые аргументы передаются в LineCollection

scatter(xs, ys, zs=0, zdir='z', s=20, c=None, depthshade=True, *args, **kwargs) [source]

Построение диаграммы рассеяния.

Аргумент	Описание
xs, ys	Позиции точек данных.
zs	Массив той же длины, что и xs и ys, или одно значение для размещения всех точек в одной плоскости. По умолчанию 0.
zdir	Направление, используемое в качестве z ('x', 'y' или 'z') при построении 2D набора.
s	Размер в пунктах^2. Скаляр или массив той же длины, что и x и y.
c	Цвет. c может быть одной строкой формата цвета, последовательностью спецификаций цвета длиной N, или последовательностью N чисел для отображения в цветах с использованием cmap и norm, заданных через ключевые параметры (см. ниже). Обратите внимание, что c не должен быть одной числовой последовательностью RGB или RGBA, так как это неотличимо от массива значений для отображения в цветах. c может быть 2-мерным массивом, в котором строки являются RGB или RGBA, в том числе и в случае одной строки для указания одного цвета для всех точек.
depthshade	Определяет, затеняются ли маркеры разброса, чтобы создать впечатление глубины. По умолчанию True.

Ключевые аргументы передаются в scatter().

Возвращает Patch3DCollection

scatter3D(xs, ys, zs=0, zdir='z', s=20, c=None, depthshade=True, *args, **kwargs)

Построение диаграммы рассеяния.

Аргумент	Описание
xs, ys	Позиции точек данных.
zs	Массив той же длины, что и xs и ys, или одно значение для размещения всех точек в одной плоскости. По умолчанию 0.
zdir	Направление, используемое в качестве z ('x', 'y' или 'z') при построении 2D набора.
s	Размер в пунктах^2. Скаляр или массив той же длины, что и x и y.
c	Цвет. c может быть одной строкой формата цвета, последовательностью спецификаций цвета длиной N, или последовательностью N чисел для отображения в цветах с использованием cmap и norm, заданных через ключевые параметры (см. ниже). Обратите внимание, что c не должен быть одной числовой последовательностью RGB или RGBA, так как это неотличимо от массива значений для отображения в цветах. c может быть 2-мерным массивом, в котором строки являются RGB или RGBA, в том числе и в случае одной строки для указания одного цвета для всех точек.
depthshade	Определяет, затеняются ли маркеры разброса, чтобы создать впечатление глубины. По умолчанию True.

Ключевые аргументы передаются в scatter().

Возвращает Patch3DCollection

set_autoscale_on(b) [source]

Установить, применяется ли автоматическое масштабирование к командам построения графиков

Введено в версии 1.1.0: Данная функция была добавлена, но не протестирована. Пожалуйста, сообщите о любых ошибках.

Параметры:	b : bool

set_autoscalez_on(b) [source]

Установить, применяется ли автоматическое масштабирование по оси z к командам построения графиков

Введено в версии 1.1.0: Данная функция была добавлена, но не протестирована. Пожалуйста, сообщите о любых ошибках.

Параметры:	b : bool

set_axis_off() [source]

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

set_axis_on() [source]

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

set_frame_on(b) [source]

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

Введено в версии 1.1.0.

Параметры:	b : bool

set_proj_type(proj_type) [source]

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

Параметры:	proj_type : str Тип проекции, принимает 'persp' и 'ortho'.

set_title(label, fontdict=None, loc='center', **kwargs) [source]

Установить заголовок для осей.

Установите один из трех доступных заголовков осей. Доступные заголовки расположены над осями по центру, по левому краю и по правому краю.

Параметры:	label : str Текст для заголовка fontdict : dict Словарь, контролирующий вид текста заголовка, значение по умолчанию fontdict: {'fontsize': rcParams['axes.titlesize'], 'fontweight' : rcParams['axes.titleweight'], 'verticalalignment': 'baseline', 'horizontalalignment': loc} loc : {'center', 'left', 'right'}, str, optional Какой заголовок установить, по умолчанию 'center' pad : float Смещение заголовка от верхней части осей в пунктах. По умолчанию None использовать rcParams['axes.titlepad'].
Возвращает:	text : Text Экземпляр matplotlib text, представляющий заголовок
Другие параметры:	**kwargs : Text properties Другие ключевые аргументы — свойства текста, см. Text для списка допустимых свойств текста.

set_top_view() [source]

set_xlim(left=None, right=None, emit=True, auto=False, *, xmin=None, xmax=None)

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

См. matplotlib.axes.Axes.set_xlim() для полной документации.

set_xlim3d(left=None, right=None, emit=True, auto=False, *, xmin=None, xmax=None) [source]

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

См. matplotlib.axes.Axes.set_xlim() для полной документации.

set_xscale(value, **kwargs) [source]

Установить масштаб оси X.

Параметры:	value : {"linear", "log", "symlog", "logit", ...} стратегия масштабирования

См. также

matplotlib.scale.LinearScale

линейное преобразование

matplotlib.scale.LogTransform

логарифмическое преобразование

matplotlib.scale.SymmetricalLogTransform

симметричное логарифмическое преобразование

matplotlib.scale.LogisticTransform

логистическое преобразование .. versionadded :: 1.1.0 Эта функция была добавлена, но не протестирована. Пожалуйста, сообщите об ошибках.

Примечания

Разные ключевые слова принимаются в зависимости от масштаба. Подробнее см. в модуле scale.

set_ylim(bottom=None, top=None, emit=True, auto=False, *, ymin=None, ymax=None)

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

См. matplotlib.axes.Axes.set_ylim() для полной документации.

set_ylim3d(bottom=None, top=None, emit=True, auto=False, *, ymin=None, ymax=None) [source]

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

См. matplotlib.axes.Axes.set_ylim() для полной документации.

set_yscale(value, **kwargs) [source]

Установить масштаб оси Y.

Параметры:	value : {"linear", "log", "symlog", "logit", ...} стратегия масштабирования

См. также

matplotlib.scale.LinearScale

линейное преобразование

matplotlib.scale.LogTransform

логарифмическое преобразование

matplotlib.scale.SymmetricalLogTransform

симметричное логарифмическое преобразование

matplotlib.scale.LogisticTransform

логистическое преобразование .. versionadded :: 1.1.0 Эта функция была добавлена, но не протестирована. Пожалуйста, сообщите об ошибках.

Примечания

Разные ключевые слова принимаются в зависимости от масштаба. Подробнее см. в модуле scale.

set_zbound(lower=None, upper=None) [source]

Установить нижнюю и верхнюю числовые границы оси Z. Этот метод будет учитывать инверсию осей независимо от порядка параметров. Он не изменит _autoscaleZon атрибут.

New in version 1.1.0: Эта функция была добавлена, но не протестирована. Пожалуйста, сообщите об ошибках.

set_zlabel(zlabel, fontdict=None, labelpad=None, **kwargs) [source]

Установить метку оси Z. См. документ для set_ylabel() для описания.

set_zlim(bottom=None, top=None, emit=True, auto=False, *, zmin=None, zmax=None)

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

См. matplotlib.axes.Axes.set_ylim() для полной документации

set_zlim3d(bottom=None, top=None, emit=True, auto=False, *, zmin=None, zmax=None) [source]

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

См. matplotlib.axes.Axes.set_ylim() для полной документации

set_zmargin(m) [source]

Установить отступ границ данных Z перед автоматическим масштабированием.

К каждой границе интервала будут добавлены m раз интервала данных перед его использованием в автоматическом масштабировании.

принимает: число в диапазоне от 0 до 1

New in version 1.1.0: Эта функция была добавлена, но не протестирована. Пожалуйста, сообщите об ошибках.

set_zscale(value, **kwargs) [source]

Установить масштаб оси Z: 'linear' | 'log' | 'logit' | 'symlog'

ПРИНИМАЕТ: ['linear' | 'log' | 'logit' | 'symlog']

Разные ключевые слова принимаются в зависимости от масштаба:

'linear'

'log'

basex/basey:

Основание логарифма

nonposx/nonposy: {'mask', 'clip'}

отрицательные значения в x или y могут быть замаскированы как недопустимые или обрезаны до очень малого положительного числа

subsx/subsy:

Где разместить дополнительные деления между каждым основным делением. Должно быть последовательностью целых чисел. Например, в логарифмическом масштабе: [2, 3, 4, 5, 6, 7, 8, 9]

разместит 8 логарифмически распределенных дополнительных делений между каждым основным делением.

'logit'

nonpos: {'mask', 'clip'}

значения за пределами ]0, 1[ могут быть замаскированы как недопустимые или обрезаны до числа, очень близкого к 0 или 1

'symlog'

basex/basey:

Основание логарифма

linthreshx/linthreshy:

Одиночное число, определяющее диапазон (-x, x), в котором график линейный. Это позволяет избежать того, что график уходит в бесконечность около нуля.

subsx/subsy:

Где разместить дополнительные деления между каждым основным делением. Должно быть последовательностью целых чисел. Например, в логарифмическом масштабе: [2, 3, 4, 5, 6, 7, 8, 9]

разместит 8 логарифмически распределенных дополнительных делений между каждым основным делением.

linscalex/linscaley:

Это позволяет линейному диапазону (-linthresh до linthresh) быть растянутым относительно логарифмического диапазона. Его значение — количество декад для каждой половины линейного диапазона. Например, когда linscale == 1.0 (по умолчанию), пространство, используемое для положительной и отрицательной половин линейного диапазона, будет равно одной декаде в логарифмическом диапазоне.

Примечание

В настоящее время объекты Axes3D поддерживают только линейные масштабы. Другие масштабы могут или не могут работать, и поддержка их улучшается с каждым выпуском.

New in version 1.1.0: Эта функция была добавлена, но не протестирована. Пожалуйста, сообщите об ошибках.

set_zticklabels(*args, **kwargs) [source]

Установить метки делений оси Z. См. matplotlib.axes.Axes.set_yticklabels() для получения дополнительной информации.

Примечание

Дополнительные деления не поддерживаются объектами Axes3D.

New in version 1.1.0.

set_zticks(*args, **kwargs) [source]

Установить метки шкалы z. Подробнее см. matplotlib.axes.Axes.set_yticks().

Примечание

Меньшие метки не поддерживаются.

Добавлена в версии 1.1.0.

text(x, y, z, s, zdir=None, **kwargs) [source]

Добавить текст на график. Параметры kwargs будут переданы в Axes.text, за исключением параметра zdir, который устанавливает направление, используемое как направление z.

text2D(x, y, s, fontdict=None, withdash=False, **kwargs)

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

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

Параметры:	x, y : scalars Позиция для размещения текста. По умолчанию, в координатах данных. Система координат может быть изменена с помощью параметра transform. s : str Текст. fontdict : dictionary, optional, default: None Словарь для переопределения свойств текста по умолчанию. Если fontdict равен None, значения по умолчанию определяются вашими параметрами rc. withdash : boolean, optional, default: False Создаёт экземпляр TextWithDash вместо экземпляра Text.
Возвращает:	text : Text Созданный экземпляр Text.
Другие параметры:	**kwargs : Text properties. Другие параметры текста.

Примеры

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

>>> text(x, y, s, fontsize=12)

Преобразование по умолчанию указывает, что текст находится в координатах данных, альтернативно, вы можете указать текст в координатах осей (0,0 - нижний левый, 1,1 - верхний правый). Пример ниже размещает текст в центре осей:

>>> text(0.5, 0.5, 'matplotlib', horizontalalignment='center',
...      verticalalignment='center', transform=ax.transAxes)

Можно поместить прямоугольную рамку вокруг экземпляра текста (например, для установки цвета фона), используя ключевое слово bbox. bbox — это словарь свойств Rectangle. Например:

>>> text(x, y, s, bbox=dict(facecolor='red', alpha=0.5))

text3D(x, y, z, s, zdir=None, **kwargs)

Добавить текст на график. Параметры kwargs будут переданы в Axes.text, за исключением параметра zdir, который устанавливает направление, используемое как направление z.

tick_params(axis='both', **kwargs) [source]

Удобный метод для изменения внешнего вида меток и меток осей.

См. matplotlib.axes.Axes.tick_params() для более подробной документации.

Единственное отличие состоит в том, что установка axis в 'both' означает, что настройки применяются ко всем трём осям. Также параметр axis принимает значение 'z', что означает применение к оси z.

Кроме того, из-за того, как объекты Axes3D рисуются очень по-другому, чем обычные оси 2D, некоторые из этих настроек могут иметь неоднозначный смысл. Для простоты ось 'z' будет принимать настройки, как если бы она была похожа на ось 'y'.

Примечание

Хотя эта функция в настоящее время реализована, основная часть объекта Axes3D может игнорировать некоторые из этих настроек. В будущих выпусках это будет исправлено. Приоритет будет дан тем, кто подаст ошибки.

Новая в версии 1.1.0: Эта функция была добавлена, но не протестирована. Пожалуйста, сообщите о любых ошибках.

ticklabel_format(*, style='', scilimits=None, useOffset=None, axis='both') [source]

Удобный метод для управления ScalarFormatter, используемым по умолчанию для линейных осей в объектах Axed3D.

См. matplotlib.axes.Axes.ticklabel_format() для полной документации. Обратите внимание, что эта версия применяется ко всем трём осям объекта Axes3D. Следовательно, аргумент axis также принимает значение 'z', а значение 'both' применяется ко всем трём осям.

Новая в версии 1.1.0: Эта функция была добавлена, но не протестирована. Пожалуйста, сообщите о любых ошибках.

tricontour(*args, extend3d=False, stride=5, zdir='z', offset=None, **kwargs) [source]

Создать 3D контурный график.

Аргумент	Описание
X, Y,	Значения данных в виде numpy.массивов
Z
extend3d	Расширить контур в 3D (по умолчанию: False)
stride	Шаг (размер шага) для расширения контура
zdir	Направление для использования: x, y или z (по умолчанию)
offset	Если указано, нарисовать проекцию линий контура на этой позиции в плоскости, перпендикулярной zdir

Другие ключевые аргументы передаются в tricontour().

Возвращает contour.

Изменено в версии 1.3.0: Добавлена поддержка пользовательских триангуляций

ЭКСПЕРИМЕНТАЛЬНО: Этот метод в настоящее время выдает неправильный результат из-за давней ошибки в отображении 3D PolyCollection.

tricontourf(*args, zdir='z', offset=None, **kwargs) [source]

Создать 3D график контурных заполнений.

Аргумент	Описание
X, Y,	Значения данных в виде numpy.массивов
Z
zdir	Направление для использования: x, y или z (по умолчанию)
offset	Если указано, нарисовать проекцию линий контура на этой позиции в плоскости, перпендикулярной zdir

Другие ключевые аргументы передаются в tricontour().

Возвращает contour.

Изменено в версии 1.3.0: Добавлена поддержка пользовательских триангуляций

ЭКСПЕРИМЕНТАЛЬНО: Этот метод в настоящее время выдает неправильный результат из-за давней ошибки в отображении 3D PolyCollection.

tunit_cube(vals=None, M=None) [source]

tunit_edges(vals=None, M=None) [source]

unit_cube(vals=None) [source]

update_datalim(xys, **kwargs) [source]

Обновление bbox границ данных с последовательностью кортежей xy или эквивалентной 2-мерной матрицей.

view_init(elev=None, azim=None) [source]

Установите угол подъёма и азимут осей.

Это можно использовать для программной ротации осей.

«elev» хранит угол подъёма в плоскости z. «azim» хранит угол азимута в плоскости x,y.

Если elev или azim равны None (по умолчанию), используется начальное значение, заданное в конструкторе Axes3D.

voxels([x, y, z, ]/, filled, **kwargs) [source]

Отобразить набор заполненных объёмных элементов.

Все объёмные элементы отображаются как кубы 1x1x1 на оси, а заполненный[0,0,0] размещается с нижним углом в начале координат. Затенённые грани не отображаются.

Вызовы:

voxels(filled, facecolors=fc, edgecolors=ec, **kwargs)
voxels(x, y, z, filled, facecolors=fc, edgecolors=ec, **kwargs)

Введено в версии 2.1.

Параметры:

filled : 3D np.array of bool Трехмерный массив значений, где истинные значения указывают, какие объёмные элементы заполнить x, y, z : 3D np.array, optional Координаты углов объёмных элементов. Это должно соответствовать форме, на единицу большей в каждом измерении, чем форма filled. Эти значения можно использовать для отображения некубических объёмных элементов. Если не указано, по умолчанию используются увеличивающиеся целые числа вдоль каждой оси, такие как возвращаемые indices(). Как указано в / в сигнатуре функции, эти аргументы можно передать только позиционно. facecolors, edgecolors : array_like, optional Цвет для рисования граней и рёбер объёмных элементов. Может быть передан только в качестве ключевых аргументов. Этот параметр может быть: Единственное значение цвета для окраски всех объёмных элементов одним цветом. Это может быть строка или одномерный массив rgb/rgba None, по умолчанию, для использования одного цвета для граней и стили по умолчанию для рёбер. Трехмерный массив имён цветов, где каждый элемент — цвет соответствующего объёмного элемента. Размер должен совпадать с объёмными элементами. Четырехмерный массив данных rgb/rgba, с компонентами вдоль последней оси. **kwargs Дополнительные ключевые аргументы для передачи в Poly3DCollection()

Возвращаемое значение:

faces : dict Словарь, индексированный по координатам, где faces[i,j,k] — Poly3DCollection нарисованных граней для объёмного элемента filled[i,j,k]. Если для данного объёмного элемента не было нарисовано ни одной грани, либо потому, что его не просили нарисовать, либо он полностью скрыт, тогда (i,j,k) not in faces.

Примеры

(Исходный код, png, pdf)

(Исходный код, png, pdf)

(Исходный код, png, pdf)

(Исходный код, png, pdf)

zaxis_date(tz=None) [source]

Настраивает метки и деления оси z, обрабатывая данные z как даты.

tz — строка часового пояса или tzinfo-объект. По умолчанию используется значение rc.

Примечание

Эта функция предоставляется только для полноты картины. Объекты Axes3D официально не поддерживают даты для меток, и поэтому это может или не может работать как ожидается.

Введено в версии 1.1.0: Эта функция была добавлена, но не протестирована. Пожалуйста, сообщите о любых ошибках.

zaxis_inverted() [source]

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

Введено в версии 1.1.0: Эта функция была добавлена, но не протестирована. Пожалуйста, сообщите о любых ошибках.