Spec-Zone.ru › Matplotlib 3.1

matplotlib.axes

Содержание

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

Класс 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.

Атрибуты:
dataLim : BBox

Область, охватывающая все данные, отображаемые в Axes.

viewLim : BBox

Пределы просмотра в координатах данных.

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

Параметры:
fig : Figure

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

rect : [left, bottom, width, height]

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

sharex, sharey : Axes, optional

Ось x или y axis совмещена с осью x или y в входном Axes.

frameon : bool, optional

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

**kwargs

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

Свойство Описание
adjustable {'box', 'datalim'}
agg_filter функция фильтра, которая принимает (m, n, 3) массив чисел с плавающей точкой и значение dpi, и возвращает (m, n, 3) массив
alpha число с плавающей точкой
anchor 2-кортеж чисел с плавающей точкой или {'C', 'SW', 'S', 'SE', ...}
animated логическое значение
aspect {'auto', 'equal'} или число
autoscale_on логическое значение
autoscalex_on логическое значение
autoscaley_on логическое значение
axes_locator Callable[[Axes, Renderer], Bbox]
axisbelow логическое значение или 'line'
clip_box Bbox
clip_on логическое значение
clip_path [(Path, Transform) | Patch | None]
contains вызываемая функция
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 [left, bottom, width, height] или Bbox
rasterization_zorder float или None
rasterized bool или None
sketch_params (масштаб: float, длина: float, случайность: float)
snap bool или None
title строка
transform Transform
url строка
visible логическое значение
xbound неизвестно
xlabel строка
xlim (левый: float, правый: float)
xmargin float больше, чем -0.5
xscale {"линейный", "логарифмический", "симлогический", "логит", ...}
xticklabels Список[строка]
xticks список
ybound неизвестно
ylabel строка
ylim (нижняя: число, верхняя: число)
ymargin число больше -0.5
yscale {"линейный", "логарифмический", "симлогический", "логит", ...}
yticklabels Список[строка]
yticks список
zorder число с плавающей точкой
Возвращает:
axes : 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.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 Построить диаграмму гексагональной бининговки.
Axes.hist Построить гистограмму.
Axes.hist2d Построить двумерную гистограмму.

Контуры

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.

Цикл свойств

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.update_datalim_bounds Расширить 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.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 с помощью списка отметок
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 с помощью списка отметок
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, если единицы измерения установлены на осях x или y.

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

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 на оси; вернуть таблицу.

Twinning

Axes.twinx Создать дополнительные оси, разделяющие ось абсцисс.
Axes.twiny Создать дополнительные оси, разделяющие ось ординат.
Axes.get_shared_x_axes Возвращает ссылку на объект группировщика общих осей абсцисс.
Axes.get_shared_y_axes Возвращает ссылку на объект группировщика общих осей ординат.

Axes Position

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 Установить положение осей.

Async/Event based

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
Axes.in_axes Возвращает True, если заданное событие мыши mouseevent (в координатах отображения) находится в области Axes.
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 Возвращает значение zorder, ниже которого элементы будут растрированы.
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 Возвращает значение порядка отображения объекта.
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, если в оси были добавлены какие-либо элементы.

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

Inheritance diagram of matplotlib.axes.Axes

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

Spec-Zone.ru

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