matplotlib.pyplot.axes

matplotlib.pyplot.axes(arg=None, **kwargs)[source]

Добавить ось на текущую фигуру и сделать её текущей.

Возможные подписи:

plt.axes()
plt.axes(rect, projection=None, polar=False, **kwargs)
plt.axes(ax)

Параметры:	argNone или 4-кортеж Точное поведение этой функции зависит от типа: None: Добавляется новая полная ось окна с использованием `subplot(*kwargs)`. 4-кортеж чисел с плавающей точкой rect* = `[left, bottom, width, height]`. Добавляется новая ось с размерами rect в нормированных (0, 1) единицах с использованием `add_axes` на текущей фигуре. projection{None, 'aitoff', 'hammer', 'lambert', 'mollweide', 'polar', 'rectilinear', str}, необязательно Тип проекции `Axes`. str - имя пользовательской проекции, см. `projections`. По умолчанию None соответствует проекции 'rectilinear'. polarbool, по умолчанию: False Если True, эквивалентно projection='polar'. sharex, sharey`Axes`, необязательно Использовать общую ось x или y с sharex и/или sharey. Ось будет иметь те же пределы, метки и масштаб, что и ось у общей оси. labelstr Метка для возвращаемой оси.
Возвращаемое значение:	`Axes` или подкласс `Axes` Возвращаемый класс оси зависит от используемой проекции. Это `Axes`, если используется прямолинейная проекция, и `projections.polar.PolarAxes`, если используется полярная проекция.
Другие параметры:	**kwargs Этот метод также принимает ключевые аргументы для возвращаемого класса оси. Ключевые аргументы для класса прямолинейной оси `Axes` можно найти в следующей таблице, но могут быть и другие ключевые аргументы, если используется другая проекция, см. фактический класс оси.

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

`yscale`	{"линейный", "логарифмический", "симлогирифмический", "логит", ...} или `ScaleBase`
`yticklabels`	неизвестно
`yticks`	неизвестно
`zorder`	вещественное число

См. также

Figure.add_axes
pyplot.subplot
Figure.add_subplot
Figure.subplots
pyplot.subplots

Примечания

Если в графике уже есть ось с ключом (args, kwargs), она просто станет текущей и будет возвращена. Это поведение устарело. В то же время, если вы не хотите этого поведения (т.е. хотите принудительно создать новую ось), вы должны использовать уникальный набор аргументов и ключевых слов. Атрибут оси label был добавлен для этой цели: если вы хотите добавить две оси, которые в остальном идентичны в график, убедитесь, что у них разные метки.

Примеры

# Creating a new full window axes
plt.axes()

# Creating a new axes with specified dimensions and some kwargs
plt.axes((left, bottom, width, height), facecolor='w')