mpl_toolkits.mplot3d.axes3d.Axes3D

class mpl_toolkits.mplot3d.axes3d.Axes3D(fig, rect=None, *args, **kwargs) [source]

Объект осей 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() для полного объяснения. Обратите внимание, что эта функция работает одинаково для всех трёх осей. Поэтому, 'z' можно передать для axis, а '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 ('x', 'y' или 'z'), при построении 2D набора.

Ключевые аргументы передаются в 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` Коллекция трёхмерных многоугольников, представляющих столбцы.

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, **kwargs) [source]

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

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

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

Возвращает contour

contour3D(X, Y, Z, *args, **kwargs)

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

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

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

Возвращает contour

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

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

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

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

Возвращает contourf

Изменено в версии 1.1.0: Добавлены ключевые аргументы zdir и offset.

contourf3D(X, Y, Z, *args, **kwargs)

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

Аргумент	Описание
X, Y,	Значения данных как массивы numpy.
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_axisbelow() [source]

Получить значение, указывающее, установлено ли свойство axisbelow.

Для объектов axes3d это всегда True

Добавлен в версии 1.1.0: Функция была добавлена для полноты.

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: Эта функция теперь правильно относится к пределам оси y в 3D.

get_zbound() [source]

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

lowerBound < upperBound

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

get_zlabel() [source]: Получить текст метки оси z.

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

get_zlim(): Получить пределы оси z в 3D.

get_zlim3d() [source]: Получить пределы оси z в 3D.

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.

margins(*args, **kw) [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. Параметр tight передаётся в autoscale_view(), который выполняется после изменения отступа; по умолчанию здесь стоит True, исходя из предположения, что при указании отступов обычно не требуется дополнительное заполнение для соответствия отметкам. Установка tight в None сохранит предыдущее значение.

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

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, **kwargs) [source]

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

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

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

plot3D(xs, ys, *args, **kwargs)

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

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

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

plot_surface(X, Y, Z, *args, **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. 'classic' режим использует значение по умолчанию `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`.

X, Y, Z : 2d arrays

Значения данных.

rcount, ccount : int

Максимальное число образцов, используемых в каждом направлении. Если входные данные больше, они будут уменьшены (путем среза) до этих значений. По умолчанию 50.

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

rstride, cstride : int

'classic' режим использует значение по умолчанию 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, **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: Эта функция построения была добавлена для версии 1.2.0.

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

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

Примечание

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

Параметры:

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

X, Y, Z : 2d arrays

Значения данных.

rcount, ccount : int

Максимальное число образцов в каждом направлении. Если входные данные больше, они будут уменьшены (путем среза) до этих значений. Установка значения count в ноль не приводит к выборке данных в соответствующем направлении, что приводит к 3D линии, а не к 3D каркасу. По умолчанию 50.

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

rstride, cstride : int

Шаг уменьшения выборки в каждом направлении. Эти аргументы взаимно исключают rcount и ccount. Если задан только один из аргументов rstride или cstride, другой устанавливается по умолчанию в 1. Установка значения stride в ноль не приводит к выборке данных в соответствующем направлении, что приводит к 3D линии, а не к 3D каркасу.

'classic' режим использует значение по умолчанию rstride = cstride = 1 вместо нового значения по умолчанию rcount = ccount = 50.

**kwargs :

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

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

Построение 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

quiver3D(*args, **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 может быть двумерным массивом, в котором строки являются 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 может быть двумерным массивом, в котором строки являются 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_axisbelow(b) [source]

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

Для объектов axes3d это значение игнорируется и используется True

Новое в версии 1.1.0: Эта функция добавлена для полноты.

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

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, представляющий заголовок
Другие параметры:	`**kwargs : Text properties` Другие ключевые параметры — это свойства текста, см. `Text` для списка допустимых свойств текста.

set_top_view() [source]

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

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

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

set_xlim3d(left=None, right=None, emit=True, auto=False, **kw) [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 Данная функция была добавлена, но не протестирована. Пожалуйста, сообщите о любых ошибках.

Примечания

Принимаются различные значения kwargs в зависимости от масштаба. Для получения дополнительной информации см. модуль scale.

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

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

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

set_ylim3d(bottom=None, top=None, emit=True, auto=False, **kw) [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 Данная функция была добавлена, но не протестирована. Пожалуйста, сообщите о любых ошибках.

Примечания

set_zbound(lower=None, upper=None) [source]: Установите нижнюю и верхнюю числовые границы оси Z. Этот метод будет учитывать инверсию осей независимо от порядка параметров. Он не изменит _autoscaleZon атрибут.

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

set_zlabel(zlabel, fontdict=None, labelpad=None, **kwargs) [source]: Установить zlabel. См. документацию set_ylabel() для описания.

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

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

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

set_zlim3d(bottom=None, top=None, emit=True, auto=False, **kw) [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: 'линейный' | 'логарифмический' | 'логит' | 'симлогит'

ПРИНИМАЕТ: ['линейный' | 'логарифмический' | 'логит' | 'симлогит']

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

'линейный'

'логарифмический'

basex/basey:

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

nonposx/nonposy: ['маска' | 'обрезать' ]

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

subsx/subsy:

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

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

'логит'

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

'симлогит'

basex/basey:

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

linthreshx/linthreshy:

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

subsx/subsy:

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

linscalex/linscaley:

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

Примечание

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

set_zticklabels(*args, **kwargs) [source]: Установить метки делений оси z. См. matplotlib.axes.Axes.set_yticklabels() для получения более подробной информации.

Примечание

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

Добавлено в версии 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]: Добавить текст к графику. Ключевые параметры будут переданы в 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): Добавить текст к графику. Ключевые параметры будут переданы в 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 может игнорировать некоторые из этих настроек. В будущих выпусках это будет исправлено. Приоритет будет отдан тем, кто сообщает об ошибках.

ticklabel_format(**kwargs) [source]

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

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

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

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

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

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

Возвращает contour

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

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

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

Создание 3D графика контурного заполнения.

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

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

Возвращает contour

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

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 данных lim с помощью последовательности кортежей 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 на оси, при этом filled[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` Цвет для рисования граней и ребер объемов. Может передаваться только как ключевые аргументы. Этот параметр может быть: Единичное значение цвета для окраски всех объемов в один цвет. Это может быть строка или 1-мерный массив rgb/rgba `None`, по умолчанию, использовать один цвет для граней и стандартный стиль для ребер. Трехмерный массив имен цветов, где каждый элемент — цвет соответствующего объема. Размер должен соответствовать объемам. Четырехмерный массив данных rgb/rgba, с компонентами по последней оси. **kwargs Дополнительные ключевые аргументы для передачи в `Poly3DCollection()`
Возвращает:	`faces : dict` Словарь, индексированный по координатам, где `faces[i,j,k]` — это `Poly3DCollection` нарисованных граней для объема `filled[i,j,k]`. Если для заданного объема не было нарисовано ни одной грани, либо потому что это не было запрошено, либо потому что он полностью закрыт, то `(i,j,k) not in faces`.

filled : 3D np.array of bool

Трехмерный массив значений, при этом значения с истинными значениями указывают на то, какие объемы заполнять

x, y, z : 3D np.array, optional

Координаты углов объемов. Это должно расширяться до формы, на единицу больше в каждом измерении, чем форма filled. Эти значения могут быть использованы для отображения объемов некубической формы.

Если не указано, по умолчанию используются возрастающие целые числа по каждой оси, такие как возвращаемые indices(). Как указано в / в подписи функции, эти аргументы можно передавать только позиционно.

facecolors, edgecolors : array_like, optional

Цвет для рисования граней и ребер объемов. Может передаваться только как ключевые аргументы. Этот параметр может быть:

Единичное значение цвета для окраски всех объемов в один цвет. Это может быть строка или 1-мерный массив 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: Эта функция была добавлена, но не протестирована. Пожалуйста, сообщите об ошибках.