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]

Bases: matplotlib.axes._base._AxesBase

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

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

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

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

Параметры:

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

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

END_OF_DOCUMENT_MARKER

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

Свойство	Описание
`adjustable`	{'box', 'datalim'}
`agg_filter`	функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив чисел с плавающей точкой (m, n, 3)
`alpha`	число с плавающей точкой или None
`anchor`	2-кортеж чисел с плавающей точкой или {'C', 'SW', 'S', 'SE', ...}
`animated`	булево значение
`aspect`	{'auto'} или число
`autoscale_on`	булево значение
`autoscalex_on`	булево значение
`autoscaley_on`	булево значение
`axes_locator`	Callable[[Axes, Renderer], Bbox]
`axisbelow`	булево значение или 'line'
`box_aspect`	None или число
`clip_box`	`Bbox`
`clip_on`	булево значение
`clip_path`	Объект Patch или (Path, Transform) или None
`contains`	неизвестно
`facecolor` или fc	цвет
`figure`	`Figure`
`frame_on`	булево значение
`gid`	строка
`in_layout`	булево значение
`label`	объект

`navigate`	bool
`navigate_mode`	неизвестно
`path_effects`	`AbstractPathEffect`
`picker`	None или bool или вызываемый объект
`position`	[слева, снизу, ширина, высота] или `Bbox`
`prop_cycle`	неизвестно
`rasterization_zorder`	float или None
`rasterized`	bool или None
`sketch_params`	(масштаб: float, длина: float, случайность: float)
`snap`	bool или None
`title`	строка
`transform`	`Transform`
`url`	строка
`visible`	bool
`xbound`	неизвестно
`xlabel`	строка
`xlim`	(низ: float, верх: float)
`xmargin`	float, больше чем -0.5
`xscale`	{"линейный", "логарифмический", "симлогирифмический", "логит", ...}
`xticklabels`	неизвестно
`xticks`	неизвестно
`ybound`	неизвестно

`ylabel`	строка
`ylim`	(нижний: число с плавающей точкой, верхний: число с плавающей точкой)
`ymargin`	число больше -0,5
`yscale`	{"линейный", "логарифмический", "симлогический", "логитический", ...}
`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.stem`	Построение графика стебля.
`Axes.eventplot`	Построение идентичных параллельных линий в заданных позициях.
`Axes.pie`	Построение круговой диаграммы.
`Axes.stackplot`	Построение стопки областей.
`Axes.broken_barh`	Построение горизонтальной последовательности прямоугольников.
`Axes.vlines`	Построение вертикальных линий.
`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`	Построение 2D-диаграммы гексагональной разбивки точек x, y.
`Axes.hist`	Построение гистограммы.
`Axes.hist2d`	Построение 2D-гистограммы.

Контуры

`Axes.clabel`	Подписать контурный график.
`Axes.contour`	Построение линий уровня.
`Axes.contourf`	Построение областей уровня.

Массив

`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`	Установить метку для оси абсцисс.
`Axes.get_xlabel`	Получить строку текста метки оси абсцисс.
`Axes.set_ylabel`	Установить метку для оси ординат.
`Axes.get_ylabel`	Получить строку текста метки оси ординат.
`Axes.set_title`	Установить заголовок для осей.
`Axes.get_title`	Получить заголовок оси.
`Axes.legend`	Разместить легенду на осях.
`Axes.get_legend`	Возвращает экземпляр `Legend`, или None, если легенда не определена.
`Axes.get_legend_handles_labels`	Возвращает маркеры и метки для легенды.

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

`Axes.set_xscale`	Установить масштаб оси абсцисс.
`Axes.get_xscale`	Возвращает масштаб оси абсцисс (как строку).
`Axes.set_yscale`	Установить масштаб оси ординат.
`Axes.get_yscale`	Возвращает масштаб оси ординат (как строку).

Автомасштабирование и поля

`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.get_autoscale_on`	Получить, применяется ли автомасштабирование для обеих осей к командам построения графиков
`Axes.set_autoscalex_on`	Установить, применять ли автомасштабирование по оси X к командам построения графиков
`Axes.get_autoscalex_on`	Получить, применяется ли автомасштабирование по оси X к командам построения графиков
`Axes.set_autoscaley_on`	Установить, применять ли автомасштабирование по оси Y к командам построения графиков
`Axes.get_autoscaley_on`	Получить, применяется ли автомасштабирование по оси Y к командам построения графиков

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

`Axes.apply_aspect`	Настроить оси для заданного соотношения сторон данных.
`Axes.set_aspect`	Установить соотношение сторон масштабирования осей, т.е.
`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 для обработки данных как дат.
`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.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`	Возвращает True, если единицы установлены на любой оси.

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

`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, совмещенный по оси 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.

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

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

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

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

`Axes.can_pan`	Возвращает True, если этот объект оси поддерживает любую функциональность кнопок масштабирования/перемещения.
`Axes.can_zoom`	Возвращает True, если эта ось поддерживает функциональность кнопки масштабирования по области.
`Axes.get_navigate`	Получить, реагирует ли ось на команды навигации.
`Axes.set_navigate`	Установить, реагирует ли ось на команды навигации в панели инструментов.
`Axes.get_navigate_mode`	Получить состояние кнопки панели инструментов навигации: 'ПЕРЕМЕЩЕНИЕ', 'МАСШТАБИРОВАНИЕ' или None.
`Axes.set_navigate_mode`	Установить состояние кнопки панели инструментов навигации;
`Axes.start_pan`	Вызывается при запуске операции перемещения.
`Axes.drag_pan`	Вызывается при перемещении мыши во время операции перемещения.
`Axes.end_pan`	Вызывается при завершении операции перемещения (когда кнопка мыши отпущена).
`Axes.format_coord`	Возвращает строку формата, форматирующую координаты x, y.
`Axes.format_cursor_data`	Возвращает строковое представление данных.
`Axes.format_xdata`	Возвращает x, отформатированный как значение x.
`Axes.format_ydata`	Возвращает y, отформатированный как значение y.
`Axes.mouseover`	Если это свойство установлено в True, объект запросит пользовательские данные контекста, когда курсор мыши будет над ним.
`Axes.in_axes`	Возвращает True, если заданное событие мыши (в координатах отображения) находится в области оси.
`Axes.pick`	Обработать событие выбора.
`Axes.pickable`	Возвращает, может ли объект быть выбранным.
`Axes.get_picker`	Возвращает поведение выбора объекта.
`Axes.set_picker`	Определить поведение выбора объекта.
`Axes.set_contains`	[Устарело] Определить пользовательскую проверку включения для объекта.
`Axes.get_contains`	[Устарело] Возвращает пользовательскую функцию проверки включения объекта, если она установлена, или None.

`Axes.contains`	Проверка, содержит ли элемент художник событие мыши.
`Axes.contains_point`	Возвращает, находится ли точка 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

Параметры:

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_data_ratio_log [Устарело] Возвращает коэффициент масштабирования исходных данных в логарифмическом масштабе.

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`	Возвращает True, если в осях добавлены какие-либо элементы.