matplotlib.axes.Axes

classmatplotlib.axes.Axes(fig, *args, facecolor=None, frameon=True, sharex=None, sharey=None, label='', xscale=None, yscale=None, box_aspect=None, forward_navigation_events='auto', **kwargs)[source]

Объект Axes encapsuliрует все элементы отдельного (под-)графика в figure.

Он содержит большинство элементов (под-)графика: Axis, Tick, Line2D, Text, Polygon и т. д., и задаёт систему координат.

Как и все видимые элементы в figure, Axes является подклассом Artist.

Экземпляр Axes поддерживает обратные вызовы через атрибут callbacks, который является экземпляром CallbackRegistry. События, к которым можно подключиться, — это 'xlim_changed' и 'ylim_changed', и обратный вызов будет вызван с func(ax), где ax — экземпляр Axes.

Примечание

Пользователь напрямую не создаёт экземпляры Axes, а использует методы создания Axes; например, из pyplot или Figure: subplots, subplot_mosaic или Figure.add_axes.

Атрибуты:

dataLimBbox

Прямоугольник, содержащий все данные, отображаемые в Axes.

viewLimBbox

Пределы отображения в координатах данных.

Создаёт Axes в figure.

Параметры:

figFigure

Axes создаётся в figure fig.

*args

*args может быть одиночным прямоугольником (left, bottom, width, height) или одиночной Bbox. Это задаёт прямоугольник (в координатах figure), где располагается Axes.

*args также может состоять из трёх чисел или одного трёхзначного числа; в последнем случае цифры рассматриваются как независимые числа. Числа интерпретируются как (nrows, ncols, index): (nrows, ncols) задаёт размер массива подграфиков, а index — индекс подграфика, который создаётся (начиная с 1). Наконец, *args может напрямую быть экземпляром SubplotSpec.

sharex, shareyAxes, необязательно

Ось x или y совмещается с осью x или y во входном Axes. Обратите внимание, что отменить совместное использование осей невозможно.

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

Определяет, видна ли рамка Axes.

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

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

forward_navigation_eventsbool или "auto", по умолчанию: "auto"

Управляет тем, передаются ли события панорамирования/приближения в Axes ниже этого. "auto" — True для осей с невидимой областью и False в противном случае.

**kwargs

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

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

xticklabels	неизвестно
xticks	неизвестно
ybound	(нижняя граница: float, верхняя граница: float)
ylabel	строка
ylim	(нижняя граница: float, верхняя граница: float)
ymargin	число, большее -0,5
yscale	неизвестно
yticklabels	неизвестно
yticks	неизвестно
zorder	число с плавающей точкой

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

Axes

Новый объект Axes.