matplotlib.axes
Оглавление
- Наследование
- Класс Axes
- Подграфики
- Очистка
- Внешний вид
- Цикл свойств
- Единицы измерения
- Добавление элементов
- Двойнирование и совместное использование
- Положение осей
- Асинхронные/событийно-ориентированные
- Интерактивные действия
- Дочерние элементы
- Рисование
- Проекция
- Прочее
Наследование
Класс 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.- Атрибуты:
-
-
dataLim
Bbox -
Прямоугольник, охватывающий все данные, отображаемые в Axes.
-
viewLim
Bbox -
Пределы просмотра в координатах данных.
-
dataLim
Создаёт Axes в фигуре.
- Параметры:
-
-
fig
Figure -
Axes строится в
Figurefig. - rectкортеж (left, bottom, width, height).
-
Axes строится в прямоугольнике rect. rect задан в координатах
Figure. -
sharex, sharey
Axes, необязательно - frameonbool, по умолчанию: True
-
Видимость рамки Axes.
- box_aspectfloat, необязательно
-
Установка фиксированного аспекта прямоугольника Axes, то есть соотношения высоты к ширине. Подробнее см.
set_box_aspect. - **kwargs
-
fig
-
Другие необязательные ключевые аргументы:
Свойство
Описание
{'box', 'datalim'}
функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив чисел с плавающей точкой (m, n, 3) и два смещения от нижнего левого угла изображения
скаляр или None
(число, число) или {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
логическое значение
{'auto', 'equal'} или число
логическое значение
неизвестно
неизвестно
Callable[[Axes, Renderer], Bbox]
логическое значение или 'line'
число или None
логическое значение
Объект Patch или (Path, Transform) или None
facecolorили fcцвет
логическое значение
строка
логическое значение
объект
логическое значение
логическое значение
неизвестно
None или логическое значение или число с плавающей точкой или вызываемый объект
[left, bottom, width, height] или
Bboxнеизвестно
число с плавающей точкой или None
логическое значение
(scale: число, length: число, randomness: число)
логическое значение или None
строка
строка
логическое значение
неизвестно
строка
(bottom: число, top: число)
число больше -0.5
неизвестно
неизвестно
неизвестно
неизвестно
-
Подграфики
Базовый класс для подграфиков, которые являются экземплярами | |
Построение графиков
Основные
Построение графика зависимости y от x в виде линий и/или маркеров. | |
Построение графика зависимости y от x в виде линий и/или маркеров с ошибками. | |
Точечный график (scatter plot) y по x. | |
[Не рекомендуется] Построение графика, принуждающего ось обрабатывать числа с плавающей точкой как даты. | |
Построение ступенчатого графика. | |
Построение графика с логарифмической шкалой по обеим осям (x и y). | |
Построение графика с логарифмической шкалой по оси x. | |
Построение графика с логарифмической шкалой по оси y. | |
Заполнение области между двумя горизонтальными кривыми. | |
Заполнение области между двумя вертикальными кривыми. | |
Построение гистограммы столбцов. | |
Построение горизонтальной гистограммы столбцов. | |
Добавление меток к столбцам гистограммы. | |
Построение диаграммы стебля. | |
Построение идентичных параллельных линий в заданных позициях. | |
Построение круговой диаграммы. | |
Построение составной (слоистой) диаграммы. | |
Построение горизонтальной последовательности прямоугольников. | |
Построение вертикальных линий от ymin до ymax для каждой точки x. | |
Построение горизонтальных линий от xmin до xmax для каждой точки y. | |
Построение заполненных многоугольников. |
Разрывы
Добавление горизонтальной линии на график. | |
Добавление горизонтального разрыва (прямоугольника) на график. | |
Добавление вертикальной линии на график. | |
Добавление вертикального разрыва (прямоугольника) на график. | |
Добавление прямой бесконечной длины. |
Спектральные
Построение автокорреляционной функции для x. | |
Построение спектра фаз. | |
Построение когерентности между x и y. | |
Построение спектральной плотности. | |
Построение спектра амплитуд. | |
Построение спектра фаз. | |
Построение спектральной плотности мощности. | |
Построение спектрограммы. | |
Построение взаимной корреляции между x и y. |
Статистики
Построение диаграммы размаха. | |
Построение скрипичного графика. | |
Функция построения скрипичных графиков. | |
Функция построения диаграмм размаха. |
Дискретизированные
Построение 2D-графика с гексагональными ячейками для точек x, y. | |
Вычисление и построение гистограммы. | |
Построение 2D-гистограммы. | |
Построение ступенчатой функции в виде линии с границами или в виде заполненного участка. |
Контуры
Помечает контурный график. | |
Строит контурные линии. | |
Строит заполненные контуры. |
Массивы 2D
Отображает данные как изображение, т.е. на 2D регулярной растровой сетке. | |
Строит значения 2D матрицы или массива как цветное изображение. | |
Создаёт псевдоцветной график с нерегулярной прямоугольной сеткой. | |
Создаёт псевдоцветной график с нерегулярной прямоугольной сеткой. | |
Создаёт псевдоцветной график с нерегулярной прямоугольной сеткой. | |
Строит схему разреженности 2D массива. |
Неструктурированные треугольники
Создаёт псевдоцветной график неструктурированной треугольной сетки. | |
Рисует неструктурированную треугольную сетку в виде линий и/или маркеров. | |
Рисует контурные линии на неструктурированной треугольной сетке. | |
Рисует контурные области на неструктурированной треугольной сетке. |
Текст и аннотации
Аннотирует точку xy текстом text. | |
Добавляет текст в Axes. | |
Добавляет таблицу в | |
Добавляет стрелку в Axes. | |
Добавляет дочерний вставной график Axes в существующий Axes. | |
Добавляет указатель вставки в Axes. | |
Добавляет прямоугольник-указатель вставки в Axes, основанный на пределов осей для inset_ax, и рисует соединители между inset_ax и прямоугольником. | |
Добавляет вторую ось x в данный Axes. | |
Добавляет вторую ось y в данный Axes. |
Векторные поля
Строит 2D поле стрелок-барбов. | |
Строит 2D поле стрелок. | |
Добавляет ключ к графику quiver. | |
Рисует линии потока векторного поля. |
Очистка
Очищает Axes. | |
Очищает Axes. |
Внешний вид
Удобный метод для получения или установки некоторых свойств осей. | |
Отключает оси x и y. | |
Включает оси x и y. | |
Устанавливает, будет ли отрисовываться прямоугольник Axes. | |
Получить, будет ли отрисовываться прямоугольник Axes. | |
Устанавливает, будут ли метки и линии сетки над или под большинством элементов. | |
Получить, будут ли метки и линии сетки над или под большинством элементов. | |
Настроить линии сетки. | |
Получить цвет фона Axes. | |
Установить цвет фона Axes. |
Цикл свойств
Установить цикл свойств Axes. |
Ось / пределы
[Не рекомендуется] Возвращает экземпляр XAxis. | |
[Не рекомендуется] Возвращает экземпляр YAxis. |
Пределы оси и направление
Инвертировать ось X. | |
Возвращает, ориентирована ли ось X в "обратном" направлении. | |
Инвертировать ось Y. | |
Возвращает, ориентирована ли ось Y в "обратном" направлении. | |
Установить пределы области просмотра оси X. | |
Возвратить пределы области просмотра оси X. | |
Установить пределы области просмотра оси Y. | |
Возвратить пределы области просмотра оси Y. | |
Расширить | |
Установить нижнюю и верхнюю числовые границы оси X. | |
Возвратить нижнюю и верхнюю границы оси X в порядке возрастания. | |
Установить нижнюю и верхнюю числовые границы оси Y. | |
Возвратить нижнюю и верхнюю границы оси Y в порядке возрастания. |
Подписи осей, заголовок и легенда
Установить подпись для оси X. | |
Получить текстовую строку подписи xlabel. | |
Установить подпись для оси Y. | |
Получить текстовую строку подписи ylabel. | |
Установить заголовок для Axes. | |
Получить заголовок Axes. | |
Поместить легенду на Axes. | |
Возвращает экземпляр | |
Возвращает маркеры и подписи для легенды |
Масштабы осей
Установить масштаб оси X. | |
Возвращает масштаб оси X (в виде строки). | |
Установить масштаб оси Y. | |
Возвращает масштаб оси Y (в виде строки). |
Автомасштабирование и отступы
При автомасштабировании, соблюдать ли все | |
Установить или получить отступы при автомасштабировании. | |
Установить отступ для пределов данных по оси X перед автомасштабированием. | |
Установить отступ для пределов данных по оси Y перед автомасштабированием. | |
Пересчитать пределы данных на основе текущих элементов графиков. | |
Автомасштабировать область отображения оси по данным (переключение). | |
Автомасштабировать пределы отображения, используя пределы данных. | |
Установить, применяется ли автомасштабирование к каждой оси при следующем рисовании или вызове | |
Возвращает True, если каждая ось автомасштабируется, иначе False. | |
Установить, применяется ли автомасштабирование по оси X при рисовании или при вызове | |
Возвращает, автомасштабируется ли ось X. | |
Установить, применяется ли автомасштабирование по оси Y при рисовании или при вызове | |
Возвращает, автомасштабируется ли ось Y. |
Соотношение сторон
Настроить оси для заданного соотношения сторон данных. | |
Установить соотношение сторон масштабирования осей, т.е. масштаб по оси y/x. | |
Возвращает соотношение сторон масштабирования осей. | |
Установить соотношение сторон прямоугольника осей, т.е. отношение высоты к ширине. | |
Возвращает соотношение сторон прямоугольника осей, т.е. отношение высоты к ширине. | |
Установить, как оси будут подстраиваться под требуемое соотношение сторон. | |
Возвращает, будут ли оси изменять свои физические размеры ('box') или пределы данных ('datalim') для достижения желаемого соотношения сторон. |
Штрихи и подписи штрихов
Устанавливает метки штрихов оси x и, необязательно, их подписи. | |
Возвращает координаты меток штрихов оси x в координатах данных. | |
Устанавливает подписи оси x с помощью списка строковых подписей. | |
Получает подписи штрихов оси x. | |
Возвращает основные подписи штрихов оси x как список объектов | |
Возвращает второстепенные подписи штрихов оси x как список объектов | |
Возвращает линии сетки оси x как список объектов | |
Возвращает линии штрихов оси x как список объектов | |
Настройка меток и подписей оси для обработки данных на оси x как дат. | |
Устанавливает метки штрихов оси y и, необязательно, их подписи. | |
Возвращает координаты меток штрихов оси y в координатах данных. | |
Устанавливает подписи оси y с помощью списка строковых подписей. | |
Получает подписи штрихов оси y. | |
Возвращает основные подписи штрихов оси y как список объектов | |
Возвращает второстепенные подписи штрихов оси y как список объектов | |
Возвращает линии сетки оси y как список объектов | |
Возвращает линии штрихов оси y как список объектов | |
Настройка меток и подписей оси для обработки данных на оси y как дат. | |
Убирает второстепенные метки с осей. | |
Отображает второстепенные метки на осях. | |
Настройка | |
Изменение внешнего вида штрихов, подписей штрихов и линий сетки. | |
Управление поведением основных локаторов меток. |
Единицы измерения
Преобразование x используя тип единиц измерения оси x. | |
Преобразование y используя тип единиц измерения оси y. | |
Возвращает, установлены ли единицы измерения на любой оси. |
Добавление объектов
Добавляет | |
Добавляет | |
Добавляет | |
Добавляет | |
Добавляет | |
Добавляет | |
Добавляет | |
Добавляет |
Дублирование и совместное использование
Создать дублирующий объект Axes, использующий общую ось абсцисс. | |
Создать дублирующий объект Axes, использующий общую ось ординат. | |
Использовать общую ось абсцисс с other. | |
Использовать общую ось ординат с other. | |
Возвращает неизменяемый вид на группировщик общих осей абсцисс. | |
Возвращает неизменяемый вид на группировщик общих осей ординат. |
Положение Axes
Получить положение якоря. | |
Определить положение якоря. | |
Возвращает axes_locator. | |
Установить локато Axes. | |
Сбросить активное положение на исходное. | |
Возвращает положение Axes в пределах фигуры как | |
Установить положение Axes. |
Асинхронное/событийно-ориентированное
Указывает, является ли элемент 'недействительным' и требует ли перерисовки для соответствия внутреннему состоянию элемента. | |
Выполняет все зарегистрированные обратные вызовы. | |
Добавить функцию обратного вызова, которая будет вызываться всякий раз, когда изменяются свойства | |
Удалить обратный вызов по идентификатору наблюдателя. |
Интерактивный
Возвращает, поддерживает ли этот Axes функциональность панорамирования/приближения. | |
Возвращает, поддерживает ли этот Axes функциональность приближения по прямоугольнику. | |
Получить, реагирует ли Axes на команды навигации. | |
Установить, реагирует ли Axes на команды навигационной панели инструментов. | |
Получить статус кнопки навигационной панели инструментов: 'PAN', 'ZOOM' или None. | |
Установить статус кнопки навигационной панели инструментов. | |
Вызывается при начале операции панорамирования. | |
Вызывается при перемещении мыши во время операции панорамирования. | |
Вызывается по завершении операции панорамирования (когда кнопка мыши отпущена). | |
Возвращает строку форматирования координат x, y. | |
Возвращает строковое представление data. | |
Возвращает отформатированное значение x как значение по оси x. | |
Возвращает отформатированное значение y как значение по оси y. | |
Возвращает, запрашивается ли у этого элемента пользовательская информация о контексте при перемещении курсора мыши над ним. | |
Возвращает, находится ли указанное событие (в координатах отображения) в Axes. | |
Проверяет, содержит ли элемент событие мыши. | |
Возвращает, находится ли point (пара пиксельных координат) внутри области Axes. | |
Возвращает данные курсора для заданного события. |
Подчинённые элементы
Возвращает список элементов | |
Возвращает список линий, содержащихся в Axes. | |
Поиск элементов-артистов. |
Рисование
Отрисовать элемент (и его потомков) с помощью заданного рендерера. | |
Эффективно перерисовать отдельный элемент. | |
Эффективно перерисовать данные Оси, но не метки, деления и т. д. осей. | |
[Устарело] | |
Возвращает значение zorder, ниже которого элементы будут растрированы. | |
Устанавливает порог zorder для растрирования при выводе векторной графики. | |
Возвращает прямоугольник Оси в пространстве отображения; args и kwargs пустые. | |
Возвращает плотно прилегающий прямоугольник Оси, включая оси и их декорации (подписи, заголовки и т. д.). |
Проекция
Методы, используемые Axis, которые должны быть переопределены для непрямолинейных Осей.
Получить преобразование, используемое для отрисовки меток, делений и линий сетки оси X. | |
Получить преобразование, используемое для отрисовки меток, делений и линий сетки оси Y. | |
Возвращает коэффициент масштаба данных. | |
| |
| |
| |
|
Другое
Возвращает список по умолчанию элементов, используемых для расчета прямоугольника. | |
Возвращает обрезной путь с примененной неаффинной частью преобразования и оставшейся аффинной частью преобразования. | |
Возвращает, имеются ли добавленные элементы в оси. | |
Устанавливает сразу несколько свойств. |
- 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