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 -
Ось строится в
Figurefig. -
rect[left, bottom, width, height] -
Ось строится в прямоугольнике rect. rect задан в координатах
Figure. -
sharex, shareyAxes, optional -
Ось x или y разделяется с осью x или y входного
Axes. -
frameonbool, optional -
True означает, что рамка оси видна.
- **kwargs
-
Другие необязательные ключевые аргументы:
-
Свойство Описание adjustable{'box', 'datalim'} agg_filterфункция фильтра, которая принимает (m, n, 3) массив float и значение dpi, и возвращает (m, n, 3) массив alphafloat или None anchor2-кортеж чисел с плавающей точкой или {'C', 'SW', 'S', 'SE', ...} animatedbool aspect{'auto', 'equal'} или число autoscale_onbool autoscalex_onbool autoscaley_onbool axes_locatorCallable[[Axes, Renderer], Bbox] axisbelowbool или 'line' clip_boxBboxclip_onbool clip_pathPatch или (Path, Transform) или None containsвызываемая функция facecolorцвет fcцвет figureFigureframe_onbool gidстрока in_layoutbool labelобъект navigatebool navigate_modeнеизвестно path_effectsAbstractPathEffectpickerNone или bool или float или вызываемая функция position[левый, нижний, ширина, высота] или Bboxprop_cycleнеизвестно rasterization_zorderчисло с плавающей точкой или None rasterizedbool или None sketch_params(масштаб: float, длина: float, случайность: float) snapbool или None titleстрока transformTransformurlстрока visiblebool xboundнеизвестно xlabelстрока xlim(низ: float, верх: float) xmarginfloat, больше чем -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, если к осям добавлены какие-либо элементы. |
Наследование
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.2.2/api/axes_api.html