Spec-Zone.ru › Matplotlib 3.2

matplotlib.axes

Содержание

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

Класс Axes

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

Базовый класс: matplotlib.axes._base._AxesBase

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

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

Атрибуты:
dataLimBbox

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

viewLimBbox

Пределы отображения в координатах данных.

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

Параметры:
figFigure

Ось строится в Figure fig.

rect[left, bottom, width, height]

Ось строится в прямоугольнике rect. rect задан в координатах Figure.

sharex, shareyAxes, optional

Ось x или y разделяется с осью x или y входного Axes.

frameonbool, optional

True означает, что рамка оси видна.

**kwargs

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

END_OF_DOCUMENT_MARKER
Свойство Описание
adjustable {'box', 'datalim'}
agg_filter функция фильтра, которая принимает (m, n, 3) массив float и значение dpi, и возвращает (m, n, 3) массив
alpha float или None
anchor 2-кортеж чисел с плавающей точкой или {'C', 'SW', 'S', 'SE', ...}
animated bool
aspect {'auto', 'equal'} или число
autoscale_on bool
autoscalex_on bool
autoscaley_on bool
axes_locator Callable[[Axes, Renderer], Bbox]
axisbelow bool или 'line'
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 [левый, нижний, ширина, высота] или Bbox
prop_cycle неизвестно
rasterization_zorder число с плавающей точкой или 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 (низ: float, верх: float)
ymargin число, большее чем -0.5
yscale {"линейный", "логарифмический", "симлогический", "логит", ...}
yticklabels Список[строка]
yticks неизвестно
zorder число с плавающей точкой
Возвращает:
axesAxes

Новый объект 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 Построение графика с логарифмической шкалой по обеим осям.
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.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 Отобразить данные как изображение; т.е.
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.get_fc Получить цвет заливки области осей.
Axes.set_facecolor Установить цвет заливки области осей.
Axes.set_fc Установить цвет заливки области осей.

Цикл свойств

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.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_adjustable Определить, какой параметр ось будет изменять для достижения заданного соотношения сторон.
Axes.get_adjustable

Деления и подписи к делениям

Axes.set_xticks Установить деления оси X со списком ticks
Axes.get_xticks Возвращает деления оси X как список расположений
Axes.set_xticklabels Установить подписи делений оси X с помощью списка строковых меток.
Axes.get_xticklabels Получить метки делений оси X как список экземпляров Text.
Axes.get_xmajorticklabels Получить основные метки делений оси X.
Axes.get_xminorticklabels Получить вспомогательные метки делений оси X.
Axes.get_xgridlines Получить линии сетки оси X как список экземпляров Line2D.
Axes.get_xticklines Получить линии делений оси X как список экземпляров Line2D.
Axes.xaxis_date Настройка делений и меток оси X для обработки данных X как дат.
Axes.set_yticks Установить деления оси Y со списком ticks
Axes.get_yticks Возвращает деления оси Y как список расположений
Axes.set_yticklabels Установить подписи делений оси Y с помощью списка строковых меток.
Axes.get_yticklabels Получить метки делений оси Y как список экземпляров Text.
Axes.get_ymajorticklabels Получить основные метки делений оси Y.
Axes.get_yminorticklabels Получить вспомогательные метки делений оси Y.
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 Возвращает 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 Создание дублирующей оси, совмещающей ось x.
Axes.twiny Создание дублирующей оси, совмещающей ось y.
Axes.get_shared_x_axes Возврат ссылки на объект группировщика совмещенных осей x.
Axes.get_shared_y_axes Возврат ссылки на объект группировщика совмещенных осей y.

Позиция осей

Axes.get_anchor Получение расположения якоря.
Axes.set_anchor Определение расположения якоря.
Axes.get_axes_locator Возврат axes_locator.
Axes.set_axes_locator Установка 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 Возвращает True, если данная ось поддерживает функцию масштабирования/перемещения.
Axes.can_zoom Возвращает True, если данная ось поддерживает функцию масштабирования рамкой.
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 как значение по оси 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 Возвращает, находится ли точка (пара пиксельных координат) внутри области осей.
Axes.get_cursor_data Возвращает данные курсора для данного события.

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

Axes.get_children Возвращает список дочерних элементов Artist этого Artist.
Axes.get_images Возвращает список изображений осей, содержащихся в осях.
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 Возвращает облегающий прямоугольник области осей, включая оси и их декорации (подписи осей, заголовок и т. д.).

Массовое изменение свойств

Axes.set Метод массовой установки свойств.
Axes.update Обновить свойства этого графического элемента из словаря props.
Axes.properties Возвращает словарь всех свойств графического элемента.
Axes.update_from Скопировать свойства из other в self.

Общие свойства графических элементов

Axes.set_agg_filter Установить фильтр agg.
Axes.set_alpha Установить значение альфа для смешивания — не поддерживается во всех бэкендах.
Axes.set_animated Установить состояние анимации объекта.
Axes.set_clip_box Установить область обрезки объекта с помощью Bbox.
Axes.set_clip_on Установить, использует ли объект обрезку.
Axes.set_clip_path Установить путь обрезки объекта.
Axes.set_gid Установить идентификатор (группы) для объекта.
Axes.set_label Установить метку, которая будет отображаться в легенде.
Axes.set_path_effects Установить эффекты пути.
Axes.set_rasterized Принудительно использовать растровое (битовое) отображение в векторе бэкенда.
Axes.set_sketch_params Устанавливает параметры наброска.
Axes.set_snap Установить поведение привязки.
Axes.set_transform Установить преобразование объекта.
Axes.set_url Установить URL для объекта.
Axes.set_visible Установить видимость объекта.
Axes.set_zorder Установить z-порядок для объекта.
Axes.get_agg_filter Возвращает функцию фильтра для использования с фильтром agg.
Axes.get_alpha Возвращает значение альфа для смешивания — не поддерживается во всех бэкендах.
Axes.get_animated Возвращает состояние анимации.
Axes.get_clip_box Возвращает область обрезки.
Axes.get_clip_on Возвращает, использует ли объект обрезку.
Axes.get_clip_path Возвращает путь обрезки.
Axes.get_gid Возвращает идентификатор группы.
Axes.get_label Возвращает метку, используемую для данного объекта в легенде.
Axes.get_path_effects
Axes.get_rasterized Возвращает, необходимо ли растрировать объект.
Axes.get_sketch_params Возвращает параметры наброска для объекта.
Axes.get_snap Возвращает параметр привязки.
Axes.get_transform Возвращает экземпляр Transform, используемый данным объектом.
Axes.get_url Возвращает URL.
Axes.get_visible Возвращает видимость.
Axes.get_zorder Возвращает z-порядок объекта.
Axes.axes Экземпляр Axes, в котором находится объект, или None.
Axes.set_figure Установить Figure для данного Axes.
Axes.get_figure Возвращает экземпляр Figure, к которому принадлежит объект.

Методы объекта

Axes.remove Удалить объект из фигуры, если это возможно.
Axes.is_transform_set Возвращает, задано ли преобразование у объекта.

Проекция

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

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

Схема наследования для matplotlib.axes.Axes

© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.2.2/api/axes_api.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API