Класс Axes

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

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

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

Содержание

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

Построение графиков

Основные

`Axes.plot`	Построение линий и/или маркеров на `Axes`.
`Axes.errorbar`	Построение диаграммы с ошибками.
`Axes.scatter`	Построение диаграммы рассеяния `x` по `y`.
`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`	Построить матрицу или массив как изображение.
`Axes.pcolor`	Создать псевдоцветной график 2-мерного массива.
`Axes.pcolorfast`	Псевдоцветной график 2-мерного массива.
`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`	Получить, установлено ли значение axis below в true или false
`Axes.grid`	Включить или выключить сетку осей.
`Axes.get_axis_bgcolor`	Устарело начиная с версии 2.0.
`Axes.get_facecolor`
`Axes.get_fc`
`Axes.set_facecolor`
`Axes.set_fc`
`Axes.set_axis_bgcolor`	Устарело начиная с версии 2.0.

Цикл свойств

`Axes.set_prop_cycle`	Установить цикл свойств для любых будущих команд построения графиков на этом Axes.
`Axes.set_color_cycle`	Установить цикл цветов для любых будущих команд построения графиков на этом Axes.

Ограничения осей

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

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

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

Подписи осей, заголовок и легенда

`Axes.get_xlabel`	Получить строку текста подписи оси x.
`Axes.get_ylabel`	Получить строку текста подписи оси y.
`Axes.set_xlabel`	Установить подпись для оси x.
`Axes.set_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.get_yscale`	Возвращает строку масштаба оси Y: linear, log, logit, symlog
`Axes.set_yscale`	Установить масштаб оси Y

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

`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.get_autoscale_on`	Получить, применяется ли автомасштабирование для обеих осей при командах построения графиков
`Axes.set_autoscale_on`	Установить, применяется ли автомасштабирование при командах построения графиков
`Axes.get_autoscalex_on`	Получить, применяется ли автомасштабирование по оси X при командах построения графиков
`Axes.set_autoscalex_on`	Установить, применяется ли автомасштабирование по оси X при командах построения графиков
`Axes.get_autoscaley_on`	Получить, применяется ли автомасштабирование по оси Y при командах построения графиков
`Axes.set_autoscaley_on`	Установить, применяется ли автомасштабирование по оси Y при командах построения графиков

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

`Axes.apply_aspect`	Используйте `_aspect()` и `_adjustable()` для изменения рамки осей или пределов отображения.
`Axes.get_aspect`
`Axes.set_aspect`	aspect
`Axes.get_adjustable`
`Axes.set_adjustable`	ПРИНИМАЕТ: [‘box’ \| ‘datalim’ \| ‘box-forced’]

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

`Axes.xaxis_date`	Настройка делений и меток оси абсцисс, рассматривая данные по оси x как даты.
`Axes.yaxis_date`	Настройка делений и меток оси ординат, рассматривая данные по оси y как даты.
`Axes.get_xmajorticklabels`	Получение основных меток делений оси абсцисс.
`Axes.get_xminorticklabels`	Получение второстепенных меток делений оси абсцисс.
`Axes.get_xticklabels`	Получение меток делений оси абсцисс в виде списка объектов `Text`.
`Axes.get_xticklines`	Получение линий делений оси абсцисс в виде списка объектов Line2D.
`Axes.get_xticks`	Возвращает метки делений оси абсцисс в виде списка координат.
`Axes.get_ymajorticklabels`	Получение основных меток делений оси ординат.
`Axes.get_yminorticklabels`	Получение второстепенных меток делений оси ординат.
`Axes.get_yticklabels`	Получение меток делений оси ординат в виде списка объектов `Text`.
`Axes.get_yticklines`	Получение линий делений оси ординат в виде списка объектов Line2D.
`Axes.get_yticks`	Возвращает метки делений оси ординат в виде списка координат.
`Axes.minorticks_off`	Убрать второстепенные деления с осей.
`Axes.minorticks_on`	Добавить автоматические второстепенные деления на оси.
`Axes.set_xticklabels`	Установить метки делений оси абсцисс с помощью списка строковых меток.
`Axes.set_xticks`	Установить метки делений оси абсцисс с помощью списка делений.
`Axes.set_yticklabels`	Установить метки делений оси ординат с помощью списка строковых меток.
`Axes.set_yticks`	Установить метки делений оси ординат с помощью списка делений.
`Axes.get_xgridlines`	Получение линий сетки оси абсцисс в виде списка объектов Line2D.
`Axes.get_ygridlines`	Получение линий сетки оси ординат в виде списка объектов Line2D.
`Axes.ticklabel_format`	Изменение формата меток делений, используемого по умолчанию для линейных осей.
`Axes.tick_params`	Изменение внешнего вида меток делений.
`Axes.locator_params`	Управление поведением локаторов меток делений.

Единицы измерения

`Axes.convert_xunits`	Для элементов на оси абсцисс, если ось поддерживает единицы измерения.
`Axes.convert_yunits`	Для элементов на оси ординат, если ось поддерживает единицы измерения.
`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.twiny`	Создать дублирующую ось, совмещенную по оси ординат.
`Axes.get_shared_x_axes`	Возвращает копию объекта группировщика совмещенных осей абсцисс.
`Axes.get_shared_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`	Установить положение осей

Async/Event based

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

Interactive

`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.hitlist`	Список дочерних элементов художника, содержащих событие мыши event.
`Axes.mouseover`
`Axes.in_axes`	Возвращает True, если заданное событие мыши (в координатах отображения)
`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.

Children

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

Drawing

`Axes.draw`	Отобразить все (линии графика, оси, метки)
`Axes.draw_artist`	Этот метод можно использовать только после первоначального отрисовки, который кэширует рендерер.
`Axes.redraw_in_frame`	Этот метод можно использовать только после первоначального отрисовки, который кэширует рендерер.
`Axes.get_renderer_cache`
`Axes.get_rasterization_zorder`	Получить значение z-порядка, ниже которого объекты будут растрированы
`Axes.set_rasterization_zorder`	Установить значение z-порядка, ниже которого объекты будут растрированы.
`Axes.get_window_extent`	Получить прямоугольник области осей в пространстве отображения; args и
`Axes.get_tightbbox`	Возвращает плотное (tight) ограничивающее прямоугольник области осей.

Изменение свойств в группах

`Axes.set`	Установщик свойств в группах.
`Axes.update`	Обновить свойства данного `Artist` из словаря 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`	Установить экземпляр `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`	Возвращает True, если объект должен быть растрирован.
`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`	Установить фигуру класса:`Axes`
`Axes.get_figure`	Возвращает экземпляр `Figure`, к которому принадлежит объект.

Методы объекта

`Axes.is_figure_set`	Возвращает True, если объект привязан к `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