matplotlib.axes

Содержание

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

Наследование

Inheritance diagram of matplotlib.axes.Axes

Класс Axes

classmatplotlib.axes.Axes(fig, rect, *, facecolor=None, frameon=True, sharex=None, sharey=None, label='', xscale=None, yscale=None, box_aspect=None, **kwargs)[source]

Bases: matplotlib.axes._base._AxesBase

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

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

Атрибуты

dataLimBbox: Прямоугольник, содержащий все данные, отображённые в осях.
viewLimBbox: Пределы отображения в координатах данных.

Создаёт область Axes в фигуре.

Параметры

figFigure: Область Axes создаётся в Figure fig.
rect[left, bottom, width, height]: Область Axes создаётся в прямоугольнике rect. rect указаны в координатах Figure.
sharex, shareyAxes, optional: Ось x или y совмещается с осью x или y в входящей Axes.
frameonbool, по умолчанию: True: Показывать рамку области Axes.
box_aspectfloat, optional: Установить фиксированное соотношение сторон для области Axes, т. е. отношение высоты к ширине. Смотрите set_box_aspect для подробностей.
**kwargs: Другие необязательные ключевые параметры:

Свойство	Описание
`adjustable`	{'box', 'datalim'}
`agg_filter`	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
`alpha`	скаляр или None
`anchor`	(float, float) или {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
`animated`	bool
`aspect`	{'auto', 'equal'} или float
`autoscale_on`	bool
`autoscalex_on`	bool
`autoscaley_on`	bool
`axes_locator`	Callable[[Axes, Renderer], Bbox]
`axisbelow`	bool или 'line'
`box_aspect`	float или None
`clip_box`	`Bbox`
`clip_on`	bool
`clip_path`	Patch или (Path, Transform) или None
`facecolor` или fc	цвет
`figure`	`Figure`
`frame_on`	bool
`gid`	str
`in_layout`	bool
`label`	объект
`navigate`	bool
`navigate_mode`	неизвестно
`path_effects`	`AbstractPathEffect`
`picker`	None или bool или float или вызываемый объект
`position`	[слева, снизу, ширина, высота] или `Bbox`
`prop_cycle`	неизвестно
`rasterization_zorder`	float или None
`rasterized`	bool
`sketch_params`	(масштаб: float, длина: float, случайность: float)
`snap`	bool или None
`title`	строка
`transform`	`Transform`
`url`	строка
`visible`	bool
`xbound`	неизвестно
`xlabel`	строка
`xlim`	(нижняя граница: float, верхняя граница: float)
`xmargin`	float больше -0.5
`xscale`	{"линейный", "логарифмический", "симлогарифмический", "логит", ...} или `ScaleBase`
`xticklabels`	неизвестно
`xticks`	неизвестно
`ybound`	неизвестно

END_OF_DOCUMENT_MARKER

`ylabel`	str
`ylim`	(bottom: float, top: float)
`ymargin`	число, большее -0.5
`yscale`	{"linear", "log", "symlog", "logit", ...} или `ScaleBase`
`yticklabels`	неизвестно
`yticks`	неизвестно
`zorder`	число с плавающей точкой

Возвращает

Axes: Объект нового Axes.

Подграфики

`SubplotBase`	Базовый класс для подграфиков, которые являются экземплярами `Axes` с дополнительными методами для облегчения создания и манипулирования набором `Axes` внутри фигуры.
`subplot_class_factory`

Графики

Основные

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

Разбитые по группам

`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`	Добавить аннотацию к точке 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`	Добавить ключ к графику стрелок.
`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` область, чтобы включить заданные точки.
`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.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 (как строку).
`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`	Устанавливает расположение делений оси 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.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.reset_position`	Сбросить активное положение до исходного.
`Axes.get_position`	Вернуть позицию Axes внутри фигуры как `Bbox`.
`Axes.set_position`	Установить позицию Axes.

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

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