Класс Axes

class matplotlib.axes.Axes(fig, rect, facecolor=None, frameon=True, sharex=None, sharey=None, label='', xscale=None, yscale=None, **kwargs) [source]

Класс Axes содержит большинство элементов рисунка: Axis, Tick, Line2D, Text, Polygon и др., а также определяет систему координат.

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

Создайте экземпляр Axes в Figure fig с rect=[left, bottom, width, height] в координатах Figure.

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

Ключевое слово	Описание
adjustable	[ 'box' \| 'datalim' ]
alpha	вещественное число: прозрачность альфа-канала (может быть None)
anchor	[ 'C', 'SW', 'S', 'SE', 'E', 'NE', 'N', 'NW', 'W' ]
aspect	[ 'auto' \| 'equal' \| aspect_ratio ]
autoscale_on	логическое значение; нужно ли автоматически масштабировать viewlim
axisbelow	[ bool \| 'line' ] отображать сетку и деления ниже или выше большинства других объектов, или ниже линий, но выше областей
cursor_props	кортеж (вещественное число, цвет)
figure	экземпляр `Figure`
frame_on	логическое значение; нужно ли рисовать рамку осей
label	метка оси
navigate	логическое значение
navigate_mode	[ 'PAN' \| 'ZOOM' \| None ] состояние кнопки инструментария навигации
position	[left, bottom, width, height] в координатах класса:`Figure`
sharex	экземпляр класса:`Axes` для совместного использования оси x
sharey	экземпляр класса:`Axes` для совместного использования оси y
title	строка заголовка
visible	логическое значение, отображать ли ось
xlabel	метка оси x
xlim	(xmin, xmax) пределы отображения
xscale	['linear' \| 'log' \| 'logit' \| 'symlog']
xticklabels	последовательность строк
xticks	последовательность вещественных чисел
ylabel	строка метки оси y
ylim	(ymin, ymax) пределы отображения
yscale	['linear' \| 'log' \| 'logit' \| 'symlog']
yticklabels	последовательность строк
yticks	последовательность вещественных чисел

Оглавление

Построение графиков
Очистка
Внешний вид
Цикл свойств
Оси / пределы
Единицы измерения
Добавление элементов
Двойничатие
Позиционирование осей
Асинхронные/событийно-ориентированные
Интерактив
Дочерние элементы
Рисование
Массовая манипуляция свойствами
Общие свойства элементов
Методы элементов
Проекция

Другое
Наследование

Графики

Основные

`Axes.plot`	Построение графика y от x с линиями и/или маркерами.
`Axes.errorbar`	Построение графика y от x с линиями и/или маркерами с ошибками.
`Axes.scatter`	Точечный график y от x с изменяющимся размером и/или цветом маркеров.
`Axes.plot_date`	Построение графика с данными, содержащими даты.
`Axes.step`	Построение ступенчатого графика.
`Axes.loglog`	Построение графика с логарифмической шкалой по обеим осям (x и y).
`Axes.semilogx`	Построение графика с логарифмической шкалой по оси x.
`Axes.semilogy`	Построение графика с логарифмической шкалой по оси y.
`Axes.fill_between`	Заполнение области между двумя кривыми.
`Axes.fill_betweenx`	Заполнение области между двумя вертикальными кривыми.
`Axes.bar`	Построение столбчатой диаграммы.
`Axes.barh`	Построение горизонтальной столбчатой диаграммы.

`Axes.stem`	Создать диаграмму столбцов.
`Axes.eventplot`	Построить идентичные параллельные линии в заданных позициях.
`Axes.pie`	Построить круговую диаграмму.
`Axes.stackplot`	Рисует ступенчатую облачную диаграмму.
`Axes.broken_barh`	Построить горизонтальную последовательность прямоугольников.
`Axes.vlines`	Построить вертикальные линии.
`Axes.hlines`	Построить горизонтальные линии в каждой точке y от xmin до xmax.
`Axes.fill`	Построить заполненные многоугольники.

Диапазоны

`Axes.axhline`	Добавить горизонтальную линию через ось.
`Axes.axhspan`	Добавить горизонтальный диапазон (прямоугольник) через ось.
`Axes.axvline`	Добавить вертикальную линию через оси.
`Axes.axvspan`	Добавить вертикальный диапазон (прямоугольник) через оси.

Спектральный

`Axes.acorr`	Построение автокорреляционной функции x.
`Axes.angle_spectrum`	Построение спектра фаз.
`Axes.cohere`	Построение когерентности между x и y.
`Axes.csd`	Построение спектральной плотности перекрёстной корреляции.
`Axes.magnitude_spectrum`	Построение спектра модулей.
`Axes.phase_spectrum`	Построение спектра фаз.
`Axes.psd`	Построение спектральной плотности мощности.
`Axes.specgram`	Построение спектрограммы.
`Axes.xcorr`	Построение взаимной корреляции между x и y.

Статистика

`Axes.boxplot`	Создать диаграмму размаха.
`Axes.violinplot`	Создать диаграмму "скрипка".
`Axes.violin`	Функция рисования диаграмм "скрипка".
`Axes.bxp`	Функция рисования диаграмм размаха.

Бины

`Axes.hexbin`	Создать диаграмму с гексагональным разбиением.
`Axes.hist`	Построить гистограмму.
`Axes.hist2d`	Построить 2D гистограмму.

Контуры

`Axes.clabel`	Подписать контурный график.
`Axes.contour`	Построить контурные линии.
`Axes.contourf`	Построить контурные области.

Массив

`Axes.imshow`	Отображение изображения на осях.
`Axes.matshow`	Построение значений 2D матрицы или массива в виде цветного изображения.
`Axes.pcolor`	Создание псевдоцветного графика с нерегулярной прямоугольной сеткой.
`Axes.pcolorfast`	Создание псевдоцветного графика с нерегулярной прямоугольной сеткой.
`Axes.pcolormesh`	Создание псевдоцветного графика с нерегулярной прямоугольной сеткой.
`Axes.spy`	Построение схемы разреженности на 2-мерном массиве.

Неструктурированные треугольники

`Axes.tripcolor`	Создание псевдоцветного графика неструктурированной треугольной сетки.
`Axes.triplot`	Отображение неструктурированной треугольной сетки в виде линий и/или маркеров.
`Axes.tricontour`	Отрисовка контуров на неструктурированной треугольной сетке.
`Axes.tricontourf`	Отрисовка контуров на неструктурированной треугольной сетке.

Текст и аннотации

`Axes.annotate`	Добавить аннотацию к точке `xy` с текстом `s`.
`Axes.text`	Добавить текст на оси.
`Axes.table`	Добавить таблицу на текущие оси.
`Axes.arrow`	Добавить стрелку на оси.

Поля

`Axes.barbs`	Построение 2-мерного поля стрелок-стержней.
`Axes.quiver`	Построение 2-мерного поля векторов.
`Axes.quiverkey`	Добавление ключа к графику векторов.
`Axes.streamplot`	Отображает линии потока векторного поля.

Очистка

`Axes.cla`	Очистить текущие оси.
`Axes.clear`	Очистить оси.

Внешний вид

`Axes.axis`	Установить свойства осей.
`Axes.set_axis_off`	Отключить оси.
`Axes.set_axis_on`	Включить оси.
`Axes.set_frame_on`	Установить, отображается ли прямоугольная область осей.
`Axes.get_frame_on`	Получить, отображается ли прямоугольная область осей.
`Axes.set_axisbelow`	Установить, находятся ли метки осей и линии сетки над или под большинством других элементов.
`Axes.get_axisbelow`	Получить, находятся ли метки осей и линии сетки над или под большинством других элементов.
`Axes.grid`	Включить или отключить сетку осей.
`Axes.get_facecolor`	Получить цвет фона области осей.
`Axes.get_fc`	Получить цвет фона области осей.
`Axes.set_facecolor`	Установить цвет фона области осей.
`Axes.set_fc`	Установить цвет фона области осей.

Цикл свойств

`Axes.set_prop_cycle`	Установить цикл свойств Axes.
`Axes.set_color_cycle`	Устарело начиная с версии 1.5.

Ось / Пределы

`Axes.get_xaxis`	Возвращает экземпляр XAxis.
`Axes.get_yaxis`	Возвращает экземпляр YAxis.

Пределы осей и направление

`Axes.invert_xaxis`	Инвертировать ось x.
`Axes.xaxis_inverted`	Возвращает, инвертирована ли ось x.
`Axes.invert_yaxis`	Инвертировать ось y.
`Axes.yaxis_inverted`	Возвращает, инвертирована ли ось y.
`Axes.set_xlim`	Установить пределы данных для оси x
`Axes.get_xlim`	Получить диапазон оси x
`Axes.set_ylim`	Установить пределы данных для оси y
`Axes.get_ylim`	Получить диапазон оси y
`Axes.update_datalim`	Обновить область данных datalim последовательностью кортежей xy или эквивалентом.
`Axes.update_datalim_bounds`	Обновить datalim, включив заданные `Bbox` пределы
`Axes.set_xbound`	Установить нижние и верхние числовые пределы оси x.

`Axes.get_xbound`	Возвращает нижнюю и верхнюю границы оси x в порядке возрастания.
`Axes.set_ybound`	Устанавливает нижнюю и верхнюю числовые границы оси y.
`Axes.get_ybound`	Возвращает нижнюю и верхнюю границы оси y в порядке возрастания.

Оси, заголовок и легенда

`Axes.set_xlabel`	Установить метку для оси X.
`Axes.get_xlabel`	Получить строку текста метки оси X.
`Axes.set_ylabel`	Установить метку для оси Y.
`Axes.get_ylabel`	Получить строку текста метки оси Y.
`Axes.set_title`	Установить заголовок для осей.
`Axes.get_title`	Получить заголовок осей.
`Axes.legend`	Размещает легенду на осях.
`Axes.get_legend`	Возвращает экземпляр `Legend`, или None, если легенда не определена.
`Axes.get_legend_handles_labels`	Возвращает маркеры и метки для легенды

Масштабы осей

`Axes.set_xscale`	Установить масштаб оси X.
`Axes.get_xscale`	Возвращает строку масштаба оси X: linear, log, logit, symlog
`Axes.set_yscale`	Установить масштаб оси Y.
`Axes.get_yscale`	Возвращает строку масштаба оси Y: linear, log, logit, symlog

Автомасштабирование и отступы

`Axes.use_sticky_edges`	При автомасштабировании, нужно ли учитывать все `Artist.sticky_edges`.
`Axes.margins`	Установить или получить отступы автомасштабирования.
`Axes.set_xmargin`	Установить отступ пределов данных по оси X перед автомасштабированием.
`Axes.set_ymargin`	Установить отступ пределов данных по оси Y перед автомасштабированием.
`Axes.relim`	Пересчитать пределы данных на основе текущих элементов.
`Axes.autoscale`	Автомасштабировать область отображения по данным (переключатель).
`Axes.autoscale_view`	Автомасштабировать пределы отображения, используя пределы данных.
`Axes.set_autoscale_on`	Установить, применяется ли автомасштабирование при командах построения графика.
`Axes.get_autoscale_on`	Получить, применяется ли автомасштабирование по обеим осям при командах построения графика.
`Axes.set_autoscalex_on`	Установить, применяется ли автомасштабирование по оси X при командах построения графика.

`Axes.get_autoscalex_on`	Получить, включена ли автоматическая подстройка масштаба по оси x при построении графиков
`Axes.set_autoscaley_on`	Установить, включена ли автоматическая подстройка масштаба по оси y при построении графиков
`Axes.get_autoscaley_on`	Получить, включена ли автоматическая подстройка масштаба по оси y при построении графиков

Соотношение сторон

`Axes.apply_aspect`	Настройка осей для заданного соотношения сторон данных.
`Axes.set_aspect`	Установить соотношение сторон масштабирования осей, т.е.
`Axes.get_aspect`
`Axes.set_adjustable`	Определить, какой параметр оси изменится для достижения заданного соотношения сторон.
`Axes.get_adjustable`

Деления и метки делений

`Axes.set_xticks`	Установить метки по оси X со списком делений
`Axes.get_xticks`	Возвращает метки по оси X в виде списка расположений
`Axes.set_xticklabels`	Установить метки делений оси X со списком строковых меток.
`Axes.get_xticklabels`	Получить метки делений оси X в виде списка экземпляров `Text`.
`Axes.get_xmajorticklabels`	Получить основные метки делений по оси X.
`Axes.get_xminorticklabels`	Получить дополнительные метки делений по оси X.
`Axes.get_xgridlines`	Получить линии сетки по оси X в виде списка экземпляров `Line2D`.
`Axes.get_xticklines`	Получить линии делений по оси X в виде списка экземпляров `Line2D`.
`Axes.xaxis_date`	Настройка делений и меток оси X, рассматривая данные по оси X как даты.
`Axes.set_yticks`	Установить метки по оси Y со списком делений

`Axes.get_yticks`	Возвращает метки оси Y в виде списка положений
`Axes.set_yticklabels`	Устанавливает метки оси Y с помощью списка строк меток.
`Axes.get_yticklabels`	Возвращает метки делений оси Y в виде списка экземпляров `Text`.
`Axes.get_ymajorticklabels`	Возвращает метки основных делений оси Y.
`Axes.get_yminorticklabels`	Возвращает метки дополнительных делений оси Y.
`Axes.get_ygridlines`	Возвращает линии сетки оси Y в виде списка экземпляров `Line2D`.
`Axes.get_yticklines`	Возвращает линии делений оси Y в виде списка экземпляров `Line2D`.
`Axes.yaxis_date`	Настраивает деления и метки оси Y, обрабатывая данные Y как даты.
`Axes.minorticks_off`	Удаляет дополнительные деления с оси.
`Axes.minorticks_on`	Добавляет автоматическое масштабирование дополнительных делений на ось.

`Axes.ticklabel_format`	Изменить `ScalarFormatter`, используемый по умолчанию для линейных осей.
`Axes.tick_params`	Изменить внешний вид делений, меток делений и линий сетки.
`Axes.locator_params`	Управление поведением локаторов делений.

Единицы

`Axes.convert_xunits`	Для элементов на оси, если ось x поддерживает единицы, преобразовать x с использованием типа единиц оси x
`Axes.convert_yunits`	Для элементов на оси, если ось y поддерживает единицы, преобразовать y с использованием типа единиц оси y
`Axes.have_units`	Возвращает True, если для осей x или y установлены единицы

Добавление элементов

`Axes.add_artist`	Добавить любой `Artist` на ось.
`Axes.add_collection`	Добавить экземпляр `Collection` на ось.
`Axes.add_container`	Добавить экземпляр `Container` на ось.
`Axes.add_image`	Добавить `AxesImage` на ось.
`Axes.add_line`	Добавить `Line2D` в список линий графика
`Axes.add_patch`	Добавить `Patch` p в список элементов области графика; область обрезки будет установлена в область обрезки оси.
`Axes.add_table`	Добавить экземпляр `Table` в список таблиц области графика

Дублирование

`Axes.twinx`	Создать дублирующее Axes, использующее общую ось x
`Axes.twiny`	Создать дублирующее Axes, использующее общую ось y
`Axes.get_shared_x_axes`	Возвращает ссылку на объект Grouper общих осей x.
`Axes.get_shared_y_axes`	Возвращает ссылку на объект Grouper общих осей y.

Положение Axes

`Axes.get_anchor`	Получить положение якоря.
`Axes.set_anchor`	Определить положение якоря.
`Axes.get_axes_locator`	Возвращает axes_locator.
`Axes.set_axes_locator`	Установить axes locator.
`Axes.reset_position`	Сбросить активное положение до исходного.
`Axes.get_position`	Получить копию прямоугольника осей как `Bbox`.
`Axes.set_position`	Установить положение осей.

Асинхронно/основанное на событиях

`Axes.stale`	Если художник "застарел" и его нужно перерисовать, чтобы вывод соответствовал внутреннему состоянию художника.
`Axes.pchanged`	Сгенерировать событие при изменении свойства, вызвав все зарегистрированные обратные вызовы.
`Axes.add_callback`	Добавляет функцию обратного вызова, которая будет вызываться всякий раз, когда изменяется одно из свойств `Artist`.
`Axes.remove_callback`	Удалить обратный вызов по его id.

Взаимодействие

`Axes.can_pan`	Возвращает True, если этот объект оси поддерживает функции перемещения/приближения.
`Axes.can_zoom`	Возвращает True, если эта ось поддерживает функцию приближения по прямоугольнику.
`Axes.get_navigate`	Получить, реагирует ли ось на команды навигации.
`Axes.set_navigate`	Установить, реагирует ли ось на команды навигации в панели инструментов.
`Axes.get_navigate_mode`	Получить состояние кнопки навигации в панели инструментов: 'ПЕРЕМЕЩЕНИЕ', 'ПРИБЛИЖЕНИЕ' или None.
`Axes.set_navigate_mode`	Установить состояние кнопки навигации в панели инструментов;
`Axes.start_pan`	Вызывается при начале операции перемещения.
`Axes.drag_pan`	Вызывается при перемещении мыши во время операции перемещения.
`Axes.end_pan`	Вызывается при завершении операции перемещения (когда кнопка мыши отпущена).
`Axes.format_coord`	Возвращает строку форматирования координат x, y.

`Axes.format_cursor_data`	Возвращает отформатированную строку данных курсора.
`Axes.format_xdata`	Возвращает отформатированную строку x.
`Axes.format_ydata`	Возвращает отформатированную строку y.
`Axes.mouseover`
`Axes.in_axes`	Возвращает True, если заданное событие мыши (в координатах отображения) находится в области Axes.
`Axes.pick`	Вызвать событие выбора.
`Axes.pickable`	Возвращает True, если `Artist` можно выбрать.
`Axes.get_picker`	Возвращает объект пикера, используемый этим объектом.
`Axes.set_picker`	Установить эпсилон для выбора, используемый этим объектом.
`Axes.set_contains`	Заменить тест принадлежности, используемый этим объектом.
`Axes.get_contains`	Возвращает тест _contains, используемый объектом, или None для значения по умолчанию.

`Axes.contains`	Проверка, произошла ли обработка события мыши в области графика.
`Axes.contains_point`	Возвращает True, если точка (кортеж x, y) находится внутри области графика (области, заданной её областью).
`Axes.get_cursor_data`	Получить данные курсора для данного события.
`Axes.get_cursor_props`	Устарело начиная с версии 2.1.
`Axes.set_cursor_props`	Устарело начиная с версии 2.1.

Дочерние элементы

`Axes.get_children`	возвращает список дочерних элементов-графических объектов
`Axes.get_images`	возвращает список изображений Axes, содержащихся в Axes
`Axes.get_lines`	Возвращает список линий, содержащихся в области графика.
`Axes.findobj`	Найти объекты графических элементов.

Отрисовка

Axes.draw Отобразить всё (линии графика, оси, метки)

Axes.draw_artist Этот метод можно использовать только после начального отображения, которое кеширует рендерер.

Axes.redraw_in_frame Этот метод можно использовать только после начального отображения, которое кеширует рендерер.

Axes.get_renderer_cache

Axes.get_rasterization_zorder Возвращает значение z-порядка, ниже которого элементы будут растрированы.

Axes.set_rasterization_zorder

Параметры:

Axes.get_window_extent Получить прямоугольник области осей в пространстве отображения; args и kwargs пусты

Axes.get_tightbbox Возвращает плотное (tight) ограничивающее прямоугольник области осей.

Массовая обработка свойств

`Axes.set`	Партионный установщик свойств.
`Axes.update`	Обновление свойств этого объекта из словаря prop.
`Axes.properties`	возвращает словарь, отображающий имя свойства -> значение для всех свойств объекта Artist
`Axes.update_from`	Копирование свойств из other в self.

Общие свойства объекта Artist

`Axes.set_agg_filter`	Установить фильтр agg.
`Axes.set_alpha`	Установить значение альфа для смешивания — не поддерживается во всех бэкендах.
`Axes.set_animated`	Установить состояние анимации объекта.
`Axes.set_clip_box`	Установить область обрезки объекта `Bbox`.
`Axes.set_clip_on`	Установить, использует ли объект обрезку.
`Axes.set_clip_path`	Установить путь обрезки объекта, который может быть:
`Axes.set_gid`	Устанавливает идентификатор (группы) объекта.
`Axes.set_label`	Устанавливает метку для автоматической легенды.
`Axes.set_path_effects`	Установить эффекты пути.
`Axes.set_rasterized`	Принудительное растрирование (рисование битовой картой) в выходном изображении векторного бэкенда.
`Axes.set_sketch_params`	Устанавливает параметры наброска.

`Axes.set_snap`	Устанавливает настройку привязки, которая может быть:
`Axes.set_transform`	Установить преобразование объекта.
`Axes.set_url`	Устанавливает URL для объекта.
`Axes.set_visible`	Установить видимость объекта.
`Axes.set_zorder`	Установить z-порядок для объекта.
`Axes.get_agg_filter`	Возвращает функцию фильтра для использования с agg фильтром.
`Axes.get_alpha`	Возвращает значение альфа-канала, используемого для смешивания. Не поддерживается во всех бэкендах.
`Axes.get_animated`	Возвращает состояние анимации объекта.
`Axes.get_clip_box`	Возвращает область обрезки объекта.
`Axes.get_clip_on`	Возвращает, использует ли объект обрезку.
`Axes.get_clip_path`	Возвращает путь обрезки объекта.
`Axes.get_gid`	Возвращает идентификатор группы.

`Axes.get_label`	Получить метку, используемую для этого объекта в легенде.
`Axes.get_path_effects`
`Axes.get_rasterized`	Возвращает значение, указывающее, должен ли объект быть растрированным.
`Axes.get_sketch_params`	Возвращает параметры зарисовки для объекта.
`Axes.get_snap`	Возвращает настройку привязки, которая может быть:
`Axes.get_transform`	Возвращает экземпляр `Transform`, используемый этим объектом.
`Axes.get_url`	Возвращает URL.
`Axes.get_visible`	Возвращает видимость объекта.
`Axes.get_zorder`	Возвращает порядок z объекта.
`Axes.axes`	Экземпляр `Axes`, в котором находится объект, или None.

`Axes.set_figure`	Установить `Figure` для данного `Axes`.
`Axes.get_figure`	Возвращает экземпляр `Figure`, к которому принадлежит объект-художник.

Методы объектов-художников

`Axes.remove`	Удалить объект-художника из фигуры, если это возможно.
`Axes.is_transform_set`	Возвращает True, если для `Artist` явно задан преобразователь.

Проекция

Методы, используемые Axis, которые необходимо переопределять для осей, не являющихся прямоугольными.

`Axes.name`
`Axes.get_xaxis_transform`	Получить преобразование, используемое для рисования меток, делений и линий сетки оси X.
`Axes.get_yaxis_transform`	Получить преобразование, используемое для рисования меток, делений и линий сетки оси Y.
`Axes.get_data_ratio`	Возвращает коэффициент масштаба исходных данных.
`Axes.get_data_ratio_log`	Возвращает коэффициент масштаба исходных данных в логарифмическом масштабе.
`Axes.get_xaxis_text1_transform`	Получить преобразование, используемое для рисования меток оси X, которое добавит заданное количество отступов (в пунктах) между осями и меткой.
`Axes.get_xaxis_text2_transform`	Получить преобразование, используемое для рисования меток вторичной оси X, которое добавит заданное количество отступов (в пунктах) между осями и меткой.
`Axes.get_yaxis_text1_transform`	Получить преобразование, используемое для рисования меток оси Y, которое добавит заданное количество отступов (в пунктах) между осями и меткой.

Axes.get_yaxis_text2_transform Получить преобразование, используемое для рисования меток вторичной оси Y, которое добавит указанное количество отступов (в пунктах) между осями и меткой.

Другие

`Axes.zorder`
`Axes.aname`
`Axes.get_default_bbox_extra_artists`
`Axes.get_transformed_clip_path_and_affine`	Возвращает обрезной путь с примененной неаффинной частью его преобразования и оставшейся аффинной частью его преобразования.
`Axes.has_data`	Возвращает True, если на оси были добавлены какие-либо объекты.
`Axes.hold`	Устарело начиная с версии 2.0.
`Axes.ishold`	Устарело начиная с версии 2.0.

Наследование

Inheritance diagram of matplotlib.axes.Axes