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.Атрибуты: -
dataLim : BBox -
Область, охватывающая все данные, отображаемые в Axes.
-
viewLim : BBox -
Пределы просмотра в координатах данных.
Создать axes в фигуре.
-
Параметры:
-
Другие необязательные ключевые аргументы:
Свойство Описание adjustable{'box', 'datalim'} agg_filterфункция фильтра, которая принимает (m, n, 3) массив чисел с плавающей точкой и значение dpi, и возвращает (m, n, 3) массив alphaчисло с плавающей точкой anchor2-кортеж чисел с плавающей точкой или {'C', 'SW', 'S', 'SE', ...} animatedлогическое значение aspect{'auto', 'equal'} или число autoscale_onлогическое значение autoscalex_onлогическое значение autoscaley_onлогическое значение axes_locatorCallable[[Axes, Renderer], Bbox]
-
frame_onbool gidstr in_layoutbool labelобъект navigatebool navigate_modeнеизвестно path_effectsAbstractPathEffectpickerNone или bool или float или вызываемый объект position[left, bottom, width, height] или Bboxrasterization_zorderfloat или None
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, если в оси были добавлены какие-либо элементы. |
Наследование
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.1.1/api/axes_api.html