mpl_toolkits.mplot3d.axes3d.Axes3D

classmpl_toolkits.mplot3d.axes3d.Axes3D(fig, rect=None, *args, elev=30, azim=-60, roll=0, sharez=None, proj_type='persp', box_aspect=None, computed_zorder=True, focal_length=None, **kwargs)[source]

Bases: Axes

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

Parameters:

figFigure

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

recttuple (left, bottom, width, height), default: None.

Положение осей.

elevfloat, default: 30

Угол подъёма в градусах, вращает камеру над и под плоскостью x-y, положительный угол соответствует расположению над плоскостью.

azimfloat, default: -60

Азимутальный угол в градусах вращает камеру вокруг оси z, положительный угол соответствует вращению по часовой стрелке. Другими словами, положительный азимут вращает камеру вокруг начала координат от её положения вдоль оси +x к оси +y.

rollfloat, default: 0

Угол поворота в градусах вращает камеру вокруг оси обзора. Положительный угол вращает камеру по часовой стрелке, что вызывает вращение сцены против часовой стрелки.

sharezAxes3D, optional

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

proj_type{'persp', 'ortho'}

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

box_aspect3-tuple of floats, default: None

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

computed_zorderbool, default: True

Если True, порядок отрисовки вычисляется на основе среднего положения Artist вдоль направления обзора. Установите в значение False, если вы хотите вручную управлять порядком, в котором элементы отрисовываются поверх друг друга, используя свойство zorder. Это можно использовать для тонкой настройки, если автоматический порядок не даёт желаемого результата. Обратите внимание, что ручной порядок zorder будет верным только для ограниченного угла обзора. Если пользователь повернёт фигуру, она будет выглядеть неправильно под определёнными углами.

auto_add_to_figurebool, default: False

До Matplotlib 3.4 Axes3D добавляли себя к родительской Figure при инициализации. Другие классы Axes так не делают.

Это поведение устарело в 3.4, по умолчанию установлено в False в 3.6. Ключевое слово не будет документировано, а значение отличное от False будет ошибкой в 3.7.

focal_lengthfloat, default: None

Для типа проекции 'persp', фокусное расстояние виртуальной камеры. Должно быть > 0. Если None, по умолчанию 1. Для типа проекции 'ortho', должно быть установлено либо None, либо бесконечность (numpy.inf). Если None, по умолчанию бесконечность. Фокусное расстояние можно вычислить из желаемого поля зрения по формуле: focal_length = 1/tan(FOV/2)

**kwargs

END_OF_DOCUMENT_MARKER

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

Свойство	Описание
`adjustable`	{'box', 'datalim'}
`agg_filter`	функция фильтра, которая принимает массив чисел с плавающей точкой размера (m, n, 3) и значение dpi, и возвращает массив чисел с плавающей точкой размера (m, n, 3) и два смещения от нижнего левого угла изображения
`alpha`	скаляр или None
`anchor`	(число, число) или {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
`animated`	логическое значение
`aspect`	{'auto', 'equal', 'equalxy', 'equalxz', 'equalyz'}
`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
`facecolor` или fc	цвет
`figure`	`Figure`
`frame_on`	логическое значение
`gid`	строка
`in_layout`	логическое значение
`label`	объект
`mouseover`	логическое значение
`navigate`	логическое значение
`navigate_mode`	неизвестно
`path_effects`	`AbstractPathEffect`
`picker`	None или логическое значение или число с плавающей точкой или вызываемая функция
`position`	[слева, снизу, ширина, высота] или `Bbox`
`proj_type`	{'persp', 'ortho'}
`prop_cycle`	неизвестно
`rasterization_zorder`	число с плавающей точкой или None
`rasterized`	логическое значение
`sketch_params`	(масштаб: число, длина: число, случайность: число)
`snap`	логическое значение или None
`title`	неизвестно
`transform`	`Transform`
`url`	строка
`visible`	логическое значение
`xbound`	неизвестно
`xlabel`	строка
`xlim` или xlim3d	(нижняя граница: число, верхняя граница: число)
`xlim3d`	(нижняя граница: число, верхняя граница: число)
`xmargin`	число больше -0.5
`xscale`	неизвестно

`xticklabels`	неизвестно
`xticks`	неизвестно
`ybound`	неизвестно
`ylabel`	str
`ylim` или ylim3d	(нижняя граница: float, верхняя граница: float)
`ylim3d`	(нижняя граница: float, верхняя граница: float)
`ymargin`	float больше -0.5
`yscale`	неизвестно
`yticklabels`	неизвестно
`yticks`	неизвестно
`zbound`	неизвестно
`zlabel`	неизвестно
`zlim` или zlim3d	неизвестно
`zmargin`	float больше -0.5
`zorder`	float
`zscale`	неизвестно
`zticklabels`	неизвестно
`zticks`	неизвестно

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]

apply_aspect(position=None)[source]

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

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

Параметры:

positionNone или .Bbox: Если не None, это определяет положение осей внутри фигуры как Bbox. См. get_position для получения дополнительных сведений.

См. также

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

Примечания

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

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

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

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

См. Axes.autoscale для полной документации. Поскольку эта функция применяется к 3D-осям, axis также может быть установлен на 'z', а установка axis на 'both' масштабирует все три оси.

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

Автомасштабирование пределов просмотра с использованием пределов данных.

См. Axes.autoscale_view для полного описания. Поскольку эта функция применяется к осям 3D, она также принимает аргумент scalez.

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

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

Параметры:

leftОдномерный массив-подобный объект: Координаты x левых границ столбцов.
heightОдномерный массив-подобный объект: Высота столбцов.
zsЧисло или одномерный массив-подобный объект: Координата z столбцов; если указано единственное значение, оно используется для всех столбцов.
zdir{'x', 'y', 'z'}, по умолчанию: 'z': При построении 2D данных, направление для использования как z ('x', 'y' или 'z').
dataиндексируемый объект, необязательно: Если указан, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение).
**kwargs: Другие аргументы передаются в matplotlib.axes.Axes.bar.

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

mpl_toolkits.mplot3d.art3d.Patch3DCollection

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

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

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

Параметры:

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

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

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

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

colorпоследовательность цветов, необязательно

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

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

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

-Z (нижняя часть ящика)
+Z (верхняя часть ящика)
-Y
+Y
-X
+X

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

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

shadeбулево, по умолчанию: True

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

lightsourceLightSource

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

dataиндексируемый объект, необязательно

Если указан, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение).

**kwargs

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

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

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

can_pan()[source]

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

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

can_zoom()[source]

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

Объекты Axes3D не используют функцию масштабирования прямоугольником.

clabel(*args, **kwargs)[source]: В настоящее время не реализовано для осей 3D и возвращает None.

clear()[source]: Очистить ось.

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

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

Параметры:

X, Y, Zмассив-подобные значения,: Входные данные. См. Axes.contour для поддерживаемых форм данных.
extend3dbool, по умолчанию: False: Расширить контур в 3D.
strideцелое число: Шаг для расширения контура.
zdir{'x', 'y', 'z'}, по умолчанию: 'z': Направление для использования.
offsetчисло с плавающей точкой, необязательно: Если указано, отобразить проекцию линий контура в этой позиции в плоскости, перпендикулярной zdir.
dataиндексируемый объект, необязательно: Если задано, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение).
*args, **kwargs: Другие аргументы передаются в matplotlib.axes.Axes.contour.

Возвращает:

matplotlib.contour.QuadContourSet

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

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

Параметры:

X, Y, Zмассив-подобные значения,: Входные данные. См. Axes.contour для поддерживаемых форм данных.
extend3dbool, по умолчанию: False: Расширить контур в 3D.
strideцелое число: Шаг для расширения контура.
zdir{'x', 'y', 'z'}, по умолчанию: 'z': Направление для использования.
offsetчисло с плавающей точкой, необязательно: Если указано, отобразить проекцию линий контура в этой позиции в плоскости, перпендикулярной zdir.
dataиндексируемый объект, необязательно: Если задано, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение).
*args, **kwargs: Другие аргументы передаются в matplotlib.axes.Axes.contour.

Возвращает:

matplotlib.contour.QuadContourSet

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

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

Параметры:

X, Y, Zмассив-подобные значения: Входные данные. См. Axes.contourf для поддерживаемых форм данных.
zdir{'x', 'y', 'z'}, по умолчанию: 'z': Направление для использования.
offsetчисло с плавающей точкой, необязательно: Если указано, отобразить проекцию линий контура в этой позиции в плоскости, перпендикулярной zdir.
dataиндексируемый объект, необязательно: Если задано, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение).
*args, **kwargs: Другие аргументы передаются в matplotlib.axes.Axes.contourf.

Возвращает:

matplotlib.contour.QuadContourSet

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

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

Параметры:

X, Y, Zмассив-подобные значения: Входные данные. См. Axes.contourf для поддерживаемых форм данных.
zdir{'x', 'y', 'z'}, по умолчанию: 'z': Направление для использования.
offsetчисло с плавающей точкой, необязательно: Если указано, отобразить проекцию линий контура в этой позиции в плоскости, перпендикулярной zdir.
dataиндексируемый объект, необязательно: Если задано, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение).
*args, **kwargs: Другие аргументы передаются в matplotlib.axes.Axes.contourf.

Возвращает:

matplotlib.contour.QuadContourSet

convert_zunits(z)[source]: Для элементов на оси, если ось z поддерживает единицы измерения, преобразовать z, используя тип единиц оси z

disable_mouse_rotation()[source]: Отключить вращение и масштабирование мышью для 3D отображения.

propertydist[source]

draw(renderer)[source]

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

Это не имеет эффекта, если элемент не отображается (Artist.get_visible возвращает False).

Параметры:

rendererRendererBase подкласс.

Примечания

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

errorbar(x, y, z, zerr=None, yerr=None, xerr=None, fmt='', barsabove=False, errorevery=1, ecolor=None, elinewidth=None, capsize=None, capthick=None, xlolims=False, xuplims=False, ylolims=False, yuplims=False, zlolims=False, zuplims=False, *, data=None, **kwargs)[source]

Строит линии и/или маркеры с областями погрешности вокруг них.

x/y/z определяют положение данных, а xerr/yerr/zerr определяют размеры областей погрешности. По умолчанию это рисует маркеры/линии данных, а также области погрешности. Используйте fmt='none', чтобы нарисовать только области погрешности.

Параметры:

x, y, zfloat или array-like

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

xerr, yerr, zerrfloat или array-like, форма (N,) или (2, N), необязательно

Размеры областей погрешности:

скаляр: Симметричные значения +/- для всех точек данных.
форма (N,): Симметричные значения +/- для каждой точки данных.
форма (2, N): Отдельные значения - и + для каждой области. Первый ряд содержит нижние погрешности, второй ряд содержит верхние погрешности.
None: Без области погрешности.

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

fmtстрока, по умолчанию: ''

Формат для точек данных / линий данных. Подробности см. в plot.

Используйте 'none' (регистронезависимо), чтобы нарисовать области погрешности без маркеров данных.

ecolorцвет, по умолчанию: None

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

elinewidthfloat, по умолчанию: None

Толщина линий области погрешности. Если None, используется толщина линии текущего стиля.

capsizefloat, по умолчанию: rcParams["errorbar.capsize"] (по умолчанию: 0.0)

Длина колпачков области погрешности в пунктах.

capthickfloat, по умолчанию: None

Псевдоним для параметра markeredgewidth (также mew). Эта настройка — более понятное имя для свойства, которое управляет толщиной колпачка области погрешности в пунктах. Для обратной совместимости, если заданы mew или markeredgewidth, они будут переопределять capthick. Это может измениться в будущих версиях.

barsabovebool, по умолчанию: False

Если True, строит области погрешности над символами графика. По умолчанию — под.

xlolims, ylolims, zlolimsbool, по умолчанию: False

Эти параметры могут использоваться для указания того, что значение задаёт только нижнюю границу. В этом случае используется символ каретки для указания этого. lims-аргументы могут быть скалярами или массивоподобными объектами той же длины, что и погрешности. Чтобы использовать ограничения с инвертированными осями, необходимо вызвать set_xlim или set_ylim до errorbar. Обратите внимание на сложные имена параметров: например, установка ylolims в True означает, что значение y является нижней границей истинного значения, поэтому будет нарисована только стрелка, направленная вверх!

xuplims, yuplims, zuplimsbool, по умолчанию: False

Аналогично выше, но для управления верхними границами.

erroreveryint или (int, int), по умолчанию: 1

рисует области погрешности для подмножества данных. errorevery =N рисует области погрешности для точек (x[::N], y[::N], z[::N]). errorevery =(start, N) рисует области погрешности для точек (x[start::N], y[start::N], z[start::N]). Например, errorevery=(6, 3) добавляет области погрешности к данным в (x[6], x[9], x[12], x[15], ...). Используется для предотвращения перекрытия областей погрешности, когда две серии данных имеют одинаковые значения на оси x.

Возвращает:

errlinesсписок: Список экземпляров Line3DCollection каждый содержащий линию области погрешности.
caplinesсписок: Список экземпляров Line3D каждый содержащий объект колпачка.
limmarksсписок: Список экземпляров Line3D каждый содержащий маркер с верхней или нижней границей.

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

dataиндексируемый объект, необязательно

Если задано, следующие параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение):

x, y, z, xerr, yerr, zerr

**kwargs

Все остальные ключевые параметры для форматирования линий области погрешности передаются Line3DCollection.

Примеры

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

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

format_zdata(z)[source]: Форматирует строковое представление z. Эта функция будет использовать атрибут fmt_zdata если он является вызываемым, иначе вернётся к форматированию z-оси.

get_autoscalez_on()[source]: Возвращает значение, определяющее, включена ли автоматическая шкала z-оси.

get_axis_position()[source]

get_frame_on()[source]: Получить, отображаются ли панели 3D осей.

get_proj()[source]: Создать матрицу проекции из текущей точки обзора.

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

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

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

Параметры:

rendererRendererBase подкласс: рендерер, который будет использован для отрисовки графиков (т.е. fig.canvas.get_renderer())
bbox_extra_artistsсписок Artist или None: Список элементов для включения в ограничительную рамку. Если None (по умолчанию), то все дочерние элементы Axes включаются в ограничительную рамку.
call_axes_locatorbool, по умолчанию: True: Если call_axes_locator False, оно не вызывает атрибут _axes_locator, который необходим для получения правильной ограничительнй рамки. call_axes_locator=False может быть использован, если вызывающий элемент заинтересован только в относительном размере tightbbox по сравнению с ограничительной рамкой Axes.
for_layout_onlyпо умолчанию: 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()[source]: Получить 3D границы мира.

get_xlim()[source]

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

Возвращает:

left, right(float, float): Текущие пределы оси x в координатах данных.

См. также

Axes.set_xlim
set_xbound, get_xbound
invert_xaxis, xaxis_inverted

Примечания

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

get_xlim3d()[source]: Псевдоним для get_xlim.

get_ylim()[source]

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

Возвращает:

bottom, top(float, float): Текущие пределы оси y в координатах данных.

См. также

Axes.set_ylim
set_ybound, get_ybound
invert_yaxis, yaxis_inverted

Примечания

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

get_ylim3d()[source]: Псевдоним для get_ylim.

get_zaxis()[source]: Возвращает объект ZAxis (Axis).

get_zbound()[source]: Возвращает нижнюю и верхнюю границы оси z, в порядке возрастания.

get_zgridlines()[source]: Возвращает линии сетки оси z в виде списка объектов Line2D.

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

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

get_zlim3d()[source]: Псевдоним для get_zlim.

get_zmajorticklabels()[source]: Возвращает метки основных делений оси z в виде списка объектов Text.

get_zminorticklabels()[source]: Возвращает метки вспомогательных делений оси z в виде списка объектов Text.

get_zscale()[source]: Возвращает масштаб оси z (в виде строки).

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

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

Параметры:

minorbool

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

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

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

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

Возвращает:

Список объектов Text

get_zticklines(minor=False)[source]: Возвращает линии делений оси z в виде списка объектов Line2D.

get_zticks(*, minor=False)[source]

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

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

Параметры:

minorbool, по умолчанию: False: True для возврата значений вспомогательных делений, False для возврата значений основных делений.

Возвращает:

Массив NumPy значений делений

grid(visible=True, **kwargs)[source]: Включить/выключить сетку в 3D.

Примечание

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

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

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

Установить или получить отступы автомасштабирования.

См. Axes.margins для полной документации. Поскольку эта функция применяется к 3D оси, она также принимает аргумент z и возвращает (xmargin, ymargin, zmargin).

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

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

Параметры:

rotate_btnint или список целых чисел, по умолчанию: 1: Кнопка или кнопки мыши, используемые для вращения 3D осей.
zoom_btnint или список целых чисел, по умолчанию: 3: Кнопка или кнопки мыши, используемые для масштабирования 3D осей.

name='3d'

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

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

Параметры:

xsодномерный массив-подобный объект: x-координаты вершин.
ysодномерный массив-подобный объект: y-координаты вершин.
zsчисло с плавающей точкой или одномерный массив-подобный объект: z-координаты вершин; одно значение для всех точек или одно значение для каждой точки.
zdir{'x', 'y', 'z'}, по умолчанию: 'z': При построении 2D данных, направление для использования как z ('x', 'y' или 'z').
**kwargs: Другие аргументы передаются в matplotlib.axes.Axes.plot.

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

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

Параметры:

xsОдномерный массив-подобный объект: Координаты x вершин.
ysОдномерный массив-подобный объект: Координаты y вершин.
zsЧисло с плавающей точкой или одномерный массив-подобный объект: Координаты z вершин; либо одно для всех точек, либо одно для каждой точки.
zdir{'x', 'y', 'z'}, по умолчанию: 'z': При построении 2D данных, направление для использования в качестве z ('x', 'y' или 'z').
**kwargs: Другие аргументы передаются методу matplotlib.axes.Axes.plot.

plot_surface(X, Y, Z, *, 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 массивы

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

rcount, ccountint

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

rstride, cstrideint

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

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

цветцвет-подобный объект

Цвет участков поверхности.

cmapЦветовая карта

Цветовая карта участков поверхности.

facecolorsмассив цветов.

Цвета каждого отдельного участка.

normНормализация

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

vmin, vmaxчисло с плавающей точкой

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

затенятьbool, по умолчанию: True

Определяет, будут ли затенены значения facecolors. Затенение всегда отключено, когда указан cmap.

lightsourceLightSource

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

**kwargs

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

plot_trisurf(*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, Zмассив-подобные объекты: Значения данных в виде одномерных массивов.
цвет: Цвет участков поверхности.
cmap: Цветовая карта для участков поверхности.
normНормализация: Экземпляр Normalize для сопоставления значений с цветами.
vmin, vmaxчисло с плавающей точкой, по умолчанию: None: Минимальное и максимальное значение для сопоставления.
затенятьbool, по умолчанию: True: Определяет, будут ли затенены значения facecolors. Затенение всегда отключено, когда указан cmap.
lightsourceLightSource: Источник света для использования, когда затенять равно True.
**kwargs: Все остальные аргументы передаются классу Poly3DCollection

Примеры

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

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

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

Построение 3D каркасной диаграммы.

Примечание

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

Параметры:

X, Y, Z2D массивы

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

rcount, ccountint

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

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=.3, pivot='tail', normalize=False, **kwargs)[source]

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

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

Параметры:

X, Y, Zarray-like: Координаты x, y и z расположения стрелки (по умолчанию - хвост стрелки; см. аргумент pivot).
U, V, Warray-like: Компоненты x, y и z векторов стрелок.
lengthfloat, по умолчанию: 1: Длина каждой стрелки.
arrow_length_ratiofloat, по умолчанию: 0.3: Отношение размера стрелки к длине стрелки.
pivot{'tail', 'middle', 'tip'}, по умолчанию: 'tail': Часть стрелки, которая находится в узле сетки; стрелка вращается вокруг этой точки, поэтому название pivot.
normalizebool, по умолчанию: False: Определяет, будут ли все стрелки нормализованы к одной длине или сохранят длины, определенные u, v и w.
dataиндексируемый объект, необязательно: Если задано, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не приводит к исключению).
**kwargs: Все дополнительные ключевые аргументы передаются в LineCollection

quiver3D(X, Y, Z, U, V, W, /, length=1, arrow_length_ratio=.3, pivot='tail', normalize=False, **kwargs)[source]

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

Параметры:

X, Y, Zarray-like: Координаты x, y и z расположения стрелки (по умолчанию - хвост стрелки; см. аргумент pivot).
U, V, Warray-like: Компоненты x, y и z векторов стрелок.
lengthfloat, по умолчанию: 1: Длина каждой стрелки.
arrow_length_ratiofloat, по умолчанию: 0.3: Отношение размера стрелки к длине стрелки.
pivot{'tail', 'middle', 'tip'}, по умолчанию: 'tail': Часть стрелки, которая находится в узле сетки; стрелка вращается вокруг этой точки, поэтому название pivot.
normalizebool, по умолчанию: False: Определяет, будут ли все стрелки нормализованы к одной длине или сохранят длины, определенные u, v и w.
dataиндексируемый объект, необязательно: Если задано, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не приводит к исключению).
**kwargs: Все дополнительные ключевые аргументы передаются в LineCollection

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

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

Параметры:

xs, ysпоследовательность значений

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

zsчисло или последовательность значений, по умолчанию: 0

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

zdir{'x', 'y', 'z', '-x', '-y', '-z'}, по умолчанию: 'z'

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

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

sчисло или последовательность значений, по умолчанию: 20

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

cцвет, последовательность или последовательность цветов, необязательно

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

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

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

depthshadebool, по умолчанию: True

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

dataиндексируемый объект, необязательно

Если указан, следующие параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение):

xs, ys, zs, s, edgecolors, c, facecolor, facecolors, color

**kwargs

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

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

pathsPathCollection

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

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

Параметры:

xs, ysпоследовательность значений

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

zsчисло или последовательность значений, по умолчанию: 0

zdir{'x', 'y', 'z', '-x', '-y', '-z'}, по умолчанию: 'z'

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

sчисло или последовательность значений, по умолчанию: 20

cцвет, последовательность или последовательность цветов, необязательно

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

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

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

depthshadebool, по умолчанию: True

dataиндексируемый объект, необязательно

xs, ys, zs, s, edgecolors, c, facecolor, facecolors, color

**kwargs

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

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

pathsPathCollection

set(*, adjustable=<UNSET>, agg_filter=<UNSET>, alpha=<UNSET>, anchor=<UNSET>, animated=<UNSET>, aspect=<UNSET>, autoscale_on=<UNSET>, autoscalex_on=<UNSET>, autoscaley_on=<UNSET>, autoscalez_on=<UNSET>, axes_locator=<UNSET>, axisbelow=<UNSET>, box_aspect=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, facecolor=<UNSET>, frame_on=<UNSET>, gid=<UNSET>, in_layout=<UNSET>, label=<UNSET>, mouseover=<UNSET>, navigate=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, position=<UNSET>, proj_type=<UNSET>, prop_cycle=<UNSET>, rasterization_zorder=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, title=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, xbound=<UNSET>, xlabel=<UNSET>, xlim=<UNSET>, xlim3d=<UNSET>, xmargin=<UNSET>, xscale=<UNSET>, xticklabels=<UNSET>, xticks=<UNSET>, ybound=<UNSET>, ylabel=<UNSET>, ylim=<UNSET>, ylim3d=<UNSET>, ymargin=<UNSET>, yscale=<UNSET>, yticklabels=<UNSET>, yticks=<UNSET>, zbound=<UNSET>, zlabel=<UNSET>, zlim=<UNSET>, zlim3d=<UNSET>, zmargin=<UNSET>, zorder=<UNSET>, zscale=<UNSET>, zticklabels=<UNSET>, zticks=<UNSET>)[source]

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

Поддерживаемые свойства:

Свойство	Описание
`adjustable`	{'box', 'datalim'}
`agg_filter`	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
`alpha`	скаляр или None
`anchor`	(float, float) или {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
`animated`	bool
`aspect`	{'auto', 'equal', 'equalxy', 'equalxz', 'equalyz'}
`autoscale_on`	bool
`autoscalex_on`	неизвестно
`autoscaley_on`	неизвестно
`autoscalez_on`	неизвестно
`axes_locator`	Callable[[Axes, Renderer], Bbox]
`axisbelow`	bool или 'line'
`box_aspect`	тройку чисел с плавающей точкой или None
`clip_box`	`Bbox`
`clip_on`	bool
`clip_path`	Patch или (Path, Transform) или None
`facecolor` или fc	цвет
`figure`	`Figure`
`frame_on`	bool
`gid`	строка
`in_layout`	bool
`label`	объект
`mouseover`	bool
`navigate`	bool
`navigate_mode`	неизвестно
`path_effects`	`AbstractPathEffect`
`picker`	None или bool или float или вызываемый объект
`position`	[left, bottom, width, height] или `Bbox`
`proj_type`	{'persp', 'ortho'}
`prop_cycle`	неизвестно
`rasterization_zorder`	число с плавающей точкой или None
`rasterized`	bool
`sketch_params`	(масштаб: float, длина: float, случайность: float)
`snap`	bool или None
`title`	неизвестно
`transform`	`Transform`
`url`	строка
`visible`	bool
`xbound`	неизвестно
`xlabel`	строка
`xlim`	(нижняя граница: float, верхняя граница: float)
`xlim3d`	(нижняя граница: float, верхняя граница: float)
`xmargin`	число с плавающей точкой, большее -0.5
`xscale`	неизвестно

`xticklabels`	неизвестно
`xticks`	неизвестно
`ybound`	неизвестно
`ylabel`	str
`ylim`	(нижняя: float, верхняя: float)
`ylim3d`	(нижняя: float, верхняя: float)
`ymargin`	float, больше -0.5
`yscale`	неизвестно
`yticklabels`	неизвестно
`yticks`	неизвестно
`zbound`	неизвестно
`zlabel`	неизвестно
`zlim`	неизвестно
`zlim3d`	неизвестно
`zmargin`	float, больше -0.5
`zorder`	float
`zscale`	неизвестно
`zticklabels`	неизвестно
`zticks`	неизвестно

set_aspect(aspect, adjustable=None, anchor=None, share=False)[source]

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

Параметры:

aspect{'auto', 'equal', 'equalxy', 'equalxz', 'equalyz'}

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

значение	описание
'auto'	автоматическое; заполнить прямоугольник положения данными.
'equal'	адаптировать все оси, чтобы получить одинаковые соотношения сторон.
'equalxy'	адаптировать оси x и y, чтобы получить одинаковые соотношения сторон.
'equalxz'	адаптировать оси x и z, чтобы получить одинаковые соотношения сторон.
'equalyz'	адаптировать оси y и z, чтобы получить одинаковые соотношения сторон.

adjustableNone

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

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

anchorNone или str или 2-кортеж float, необязательно

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

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

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

sharebool, по умолчанию: False

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

См. также

mpl_toolkits.mplot3d.axes3d.Axes3D.set_box_aspect

... ```

set_frame_on(b)[source]

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

Параметры:

bbool

set_proj_type(proj_type, focal_length=None)[source]

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

Параметры:

proj_type{'persp', 'ortho'}: Тип проекции.
focal_lengthfloat, по умолчанию: None: Для типа проекции 'persp' — фокусное расстояние виртуальной камеры. Должно быть > 0. Если None, по умолчанию 1. Фокусное расстояние можно вычислить из желаемого поля зрения по формуле: focal_length = 1/tan(FOV/2)

set_title(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'}, по умолчанию: rcParams["axes.titlelocation"] (по умолчанию: 'center')

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

yfloat, по умолчанию: rcParams["axes.titley"] (по умолчанию: None)

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

padfloat, по умолчанию: rcParams["axes.titlepad"] (по умолчанию: 6.0)

Отступ заголовка от верха оси в пунктах.

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

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

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

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

set_top_view()[source]

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

Установить пределы области отображения оси X.

Параметры:

leftfloat, необязательно

Левая граница xlim в координатах данных. Передача None оставляет предел без изменений.

Левую и правую границы xlim также можно передать как кортеж (left, right) в качестве первого позиционного аргумента (или как аргумент left).

rightfloat, необязательно

Правая граница xlim в координатах данных. Передача None оставляет предел без изменений.

emitbool, по умолчанию: True

Уведомлять ли наблюдателей об изменении пределов.

autobool или None, по умолчанию: False

Включить или выключить автоматическое масштабирование оси X. True — включить, False — выключить, None — оставить без изменений.

xmin, xmaxfloat, необязательно

Соответствуют left и right соответственно, и ошибка возникает при передаче как xmin и left, так и xmax и right.

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

left, right(float, float): Новые пределы оси X в координатах данных.

См. также

get_xlim
set_xbound, get_xbound
invert_xaxis, xaxis_inverted

Примечания

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

Примеры

>>> set_xlim(left, right)
>>> set_xlim((left, right))
>>> left, right = set_xlim(left, right)

Один из пределов может остаться без изменений.

>>> set_xlim(right=right_lim)

Пределы могут быть переданы в обратном порядке для изменения направления оси X. Например, предположим, что x представляет количество лет до настоящего времени. Пределы оси X могут быть установлены следующим образом, чтобы 5000 лет назад отображались слева, а настоящее время — справа.

>>> set_xlim(5000, 0)

set_xscale(value, **kwargs)[source]

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

Параметры:

value{"linear"}: Тип масштаба оси. 3D-оси в настоящее время поддерживают только линейные масштабы; другие масштабы приводят к бессмысленным результатам.
**kwargs: Ключевые аргументы номинально передаются классу масштаба, но ни один из них не применим для линейных масштабов.

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

Установите пределы масштабирования оси y.

Параметры:

bottomfloat, необязательно

Нижнее значение пределов оси y в координатах данных. Передача None оставляет предел без изменений.

Нижнее и верхнее значения пределов оси y также могут быть переданы в виде кортежа (bottom, top) в качестве первого позиционного аргумента (или в качестве аргумента bottom).

topfloat, необязательно

Верхнее значение пределов оси y в координатах данных. Передача None оставляет предел без изменений.

emitbool, по умолчанию: True

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

autobool или None, по умолчанию: False

Указывает, включить ли автоматическое масштабирование оси y. True включает, False отключает, None оставляет без изменений.

ymin, ymaxfloat, необязательно

Они эквивалентны bottom и top соответственно, и передача ymin и bottom или ymax и top является ошибкой.

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

bottom, top(float, float): Новые пределы оси y в координатах данных.

См. также

get_ylim
set_ybound, get_ybound
invert_yaxis, yaxis_inverted

Примечания

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

Примеры

>>> set_ylim(bottom, top)
>>> set_ylim((bottom, top))
>>> bottom, top = set_ylim(bottom, top)

Один из пределов может быть оставлен без изменений.

>>> set_ylim(top=top_lim)

Пределы могут быть переданы в обратном порядке, чтобы изменить направление оси y. Например, предположим, что y представляет глубину океана в м. Пределы оси y можно установить следующим образом, чтобы глубина 5000 м была внизу графика, а поверхность, 0 м, - наверху.

>>> set_ylim(5000, 0)

set_yscale(value, **kwargs)[source]

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

Параметры:

value{"linear"}: Тип масштаба оси для применения. 3D оси в настоящее время поддерживают только линейные масштабы; другие масштабы приводят к бессмысленным результатам.
**kwargs: Ключевые аргументы номинально передаются в класс масштаба, но ни один из них не применим для линейных масштабов.

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

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

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

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

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

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

См. Axes.set_ylim для подробного описания.

set_zlim3d(bottom=None, top=None, *, emit=True, auto=False, zmin=None, zmax=None)[source]: Псевдоним для set_zlim.

set_zmargin(m)[source]

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

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

Например, если ваши данные находятся в диапазоне [0, 2], отступ 0,1 приведет к диапазону [-0,2, 2,2]; отступ -0,1 приведет к диапазону [0,2, 1,8].

Параметры:

mfloat больше -0,5

set_zscale(value, **kwargs)[source]

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

Параметры:

value{"linear"}: Тип масштаба оси для применения. 3D оси в настоящее время поддерживают только линейные масштабы; другие масштабы приведут к бессмысленным результатам.
**kwargs: Ключевые аргументы номинально передаются в класс масштаба, но ни один из них не применим для линейных масштабов.

set_zticklabels(labels, *, fontdict=None, minor=False, **kwargs)[source]

Установить метки оси 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 свойства.

set_zticks(ticks, labels=None, *, minor=False, **kwargs)[source]

Установить позиции делений и (необязательно) метки на оси Z.

При необходимости пределы отображения оси расширяются так, чтобы все заданные деления были видны.

Параметры:

tickslist of floats

Список положений делений. Менеджер делений оси Locator заменяется на FixedLocator.

Некоторые форматеры меток не будут помечать произвольные позиции делений; например, форматеры в логарифмическом масштабе по умолчанию помечают только деления десятичного порядка. В таком случае вы можете явно установить форматер на оси с помощью Axis.set_major_formatter или сами предоставить отформатированные метки.

labelslist of str, optional

Список меток делений. Если не указан, метки генерируются с помощью форматера меток оси Formatter.

minorbool, default: False

Если False, устанавливаются основные деления; если True, вспомогательные.

**kwargs

Text свойства меток. Они применяются только если вы передали метки. В остальных случаях, пожалуйста, используйте tick_params.

Примечания

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

sharez(other)[source]

Поделить ось Z с other.

Это эквивалентно передаче sharex=other при создании оси, и не может быть использовано, если ось Z уже разделена с другой осью.

stem(x, y, z, *, linefmt='C0-', markerfmt='C0o', basefmt='C3-', bottom=0, label=None, orientation='z', data=None)[source]

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

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

Параметры:

x, y, zarray-like

Позиции головок стеблей. Стебли рисуются вдоль направления orientation от базовой линии в bottom (в координатах orientation) до головок. По умолчанию, координаты x и y используются для базовой линии, а z для позиции головки, но это можно изменить с помощью orientation.

linefmtstr, default: 'C0-'

Строка, определяющая свойства вертикальных линий. Обычно это цвет или цвет и стиль линии:

Символ	Стиль линии
`'-'`	сплошная линия
`'--'`	пунктирная линия
`'-.'`	штрихпунктирная линия
`':'`	точечная линия

Примечание: хотя технически возможно указать форматы, отличные от цвета или цвета и стиля линии (например, 'rx' или '-.'), это выходит за рамки задач метода и скорее всего не приведет к разумному графику.

markerfmtstr, default: 'C0o'

Строка, определяющая свойства маркеров в головах стеблей.

basefmtstr, default: 'C3-'

Строка форматирования, определяющая свойства базовой линии.

bottomfloat, default: 0

Позиция базовой линии в координатах orientation.

labelstr, default: None

Метка для использования стеблей в легендах.

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

Направление, по которому рисуются стебли.

dataиндексируемый объект, необязательно

Если задано, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение).

Возвращает:

StemContainer: Контейнер можно рассматривать как кортеж (markerline, stemlines, baseline)

Примеры

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

(png)

(png)

stem3D(x, y, z, *, linefmt='C0-', markerfmt='C0o', basefmt='C3-', bottom=0, label=None, orientation='z', data=None)[source]

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

Параметры:

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

text2D(x, y, s, fontdict=None, **kwargs)[source]

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

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

Параметры:

x, yfloat: Положение для размещения текста. По умолчанию, это координаты данных. Система координат может быть изменена с помощью параметра transform.
sstr: Текст.
fontdictdict, по умолчанию: None: Словарь для переопределения свойств текста по умолчанию. Если fontdict равен None, значения по умолчанию определяются параметром rcParams.

Возвращает:

Text: Созданный экземпляр Text.

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

**kwargsText свойства.

Другие параметры текста общего назначения.

Свойство	Описание
`agg_filter`	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от левого нижнего угла изображения
`alpha`	скаляр или None
`animated`	bool
`backgroundcolor`	цвет
`bbox`	словарь со свойствами для `patches.FancyBboxPatch`
`clip_box`	неизвестно
`clip_on`	неизвестно
`clip_path`	неизвестно
`color` или c	цвет
`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	{'left', 'center', 'right'}
`in_layout`	bool
`label`	объект
`linespacing`	float (кратное размеру шрифта)
`math_fontfamily`	str
`mouseover`	bool
`multialignment` или ma	{'left', 'right', 'center'}
`parse_math`	bool
`path_effects`	`AbstractPathEffect`
`picker`	None или bool или float или вызываемый объект
`position`	(float, float)
`rasterized`	bool
`rotation`	float или {'vertical', 'horizontal'}
`rotation_mode`	{None, 'default', 'anchor'}
`sketch_params`	(scale: float, length: float, randomness: float)
`snap`	bool или None
`text`	объект
`transform`	`Transform`
`transform_rotates_text`	bool
`url`	str
`usetex`	bool или None
`verticalalignment` или va	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
`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(x, y, z, s, zdir=None, **kwargs)[source]: Добавление текста к графику. kwargs будут переданы в Axes.text, за исключением ключевого слова zdir, которое задаёт направление, используемое как z-направление.

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

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

См. Axes.tick_params для полной документации. Поскольку эта функция применяется к 3D осям, axis также может быть установлен в 'z', а установка axis в 'both' автоматически масштабирует все три оси.

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

Примечание

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

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

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

Примечание

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

Параметры:

X, Y, Zarray-like: Входные данные. См. Axes.tricontour для поддерживаемых форм данных.
extend3dbool, по умолчанию: False: Включить ли расширение контура в 3D.
шагint: Шаг для расширения контура.
zdir{'x', 'y', 'z'}, по умолчанию: 'z': Направление для использования.
смещениеfloat, необязательно: Если указано, отобразить проекцию линий контура в этой позиции в плоскости, перпендикулярной zdir.
данныеиндексируемый объект, необязательно: Если задано, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не приводит к исключению).
*args, **kwargs: Другие аргументы передаются в matplotlib.axes.Axes.tricontour.

Возвращает:

matplotlib.tri.tricontour.TriContourSet

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

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

Примечание

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

Параметры:

X, Y, Zarray-like: Входные данные. См. Axes.tricontourf для поддерживаемых форм данных.
zdir{'x', 'y', 'z'}, по умолчанию: 'z': Направление для использования.
смещениеfloat, необязательно: Если указано, отобразить проекцию линий контура в этой позиции в плоскости, перпендикулярной zdir.
данныеиндексируемый объект, необязательно: Если задано, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не приводит к исключению).
*args, **kwargs: Другие аргументы передаются в matplotlib.axes.Axes.tricontourf.

Возвращает:

matplotlib.tri.tricontour.TriContourSet

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

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

unit_cube(vals=None)[source]

update_datalim(xys, **kwargs)[source]

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

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

Параметры:

xys2D массив-подобный объект: Точки, которые следует включить в Bbox пределов данных. Это может быть список кортежей (x, y) или Nx2 массив.
updatex, updateybool, по умолчанию: True: Определяет, следует ли обновлять пределы x/y.

view_init(elev=None, azim=None, roll=None, vertical_axis='z')[source]

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

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

Чтобы смотреть нормально к первичным плоскостям, можно использовать следующие углы подъёма и азимута. Угол поворота 0, 90, 180 или 270 градусов будет вращать эти виды, сохраняя оси под прямыми углами.

плоскость вида	elev	azim
XY	90	-90
XZ	0	-90
YZ	0	0
-XY	-90	90
-XZ	0	90
-YZ	0	180

Параметры:

elevfloat, по умолчанию: None: Угол подъёма в градусах вращает камеру над плоскостью, проходящей через вертикальную ось, при положительном угле соответствующем расположению над этой плоскостью. Например, с вертикальной осью по умолчанию 'z', угол подъёма определяет угол расположения камеры над плоскостью x-y. Если None, используется начальное значение, указанное в конструкторе Axes3D.
azimfloat, по умолчанию: None: Азимутальный угол в градусах вращает камеру вокруг вертикальной оси, при положительном угле соответствующем правостороннему вращению. Например, с вертикальной осью по умолчанию 'z', положительный азимут вращает камеру вокруг начала координат из её расположения вдоль оси +x к оси +y. Если None, используется начальное значение, указанное в конструкторе Axes3D.
rollfloat, по умолчанию: None: Угол поворота в градусах вращает камеру вокруг оси просмотра. Положительный угол вращает камеру по часовой стрелке, что приводит к вращению сцены против часовой стрелки. Если None, используется начальное значение, указанное в конструкторе Axes3D.
vertical_axis{"z", "x", "y"}, по умолчанию: "z": Ось, выравниваемая вертикально. azim вращается вокруг этой оси.

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

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

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

Параметры:

filled3D np.array булевых значений

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

x, y, z3D np.array, необязательно

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

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

facecolors, edgecolorsмассив-подобный объект, необязательно

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

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

shadebool, по умолчанию: True

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

lightsourceLightSource

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

**kwargs

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

Возвращает:

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

Примеры

свойствоw_xaxis[source]

свойствоw_yaxis[source]

propertyw_zaxis[source]

zaxis_date(tz=None)[source]

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

Параметры:

tzстрока или datetime.tzinfo, по умолчанию: rcParams["timezone"] (по умолчанию: 'UTC'): Временная зона, используемая для создания меток дат.

Примечания

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

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