matplotlib.axes

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

Содержание

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

Класс Axes

Axes

Объект Axes encapsulates все элементы отдельного (под-)графика на рисунке.

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

Основные

`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`	Построить заполненные контуры.

Двумерные массивы

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

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

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

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

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

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

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

Очистка

`Axes.cla`	Очистить область Axes.
`Axes.clear`	Очистить область Axes.

Внешний вид

`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.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.set_aspect`	Установить соотношение сторон масштабирования осей, т.е. масштаб по оси y/x.
`Axes.get_aspect`	Возвращает соотношение сторон масштабирования осей.
`Axes.set_box_aspect`	Установить соотношение сторон области осей, т.е. отношение высоты к ширине.
`Axes.get_box_aspect`	Возвращает соотношение сторон области осей, т.е. отношение высоты к ширине.
`Axes.set_adjustable`	Установить, как оси будут подстраиваться для достижения требуемого соотношения сторон.
`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`	Возвращает, установлены ли единицы измерения на любой из осей.

END_OF_DOCUMENT_MARKER

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

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

Положение области рисования

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

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

`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.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, включая ось и ее декорации (метка оси x, заголовок и т. д.).

Проекция

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

`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 какие-либо элементы.
`Axes.set`	Установка нескольких свойств сразу.

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

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

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

Параметры:

axesAxes: Axes, из которого этот подсписок будет получать элементы Artists.
prop_namestr: Имя свойства, используемого для доступа к этому подсписку из Axes; используется для генерации предупреждений о устаревании.
valid_typesсписок типов, необязательно: Список типов, определяющих, какие элементы будут возвращены этим подсписком. Если указано, элементы в подсписке должны быть экземплярами любого из этих типов. Если не указано, любой тип элемента Artist допустим (если не ограничен invalid_types).
invalid_typesкортеж, необязательно: Список типов, определяющих, какие элементы не будут возвращены этим подсписком. Если указано, элементы в подсписке никогда не будут экземплярами этих типов. В противном случае типы не будут исключены.

`Axes.twinx`	Создать дублирующую область рисования, совмещая ось X.
`Axes.twiny`	Создать дублирующую область рисования, совмещая ось Y.
`Axes.sharex`	Использовать одну и ту же ось X с объектом other.
`Axes.sharey`	Использовать одну и ту же ось Y с объектом other.
`Axes.get_shared_x_axes`	Возвращает неизменяемый вид на группер общих осей X.
`Axes.get_shared_y_axes`	Возвращает неизменяемый вид на группер общих осей Y.