Spec-Zone.ru › Matplotlib 3.3

mpl_toolkits.mplot3d.axes3d.Axes3D

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

Bases: matplotlib.axes._axes.Axes

3D оси объекта.

Параметры:
figFigure

Родительская фигура.

rect(float, float, float, float)

Положение осей (left, bottom, width, height).

azimfloat, default: -60

Азимутальный угол обзора.

elevfloat, default: 30

Угол подъёма обзора.

sharezAxes3D, optional

Другие оси для совместного использования пределов z.

proj_type{'persp', 'ortho'}

Тип проекции, по умолчанию 'persp'.

**kwargs

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

Свойство Описание
adjustable {'box', 'datalim'}
agg_filter функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
alpha float или None
anchor 2-кортеж чисел с плавающей точкой или {'C', 'SW', 'S', 'SE', ...}
animated bool
aspect {'auto'}
autoscale_on bool
autoscalex_on bool
autoscaley_on bool
autoscalez_on bool
axes_locator Callable[[Axes, Renderer], Bbox]
axisbelow bool или 'line'
box_aspect 3-кортеж чисел с плавающей точкой или None
clip_box Bbox
clip_on bool
clip_path Patch или (Path, Transform) или None
contains неизвестно
facecolor или fc цвет
figure Figure
frame_on bool
gid строка
in_layout bool
label объект
navigate bool
navigate_mode неизвестно
path_effects AbstractPathEffect
picker None или bool или вызываемая функция
position [left, bottom, width, height] или Bbox
proj_type {'persp', 'ortho'}
prop_cycle неизвестно
rasterization_zorder float или None
rasterized bool или None
sketch_params (scale: float, length: float, randomness: float)
snap bool или None
title строка
transform Transform
url строка
visible bool
xbound неизвестно
xlabel строка
xlim3d или xlim неизвестно
xmargin число с плавающей точкой, большее чем -0.5
xscale {"linear"}
xticklabels неизвестно
xticks неизвестно
ybound неизвестно
ylabel строка
ylim3d или ylim неизвестно
ymargin число, большее -0,5
yscale {"линейный"}
yticklabels неизвестно
yticks неизвестно
zbound неизвестно
zlabel неизвестно
zlim3d или zlim неизвестно
zmargin неизвестно
zorder число с плавающей точкой
zscale {"линейный"}
zticklabels неизвестно
zticks неизвестно

Примечания

В версии 1.2.1: Параметр sharez.

__init__(self, fig, rect=None, *args, azim=- 60, elev=30, sharez=None, proj_type='persp', box_aspect=None, **kwargs) [source]
Параметры:
figFigure

Родительская фигура.

rect(float, float, float, float)

Положение оси (left, bottom, width, height).

azimfloat, default: -60

Угол азимута.

elevfloat, default: 30

Угол возвышения.

sharezAxes3D, optional

Другие оси, с которыми нужно совмещать пределы z.

proj_type{'persp', 'ortho'}

Тип проекции, по умолчанию 'persp'.

**kwargs

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

Свойство Описание
adjustable {'box', 'datalim'}
agg_filter функция фильтра, которая принимает массив с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
alpha число с плавающей точкой или None
anchor 2-кортеж чисел с плавающей точкой или {'C', 'SW', 'S', 'SE', ...}
animated логическое значение
aspect {'auto'}
autoscale_on логическое значение
autoscalex_on логическое значение
autoscaley_on логическое значение
autoscalez_on логическое значение
axes_locator Callable[[Axes, Renderer], Bbox]
axisbelow логическое значение или 'line'
box_aspect 3-кортеж чисел с плавающей точкой или None
clip_box Bbox
clip_on логическое значение
clip_path Объект Patch или (Path, Transform) или None
contains неизвестно
facecolor или fc цвет
figure Figure
frame_on логическое значение
gid строка
in_layout логическое значение
label объект
navigate логическое значение
navigate_mode неизвестно
path_effects AbstractPathEffect
picker None или логическое значение или вызываемая функция
position [левый, нижний, ширина, высота] или Bbox
proj_type {'persp', 'ortho'}
prop_cycle неизвестно
rasterization_zorder число с плавающей точкой или None
rasterized логическое значение или None
sketch_params (масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
snap логическое значение или None
title строка
transform Transform
url строка
visible логическое значение
xbound неизвестно
xlabel строка
xlim3d или xlim неизвестно
xmargin число с плавающей точкой больше -0.5
xscale {"линейный"}
xticklabels неизвестно
xticks неизвестно
ybound неизвестно
ylabel строка
ylim3d или ylim неизвестно
ymargin число, большее -0.5
yscale {"линейный"}
yticklabels неизвестно
yticks неизвестно
zbound неизвестно
zlabel неизвестно
zlim3d или zlim неизвестно
zmargin неизвестно
zorder число с плавающей точкой
zscale {"линейный"}
zticklabels неизвестно
zticks неизвестно

Примечания

Добавлено в версии 1.2.1: Параметр sharez.

__module__ = 'mpl_toolkits.mplot3d.axes3d'
add_collection3d(self, col, zs=0, zdir='z') [source]

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

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

Поддерживаются:
  • PolyCollection
  • LineCollection
  • PatchCollection
add_contour_set(self, cset, extend3d=False, stride=5, zdir='z', offset=None) [source]
add_contourf_set(self, cset, zdir='z', offset=None) [source]
apply_aspect(self, position=None) [source]

Настройка осей для заданного соотношения сторон данных.

В зависимости от get_adjustable это изменит либо рамку осей (позицию), либо пределы вида. В первом случае, get_anchor повлияет на позицию.

См. также

matplotlib.axes.Axes.set_aspect
Описание обработки соотношения сторон.
matplotlib.axes.Axes.set_adjustable
Укажите, как оси подстраиваются для достижения требуемого соотношения сторон.
matplotlib.axes.Axes.set_anchor
Задайте положение в случае дополнительного пространства.

Примечания

Это вызывается автоматически при отрисовке каждой оси. Возможно, вам нужно будет вызвать его самостоятельно, если вам нужно обновить положение осей и/или пределы вида перед отрисовкой Figure.

auto_scale_xyz(self, X, Y, Z=None, had_data=None) [source]
autoscale(self, enable=True, axis='both', tight=None) [source]

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

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

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

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

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

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

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

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

Параметры:
left1D array-like

Координаты x левых сторон столбцов.

height1D array-like

Высота столбцов.

zsfloat or 1D array-like

Координата Z столбцов; если указано одно значение, оно будет использоваться для всех столбцов.

zdir{'x', 'y', 'z'}, default: 'z'

При построении 2D данных, направление, которое нужно использовать как Z ('x', 'y' или 'z').

**kwargs

Другие аргументы передаются в matplotlib.axes.Axes.bar.
Возвращает:
mpl_toolkits.mplot3d.art3d.Patch3DCollection
bar3d(self, x, y, z, dx, dy, dz, color=None, zsort='average', shade=True, lightsource=None, *args, **kwargs) [source]

Построить трёхмерную гистограмму.

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

Параметры:
x, y, zarray-like

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

dx, dy, dzfloat or array-like

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

colorsequence of colors, optional

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

  • Один цвет для всех столбцов.
  • Массив цветов длиной N столбцов для индивидуальной раскраски каждого столбца.
  • Массив цветов длиной 6 для одинаковой раскраски граней столбцов.
  • Массив цветов длиной 6 * N столбцов для независимой раскраски каждой грани.

При индивидуальной раскраске граней порядок цветов следующий:

  1. -Z (дно ящика)
  2. +Z (верх ящика)
  3. -Y
  4. +Y
  5. -X
  6. +X
zsortstr, optional

Схема сортировки по оси Z, передаваемая в Poly3DCollection

shadebool, default: True

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

lightsourceLightSource

Источник света, используемый, когда shade равен True.

**kwargs

Все дополнительные ключевые аргументы передаются в Poly3DCollection.
Возвращает:
collectionPoly3DCollection

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

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

Трёхмерные объекты осей не используют кнопки панорамирования/масштабирования.

can_zoom(self) [source]

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

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

cla(self) [source]

Очистить текущие оси.

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

В настоящее время не реализовано для трёхмерных осей и возвращает None.

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

Создать трёхмерный график линий уровня.

Параметры:
X, Y, Zarray-like

Входные данные.

extend3dbool, default: False

Расширять ли линии уровня в 3D.

strideint

Шаг для расширения линий уровня.

zdir{'x', 'y', 'z'}, default: 'z'

Используемое направление.

offsetfloat, optional

Если указано, построить проекцию линий уровня в этом положении на плоскости, нормальной к zdir.

*args, **kwargs

Другие аргументы передаются в matplotlib.axes.Axes.contour.
Возвращает:
matplotlib.contour.QuadContourSet
contour3D(self, X, Y, Z, *args, extend3d=False, stride=5, zdir='z', offset=None, **kwargs)

Создать трёхмерный график линий уровня.

Параметры:
X, Y, Zarray-like

Входные данные.

extend3dbool, default: False

Расширять ли линии уровня в 3D.

strideint

Шаг для расширения линий уровня.

zdir{'x', 'y', 'z'}, default: 'z'

Используемое направление.

offsetfloat, optional

Если указано, построить проекцию линий уровня в этом положении на плоскости, нормальной к zdir.

*args, **kwargs

Другие аргументы передаются в matplotlib.axes.Axes.contour.
Возвращает:
matplotlib.contour.QuadContourSet
contourf(self, X, Y, Z, *args, zdir='z', offset=None, **kwargs) [source]

Создать трёхмерный закрашенный график линий уровня.

Параметры:
X, Y, Zarray-like

Входные данные.

zdir{'x', 'y', 'z'}, default: 'z'

Используемое направление.

offsetfloat, optional

Если указано, построить проекцию линий уровня в этом положении на плоскости, нормальной к zdir.

*args, **kwargs

Другие аргументы передаются в matplotlib.axes.Axes.contourf.
Возвращает:
matplotlib.contour.QuadContourSet

Примечания

Нововведение в версии 1.1.0: Параметры zdir и offset.

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

Создать трёхмерный закрашенный график линий уровня.

Параметры:
X, Y, Zarray-like

Входные данные.

zdir{'x', 'y', 'z'}, default: 'z'

Используемое направление.

offsetfloat, optional

Если указано, построить проекцию линий уровня в этом положении на плоскости, нормальной к zdir.

*args, **kwargs

Другие аргументы передаются в matplotlib.axes.Axes.contourf.
Возвращает:
matplotlib.contour.QuadContourSet

Примечания

Нововведение в версии 1.1.0: Параметры zdir и offset.

convert_zunits(self, z) [source]

Для графических элементов в осях, если ось z имеет поддержку единиц измерения, преобразовать z используя тип единиц измерения оси z

Нововведение в версии 1.2.1.

disable_mouse_rotation(self) [source]

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

draw(self, renderer) [source]

Нарисовать графический элемент (и его дочерние элементы) используя заданный рендерер.

Это не оказывает никакого эффекта, если графический элемент не видим (Artist.get_visible возвращает False).

Параметры:
rendererRendererBase subclass.

Примечания

Этот метод переопределён в подклассах Artist.

format_coord(self, xd, yd) [source]

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

format_zdata(self, z) [source]

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

get_autoscale_on(self) [source]

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

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

get_autoscalez_on(self) [source]

Получить значение, указывающее, применяется ли автоматическое масштабирование для оси z при выполнении команд построения графиков.

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

get_axis_position(self) [source]
get_frame_on(self) [source]

Получить значение, указывающее, отрисовываются ли панели 3D осей.

get_proj(self) [source]

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

get_tightbbox(self, renderer, call_axes_locator=True, bbox_extra_artists=None, *, for_layout_only=False) [source]

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

Элементы, которые имеют атрибут artist.set_in_layout(False), не включаются в прямоугольник.

Параметры:
rendererRendererBase subclass

Рендерер, который будет использован для отрисовки графиков (например, fig.canvas.get_renderer()).

bbox_extra_artistslist of Artist or None

Список элементов, которые нужно включить в минимальный охватывающий прямоугольник. Если None, тогда все дочерние элементы-элементы художников оси включаются в минимальный охватывающий прямоугольник.

call_axes_locatorbool, default: True

Если call_axes_locator равно False, он не вызывает атрибут _axes_locator, что необходимо для получения правильного прямоугольника. call_axes_locator=False может быть использован, если вызывающий код заинтересован только в относительном размере минимального охватывающего прямоугольника по сравнению с прямоугольником осей.

for_layout_onlydefault: False

Прямоугольник не будет включать в себя x-протяженность заголовка и подписи оси x, или y-протяженность подписи оси y.
Возвращаемое значение:
BboxBase

Прямоугольник минимального охватывающего контура в пиксельных координатах изображения.

См. также

matplotlib.axes.Axes.get_window_extent
matplotlib.axis.Axis.get_tightbbox
matplotlib.spines.Spine.get_window_extent
get_w_lims(self) [source]

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

get_xlim(self)

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

get_xlim3d(self) [source]

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

Возвращаемое значение:
left, right(float, float)

Текущие пределы оси x в координатах данных.

См. также

set_xlim
set_xbound, get_xbound
invert_xaxis, xaxis_inverted

Примечания

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

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

get_ylim(self)

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

get_ylim3d(self) [source]

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

Возвращаемое значение:
bottom, top(float, float)

Текущие пределы оси y в координатах данных.

См. также

set_ylim
set_ybound, get_ybound
invert_yaxis, yaxis_inverted

Примечания

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

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

get_zaxis(self) [source]

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

get_zbound(self) [source]

Возвращает нижнюю и верхнюю границы оси z в возрастающем порядке.

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

get_zgridlines(self)

Возвращает линии сетки оси z как список объектов Line2D.

get_zlabel(self) [source]

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

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

get_zlim(self)

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

get_zlim3d(self) [source]

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

get_zmajorticklabels(self)

Возвращает метки основных делений по оси z в виде списка объектов Text.

get_zminorticklabels(self)

Возвращает метки дополнительных делений по оси z в виде списка объектов Text.

get_zscale(self) [source]
get_zticklabels(self, minor=False, which=None)

Получить метки делений по оси z.

Параметры:
minorbool

Возвращать метки дополнительных или основных делений.

whichNone, ('minor', 'major', 'both')

Переопределяет параметр minor.

Выбирает, какие метки делений возвратить.
Возвращает:
list of Text

Примечания

Строки меток делений заполняются только после вызова draw метода.

См. также: draw и draw.

get_zticklines(self, minor=False)

Возвращает линии делений по оси z в виде списка объектов Line2D.

get_zticks(self, *, minor=False)

Возвращает расположение делений по оси z в координатах данных.

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

Включение/выключение 3D сетки.

Примечание

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

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

invert_zaxis(self) [source]

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

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

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

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

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

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

margins(self, *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(self, rotate_btn=1, zoom_btn=3) [source]

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

Параметры:
rotate_btnint or list of int, default: 1

Кнопка или кнопки мыши для вращения осей в 3D.

zoom_btnint or list of int, default: 3

Кнопка или кнопки мыши для масштабирования осей в 3D.
name = '3d'
plot(self, xs, ys, *args, zdir='z', **kwargs) [source]

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

Параметры:
xs1D array-like

Координаты x вершин.

ys1D array-like

Координаты y вершин.

zsfloat or 1D array-like

Координаты z вершин; либо одна для всех точек, либо одна для каждой точки.

zdir{'x', 'y', 'z'}, default: 'z'

При построении 2D данных, направление, которое использовать в качестве z ('x', 'y' или 'z').

**kwargs

Другие аргументы передаются в matplotlib.axes.Axes.plot.
plot3D(self, xs, ys, *args, zdir='z', **kwargs)

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

Параметры:
xs1D array-like

Координаты x вершин.

ys1D array-like

Координаты y вершин.

zsfloat or 1D array-like

Координаты z вершин; либо одна для всех точек, либо одна для каждой точки.

zdir{'x', 'y', 'z'}, default: 'z'

При построении 2D данных, направление, которое использовать в качестве z ('x', 'y' или 'z').

**kwargs

Другие аргументы передаются в matplotlib.axes.Axes.plot.
plot_surface(self, X, Y, Z, *args, norm=None, vmin=None, vmax=None, lightsource=None, **kwargs) [source]

Создать поверхность.

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

Примечание

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

Примечание

Для максимальной скорости отрисовки рекомендуется установить rstride и cstride в качестве делителей числа строк минус 1 и столбцов минус 1 соответственно. Например, при 51 строке rstride может быть любым делителем 50.

Аналогично, значение rstride и cstride, равное 1 (или rcount и ccount, равное числу строк и столбцов), может использовать оптимизированный путь.

Параметры:
X, Y, Z2d arrays

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

rcount, ccountint

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

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

rstride, cstrideint

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

Режим «classic» использует значение по умолчанию rstride = cstride = 10 вместо нового значения по умолчанию rcount = ccount = 50.

colorcolor-like

Цвет поверхностей.

cmapColormap

Цветовая карта поверхностей.

facecolorsarray-like of colors.

Цвета каждого отдельного элемента поверхности.

normNormalize

Нормализация для цветовой карты.

vmin, vmaxfloat

Границы для нормализации.

shadebool, default: True

Отображать ли затенение цвета граней. Затенение всегда отключено, когда задан cmap.

lightsourceLightSource

Источник света для использования, когда shade равно True.

**kwargs

Другие аргументы передаются методу Poly3DCollection.
plot_trisurf(self, *args, color=None, norm=None, vmin=None, vmax=None, lightsource=None, **kwargs) [source]

Построить поверхность по треугольной сетке.

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

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 — массив значений для контуров, по одному значению на точку в треугольной сетке.

Параметры:
X, Y, Zarray-like

Значения данных в виде одномерных массивов.

цвет

Цвет поверхностей.

cmap

Цветовая карта для поверхностей.

normNormalize

Экземпляр Normalize для сопоставления значений с цветами.

vmin, vmaxfloat, default: None

Минимальное и максимальное значение для сопоставления.

shadebool, default: True

Отображать ли затенение цвета граней. Затенение всегда отключено, когда задан cmap.

lightsourceLightSource

Источник света для использования, когда shade равно True.

**kwargs

Все остальные аргументы передаются методу Poly3DCollection

Примеры

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

../../_images/trisurf3d2.png

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

../../_images/trisurf3d_22.png

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

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

Построить 3D каркасную модель.

Примечание

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

Параметры:
X, Y, Z2d arrays

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

rcount, ccountint

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

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

rstride, cstrideint

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

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

**kwargs

Другие аргументы передаются методу Line3DCollection.
quiver(X, Y, Z, U, V, W, /, length=1, arrow_length_ratio=0.3, pivot='tail', normalize=False, **kwargs) [source]

Построить 3D поле векторов.

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

Параметры:
X, Y, Zarray-like

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

U, V, Warray-like

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

lengthfloat, default: 1

Длина каждого вектора.

arrow_length_ratiofloat, default: 0.3

Отношение длины головки стрелки к длине вектора.

pivot{'tail', 'middle', 'tip'}, default: 'tail'

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

normalizebool, default: False

Все векторы нормализуются к одинаковой длине или сохраняют длины, определённые с помощью u, v и w.

**kwargs

Дополнительные ключевые аргументы передаются методу LineCollection
quiver3D(X, Y, Z, U, V, W, /, length=1, arrow_length_ratio=0.3, pivot='tail', normalize=False, **kwargs)

Постройте 3D поле стрелок.

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

Параметры:
X, Y, Zarray-like

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

U, V, Warray-like

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

lengthfloat, default: 1

Длина каждой стрелки.

arrow_length_ratiofloat, default: 0.3

Соотношение головки стрелки к длине стрелки.

pivot{'tail', 'middle', 'tip'}, default: 'tail'

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

normalizebool, default: False

Нормализовать ли все стрелки до одинаковой длины или сохранить длины, определенные u, v и w.

**kwargs

Все дополнительные ключевые аргументы передаются в LineCollection
scatter(self, xs, ys, zs=0, zdir='z', s=20, c=None, depthshade=True, *args, **kwargs) [source]

Создайте диаграмму рассеяния.

Параметры:
xs, ysarray-like

Позиции данных.

zsfloat or array-like, default: 0

Позиции z. Либо массив той же длины, что и xs и ys, либо одно значение для размещения всех точек в одной плоскости.

zdir{'x', 'y', 'z', '-x', '-y', '-z'}, default: 'z'

Направление оси для zs. Это полезно при построении 2D данных на 3D осях. Данные должны быть переданы как xs, ys. Установка zdir в 'y' затем строит данные на x-z-плоскости.

См. также Построение 2D данных на 3D графике.

sfloat or array-like, default: 20

Размер маркера в пунктах**2. Либо массив той же длины, что и xs и ys, либо одно значение для задания размера всех маркеров одинаковым.

ccolor, sequence, or sequence of colors, optional

Цвет маркера. Возможные значения:

  • Единая строка формата цвета.
  • Последовательность цветов длиной n.
  • Последовательность n чисел, которые будут отображены в цвета с помощью cmap и norm.
  • 2-мерный массив, в котором строки — RGB или RGBA.

Для получения более подробной информации см. аргумент c в scatter.

depthshadebool, default: True

Тень для маркеров рассеяния для создания впечатления глубины. Каждый вызов scatter() выполнит свою теневую глубину независимо.

**kwargs

Все остальные аргументы передаются в scatter.
Возвращает:
pathsPathCollection
scatter3D(self, xs, ys, zs=0, zdir='z', s=20, c=None, depthshade=True, *args, **kwargs)

Создайте диаграмму рассеяния.

Параметры:
xs, ysarray-like

Позиции данных.

zsfloat or array-like, default: 0

Позиции z. Либо массив той же длины, что и xs и ys, либо одно значение для размещения всех точек в одной плоскости.

zdir{'x', 'y', 'z', '-x', '-y', '-z'}, default: 'z'

Направление оси для zs. Это полезно при построении 2D данных на 3D осях. Данные должны быть переданы как xs, ys. Установка zdir в 'y' затем строит данные на x-z-плоскости.

См. также Построение 2D данных на 3D графике.

sfloat or array-like, default: 20

Размер маркера в пунктах**2. Либо массив той же длины, что и xs и ys, либо одно значение для задания размера всех маркеров одинаковым.

ccolor, sequence, or sequence of colors, optional

Цвет маркера. Возможные значения:

  • Единая строка формата цвета.
  • Последовательность цветов длиной n.
  • Последовательность n чисел, которые будут отображены в цвета с помощью cmap и norm.
  • 2-мерный массив, в котором строки — RGB или RGBA.

Для получения более подробной информации см. аргумент c в scatter.

depthshadebool, default: True

Тень для маркеров рассеяния для создания впечатления глубины. Каждый вызов scatter() выполнит свою теневую глубину независимо.

**kwargs

Все остальные аргументы передаются в scatter.
Возвращает:
pathsPathCollection
set_anchor(self, anchor, share=False) [source]

Определить расположение якоря.

Фактическая область рисования (активное положение) осей может быть меньше, чем Bbox (исходное положение), когда требуется фиксированный аспект. Якорь определяет, где область рисования будет расположена в доступном пространстве.

Параметры:
anchor2-tuple of floats or {'C', 'SW', 'S', 'SE', ...}

Положение якоря может быть либо:

  • последовательность (cx, cy). cx и cy могут изменяться от 0 до 1, где 0 — слева или снизу, а 1 — справа или сверху.

  • строка с использованием аббревиатур сторон света:

    • 'C' для центрирования
    • 'S' (south) для нижнего центра
    • 'SW' (south west) для нижнего левого
    • и т.д.

    Вот обзор возможных положений:

    'NW' 'N' 'NE'
    'W' 'C' 'E'
    'SW' 'S' 'SE'
sharebool, default: False

Если True, применить настройки ко всем общим осям.

См. также

matplotlib.axes.Axes.set_aspect
для описания обработки аспектов.
set_aspect(self, aspect, adjustable=None, anchor=None, share=False) [source]

Установить соотношение сторон.

В настоящее время Axes 3D не поддерживает другие соотношения сторон, кроме 'auto', которое заполняет оси пределами данных.

Чтобы смоделировать равное соотношение сторон в пространстве данных, установите соотношение пределов ваших данных, чтобы оно соответствовало значению get_box_aspect. Для управления соотношением сторон области используйте set_box_aspect.

Параметры:
aspect{'auto'}

Возможные значения:

значение описание
'auto' автоматически; заполнить прямоугольник позиции пределами данных.
adjustableNone

В настоящее время игнорируется Axes3D

Если не None, это определяет, какой параметр будет скорректирован для соответствия требуемому соотношению сторон. См. set_adjustable для получения дополнительной информации.

anchorNone or str or 2-tuple of float, optional

Если не None, это определяет, где будут нарисованы оси, если есть дополнительное пространство из-за ограничений соотношения сторон. Наиболее распространённым способом задания якорной точки являются сокращения сторон света:

значение описание
'C' центрировано
'SW' левый нижний угол
'S' середина нижнего края
'SE' правый нижний угол
др.

См. set_anchor для получения дополнительной информации.

sharebool, default: False

Если True, применить настройки ко всем общим осям.

См. также

mpl_toolkits.mplot3d.axes3d.Axes3D.set_box_aspect
set_autoscale_on(self, b) [source]

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

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

Параметры:
bbool
set_autoscalez_on(self, b) [source]

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

Новое в версии 1.1.0.

Параметры:
bbool
set_axis_off(self) [source]

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

Это влияет на линии осей, деления, метки делений, сетку и подписи осей.

set_axis_on(self) [source]

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

Это влияет на линии осей, деления, метки делений, сетку и подписи осей.

set_box_aspect(self, aspect, *, zoom=1) [source]

Установить соотношение сторон области осей.

Соотношение сторон области — это отношение высоты к ширине в единицах отображения для каждой грани области, когда она рассматривается перпендикулярно этой грани. Это не следует путать с соотношением сторон данных (для Axes3D оно всегда равно 'auto'). Значения по умолчанию — 4:4:3 (x:y:z).

Чтобы смоделировать равное соотношение сторон в пространстве данных, установите соотношение сторон области, чтобы оно соответствовало диапазону данных в каждом измерении.

zoom управляет общим размером Axes3D на рисунке.

Параметры:
aspect3-tuple of floats or None

Изменяет физические размеры Axes3D таким образом, что отношение длин осей в единицах отображения равно x:y:z.

Если None, используется значение по умолчанию 4:4:3

zoomfloat

Управляет общим размером Axes3D на рисунке.
set_frame_on(self, b) [source]

Установить, выводятся ли панели 3D осей.

Параметры:
bbool
set_proj_type(self, proj_type) [source]

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

Параметры:
proj_type{'persp', 'ortho'}
set_title(self, label, fontdict=None, loc='center', **kwargs) [source]

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

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

Параметры:
labelstr

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

fontdictdict

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

{'fontsize': rcParams['axes.titlesize'],
 'fontweight': rcParams['axes.titleweight'],
 'color': rcParams['axes.titlecolor'],
 'verticalalignment': 'baseline',
 'horizontalalignment': loc}
loc{'center', 'left', 'right'}, default: rcParams["axes.titlelocation"] (default: 'center')

Какой заголовок установить.

yfloat, default: rcParams["axes.titley"] (default: None)

Вертикальное положение заголовка (1.0 — верхнее положение). Если None (значение по умолчанию), y определяется автоматически, чтобы избежать наложения заголовков на оси.

padfloat, default: rcParams["axes.titlepad"] (default: 6.0)

Смещение заголовка от верхней части осей в пунктах.
Возвращает:
Text

Экземпляр matplotlib text, представляющий заголовок
Другие параметры:
**kwargsText properties

Другие ключевые аргументы — свойства текста; см. Text для списка допустимых свойств текста.
set_top_view(self) [source]
set_xlim(self, left=None, right=None, emit=True, auto=False, *, xmin=None, xmax=None)

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

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

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

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

set_xscale(self, value, **kwargs) [source]

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

Параметры:
value{"linear"}

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

**kwargs

Ключевые аргументы номинально передаются в класс масштаба, но ни один из них не применим для линейных масштабов.
set_ylim(self, bottom=None, top=None, emit=True, auto=False, *, ymin=None, ymax=None)

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

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

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

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

set_yscale(self, value, **kwargs) [source]

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

Параметры:
value{"linear"}

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

**kwargs

Ключевые аргументы номинально передаются в класс масштаба, но ни один из них не применим для линейных масштабов.
set_zbound(self, lower=None, upper=None) [source]

Установить нижнюю и верхнюю числовые границы оси Z.

Этот метод будет учитывать инверсию осей независимо от порядка параметров. Он не изменит настройку автоматического масштабирования (get_autoscalez_on()).

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

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

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

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

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

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

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

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

set_zmargin(self, m) [source]

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

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

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

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

set_zscale(self, value, **kwargs) [source]

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

Параметры:
value{"linear"}

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

**kwargs

Ключевые аргументы номинально передаются в класс масштаба, но ни один из них не применим для линейных масштабов.
set_zticklabels(self, labels, *, fontdict=None, minor=False, **kwargs)

Установить метки оси Z с помощью списка строковых меток.

Предупреждение

Этот метод следует использовать только после корректировки позиций делений с помощью Axes3D.set_zticks. В противном случае метки могут оказаться в неожиданных позициях.

Параметры:
labelslist of str

Тексты меток.

fontdictdict, optional

Словарь, контролирующий внешний вид меток делений. По умолчанию fontdict:

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

Устанавливать ли метки вспомогательных делений, а не основных?
Возвращает:
list of Text

Метки.
Другие параметры:
**kwargsText properties.
set_zticks(self, ticks, *, minor=False)

Установить позиции делений на оси Z.

Параметры:
tickslist of floats

Список позиций делений.

minorbool, default: False

Если False, устанавливаются основные деления; если True, вспомогательные деления.
text(self, x, y, z, s, zdir=None, **kwargs) [source]

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

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

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

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

Параметры:
x, yfloat

Позиция для размещения текста. По умолчанию, в координатах данных. Система координат может быть изменена с помощью параметра transform.

sstr

Текст.

fontdictdict, default: None

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

Созданный экземпляр Text.
Другие параметры:
**kwargsText properties.

Прочие различные параметры текста.

Свойство Описание
agg_filter функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, а возвращает массив (m, n, 3)
alpha float или None
animated bool
backgroundcolor цвет
bbox словарь с свойствами для patches.FancyBboxPatch
clip_box Bbox
clip_on bool
clip_path Объект Patch или (Path, Transform) или None
color или c цвет
contains неизвестно
figure Figure
fontfamily или family {имя_шрифта, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontproperties или font или font_properties font_manager.FontProperties или str или pathlib.Path
fontsize или size float или {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretch или stretch {числовое значение в диапазоне 0-1000, 'ultra-condensed', 'extra-condensed', 'condensed', 'semi-condensed', 'normal', 'semi-expanded', 'expanded', 'extra-expanded', 'ultra-expanded'}
fontstyle или style {'normal', 'italic', 'oblique'}
fontvariant или variant {'normal', 'small-caps'}
fontweight или weight {числовое значение в диапазоне 0-1000, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'bold', 'heavy', 'extra bold', 'black'}
gid str
horizontalalignment или ha {'center', 'right', 'left'}
in_layout bool
label объект
linespacing float (кратное размеру шрифта)
multialignment или ma {'left', 'right', 'center'}
path_effects AbstractPathEffect
picker None или bool или вызываемая функция
position (float, float)
rasterized bool или None
rotation float или {'vertical', 'horizontal'}
rotation_mode {None, 'default', 'anchor'}
sketch_params (scale: float, length: float, randomness: float)
snap bool или None
text объект
transform Transform
url строка
usetex bool или None
verticalalignment или va {'center', 'top', 'bottom', 'baseline', 'center_baseline'}
visible bool
wrap bool
x float
y float
zorder float

Примеры

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

>>> 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(self, x, y, z, s, zdir=None, **kwargs)

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

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

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

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

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

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

Примечание

В настоящее время Axes3D игнорирует некоторые из этих настроек.

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

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

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

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

Примечание

В настоящее время этот метод генерирует некорректный вывод из-за давней ошибки в отрисовке 3D PolyCollection.

Параметры:
X, Y, Zarray-like

Входные данные.

extend3dbool, default: False

Расширять ли контур в 3D.

strideint

Шаг для расширения контура.

zdir{'x', 'y', 'z'}, default: 'z'

Направление для использования.

offsetfloat, optional

Если указано, нарисовать проекцию линий контура в этой позиции в плоскости, перпендикулярной zdir.

*args, **kwargs

Другие аргументы передаются в matplotlib.axes.Axes.tricontour.
Возвращает:
matplotlib.tri.tricontour.TriContourSet
tricontourf(self, *args, zdir='z', offset=None, **kwargs) [source]

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

Примечание

В настоящее время этот метод генерирует некорректный вывод из-за давней ошибки в отрисовке 3D PolyCollection.

Параметры:
X, Y, Zarray-like

Входные данные.

zdir{'x', 'y', 'z'}, default: 'z'

Направление для использования.

offsetfloat, optional

Если указано, нарисовать проекцию линий контура в этой позиции в плоскости, перпендикулярной zdir.

*args, **kwargs

Другие аргументы передаются в matplotlib.axes.Axes.tricontourf.
Возвращает:
matplotlib.tri.tricontour.TriContourSet

Примечания

Введено в версии 1.1.0: Параметры zdir и offset.

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

tunit_cube(self, vals=None, M=None) [source]
tunit_edges(self, vals=None, M=None) [source]
unit_cube(self, vals=None) [source]
update_datalim(self, xys, **kwargs) [source]

Расширить dataLim Bbox, чтобы он включал заданные точки.

Если в настоящее время данные не заданы, Bbox проигнорирует свои пределы и установит границу в соответствии с границами xydata (xys). В противном случае он вычислит границы объединения текущих данных и данных в xys.

Параметры:
xys2D array-like

Точки для включения в границы данных Bbox. Это может быть либо список кортежей (x, y), либо массив Nx2.

updatex, updateybool, default: True

Обновлять ли пределы x/y.
view_init(self, elev=None, azim=None) [source]

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

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

'elev' хранит угол подъёма в плоскости z (в градусах). 'azim' хранит азимутальный угол в плоскости (x, y) (в градусах).

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

voxels([x, y, z, ]/, filled, facecolors=None, edgecolors=None, **kwargs) [source]

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

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

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

Параметры:
filled3D np.array of bool

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

x, y, z3D np.array, optional

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

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

facecolors, edgecolorsarray-like, optional

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

  • Одиночное значение цвета, для раскраски всех объёмов одним цветом. Это может быть строка или одномерный массив rgb/rgba
  • None, по умолчанию, для использования одного цвета для граней и значения по умолчанию для рёбер.
  • Трехмерный массив имён цветов, где каждый элемент — цвет соответствующего объёма. Размер должен соответствовать объёмам.
  • Четырехмерный массив данных rgb/rgba, с компонентами вдоль последней оси.
shadebool, default: True

Использовать ли затенение facecolors. Затенение всегда отключено, когда указан cmap.

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

lightsourceLightSource

Источник света для использования, когда shade равно True.

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

**kwargs

Дополнительные ключевые аргументы для передачи Poly3DCollection.
Возвращает:
facesdict

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

Примеры

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

../../_images/voxels.png

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

../../_images/voxels_rgb.png

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

../../_images/voxels_torus.png

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

../../_images/voxels_numpy_logo.png
property w_xaxis
property w_yaxis
property w_zaxis
zaxis_date(self, tz=None)

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

Параметры:
tzstr or datetime.tzinfo, default: rcParams["timezone"] (default: 'UTC')

Временная зона, используемая для создания меток дат.
zaxis_inverted(self) [source]

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

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

Примеры использования mpl_toolkits.mplot3d.axes3d.Axes3D

© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.3.3/api/_as_gen/mpl_toolkits.mplot3d.axes3d.Axes3D.html

Spec-Zone.ru

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