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', строка}, необязательно

Тип проекции Axes. строка — имя пользовательской проекции, см. projections. Значение по умолчанию None соответствует проекции 'rectilinear'.

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

Если True, эквивалентно projection='polar'.

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

Поделиться осью x или y axis с sharex и/или sharey. Ось будет иметь те же пределы, деления и масштаб, что и ось у сопоставленной оси.

labelстрока

Метка возвращаемых осей.

Возвращает

Axes, или подкласс Axes

Возвращаемый класс осей зависит от используемой проекции. Это Axes, если используется прямолинейная проекция, и projections.polar.PolarAxes, если используется полярная проекция.

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

**kwargs

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

Свойство	Описание
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'} или float
autoscale_on	bool
autoscalex_on	bool
autoscaley_on	bool
axes_locator	Callable[[Axes, Renderer], Bbox]
axisbelow	bool или 'line'
box_aspect	float или None
clip_box	Bbox
clip_on	bool
clip_path	Patch или (Path, Transform) или None
facecolor или fc	цвет
figure	Figure
frame_on	bool
gid	str
in_layout	bool
label	объект
navigate	bool
navigate_mode	неизвестно
path_effects	AbstractPathEffect
picker	None или bool или float или вызываемая функция
position	[левое, нижнее, ширина, высота] или Bbox
prop_cycle	неизвестно
rasterization_zorder	float или None
rasterized	bool
sketch_params	(масштаб: float, длина: float, случайность: float)
snap	bool или None
title	str
transform	Transform
url	str
visible	bool
xbound	неизвестно
xlabel	str
xlim	(нижняя граница: float, верхняя граница: float)
xmargin	float больше -0.5
xscale	{"linear", "log", "symlog", "logit", ...} или ScaleBase
xticklabels	неизвестно
xticks	неизвестно
ybound	неизвестно
ylabel	str

ylim	(нижняя граница: float, верхняя граница: float)
ymargin	float больше -0,5
yscale	{"линейный", "логарифмический", "симлогирифмический", "логит", ...} или ScaleBase
yticklabels	неизвестно
yticks	неизвестно
zorder	float

См. также

Figure.add_axes

pyplot.subplot

Figure.add_subplot

Figure.subplots

pyplot.subplots

Примечания

Если в графике уже есть ось с ключом (args, kwargs), то она просто станет текущей и будет возвращена. Это поведение устарело. В то же время, если вы не хотите этого поведения (т.е. хотите принудительно создать новую ось), вы должны использовать уникальный набор 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')

Примеры использования matplotlib.pyplot.axes