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) Положение области построения графика. azimfloat, по умолчанию: -60 Угол азимута. elevfloat, по умолчанию: 30 Угол возвышения. sharezAxes3D, необязательно Другие оси, с которыми нужно совместно использовать пределы z. proj_type{'persp', 'ortho'} Тип проекции, по умолчанию 'persp'. auto_add_to_figurebool, по умолчанию: True До версии Matplotlib 3.4 Axes3D добавляли себя в родительскую фигуру при инициализации. Другие классы Axes так не делают. Это поведение устарело в 3.4, по умолчанию в 3.5 будет False. Ключевое слово не будет документироваться, а значение отличное от False станет ошибкой в 3.6. **kwargs Другие необязательные аргументы ключевого слова:

Свойство Описание adjustable {'box', 'datalim'} agg_filter функция фильтра, которая принимает массив float (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 булево значение 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.

__init__(fig, rect=None, *args, azim=- 60, elev=30, sharez=None, proj_type='persp', box_aspect=None, **kwargs)[source]

Параметры:

figFigure Родительская фигура. rect(float, float, float, float) Положение осей. azimfloat, по умолчанию: -60 Азимутальный угол обзора. elevfloat, по умолчанию: 30 Угол подъёма обзора. sharezAxes3D, необязательно Другие оси, с которыми требуется совмещать z-пределы. proj_type{'persp', 'ortho'} Тип проекции, по умолчанию 'persp'. auto_add_to_figurebool, по умолчанию: True До версии Matplotlib 3.4, Axes3D добавляли себя в родительскую фигуру при инициализации. Другие классы осей этого не делают. Это поведение устарело в версии 3.4, по умолчанию оно изменится на False в версии 3.5. Ключевое слово станет недокументированным, а значение, отличное от False, станет ошибкой в версии 3.6. **kwargs

Другие необязательные ключевые аргументы: Свойство Описание adjustable {'box', 'datalim'} agg_filter функция фильтра, которая принимает массив float (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 [left, bottom, width, height] или Bbox proj_type {'persp', 'ortho'} prop_cycle неизвестно rasterization_zorder число с плавающей точкой или None rasterized логическое значение sketch_params (scale: float, length: float, randomness: float) snap логическое значение или None title строка transform Transform url строка visible логическое значение 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.

__module__ = 'mpl_toolkits.mplot3d.axes3d'

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 повлияет на позицию.

См. также

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]

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

В версии 1.1.0.

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

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

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

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

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

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

Параметры:

left1D массив-подобный объект Координаты x левых границ столбцов. height1D массив-подобный объект Высота столбцов. zsчисло или 1D массив-подобный объект Координата z столбцов; если указано одно значение, оно будет использовано для всех столбцов. zdir{'x', 'y', 'z'}, по умолчанию: 'z' При построении 2D данных, направление, используемое как z ('x', 'y' или 'z'). **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, **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. **kwargs Любые дополнительные ключевые аргументы передаются в Poly3DCollection.

Возвращает:

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

can_pan()[source]

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

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

can_zoom()[source]

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

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

cla()[source]

Очистить оси.

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

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

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

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

Параметры:

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

Возвращает:

matplotlib.contour.QuadContourSet

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

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

Параметры:

X, Y, Zarray-like Входные данные. extend3dbool, по умолчанию: False Расширять контур в 3D. strideint Шаг для расширения контура. zdir{'x', 'y', 'z'}, по умолчанию: 'z' Направление, которое нужно использовать. offsetfloat, необязательно Если указано, то отображается проекция контурных линий в этой позиции в плоскости, перпендикулярной zdir. *args, **kwargs Другие аргументы передаются в matplotlib.axes.Axes.contour.

Возвращает:

matplotlib.contour.QuadContourSet

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

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

Параметры:	X, Y, Zarray-like Входные данные. zdir{'x', 'y', 'z'}, по умолчанию: 'z' Направление, которое нужно использовать. offsetfloat, необязательно Если указано, то отображается проекция контурных линий в этой позиции в плоскости, перпендикулярной zdir. *args, **kwargs Другие аргументы передаются в matplotlib.axes.Axes.contourf.
Возвращает:	matplotlib.contour.QuadContourSet

Примечания

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

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

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

Параметры:	X, Y, Zarray-like Входные данные. zdir{'x', 'y', 'z'}, по умолчанию: 'z' Направление, которое нужно использовать. offsetfloat, необязательно Если указано, то отображается проекция контурных линий в этой позиции в плоскости, перпендикулярной zdir. *args, **kwargs Другие аргументы передаются в matplotlib.axes.Axes.contourf.
Возвращает:	matplotlib.contour.QuadContourSet

Примечания

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

convert_zunits(z)[source]

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

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

disable_mouse_rotation()[source]

Отключить нажатия клавиш мыши для вращения и масштабирования в 3D.

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, **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, каждый из которых содержит маркер с верхним или нижним пределом.
Другие параметры:	**kwargs Все остальные ключевые параметры для форматирования линий областей погрешности передаются Line3DCollection.

Примеры

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

format_coord(xd, yd)[source]

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

format_zdata(z)[source]

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

get_autoscale_on()[source]

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

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

get_autoscalez_on()[source]

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

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

get_axis_position()[source]

get_frame_on()[source]

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

get_proj()[source]

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

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

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

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

Параметры:

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

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

get_xlim3d()[source]

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

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

См. также

set_xlim

set_xbound, get_xbound

invert_xaxis, xaxis_inverted

Примечания

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

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

get_ylim()

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

get_ylim3d()[source]

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

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

См. также

set_ylim

set_ybound, get_ybound

invert_yaxis, yaxis_inverted

Примечания

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

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

get_zaxis()[source]

Возвращает объект ZAxis (Axis).

get_zbound()[source]

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

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

get_zgridlines()

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

get_zlabel()[source]

Получить текстовое значение подписи оси z.

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

get_zlim()

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

get_zlim3d()[source]

Получить пределы области просмотра по оси z.

get_zmajorticklabels()

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

get_zminorticklabels()

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

get_zscale()[source]

get_zticklabels(minor=False, which=None)

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

Параметры:	minorbool Возвращать метки дополнительных или основных делений. whichNone, ('minor', 'major', 'both') Переопределяет minor. Выбирает метки делений для возврата.
Возвращает:	список объектов Text

Примечания

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

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

get_zticklines(minor=False)

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

get_zticks(*, minor=False)

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

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

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

Примечание

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

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

invert_zaxis()[source]

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

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

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

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

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

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

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

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

Варианты вызова:

margins()

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

margins(margin)

margins(xmargin, ymargin, zmargin)

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

margins(..., tight=False)

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

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

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

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

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

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

Параметры:	rotate_btnint или список int, по умолчанию: 1 Кнопка или кнопки мыши, используемые для вращения осей в 3D графике. zoom_btnint или список int, по умолчанию: 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)

Построение 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, *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 массивы Значения данных. rcount, ccountint Максимальное количество выборок, используемых в каждом направлении. Если входные данные больше, они будут уменьшены (с помощью срезов) до этих значений. По умолчанию 50. Доступно начиная с версии 2.0. rstride, cstrideint Шаг уменьшения выборки в каждом направлении. Эти аргументы взаимно исключают rcount и ccount. Если установлен только один из rstride или cstride, другой по умолчанию равен 10. 'classic' режим использует значение по умолчанию rstride = cstride = 10 вместо нового значения по умолчанию rcount = ccount = 50. цветподобный цвет Цвет поверхностных областей. cmapЦветовая карта Цветовая карта поверхностных областей. facecolorsмассив цветов. Цвета каждой отдельной области. normНормализация Нормализация для цветовой карты. vmin, vmaxчисло с плавающей точкой Пределы для нормализации. shadebool, по умолчанию: True Указывает, необходимо ли затенять цвет. Затенение всегда отключено, когда указана cmap. lightsourceLightSource Источник света, который следует использовать, когда shade равно 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 Минимальное и максимальное значение для отображения. shadebool, по умолчанию: True Указывает, необходимо ли затенять цвет. Затенение всегда отключено, когда указана cmap. lightsourceLightSource Источник света, который следует использовать, когда shade равно True. **kwargs Все остальные параметры передаются в Poly3DCollection

Примеры

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

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

Доступно начиная с версии 1.2.0.

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

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

Примечание

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

Параметры:

X, Y, Z2D массивы Значения данных. 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=.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. **kwargs Дополнительные ключевые параметры передаются в LineCollection

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

Построение 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. **kwargs Дополнительные ключевые параметры передаются в LineCollection

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

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

Параметры:

xs, ysarray-like Позиции данных. zsfloat или array-like, по умолчанию: 0 Позиции z. Либо массив той же длины, что и xs и ys, либо одно значение для размещения всех точек в одной плоскости. zdir{'x', 'y', 'z', '-x', '-y', '-z'}, по умолчанию: 'z' Направление оси для zs. Это полезно при построении 2D-данных на 3D-оси. Данные должны быть переданы как xs, ys. Установка zdir в 'y' затем строит данные в плоскости x-z. См. также Построение 2D-данных на 3D-графике. sfloat или array-like, по умолчанию: 20 Размер маркера в пунктах**2. Либо массив той же длины, что и xs и ys, либо одно значение для задания одинакового размера всех маркеров. cцвет, последовательность или последовательность цветов, необязательно Цвет маркера. Возможные значения: Строка формата одного цвета. Последовательность цветов длины n. Последовательность n чисел для сопоставления цветов с помощью cmap и norm. 2D-массив, в котором строки представляют RGB или RGBA. Для получения более подробной информации см. аргумент c функции scatter. depthshadebool, по умолчанию: True Нужно ли затемнять маркеры рассеяния, чтобы создать иллюзию глубины. Каждый вызов scatter() выполнит свою затенение глубины независимо. **kwargs Все остальные аргументы передаются в scatter.

Возвращает:

pathsPathCollection

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

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

Параметры:	...
Возвращает:	...

set_anchor(anchor, share=False)[source]

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

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

Параметры:

anchor2-кортеж чисел с плавающей запятой или {'C', 'SW', 'S', 'SE', ...} Положение якоря может быть: Последовательность (cx, cy). cx и cy могут принимать значения от 0 до 1, где 0 соответствует левому или нижнему краю, а 1 — правому или верхнему. Строка, использующая аббревиатуры сторон света: 'C' для центрирования 'S' (юг) для центра нижнего края 'SW' (юго-запад) для левого нижнего края и т.д. Вот обзор возможных положений: 'NW' 'N' 'NE' 'W' 'C' 'E' 'SW' 'S' 'SE' sharebool, по умолчанию: False Если True, применить настройки ко всем связанным осям.

См. также

matplotlib.axes.Axes.set_aspect

для описания обработки аспекта.

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

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

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

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

Параметры:

aspect{'auto'} Возможные значения: значение описание 'auto' автоматическое; заполнить прямоугольник положения пределами данных. adjustableNone В настоящее время игнорируется Axes3D Если не None, это определяет, какой параметр будет откорректирован, чтобы соответствовать требуемому соотношению сторон. См. set_adjustable для получения дополнительной информации. anchorNone или строка или 2-кортеж чисел с плавающей точкой, необязательно Если не None, это определяет, где будет нарисован Axes, если есть дополнительное пространство из-за ограничений соотношения сторон. Наиболее распространенный способ указать якорь — это сокращения сторон света: значение описание 'C' по центру 'SW' левый нижний угол 'S' середина нижнего края 'SE' правый нижний угол и т.д. См. set_anchor для получения дополнительной информации. sharebool, по умолчанию: False Если True, применить настройки ко всем общим осям.

См. также

mpl_toolkits.mplot3d.axes3d.Axes3D.set_box_aspect

set_autoscale_on(b)[source]

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

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

Параметры:	bbool

set_autoscalez_on(b)[source]

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

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

Параметры:	bbool

set_axis_off()[source]

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

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

set_axis_on()[source]

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

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

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

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

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

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

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

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

set_frame_on(b)[source]

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

Параметры:	bbool

set_proj_type(proj_type)[source]

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

Параметры:	proj_type{'persp', 'ortho'}

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

set_top_view()[source]

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

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

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

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

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

set_xmargin(m)[source]

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

К каждому концу интервала будет добавлено m раз интервал данных перед его использованием в автоматическом масштабировании. Например, если ваши данные находятся в диапазоне [0, 2], коэффициент m = 0.1 приведет к диапазону [-0.2, 2.2].

Отрицательные значения -0.5 < m < 0 приведут к обрезке диапазона данных. То есть для диапазона данных [0, 2] коэффициент m = -0.1 приведет к диапазону [0.2, 1.8].

Параметры:	mfloat больше -0.5

set_xscale(value, **kwargs)[source]

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

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

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

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

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

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

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

set_ymargin(m)[source]

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

К каждому концу интервала будет добавлено m раз интервал данных перед его использованием в автоматическом масштабировании. Например, если ваши данные находятся в диапазоне [0, 2], коэффициент m = 0.1 приведет к диапазону [-0.2, 2.2].

Отрицательные значения -0.5 < m < 0 приведут к обрезке диапазона данных. То есть для диапазона данных [0, 2] коэффициент m = -0.1 приведет к диапазону [0.2, 1.8].

Параметры:	mfloat больше -0.5

set_yscale(value, **kwargs)[source]

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

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

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

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

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

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

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

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

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

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

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

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

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

set_zmargin(m)[source]

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

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

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

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

set_zscale(value, **kwargs)[source]

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

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

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

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

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

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

Параметры:	labelsсписок str Тексты меток. fontdictdict, необязательно Словарь, управляющий внешним видом меток. По умолчанию fontdict: {'fontsize': rcParams['axes.titlesize'], 'fontweight': rcParams['axes.titleweight'], 'verticalalignment': 'baseline', 'horizontalalignment': loc} minorbool, по умолчанию: False Устанавливать ли метки вспомогательных делений, а не основных.
Возвращает:	список Text Метки.
Другие параметры:	**kwargsText свойства.

set_zticks(ticks, *, minor=False)

Установить позиции меток оси Z.

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

Параметры:	ticksсписок чисел с плавающей точкой Список позиций меток. minorbool, по умолчанию: False Если False, устанавливаются основные метки; если True, вспомогательные метки.

Примечания

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

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

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

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

Параметры:

x, y, zпоследовательность Позиции головок столбиков. Столбики рисуются вдоль направления orientation от базовой линии в точке bottom (в координатах orientation) до головок. По умолчанию, позиции x и y используются для базовой линии, а z - для позиции головки, но это может быть изменено параметром orientation. linefmtстрока, по умолчанию: 'C0-' Строка, определяющая свойства вертикальных линий. Обычно это цвет или цвет и стиль линии: Символ Стиль линии '-' сплошная линия '--' штриховая линия '-.' штрихпунктирная линия ':' пунктирная линия Примечание: Хотя технически возможно указать форматы, отличные от цвета или цвета и стиля линии (например, 'rx' или '-.'), это выходит за рамки намерений метода и, скорее всего, не приведет к разумному графику. markerfmtстрока, по умолчанию: 'C0o' Строка, определяющая свойства маркеров на головках столбиков. basefmtстрока, по умолчанию: 'C3-' Строка формата, определяющая свойства базовой линии. bottomвещественное число, по умолчанию: 0 Позиция базовой линии в координатах orientation. labelстрока, по умолчанию: None Метка для использования столбиков в легенде. orientation{'x', 'y', 'z'}, по умолчанию: 'z' Направление, по которому рисуются столбики.

Возвращает:

StemContainer Контейнер может быть обработан как кортеж (markerline, stemlines, baseline)

Примеры

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

(png, pdf)

(png, pdf)

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

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

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

Параметры:

x, y, zпоследовательность Позиции головок столбиков. Столбики рисуются вдоль направления orientation от базовой линии в точке bottom (в координатах orientation) до головок. По умолчанию, позиции x и y используются для базовой линии, а z - для позиции головки, но это может быть изменено параметром orientation. linefmtстрока, по умолчанию: 'C0-' Строка, определяющая свойства вертикальных линий. Обычно это цвет или цвет и стиль линии: Символ Стиль линии '-' сплошная линия '--' штриховая линия '-.' штрихпунктирная линия ':' пунктирная линия Примечание: Хотя технически возможно указать форматы, отличные от цвета или цвета и стиля линии (например, 'rx' или '-.'), это выходит за рамки намерений метода и, скорее всего, не приведет к разумному графику. markerfmtстрока, по умолчанию: 'C0o' Строка, определяющая свойства маркеров на головках столбиков. basefmtстрока, по умолчанию: 'C3-' Строка формата, определяющая свойства базовой линии. bottomвещественное число, по умолчанию: 0 Позиция базовой линии в координатах orientation. labelстрока, по умолчанию: None Метка для использования столбиков в легенде. orientation{'x', 'y', 'z'}, по умолчанию: 'z' Направление, по которому рисуются столбики.

Возвращает:

StemContainer Контейнер может быть обработан как кортеж (markerline, stemlines, baseline)

Примеры

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

(png, pdf)

(png, pdf)

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

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

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

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

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

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

Другие параметры для различных текстовых параметров. Свойство Описание agg_filter функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) alpha скаляр или 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 вещественное число или {'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 строка horizontalalignment или ha {'center', 'right', 'left'} in_layout bool label объект linespacing вещественное число (кратное размеру шрифта) math_fontfamily строка multialignment или ma {'left', 'right', 'center'} path_effects AbstractPathEffect picker None или bool или вещественное число или вызываемая функция position (вещественное число, вещественное число) rasterized bool rotation вещественное число или {'vertical', 'horizontal'} rotation_mode {None, 'default', 'anchor'} sketch_params (масштаб: вещественное число, длина: вещественное число, случайность: вещественное число) snap bool или None text объект transform Transform transform_rotates_text bool url строка usetex bool или None verticalalignment или va {'center', 'top', 'bottom', 'baseline', 'center_baseline'} visible bool wrap bool x вещественное число y вещественное число zorder вещественное число

Примеры

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание

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

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

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

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

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

Примечание

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

Параметры:

X, Y, Zarray-like Входные данные. extend3dbool, по умолчанию: False Требуется ли расширение контура в 3D. strideint Шаг для расширения контура. zdir{'x', 'y', 'z'}, по умолчанию: 'z' Направление для использования. offsetfloat, необязательно Если указано, отобразить проекцию линий контура в этой позиции в плоскости, нормальной к zdir. *args, **kwargs Другие аргументы передаются в matplotlib.axes.Axes.tricontour.

Возвращает:

matplotlib.tri.tricontour.TriContourSet

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

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

Примечание

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

Параметры:	X, Y, Zarray-like Входные данные. zdir{'x', 'y', 'z'}, по умолчанию: 'z' Направление для использования. offsetfloat, необязательно Если указано, отобразить проекцию линий контура в этой позиции в плоскости, нормальной к zdir. *args, **kwargs Другие аргументы передаются в matplotlib.axes.Axes.tricontourf.
Возвращает:	matplotlib.tri.tricontour.TriContourSet

Примечания

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

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

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

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

unit_cube(vals=None)[source]

update_datalim(xys, **kwargs)[source]

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

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

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

view_init(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 bool 3D массив значений, причём значения с истинным значением указывают, какие объемы заполнить x, y, z3D np.array, необязательно Координаты углов объемов. Это должно быть расширено до формы, на один размер больше по каждой размерности, чем форма filled. Эти данные могут быть использованы для отображения объёмов, не являющихся кубами. Если не указаны, по умолчанию используются увеличивающиеся целые числа по каждой оси, подобные тем, что возвращает indices(). Как указано в / в сигнатуре функции, эти аргументы могут быть переданы только позиционно. facecolors, edgecolorsarray-like, необязательно Цвет для отрисовки граней и рёбер объемов. Могут быть переданы только в качестве ключевых аргументов. Эти параметры могут быть: Одно значение цвета, чтобы все объемы были одного цвета. Это может быть строка или одномерный массив rgb/rgba. None, по умолчанию, чтобы использовать один цвет для граней и по умолчанию для рёбер. 3D массив имён цветов, где каждый элемент — цвет соответствующего объёма. Размер должен соответствовать объёмам. 4D массив данных rgb/rgba, с компонентами по последней оси. shadebool, по умолчанию: 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)

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

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

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

свойствоw_xaxis

свойствоw_yaxis

свойствоw_zaxis

zaxis_date(tz=None)

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

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

Примечания

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

zaxis_inverted()[source]

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

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

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