matplotlib.axes

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

Содержание

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

Класс Axes

Axes

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

Атрибуты

`Axes.viewLim`	Пределы видимой области в виде `Bbox` в координатах данных.
`Axes.dataLim`	Ограничивающий `Bbox`, охватывающий все данные, отображаемые на Axes.
`Axes.spines`	Контейнер `Spines` для рамок Axes, то есть линий, обозначающих границы области данных.

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

Основные

`Axes.plot`	Построить график зависимости y от x в виде линий и/или маркеров.
`Axes.errorbar`	Построить график зависимости y от x в виде линий и/или маркеров с полосами погрешностей.
`Axes.scatter`	Диаграмма рассеяния 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.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 или её части.
`Axes.axhspan`	Добавить горизонтальный интервал (прямоугольник) на Axes.
`Axes.axvline`	Добавить вертикальную линию, проходящую по всей высоте Axes или её части.
`Axes.axvspan`	Добавить вертикальный интервал (прямоугольник) на Axes.
`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`	Построить двумерную диаграмму с шестиугольным разбиением точек x, y.
`Axes.hist`	Вычислить и построить гистограмму.
`Axes.hist2d`	Построить двумерную гистограмму.
`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`	Добавить текстовую аннотацию text к точке xy.
`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`	Построить двумерное поле ветровых барбов.
`Axes.quiver`	Построить двумерное поле стрелок.
`Axes.quiverkey`	Добавить ключ к графику векторов.
`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`	Задать, должны ли деления осей и линии сетки располагаться поверх или под большинством объектов Artist.
`Axes.get_axisbelow`	Получить информацию о том, располагаются ли деления осей и линии сетки поверх или под большинством объектов Artist.
`Axes.grid`	Настроить линии сетки.
`Axes.get_facecolor`	Получить цвет фона Axes.
`Axes.set_facecolor`	Задать цвет фона Axes.

Цикл свойств

Axes.set_prop_cycle

Задать цикл свойств Axes.

Оси / пределы

Доступ к осям

`Axes.xaxis`	Экземпляр `XAxis`.
`Axes.yaxis`	Экземпляр `YAxis`.
`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`	Расширяет Bbox `dataLim`, чтобы включить заданные точки.
`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.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 (в виде str).
`Axes.set_yscale`	Задаёт масштаб оси y.
`Axes.get_yscale`	Возвращает масштаб оси y (в виде str).

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

`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`	Пересчитывает пределы данных на основе текущих объектов artist.
`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 трактовались как даты.
`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 трактовались как даты.
`Axes.minorticks_off`	Удаляет вспомогательные деления с Axes.
`Axes.minorticks_on`	Отображает вспомогательные деления на Axes.
`Axes.ticklabel_format`	Настраивает `ScalarFormatter`, используемый по умолчанию для линейных Axes.
`Axes.tick_params`	Изменяет внешний вид делений, их подписей и линий сетки.
`Axes.locator_params`	Управляет поведением локаторов основных делений.

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

`Axes.convert_xunits`	Преобразует x с использованием типа единиц оси x.
`Axes.convert_yunits`	Преобразует y с использованием типа единиц оси y.
`Axes.have_units`	Возвращает значение, указывающее, заданы ли единицы измерения хотя бы для одной оси.

Добавление объектов artist

`Axes.add_artist`	Добавляет `Artist` в Axes и возвращает этот объект.
`Axes.add_child_axes`	Добавляет `Axes` к дочерним элементам 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 и возвращает этот patch.
`Axes.add_table`	Добавляет `Table` в Axes и возвращает эту таблицу.

Положение осей

`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`	Указывает, является ли объект Artist устаревшим и требуется ли его перерисовать, чтобы отображаемый результат соответствовал внутреннему состоянию объекта Artist.
`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`	Вернуть, запрашивается ли у этого объекта Artist дополнительная контекстная информация при наведении курсора мыши.
`Axes.in_axes`	Вернуть, находится ли указанное событие (в координатах дисплея) внутри объекта Axes.
`Axes.contains`	Проверить, содержит ли объект Artist событие мыши.
`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`	Найти объекты Artist.

Отрисовка

`Axes.draw`	Отрисовать объект Artist (и его дочерние объекты) с помощью указанного средства визуализации.
`Axes.draw_artist`	Эффективно перерисовать один объект Artist.
`Axes.redraw_in_frame`	Эффективно перерисовать данные Axes, но не деления осей, подписи и т. д.
`Axes.get_rasterization_zorder`	Вернуть значение zorder, ниже которого объекты Artist будут растеризованы.
`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`	Вернуть стандартный список объектов Artist, используемых для вычисления ограничивающей рамки.
`Axes.get_transformed_clip_path_and_affine`	Вернуть контур отсечения с применённой неаффинной частью преобразования и оставшуюся аффинную часть преобразования.
`Axes.has_data`	Вернуть, были ли добавлены какие-либо объекты Artist в Axes.
`Axes.set`	Задать несколько свойств одновременно.
`Axes.remove`	Удалить объект Artist из фигуры, если это возможно.

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

Подсписок дочерних объектов Axes, отобранных по типу.

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

Параметры:

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

`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.