Spec-Zone.ru › Matplotlib 3.6

matplotlib.axes

Оглавление

  • Наследование
  • Класс Axes
  • Подграфики
  • Построение графиков

    • Основные
    • Диапазоны
    • Спектральные
    • Статистические
    • Сгруппированные
    • Контуры
    • Двумерные массивы
    • Неструктурированные треугольники
    • Текст и аннотации
    • Векторные поля
  • Очистка
  • Внешний вид
  • Цикл свойств
  • Оси / пределы

    • Пределы осей и направление
    • Подписи осей, заголовок и легенда
    • Масштабы осей
    • Автомасштабирование и отступы
    • Соотношение сторон
    • Деления и метки делений
  • Единицы измерения
  • Добавление элементов
  • Двойнирование и совместное использование
  • Положение осей
  • Асинхронные/событийно-ориентированные
  • Интерактивные действия
  • Дочерние элементы
  • Рисование
  • Проекция
  • Прочее

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

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

Класс Axes

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

Наследуется от _AxesBase

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

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

Атрибуты:
dataLimBbox

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

viewLimBbox

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

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

Параметры:
figFigure

Axes строится в Figure fig.

rectкортеж (left, bottom, width, height).

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

sharex, shareyAxes, необязательно

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

frameonbool, по умолчанию: True

Видимость рамки Axes.

box_aspectfloat, необязательно

Установка фиксированного аспекта прямоугольника Axes, то есть соотношения высоты к ширине. Подробнее см. set_box_aspect.

**kwargs

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

Свойство

Описание

adjustable

{'box', 'datalim'}

agg_filter

функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив чисел с плавающей точкой (m, n, 3) и два смещения от нижнего левого угла изображения

alpha

скаляр или None

anchor

(число, число) или {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}

animated

логическое значение

aspect

{'auto', 'equal'} или число

autoscale_on

логическое значение

autoscalex_on

неизвестно

autoscaley_on

неизвестно

axes_locator

Callable[[Axes, Renderer], Bbox]

axisbelow

логическое значение или 'line'

box_aspect

число или None

clip_box

Bbox

clip_on

логическое значение

clip_path

Объект Patch или (Path, Transform) или None

facecolor или fc

цвет

figure

Figure

frame_on

логическое значение

gid

строка

in_layout

логическое значение

label

объект

mouseover

логическое значение

navigate

логическое значение

navigate_mode

неизвестно

path_effects

AbstractPathEffect

picker

None или логическое значение или число с плавающей точкой или вызываемый объект

position

[left, bottom, width, height] или Bbox

prop_cycle

неизвестно

rasterization_zorder

число с плавающей точкой или None

rasterized

логическое значение

sketch_params

(scale: число, length: число, randomness: число)

snap

логическое значение или None

title

строка

transform

Transform

url

строка

visible

логическое значение

xbound

неизвестно

xlabel

строка

xlim

(bottom: число, top: число)

xmargin

число больше -0.5

xscale

неизвестно

xticklabels

неизвестно

xticks

неизвестно

ybound

неизвестно

ylabel

строка

ylim

(нижняя: число, верхняя: число)

ymargin

число больше -0,5

yscale

неизвестно

yticklabels

неизвестно

yticks

неизвестно

zorder

число с плавающей точкой

Возвращает:
Axes

Новый объект Axes.

Подграфики

SubplotBase

Базовый класс для подграфиков, которые являются экземплярами Axes с дополнительными методами для облегчения создания и управления набором Axes внутри фигуры.

subplot_class_factory

Построение графиков

Основные

Axes.plot

Построение графика зависимости y от x в виде линий и/или маркеров.

Axes.errorbar

Построение графика зависимости y от x в виде линий и/или маркеров с ошибками.

Axes.scatter

Точечный график (scatter plot) 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.bar_label

Добавление меток к столбцам гистограммы.

Axes.stem

Построение диаграммы стебля.

Axes.eventplot

Построение идентичных параллельных линий в заданных позициях.

Axes.pie

Построение круговой диаграммы.

Axes.stackplot

Построение составной (слоистой) диаграммы.

Axes.broken_barh

Построение горизонтальной последовательности прямоугольников.

Axes.vlines

Построение вертикальных линий от ymin до ymax для каждой точки x.

Axes.hlines

Построение горизонтальных линий от xmin до xmax для каждой точки y.

Axes.fill

Построение заполненных многоугольников.

Разрывы

Axes.axhline

Добавление горизонтальной линии на график.

Axes.axhspan

Добавление горизонтального разрыва (прямоугольника) на график.

Axes.axvline

Добавление вертикальной линии на график.

Axes.axvspan

Добавление вертикального разрыва (прямоугольника) на график.

Axes.axline

Добавление прямой бесконечной длины.

Спектральные

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.stairs

Построение ступенчатой функции в виде линии с границами или в виде заполненного участка.

Контуры

Axes.clabel

Помечает контурный график.

Axes.contour

Строит контурные линии.

Axes.contourf

Строит заполненные контуры.

Массивы 2D

Axes.imshow

Отображает данные как изображение, т.е. на 2D регулярной растровой сетке.

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.

Axes.table

Добавляет таблицу в Axes.

Axes.arrow

Добавляет стрелку в Axes.

Axes.inset_axes

Добавляет дочерний вставной график Axes в существующий Axes.

Axes.indicate_inset

Добавляет указатель вставки в Axes.

Axes.indicate_inset_zoom

Добавляет прямоугольник-указатель вставки в Axes, основанный на пределов осей для inset_ax, и рисует соединители между inset_ax и прямоугольником.

Axes.secondary_xaxis

Добавляет вторую ось x в данный Axes.

Axes.secondary_yaxis

Добавляет вторую ось y в данный Axes.

Векторные поля

Axes.barbs

Строит 2D поле стрелок-барбов.

Axes.quiver

Строит 2D поле стрелок.

Axes.quiverkey

Добавляет ключ к графику quiver.

Axes.streamplot

Рисует линии потока векторного поля.

Очистка

Axes.cla

Очищает Axes.

Axes.clear

Очищает Axes.

Внешний вид

Axes.axis

Удобный метод для получения или установки некоторых свойств осей.

Axes.set_axis_off

Отключает оси x и y.

Axes.set_axis_on

Включает оси x и y.

Axes.set_frame_on

Устанавливает, будет ли отрисовываться прямоугольник Axes.

Axes.get_frame_on

Получить, будет ли отрисовываться прямоугольник Axes.

Axes.set_axisbelow

Устанавливает, будут ли метки и линии сетки над или под большинством элементов.

Axes.get_axisbelow

Получить, будут ли метки и линии сетки над или под большинством элементов.

Axes.grid

Настроить линии сетки.

Axes.get_facecolor

Получить цвет фона Axes.

Axes.set_facecolor

Установить цвет фона 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 Bbox, чтобы он включал заданные точки.

Axes.set_xbound

Установить нижнюю и верхнюю числовые границы оси X.

Axes.get_xbound

Возвратить нижнюю и верхнюю границы оси X в порядке возрастания.

Axes.set_ybound

Установить нижнюю и верхнюю числовые границы оси Y.

Axes.get_ybound

Возвратить нижнюю и верхнюю границы оси Y в порядке возрастания.

Подписи осей, заголовок и легенда

Axes.set_xlabel

Установить подпись для оси X.

Axes.get_xlabel

Получить текстовую строку подписи xlabel.

Axes.set_ylabel

Установить подпись для оси Y.

Axes.get_ylabel

Получить текстовую строку подписи ylabel.

Axes.set_title

Установить заголовок для Axes.

Axes.get_title

Получить заголовок Axes.

Axes.legend

Поместить легенду на Axes.

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.autoscale_view.

Axes.get_autoscale_on

Возвращает True, если каждая ось автомасштабируется, иначе False.

Axes.set_autoscalex_on

Установить, применяется ли автомасштабирование по оси X при рисовании или при вызове Axes.autoscale_view.

Axes.get_autoscalex_on

Возвращает, автомасштабируется ли ось X.

Axes.set_autoscaley_on

Установить, применяется ли автомасштабирование по оси Y при рисовании или при вызове Axes.autoscale_view.

Axes.get_autoscaley_on

Возвращает, автомасштабируется ли ось Y.

Соотношение сторон

Axes.apply_aspect

Настроить оси для заданного соотношения сторон данных.

Axes.set_aspect

Установить соотношение сторон масштабирования осей, т.е. масштаб по оси y/x.

Axes.get_aspect

Возвращает соотношение сторон масштабирования осей.

Axes.set_box_aspect

Установить соотношение сторон прямоугольника осей, т.е. отношение высоты к ширине.

Axes.get_box_aspect

Возвращает соотношение сторон прямоугольника осей, т.е. отношение высоты к ширине.

Axes.set_adjustable

Установить, как оси будут подстраиваться под требуемое соотношение сторон.

Axes.get_adjustable

Возвращает, будут ли оси изменять свои физические размеры ('box') или пределы данных ('datalim') для достижения желаемого соотношения сторон.

Штрихи и подписи штрихов

Axes.set_xticks

Устанавливает метки штрихов оси x и, необязательно, их подписи.

Axes.get_xticks

Возвращает координаты меток штрихов оси x в координатах данных.

Axes.set_xticklabels

Устанавливает подписи оси x с помощью списка строковых подписей.

Axes.get_xticklabels

Получает подписи штрихов оси x.

Axes.get_xmajorticklabels

Возвращает основные подписи штрихов оси x как список объектов Text.

Axes.get_xminorticklabels

Возвращает второстепенные подписи штрихов оси x как список объектов Text.

Axes.get_xgridlines

Возвращает линии сетки оси x как список объектов Line2D.

Axes.get_xticklines

Возвращает линии штрихов оси x как список объектов Line2D.

Axes.xaxis_date

Настройка меток и подписей оси для обработки данных на оси x как дат.

Axes.set_yticks

Устанавливает метки штрихов оси y и, необязательно, их подписи.

Axes.get_yticks

Возвращает координаты меток штрихов оси y в координатах данных.

Axes.set_yticklabels

Устанавливает подписи оси y с помощью списка строковых подписей.

Axes.get_yticklabels

Получает подписи штрихов оси y.

Axes.get_ymajorticklabels

Возвращает основные подписи штрихов оси y как список объектов Text.

Axes.get_yminorticklabels

Возвращает второстепенные подписи штрихов оси y как список объектов Text.

Axes.get_ygridlines

Возвращает линии сетки оси y как список объектов Line2D.

Axes.get_yticklines

Возвращает линии штрихов оси y как список объектов Line2D.

Axes.yaxis_date

Настройка меток и подписей оси для обработки данных на оси 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

Возвращает, установлены ли единицы измерения на любой оси.

Добавление объектов

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

END_OF_DOCUMENT_MARKER

Дублирование и совместное использование

Axes.twinx

Создать дублирующий объект Axes, использующий общую ось абсцисс.

Axes.twiny

Создать дублирующий объект Axes, использующий общую ось ординат.

Axes.sharex

Использовать общую ось абсцисс с other.

Axes.sharey

Использовать общую ось ординат с other.

Axes.get_shared_x_axes

Возвращает неизменяемый вид на группировщик общих осей абсцисс.

Axes.get_shared_y_axes

Возвращает неизменяемый вид на группировщик общих осей ординат.

Положение Axes

Axes.get_anchor

Получить положение якоря.

Axes.set_anchor

Определить положение якоря.

Axes.get_axes_locator

Возвращает axes_locator.

Axes.set_axes_locator

Установить локато Axes.

Axes.reset_position

Сбросить активное положение на исходное.

Axes.get_position

Возвращает положение Axes в пределах фигуры как Bbox.

Axes.set_position

Установить положение Axes.

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

Axes.stale

Указывает, является ли элемент 'недействительным' и требует ли перерисовки для соответствия внутреннему состоянию элемента.

Axes.pchanged

Выполняет все зарегистрированные обратные вызовы.

Axes.add_callback

Добавить функцию обратного вызова, которая будет вызываться всякий раз, когда изменяются свойства Artist.

Axes.remove_callback

Удалить обратный вызов по идентификатору наблюдателя.

Интерактивный

Axes.can_pan

Возвращает, поддерживает ли этот Axes функциональность панорамирования/приближения.

Axes.can_zoom

Возвращает, поддерживает ли этот Axes функциональность приближения по прямоугольнику.

Axes.get_navigate

Получить, реагирует ли Axes на команды навигации.

Axes.set_navigate

Установить, реагирует ли Axes на команды навигационной панели инструментов.

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

Возвращает, находится ли указанное событие (в координатах отображения) в Axes.

Axes.contains

Проверяет, содержит ли элемент событие мыши.

Axes.contains_point

Возвращает, находится ли point (пара пиксельных координат) внутри области Axes.

Axes.get_cursor_data

Возвращает данные курсора для заданного события.

Подчинённые элементы

Axes.get_children

Возвращает список дочерних элементов Artist данного Artist.

Axes.get_images

Возвращает список элементов AxesImage, содержащихся в Axes.

Axes.get_lines

Возвращает список линий, содержащихся в Axes.

Axes.findobj

Поиск элементов-артистов.

END_OF_DOCUMENT_MARKER ```

Рисование

Axes.draw

Отрисовать элемент (и его потомков) с помощью заданного рендерера.

Axes.draw_artist

Эффективно перерисовать отдельный элемент.

Axes.redraw_in_frame

Эффективно перерисовать данные Оси, но не метки, деления и т. д. осей.

Axes.get_renderer_cache

[Устарело]

Axes.get_rasterization_zorder

Возвращает значение zorder, ниже которого элементы будут растрированы.

Axes.set_rasterization_zorder

Устанавливает порог zorder для растрирования при выводе векторной графики.

Axes.get_window_extent

Возвращает прямоугольник Оси в пространстве отображения; args и kwargs пустые.

Axes.get_tightbbox

Возвращает плотно прилегающий прямоугольник Оси, включая оси и их декорации (подписи, заголовки и т. д.).

Проекция

Методы, используемые Axis, которые должны быть переопределены для непрямолинейных Осей.

Axes.name

Axes.get_xaxis_transform

Получить преобразование, используемое для отрисовки меток, делений и линий сетки оси X.

Axes.get_yaxis_transform

Получить преобразование, используемое для отрисовки меток, делений и линий сетки оси Y.

Axes.get_data_ratio

Возвращает коэффициент масштаба данных.

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

Возвращает, имеются ли добавленные элементы в оси.

Axes.set

Устанавливает сразу несколько свойств.

classmatplotlib.axes.Axes.ArtistList(axes, prop_name, add_name, valid_types=None, invalid_types=None)

Подсписок элементов Оси, основанный на их типе.

Подсписки элементов, специфичных для типа, станут неизменяемыми в Matplotlib 3.7. Впоследствии эти списки элементов, вероятно, будут заменены кортежами. Используйте как если бы это был уже кортеж.

Этот класс существует только для переходного периода, чтобы предупреждать об устаревшем изменении списков элементов.

Параметры:
axes.axes.Axes

Ось, из которой этот подсписок будет извлекать элементы-элементы.

prop_namestr

Имя свойства, используемое для доступа к этому подсписку из оси; используется для генерации предупреждений об устаревании.

add_namestr

Имя метода, используемого для добавления элементов данного подсписка в ось; используется для генерации предупреждений об устаревании.

valid_typesсписок типов, необязательно

Список типов, определяющих, какие элементы будут возвращены этим подсписком. Если указано, элементы в подсписке должны быть экземплярами любого из этих типов. Если не указано, любой тип элемента действителен (если не ограничен invalid_types.)

invalid_typesкортеж, необязательно

Список типов, определяющих, какие элементы не будут возвращены этим подсписком. Если указано, элементы подсписка никогда не будут экземплярами этих типов. В противном случае типы не будут исключены.

insert(index, item)

S.insert(index, value) -- вставить значение перед индексом

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

Spec-Zone.ru

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