matplotlib.axes

Класс Axes представляет собой один (под-)график в фигуре. Он содержит нарисованные данные, метки осей, подписи, заголовок, легенду и т. д. Его методы являются основным интерфейсом для управления графиком.

Содержание

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

Класс Axes

Axes

Объект Axes encapsulates all the elements of an individual (sub-)plot in a figure.

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

Основные

`Axes.plot`	Построение графика y по x в виде линий и/или маркеров.
`Axes.errorbar`	Построение графика y по x в виде линий и/или маркеров с ошибками.
`Axes.scatter`	Точечный график y по x.
`Axes.plot_date`	[Устаревший] Построение графика, принудительно интерпретирующего числа как даты.
`Axes.step`	Построение ступенчатого графика.
`Axes.loglog`	Построение графика с логарифмической шкалой по обеим осям.
`Axes.semilogx`	Построение графика с логарифмической шкалой по оси x.
`Axes.semilogy`	Построение графика с логарифмической шкалой по оси y.
`Axes.fill_between`	Заполнение области между двумя кривыми.
`Axes.fill_betweenx`	Заполнение области между двумя вертикальными кривыми.
`Axes.bar`	Построение столбчатой диаграммы.
`Axes.barh`	Построение горизонтальной столбчатой диаграммы.
`Axes.bar_label`	Подпись столбчатой диаграммы.
`Axes.stem`	Построение графика стебля.
`Axes.eventplot`	Построение параллельных линий в заданных позициях.
`Axes.pie`	Построение круговой диаграммы.
`Axes.stackplot`	Построение графика с накопленными областями или диаграммы потоков.
`Axes.broken_barh`	Построение последовательности горизонтальных прямоугольников.
`Axes.vlines`	Построение вертикальных линий в каждой точке x от ymin до ymax.
`Axes.hlines`	Построение горизонтальных линий в каждой точке y от xmin до xmax.
`Axes.fill`	Построение заполненных многоугольников.

Диапазоны

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

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

`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.ecdf`	Вычисление и построение эмпирической функции распределения кумулятивной частоты x.
`Axes.boxplot`	Построение диаграммы размаха.
`Axes.violinplot`	Построение скрипичного графика.
`Axes.bxp`	Построение диаграммы размаха из предварительно рассчитанных статистик.
`Axes.violin`	Построение скрипичного графика из предварительно рассчитанных статистик.

Гистограммы

`Axes.hexbin`	Построение 2D-диаграммы рассеяния с гексагональной разбивкой точек x, y.
`Axes.hist`	Вычисление и построение гистограммы.
`Axes.hist2d`	Построение 2D-гистограммы.
`Axes.stairs`	Рисование ступенчатой функции в виде линии или заполненного графика.

Контуры

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

Матрицы 2D

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

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

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

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

`Axes.annotate`	Аннотация точки xy текстом text.
`Axes.text`	Добавление текста на область графиков.
`Axes.table`	Добавление таблицы на область графиков `Axes`.
`Axes.arrow`	Добавление стрелки в область графиков.
`Axes.inset_axes`	Добавление вложенной области графиков в существующую область графиков.
`Axes.indicate_inset`	Добавление индикатора вложенной области графиков в область графиков.
`Axes.indicate_inset_zoom`	Добавление прямоугольника индикатора вложенной области графиков в область графиков, основанной на предельных значениях осей для inset_ax, и рисование соединителей между inset_ax и прямоугольником.
`Axes.secondary_xaxis`	Добавление второй оси X к этой `Axes`.
`Axes.secondary_yaxis`	Добавление второй оси Y к этой `Axes`.

Векторные поля

`Axes.barbs`	Построение 2D поля ветровых стрелок.
`Axes.quiver`	Построение 2D поля стрелок.
`Axes.quiverkey`	Добавление ключа к графику стрелок.
`Axes.streamplot`	Рисование линий тока векторного потока.

Очистка

`Axes.cla`	Очистка области графиков.
`Axes.clear`	Очистка области графиков.

Внешний вид

`Axes.axis`	Удобный метод для получения или задания некоторых свойств оси.
`Axes.set_axis_off`	Скрыть все визуальные компоненты оси x и оси y.
`Axes.set_axis_on`	Не скрывать все визуальные компоненты оси x и оси y.
`Axes.set_frame_on`	Установить, отображается ли прямоугольная область Axes.
`Axes.get_frame_on`	Получить, отображается ли прямоугольная область Axes.
`Axes.set_axisbelow`	Установить, находятся ли отметки и линии сетки над или под большинством элементов.
`Axes.get_axisbelow`	Получить, находятся ли отметки и линии сетки над или под большинством элементов.
`Axes.grid`	Настроить линии сетки.
`Axes.get_facecolor`	Получить цвет заливки области Axes.
`Axes.set_facecolor`	Установить цвет заливки области Axes.

Цикл свойств

Axes.set_prop_cycle

Установить цикл свойств области Axes.

Оси/пределы

`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` Bbox, чтобы включить заданные точки.
`Axes.set_xbound`	Установить нижнюю и верхнюю числовые границы оси x.
`Axes.get_xbound`	Возвратить нижнюю и верхнюю границы оси x в возрастающем порядке.
`Axes.set_ybound`	Установить нижнюю и верхнюю числовые границы оси y.
`Axes.get_ybound`	Возвратить нижнюю и верхнюю границы оси y в возрастающем порядке.

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

`Axes.set_xlabel`	Установить подпись для оси x.
`Axes.get_xlabel`	Получить текстовую строку подписи xlabel.
`Axes.set_ylabel`	Установить подпись для оси y.
`Axes.get_ylabel`	Получить текстовую строку подписи ylabel.
`Axes.label_outer`	Отобразить только подписи и метки делений "внешних" осей.
`Axes.set_title`	Установить заголовок для области Axes.
`Axes.get_title`	Получить заголовок области Axes.
`Axes.legend`	Поместить легенду на область Axes.
`Axes.get_legend`	Возвращает экземпляр `Legend`, или None, если легенда не определена.
`Axes.get_legend_handles_labels`	Возвращает маркеры и метки для легенды

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

`Axes.set_xscale`	Установить масштаб оси x.
`Axes.get_xscale`	Возвращает масштаб оси x (как строку).
`Axes.set_yscale`	Установить масштаб оси y.
`Axes.get_yscale`	Возвращает масштаб оси y (как строку).

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

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

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

`Axes.apply_aspect`	Настроить Axes для заданного соотношения сторон данных.
`Axes.set_aspect`	Установить соотношение сторон масштабирования Axes, т.е. масштаб y/x.
`Axes.get_aspect`	Возвращает соотношение сторон масштабирования Axes.
`Axes.set_box_aspect`	Установить соотношение сторон области Axes, т.е. отношение высоты к ширине.
`Axes.get_box_aspect`	Возвращает соотношение сторон области Axes, т.е. отношение высоты к ширине.
`Axes.set_adjustable`	Установить, как Axes будет подстраиваться под требуемое соотношение сторон.
`Axes.get_adjustable`	Возвращает, будет ли Axes корректировать свои физические размеры ('box') или пределы данных ('datalim'), чтобы достичь требуемого соотношения сторон.

Штрихи и метки штрихов

`Axes.set_xticks`	Устанавливает позиции делений оси x и, необязательно, метки делений.
`Axes.get_xticks`	Возвращает позиции делений оси x в координатах данных.
`Axes.set_xticklabels`	[Не рекомендуется] Устанавливает метки делений оси x списком строковых меток.
`Axes.get_xticklabels`	Возвращает метки делений оси x.
`Axes.get_xmajorticklabels`	Возвращает основные метки делений оси x в виде списка объектов `Text`.
`Axes.get_xminorticklabels`	Возвращает второстепенные метки делений оси x в виде списка объектов `Text`.
`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.
`Axes.get_ymajorticklabels`	Возвращает основные метки делений оси y в виде списка объектов `Text`.
`Axes.get_yminorticklabels`	Возвращает второстепенные метки делений оси y в виде списка объектов `Text`.
`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.
`Axes.convert_yunits`	Преобразует y, используя тип единиц оси y.
`Axes.have_units`	Возвращает, установлены ли единицы на любой оси.

Добавление художников

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

Положение Axes

`Axes.get_anchor`	Получить положение якоря.
`Axes.set_anchor`	Определить положение якоря.
`Axes.get_axes_locator`	Вернуть axes_locator.
`Axes.set_axes_locator`	Установить локатор Axes.
`Axes.get_subplotspec`	Возвращает связанное `SubplotSpec` подграфика, или None.
`Axes.set_subplotspec`	Установить `SubplotSpec`.
`Axes.reset_position`	Сбросить активное положение до исходного.
`Axes.get_position`	Возвращает положение Axes внутри Figure в виде `Bbox`.
`Axes.set_position`	Установить положение Axes.

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

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

Интерактивное

`Axes.can_pan`	Возвращает, поддерживает ли данный Axes функциональность перемещения/приближения.
`Axes.can_zoom`	Возвращает, поддерживает ли данный Axes функциональность масштабирования прямоугольником.
`Axes.get_navigate`	Получить, реагирует ли Axes на команды навигации.
`Axes.set_navigate`	Установить, реагирует ли Axes на команды навигационной панели.
`Axes.get_navigate_mode`	Получить состояние кнопки навигационной панели: 'PAN', 'ZOOM' или None.
`Axes.set_navigate_mode`	Установить состояние кнопки навигационной панели.
`Axes.get_forward_navigation_events`	Получить, как события перемещения/приближения передаются Axes, расположенным ниже данного.
`Axes.set_forward_navigation_events`	Установить, как события перемещения/приближения передаются Axes, расположенным ниже данного.
`Axes.start_pan`	Вызывается при начале операции перемещения.
`Axes.drag_pan`	Вызывается при перемещении мыши во время операции перемещения.
`Axes.end_pan`	Вызывается при завершении операции перемещения (при отпускании кнопки мыши).
`Axes.format_coord`	Возвращает строку форматирования координат x, y.
`Axes.format_cursor_data`	Возвращает строковое представление данных data.
`Axes.format_xdata`	Возвращает форматированное значение x как значение оси X.
`Axes.format_ydata`	Возвращает форматированное значение y как значение оси Y.
`Axes.mouseover`	Возвращает, запрашивается ли у данного элемента информация о контексте при перемещении курсора мыши над ним.
`Axes.in_axes`	Возвращает, находится ли данное событие (в координатах отображения) в пределах Axes.
`Axes.contains`	Проверяет, содержит ли элемент данное событие мыши.
`Axes.contains_point`	Возвращает, находится ли точка point (пара пиксельных координат) внутри области Axes.
`Axes.get_cursor_data`	Возвращает данные курсора для данного события.

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

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

Отрисовка

`Axes.draw`	Отрисовывает элемент (и его дочерние элементы) с помощью указанного рендерера.
`Axes.draw_artist`	Эффективно перерисовывает отдельный элемент.
`Axes.redraw_in_frame`	Эффективно перерисовывает данные Axes, но не деления осей, метки и т. д.
`Axes.get_rasterization_zorder`	Возвращает значение zorder, ниже которого элементы будут растровыми.
`Axes.set_rasterization_zorder`	Устанавливает порог zorder для растрирования для векторизованного вывода.
`Axes.get_window_extent`	Возвращает область Axes в пространстве отображения.
`Axes.get_tightbbox`	Возвращает ограничительную область Axes, включая оси и их декорации (подписи осей, заголовок и т. д.).

Проекция

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

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

Другие

`Axes.zorder`
`Axes.get_default_bbox_extra_artists`	Возвращает список по умолчанию элементов, используемых для расчета ограничивающего прямоугольника.
`Axes.get_transformed_clip_path_and_affine`	Возвращает путь обрезки с примененной не-аффинной частью преобразования и оставшейся аффинной частью преобразования.
`Axes.has_data`	Возвращает, содержатся ли какие-либо элементы в оси.
`Axes.set`	Устанавливает сразу несколько свойств.

classmatplotlib.axes.Axes.ArtistList(axes, prop_name, valid_types=None, invalid_types=None)

Подсписок элементов оси на основе их типа.

Подсписки элементов по типу в Matplotlib 3.7 стали неизменяемыми. В будущем эти списки элементов могут быть заменены кортежами. Используйте их как кортежи.

Parameters:

axesAxes: Ось, из которой будет взята подгруппа элементов.
prop_namestr: Имя свойства, используемое для доступа к этому подсписку из оси; используется для создания предупреждений о устаревании.
valid_typeslist of type, optional: Список типов, определяющих, какие элементы будут возвращены этим подсписком. Если указано, элементы подсписок должны быть экземплярами одного из этих типов. Если не указано, любой тип элемента допустим (кроме ограничений invalid_types).
invalid_typestuple, optional: Список типов, определяющих, какие элементы не будут возвращены этим подсписком. Если указано, элементы в подсписке никогда не будут экземплярами этих типов. В противном случае типы не будут исключены.

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