matplotlib.pyplot.axes

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

Добавление осей к текущей фигуре и назначение их текущими осями.

Возможные варианты вызова:

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

Параметры:	`arg : { None, 4-tuple, Axes }` Точное поведение этой функции зависит от типа: None: Добавляются новые оси, занимающие всё окно, используя `subplot(111, *kwargs)` 4-кортеж с плавающими числами rect* = `[left, bottom, width, height]`. Добавляются новые оси с размерами rect в нормированных (0, 1) единицах, используя `add_axes` для текущей фигуры. `Axes`: Это эквивалентно `pyplot.sca`. Устанавливает текущие оси в arg. Примечание: это неявно меняет текущую фигуру на родительскую фигуру arg. Примечание Использование `axes.Axes` в качестве аргумента устарело и будет удалено в версии 3.0. Используйте `pyplot.sca` вместо этого. `projection : {None, 'aitoff', 'hammer', 'lambert', 'mollweide', 'polar', 'rectilinear', str}, optional` Тип проекции для `Axes`. str — имя пользовательской проекции, см. `projections`. По умолчанию None соответствует 'rectilinear' проекции. `polar : boolean, optional` Если True, эквивалентно projection='polar'. `sharex, sharey : Axes, optional` Разделить ось x или y с `axis` sharex и/или sharey. Ось будет иметь такие же пределы, деления и масштаб, как и ось уделяемых осей. `label : str` Метка возвращаемых осей.
Возвращает:	`axes : Axes (or a subclass of Axes)` Возвращаемый класс осей зависит от используемой проекции. Это `Axes`, если используется прямолинейная проекция, и `projections.polar.PolarAxes`, если используется полярная проекция.
Дополнительные параметры:	**kwargs Этот метод также принимает именованные аргументы для возвращаемого класса осей. Именованные аргументы для класса прямолинейных осей `Axes` можно найти в следующей таблице, но также могут быть другие именованные аргументы, если используется другая проекция, см. фактический класс осей.

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

`yscale`	{"линейный", "логарифмический", "симлогарифмический", "логит", ...}
`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')