matplotlib.axes

Содержание

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

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

Inheritance diagram of matplotlib.axes.Axes

Класс Axes

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

Базы: matplotlib.axes._base._AxesBase

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

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

Атрибуты:	dataLim`Bbox` Прямоугольник, охватывающий все данные, отображаемые в осях. viewLim`Bbox` Пределы отображения в координатах данных.

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

Параметры:

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

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

END_OF_DOCUMENT_MARKER ```

Другие необязательные ключевые аргументы:

Свойство	Описание
`adjustable`	{'box', 'datalim'}
`agg_filter`	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
`alpha`	скаляр или None
`anchor`	2-кортеж с плавающей точкой или {'C', 'SW', 'S', 'SE', ...}
`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
`contains`	неизвестно
`facecolor` или fc	цвет
`figure`	`Figure`
`frame_on`	bool
`gid`	строка
`in_layout`	bool
`label`	объект
`navigate`	bool
`navigate_mode`	неизвестно
`path_effects`	`AbstractPathEffect`
`picker`	None или bool или float или вызываемый объект
`position`	[left, bottom, width, height] или `Bbox`
`prop_cycle`	неизвестно
`rasterization_zorder`	float или None
`rasterized`	bool
`sketch_params`	(scale: float, length: float, randomness: float)
`snap`	bool или None
`title`	строка
`transform`	`Transform`
`url`	строка
`visible`	bool
`xbound`	неизвестно
`xlabel`	строка
`xlim`	(bottom: float, top: float)
`xmargin`	число больше -0.5
`xscale`	{"linear", "log", "symlog", "logit", ...} или `ScaleBase`
`xticklabels`	неизвестно
`xticks`	неизвестно
`ybound`	неизвестно
`ylabel`	строка

`ylim`	(нижняя: float, верхняя: float)
`ymargin`	вещественное число, большее -0,5
`yscale`	{"линейный", "логарифмический", "симлогарифмический", "логит", ...} или `ScaleBase`
`yticklabels`	неизвестно
`yticks`	неизвестно
`zorder`	вещественное число

Возвращает:

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

Подграфики

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

Отображение графиков

Основные

`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`	Постройте спектrogramm.
`Axes.xcorr`	Постройте взаимную корреляцию между x и y.

Статистика

`Axes.boxplot`	Создать диаграмму размаха.
`Axes.violinplot`	Создать скрипичную диаграмму.
`Axes.violin`	Функция отрисовки для скрипичных диаграмм.
`Axes.bxp`	Функция отрисовки для диаграмм размаха.

Разбитые

`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.secondary_yaxis`	Добавить второстепенную ось Y на эту ось.

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

`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.get_frame_on`	Получить информацию о том, отображается ли прямоугольник осей.
`Axes.set_axisbelow`	Установить, находятся ли деления осей и линии сетки над или под большинством элементов.
`Axes.get_axisbelow`	Получить информацию о том, находятся ли деления осей и линии сетки над или под большинством элементов.
`Axes.grid`	Настроить линии сетки.
`Axes.get_facecolor`	Получить цвет заливки области осей.
`Axes.set_facecolor`	Установить цвет заливки области осей.

Цикл свойств

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

Оси / пределы

`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.update_datalim_bounds`	[Устарело] Расширить `datalim` Bbox так, чтобы он включал заданный `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.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`	Получить информацию о том, применяется ли автоматическое масштабирование для обеих осей при построении графиков.
`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`	Настройка формата меток делений, используемого по умолчанию для линейных осей.
`Axes.tick_params`	Изменение внешнего вида делений, меток делений и линий сетки.
`Axes.locator_params`	Управление поведением основных локаторов меток.

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

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

Добавление элементов

`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.twinx`	Создать оси, совмещающие ось абсцисс.
`Axes.twiny`	Создать оси, совмещающие ось ординат.
`Axes.sharex`	Разделить ось абсцисс с other.
`Axes.sharey`	Разделить ось ординат с other.
`Axes.get_shared_x_axes`	Возвращает ссылку на объект группировщика общих осей абсцисс.
`Axes.get_shared_y_axes`	Возвращает ссылку на объект группировщика общих осей ординат.

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

`Axes.get_anchor`	Получить положение якоря.
`Axes.set_anchor`	Определить положение якоря.
`Axes.get_axes_locator`	Возвращает axes_locator.
`Axes.set_axes_locator`	Установить axes locator.
`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.can_zoom`	Возвращает, поддерживает ли эти оси функциональность масштабирования прямоугольником.
`Axes.get_navigate`	Получить, реагирует ли область на команды навигации.
`Axes.set_navigate`	Установить, реагирует ли область на команды навигационной панели инструментов.
`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 как значение по оси абсцисс.
`Axes.format_ydata`	Возвращает отформатированное значение y как значение по оси ординат.
`Axes.mouseover`	Если данное свойство установлено в True, элемент запросит пользовательскую информацию контекста при наведении курсора мыши.
`Axes.in_axes`	Возвращает, находится ли заданное событие (в координатах отображения) в области.
`Axes.contains`	Проверка, содержит ли элемент событие мыши.
`Axes.contains_point`	Возвращает, находится ли точка (пара координат пикселей) внутри области.
`Axes.get_cursor_data`	Возвращает данные курсора для данного события.

Элементы

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

Отрисовка

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

Проекция

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