matplotlib.axes.Axes

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

Объект Axes encapsulates все элементы отдельного (под-)графика в 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.

**kwargs

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

Свойство	Описание
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'} или число
autoscale_on	логическое значение
autoscalex_on	неизвестно
autoscaley_on	неизвестно
axes_locator	Callable[[Axes, Renderer], Bbox]
axisbelow	логическое значение или 'line'
box_aspect	число с плавающей точкой или None
clip_box	BboxBase или None
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	[left, bottom, width, height] или Bbox
prop_cycle	Cycler
rasterization_zorder	число с плавающей точкой или None
rasterized	логическое значение
sketch_params	(scale: число, length: число, randomness: число)
snap	логическое значение или None
subplotspec	неизвестно
title	строка
transform	Transform
url	строка
visible	логическое значение
xbound	(нижнее: число, верхнее: число)
xlabel	строка
xlim	(левая: число, правая: число)
xmargin	число, большее -0,5
xscale	неизвестно
xticklabels	неизвестно
xticks	неизвестно

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

Возвращает:

Axes

Объект нового Axes.