mpl_toolkits.mplot3d.axes3d.Axes3D

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

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

add_collection3d(col, zs=0, zdir='z')

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

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

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

PolyCollection
LineCollection
PatchCollection

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

add_contourf_set(cset, zdir='z', offset=None)

auto_scale_xyz(X, Y, Z=None, had_data=None)

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

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

autoscale_view(tight=None, scalex=True, scaley=True, scalez=True): Автоматическое масштабирование пределов вида по пределам данных. Смотрите matplotlib.axes.Axes.autoscale_view() для документации. Обратите внимание, что эта функция применяется к 3D осям и добавляет scalez к аргументам функции.

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

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

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

Добавить 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)

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

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

Параметры:

Параметры:	x, y, z : массив-подобный объект Координаты точки привязки столбцов. dx, dy, dz : скаляр или массив-подобный объект Ширина, глубина и высота столбцов соответственно. color : последовательность допустимых цветовых спецификаций, необязательно Цвет столбцов может быть задан глобально или индивидуально. Этот параметр может быть: Одно значение цвета, чтобы окрасить все столбцы одним цветом. Массив цветов длиной N столбцов, чтобы окрасить каждый столбец независимо. Массив цветов длиной 6, чтобы раскрасить грани столбцов аналогично. Массив цветов длиной 6 * N столбцов, чтобы раскрасить каждую грань независимо. При окрашивании граней ящиков конкретно, порядок окраски такой: -Z (дно ящика) +Z (верх ящика) -Y +Y -X +X zsort : строка, необязательно Схема сортировки по оси z, переданная в `Poly3DCollection()` shade : bool, необязательно (по умолчанию = True) При значении True, это затемняет тёмные стороны столбцов (относительно источника света графика). Любые дополнительные ключевые аргументы передаются в :func:`~mpl_toolkits.mplot3d.art3d.Poly3DCollection`
Возвращает:	collection : Poly3DCollection Коллекция трёхмерных многоугольников, представляющих столбцы.

x, y, z : массив-подобный объект

Координаты точки привязки столбцов.

dx, dy, dz : скаляр или массив-подобный объект

Ширина, глубина и высота столбцов соответственно.

color : последовательность допустимых цветовых спецификаций, необязательно

Цвет столбцов может быть задан глобально или индивидуально. Этот параметр может быть:

Одно значение цвета, чтобы окрасить все столбцы одним цветом.
Массив цветов длиной N столбцов, чтобы окрасить каждый столбец независимо.
Массив цветов длиной 6, чтобы раскрасить грани столбцов аналогично.
Массив цветов длиной 6 * N столбцов, чтобы раскрасить каждую грань независимо.

При окрашивании граней ящиков конкретно, порядок окраски такой:

-Z (дно ящика)
+Z (верх ящика)
-Y
+Y
-X
+X

zsort : строка, необязательно

Схема сортировки по оси z, переданная в Poly3DCollection()

shade : bool, необязательно (по умолчанию = True)

При значении True, это затемняет тёмные стороны столбцов (относительно источника света графика).

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

:func:`~mpl_toolkits.mplot3d.art3d.Poly3DCollection`

Возвращает:

collection : Poly3DCollection

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

can_pan()

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

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

can_zoom()

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

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

cla(): Очистить ось

clabel(*args, **kwargs): Эта функция в настоящее время не реализована для 3D осей. Возвращает None.

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

Создать 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)

Создать 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): Для объектов в осях, если ось z поддерживает единицы, конвертировать z, используя тип единиц оси z

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

disable_mouse_rotation(): Отключить обработчики событий мыши.

draw(renderer)

format_coord(xd, yd): Учитывая 2D координаты просмотра, попробуйте угадать 3D координату. Ищет ближайшее ребро к точке и предполагает, что точка находится на той же высоте z, что и ближайшая точка на ребре.

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

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

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

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

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

get_axis_position()

get_axisbelow()

Получить, установлено ли значение axis below в True или нет.

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

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

get_children()

get_frame_on(): Получить, выводятся ли панели 3D осей

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

get_proj()

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

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

dist - расстояние от точки наблюдения глаза до точки объекта.

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

get_xlim()

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

Возвращает:

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

xlimits : кортеж

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

Примечания

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

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

get_xlim3d()

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

Возвращает:

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

xlimits : кортеж

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

Примечания

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

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

get_ylim()

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

Возвращает:

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

ylimits : кортеж

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

Примечания

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

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

get_ylim3d()

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

Возвращает:

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

ylimits : кортеж

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

Примечания

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

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

get_zbound()

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

lowerBound < upperBound

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

get_zlabel(): Получить текстовую строку метки z-оси.

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

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

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

get_zmajorticklabels(): Получить метки делений z-оси в виде списка объектов Text

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

get_zminorticklabels(): Получить метки делений z-оси в виде списка объектов Text

Примечание

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

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

get_zscale()

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

Примечание

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

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

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

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

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

Примечание

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

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

grid(b=True, **kwargs): Включение/выключение сетки в 3D.

Примечание

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

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

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

invert_zaxis(): Инвертировать z-ось.

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

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

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

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

margins(*args, **kw)

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

подписи::: 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 и добавляется к каждому концу этого интервала перед его использованием в автомасштабировании.

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

mouse_init(rotate_btn=1, zoom_btn=3)

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

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

name = '3d'

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

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

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

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

Аргументы rstride и cstride задают шаг, используемый для выборки входных данных для построения графика. Если передаются массивы 1k на 1k, значения по умолчанию для шагов приведут к построению сетки 100x100. Значение по умолчанию равно 10. Вызовет ValueError, если оба аргумента stride и count (см. следующий раздел) указаны.

Аргументы rcount и ccount заменяют rstride и cstride для метода выборки по умолчанию для построения поверхностных графиков. Эти аргументы определяют максимальное количество равноотстоящих выборок из входных данных для построения графика. Это метод выборки по умолчанию, если не используется стиль ‘classic’. Вызовет ValueError, если оба аргумента stride и count указаны. Добавлен в v2.0.0.

Аргумент	Описание
X, Y, Z	Значения данных в виде 2D массивов
rstride	Шаг строки массива
cstride	Шаг столбца массива
rcount	Использовать не более заданного количества строк, по умолчанию 50
ccount	Использовать не более заданного количества столбцов, по умолчанию 50
color	Цвет поверхностных элементов
cmap	Цветовая карта для поверхностных элементов
facecolors	Цвета граней отдельных элементов
norm	Экземпляр Normalize для сопоставления значений с цветами
vmin	Минимальное значение для сопоставления
vmax	Максимальное значение для сопоставления
shade	Определяет, следует ли затенять цвета граней

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

plot_trisurf(*args, **kwargs)

Аргумент	Описание
X, Y, Z	Значения данных в виде 1D массивов
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)

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

Аргументы rstride и cstride задают шаг выборки входных данных для построения графика. Если любой из них равен 0, входные данные в этом направлении не выбираются, что приводит к построению 3D линии, а не каркасного графика. Аргументы шага используются только по умолчанию, если выбран стиль ‘classic’. Теперь они заменены rcount и ccount. Вызовет ValueError, если оба аргумента stride и count указаны.

` The rcount and ccount kwargs supersedes rstride and

cstride для метода выборки по умолчанию для построения каркасного графика. Эти аргументы определяют максимальное количество равноотстоящих выборок из входных данных для построения графика. Это метод выборки по умолчанию, если не используется стиль ‘classic’. Вызовет ValueError, если оба аргумента stride и count указаны. Если любой из них равен нулю, то входные данные в этом направлении не выбираются, что приводит к построению 3D линии, а не каркасного графика. Добавлен в v2.0.0.

Аргумент	Описание
X, Y,	Значения данных в виде 2D массивов
Z
rstride	Шаг строки массива, по умолчанию 1
cstride	Шаг столбца массива, по умолчанию 1
rcount	Использовать не более заданного количества строк, по умолчанию 50
ccount	Использовать не более заданного количества столбцов, по умолчанию 50

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

Возвращает Line3DCollection

quiver(*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: [False | True]: Если 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: [False | True]: Если True, все стрелки будут иметь одинаковую длину. По умолчанию False, где длина стрелок будет разной, в зависимости от значений u, v, w.

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

scatter(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, указанных через kwargs (см. ниже). Обратите внимание, что 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, указанных через kwargs (см. ниже). Обратите внимание, что c не должен быть одночисленным числовым RGB или RGBA последовательностью, потому что это неразличимо от массива значений, подлежащих цветовому отображению. c может быть 2-мерным массивом, в котором строки являются RGB или RGBA, в том числе в случае одной строки для задания одного цвета для всех точек.
depthshade	Наличие или отсутствие затенения маркеров рассеяния для создания эффекта глубины. По умолчанию True.

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

Возвращает Patch3DCollection

set_autoscale_on(b)

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

принимает: [ True | False ]

set_autoscalez_on(b)

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

принимает: [ True | False ]

set_axis_off()

set_axis_on()

set_axisbelow(b)

Установить, будут ли метки осей и сетка сверху или снизу большинства элементов

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

ПРИНИМАЕТ: [ True | False ]

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

set_frame_on(b)

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

ПРИНИМАЕТ: [ True | False ]

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

set_proj_type(proj_type)

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

Параметры:

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

proj_type : str

Тип проекции, принимает ‘persp’ и ‘ortho’.

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

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

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

Параметры:

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

label : str

Текст для заголовка

fontdict : dict

Словарь, контролирующий внешний вид текста заголовка, по умолчанию fontdict это:

{'fontsize': rcParams['axes.titlesize'],
 'fontweight' : rcParams['axes.titleweight'],
 'verticalalignment': 'baseline',
 'horizontalalignment': loc}

loc : {‘center’, ‘left’, ‘right’}, str, optional

Какой заголовок установить, по умолчанию «center»

Возвращает:

text : Text

Экземпляр текста matplotlib, представляющий заголовок

Другие параметры:

**kwargs : Text свойства

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

set_top_view()

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

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

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

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

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

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

set_xscale(value, **kwargs)

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

Параметры:

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

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, **kw)

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

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

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

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

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

set_yscale(value, **kwargs)

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

Параметры:

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

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): Установить нижнюю и верхнюю числовые границы оси Z. Этот метод учитывает инверсию осей независимо от порядка параметров. Он не изменит _autoscaleZon атрибут.

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

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

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

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

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

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

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

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

set_zmargin(m)

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

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

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

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

set_zscale(value, **kwargs)

Установить масштаб оси 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:

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

linscalex/linscaley:

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

Примечание

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

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

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

Примечание

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

New in version 1.1.0.

set_zticks(*args, **kwargs): Установить позиции делений оси Z. См. matplotlib.axes.Axes.set_yticks() для более подробной информации.

Примечание

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

New in version 1.1.0.

text(x, y, z, s, zdir=None, **kwargs): Добавить текст на график. Параметры kwargs будут переданы в Axes.text, за исключением ключевого слова zdir, которое устанавливает направление, используемое как направление оси Z.

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

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

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

Параметры:

Параметры:	x, y : скаляры координаты данных s : строка текст fontdict : словарь, необязательно, по умолчанию: None Словарь для переопределения свойств текста. Если fontdict равен None, значения по умолчанию определяются параметрами rc. withdash : булево, необязательно, по умолчанию: False Создаёт экземпляр `TextWithDash` вместо экземпляра `Text`.
Другие параметры:
	**kwargs : `Text` свойства. Другие параметры текста.

x, y : скаляры

координаты данных

s : строка

текст

fontdict : словарь, необязательно, по умолчанию: None

Словарь для переопределения свойств текста. Если fontdict равен None, значения по умолчанию определяются параметрами rc.

withdash : булево, необязательно, по умолчанию: False

Создаёт экземпляр TextWithDash вместо экземпляра Text.

Другие параметры:

**kwargs : Text свойства.

Другие параметры текста.

Примеры

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

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

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

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

Единственное отличие состоит в том, что установка axis в ‘both’ означает, что настройки применяются ко всем трём осям. Кроме того, параметр axis также принимает значение ‘z’, которое будет означать применение только к оси z.

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

Примечание

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

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

ticklabel_format(**kwargs)

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

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

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

tricontour(*args, **kwargs)

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

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

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

Возвращает contour

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

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

tricontourf(*args, **kwargs)

Создать 3D контурный график с закрашенными областями.

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

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

Возвращает contour

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

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

tunit_cube(vals=None, M=None)

tunit_edges(vals=None, M=None)

unit_cube(vals=None)

update_datalim(xys, **kwargs)

view_init(elev=None, azim=None)

Установить углы возвышения и азимута оси.

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

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

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

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

Построение набора заполненных объёмных элементов

Все объёмные элементы отображаются как кубы 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.bool 3D массив значений, где истинное значение указывает, какие объёмные элементы заполнить x, y, z : 3D np.array, необязательно Координаты углов объёмных элементов. Это должно быть согласовано с формой, на одну позицию большей в каждом измерении, чем форма `filled`. Эти значения могут использоваться для построения объёмных элементов, не являющихся кубами. Если не указано, по умолчанию используется последовательность возрастающих целых чисел по каждой оси, как возвращаемые `indices()`. Как указано в `/` в сигнатуре функции, эти аргументы могут быть переданы только позиционно. facecolors, edgecolors : array_like, необязательно Цвет для рисования граней и рёбер объёмных элементов. Может передаваться только как ключевой аргумент. Этот параметр может быть: Одно значение цвета для окраски всех объёмных элементов одним цветом. Это может быть строка или 1D массив rgb/rgba `None`, по умолчанию, для использования одного цвета для граней и значения по умолчанию стиля для рёбер. 3D массив имён цветов, где каждый элемент - цвет соответствующего объёмного элемента. Размер должен соответствовать объёмным элементам. 4D массив данных rgb/rgba, с компонентами вдоль последней оси. **kwargs Дополнительные ключевые аргументы для передачи в `Poly3DCollection()`
Возвращаемое значение:	faces : dict Словарь, индексируемый по координатам, где `faces[i,j,k]` является `Poly3DCollection` нарисованных граней для объёмного элемента `filled[i,j,k]`. Если для данного объёмного элемента не было нарисовано граней, либо потому, что это не было запрошено, либо он полностью скрыт, тогда `(i,j,k) not in faces`.

filled : 3D массив np.bool

3D массив значений, где истинное значение указывает, какие объёмные элементы заполнить

x, y, z : 3D np.array, необязательно

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

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

facecolors, edgecolors : array_like, необязательно

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

Одно значение цвета для окраски всех объёмных элементов одним цветом. Это может быть строка или 1D массив rgb/rgba
None, по умолчанию, для использования одного цвета для граней и значения по умолчанию стиля для рёбер.
3D массив имён цветов, где каждый элемент - цвет соответствующего объёмного элемента. Размер должен соответствовать объёмным элементам.
4D массив данных 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)

Настройка меток и подписей оси z, которые обрабатывают данные z как даты.

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

Примечание

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

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

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

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