matplotlib.axes

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

Оглавление

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

Класс Axes

Axes

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

END_OF_DOCUMENT_MARKER

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

Основные

`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.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.boxplot`	Построение ящиковой диаграммы.
`Axes.violinplot`	Построение скрипичной диаграммы.
`Axes.violin`	Функция построения скрипичных диаграмм.
`Axes.bxp`	Функция построения ящиковых диаграмм.

Разбитые на интервалы

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

END_OF_DOCUMENT_MARKER

Контуры

`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.
`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`	Получить текстовую строку подписи для оси 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 (как строка).
`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`	Возвращает, будет ли область корректировать свои физические размеры ('box') или свои пределы данных ('datalim') для достижения желаемого соотношения сторон.

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

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

Единицы

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

END_OF_DOCUMENT_MARKER

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

`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.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 в пределах фигуры как `Bbox`.
`Axes.set_position`	Установить позицию Axes.

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

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

END_OF_DOCUMENT_MARKER

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

`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_renderer_cache`	[Устарело]
`Axes.get_rasterization_zorder`	Возвращает значение zorder, ниже которого элементы будут растрированы.
`Axes.set_rasterization_zorder`	Установить порог zorder для растрирования для векторной графики.
`Axes.get_window_extent`	Возвращает прямоугольник области Axes в пространстве отображения; args и kwargs пусты.
`Axes.get_tightbbox`	Возвращает плотное ограничивающее поле Axes, включая оси и их декораторы (подпись оси x, заголовок и т. д.).

END_OF_DOCUMENT_MARKER

Проекция

Методы, используемые 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. В будущем эти списки элементов могут быть заменены кортежами. Используйте, как если бы это был кортеж уже.

Параметры:

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`	Возвращает неизменяемый вид на группировщик совмещенных осей x.
`Axes.get_shared_y_axes`	Возвращает неизменяемый вид на группировщик совмещенных осей y.

matplotlib.axes

Класс Axes

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

Основные

Отрезки

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

Статистические

Разбитые на интервалы

Контуры

Массивы 2D

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

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

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

Очистка

Внешний вид

Цикл свойств

Ось / пределы

Ограничения оси и направление

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

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

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

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

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

Единицы

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

Двойникование и совместное использование

Позиция осей

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

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

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

Отрисовка

Проекция

Другие