Spec-Zone.ru › Matplotlib 3.0

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.

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

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

Ось создаётся в Figure fig.

rect : [left, bottom, width, height]

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

sharex, sharey : Axes, optional

Ось x или y делится с осью x или y в входном Axes.

frameon : bool, optional

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

**kwargs

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

Свойство Описание
adjustable {'box', 'datalim'}
agg_filter функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
alpha float
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 [(Path, Transform) | Patch | 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
rasterization_zorder float или None
rasterized bool или None
sketch_params (scale: float, length: float, randomness: float)
snap bool или None
title строка
transform Transform
url строка
visible bool
xbound (нижняя граница: float, верхняя граница: float)
xlabel строка
xlim (левая граница: float, правая граница: float)
xmargin число больше -0,5
xscale {"linear", "log", "symlog", "logit", ...}
xticklabels Список[строка]
xticks список
ybound (нижняя граница: float, верхняя граница: float)
ylabel строка
ylim (нижняя граница: float, верхняя граница: float)
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 Построить матрицу или массив в виде цветного изображения.
Axes.pcolor Создать псевдоцветной график с нерегулярной прямоугольной сеткой.
Axes.pcolorfast Создать псевдоцветной график с нерегулярной прямоугольной сеткой.
Axes.pcolormesh Создать псевдоцветной график с нерегулярной прямоугольной сеткой.
Axes.spy Построить схему разреженности двумерного массива.

Неструктурированные треугольники

Axes.tripcolor Построить псевдоцветной график неструктурированной треугольной сетки.
Axes.triplot Нарисовать неструктурированную треугольную сетку в виде линий и/или маркеров.
Axes.tricontour Построить контурные линии на неструктурированной треугольной сетке.
Axes.tricontourf Построить контурные области на неструктурированной треугольной сетке.

Текст и аннотации

Axes.annotate Добавить аннотацию к точке xy с текстом s.
Axes.text Добавить текст на график.
Axes.table Добавить таблицу на текущий график.
Axes.arrow Добавить стрелку на график.
Axes.inset_axes Добавить вложенный график в данный график.
Axes.indicate_inset Добавить указатель на вложенный график.
Axes.indicate_inset_zoom Добавить прямоугольник-указатель на вложенный график, основанный на лимитах осей для inset_ax, и провести соединительные линии между inset_ax и прямоугольником.

Поля

Axes.barbs Построить поле стрелок-баранов.
Axes.quiver Построить поле стрелок.
Axes.quiverkey Добавить ключ к полю стрелок.
Axes.streamplot Нарисовать линии потока векторного поля.

Очистка

Axes.cla Очистить текущий график.
Axes.clear Очистить область графика.

Внешний вид

Axes.axis Удобный метод получения или установки свойств осей.
Axes.set_axis_off Скрыть оси.
Axes.set_axis_on Показать оси.
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 последовательностью кортежей xy или эквивалентом.
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 с помощью типа единиц измерения оси x
Axes.convert_yunits Для элементов на оси, если ось y поддерживает единицы измерения, преобразовать y с помощью типа единиц измерения оси y
Axes.have_units Возвращает True, если единицы измерения установлены на осях x или y

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

Axes.add_artist Добавить любой элемент Artist на ось.
Axes.add_collection Добавить экземпляр Collection на ось.
Axes.add_container Добавить экземпляр Container на ось.
Axes.add_image Добавить AxesImage на ось.
Axes.add_line Добавить Line2D в список линий графика
Axes.add_patch Добавить Patch p в список областей оси; область обрезки будет установлена в область обрезки оси.
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.set_axes_locator Установить локатор осей.
Axes.reset_position Сбросить активное положение до исходного.
Axes.get_position Получить копию прямоугольника осей как Bbox.
Axes.set_position Установить положение осей.

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

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

Интерактивное взаимодействие

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.
Axes.format_ydata Возвращает отформатированную строку y.
Axes.mouseover
Axes.in_axes Возвращает True, если заданное событие мыши (в координатах отображения) находится в области осей.
Axes.pick Вызвать событие выбора.
Axes.pickable Возвращает True, если Artist можно выбрать.
Axes.get_picker Возвращает объект-сборщик, используемый этим элементом.
Axes.set_picker Установить значение эпсилон для выбора, используемое этим элементом.
Axes.set_contains Заменить проверку, используемую этим элементом, для определения принадлежности.
Axes.get_contains Возвращает проверку _contains, используемую элементом, или None для значения по умолчанию.
Axes.contains Проверить, произошло ли событие мыши в области осей.
Axes.contains_point Возвращает True, если точка (кортеж x,y) находится внутри области осей (области, определенной её фигурой).
Axes.get_cursor_data Получить данные курсора для данного события.

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

Axes.get_children возвращает список дочерних элементов-артистов
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 Обновление свойств этого элемента из словаря prop.
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 Установить метку s для автоматической легенды.
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 Возвращает True, если Artist имеет явно установленное преобразование.

Проекция

Методы, используемые 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 Получить преобразование, используемое для рисования меток оси x, которое добавит заданное количество отступов (в пунктах) между осями и меткой.
Axes.get_xaxis_text2_transform Получить преобразование, используемое для рисования меток дополнительной оси x, которое добавит заданное количество отступов (в пунктах) между осями и меткой.
Axes.get_yaxis_text1_transform Получить преобразование, используемое для рисования меток оси y, которое добавит заданное количество отступов (в пунктах) между осями и меткой.
Axes.get_yaxis_text2_transform Получить преобразование, используемое для рисования меток дополнительной оси y, которое добавит заданное количество отступов (в пунктах) между осями и меткой.

Другие

Axes.zorder
Axes.aname
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.0.0/api/axes_api.html

Spec-Zone.ru

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