matplotlib.widgets

Виджеты, нейтральные по отношению к графическому интерфейсу

Виджеты, предназначенные для работы с любыми графическими интерфейсами. Все эти виджеты требуют предварительного определения экземпляра matplotlib.axes.Axes и передачи его в качестве первого параметра. Matplotlib не пытается слишком умно подходить к макетированию — вам нужно будет определить, какой ширины и высоты должна быть ваша ось, чтобы вместить ваш виджет.

класс matplotlib.widgets.AxesWidget(ax)[исходный код]

Базы: matplotlib.widgets.Widget

Виджет, связанный с единственной Axes.

Чтобы гарантировать, что виджет остаётся отзывчивым и не удаляется, пользователь должен сохранить ссылку на объект.

Это необходимо, потому что регистр обратных вызовов хранит только слабые ссылки на функции, которые являются методами виджета. Если нет ссылок на объект виджета, он может быть удалён, что отсоединит обратные вызовы.

Атрибуты:	axAxes Родительская ось для виджета. canvasFigureCanvasBase Родительский холст фигуры для виджета. activebool Является ли виджет активным?

свойство cids

connect_event(event, callback)[исходный код]

Связывает функцию обратного вызова с событием.

Это следует использовать вместо figure.canvas.mpl_connect, поскольку эта функция хранит идентификаторы обратных вызовов для последующей очистки.

disconnect_events()[исходный код]

Отсоединить все события, созданные этим виджетом.

класс matplotlib.widgets.Button(ax, label, image=None, color='0.85', hovercolor='0.95')[исходный код]

Базы: matplotlib.widgets.AxesWidget

Кнопка в нейтральном для графического интерфейса стиле.

Для того чтобы кнопка оставалась отзывчивой, необходимо сохранить ссылку на неё. Вызовите on_clicked для подключения к кнопке.

Атрибуты:	ax Ось matplotlib.axes.Axes, на которой отображается кнопка. label Экземпляр matplotlib.text.Text. color Цвет кнопки при отсутствии наведения. hovercolor Цвет кнопки при наведении курсора.

...

класс matplotlib.widgets.CheckButtons(ax, labels, actives=None)[исходный код]

Базы: matplotlib.widgets.AxesWidget

Нейтральный по отношению к графическому интерфейсу набор флажков.

Чтобы флажки оставались отзывчивыми, вы должны сохранить ссылку на этот объект.

Подключитесь к CheckButtons с помощью метода on_clicked.

Атрибуты:	axAxes Оси родительского виджета. labelsсписок Text rectanglesсписок Rectangle linesсписок пар (Line2D, Line2D) Список линий для символов 'x' в флажках. Эти линии существуют для каждого поля, но имеют set_visible(False) значение, когда его поле не отмечено.

Добавить флажки в экземпляр matplotlib.axes.Axes ax.

Параметры:	axAxes Оси родительского виджета. labelsсписок str Метки флажков. activesсписок bool, необязательно Начальное состояние флажков. Список должен иметь такую же длину, как и labels. Если не указано, все флажки будут сняты.

свойство cnt

disconnect(cid)[исходный код]

Удалить наблюдателя с идентификатором соединения cid.

get_status()[исходный код]

Возвращает кортеж состояний (True/False) всех флажков.

свойство observers

on_clicked(func)[исходный код]

Подключить функцию обратного вызова func к событиям щелчка по кнопкам.

Возвращает идентификатор соединения, который можно использовать для отключения обратного вызова.

set_active(index)[исходный код]

Переключает (активирует или деактивирует) флажок по индексу.

Обратные вызовы будут вызваны, если eventson равно True.

Параметры:	indexint Индекс флажка, который нужно переключить.
Исключения:	ValueError Если index некорректен.

класс matplotlib.widgets.Cursor(ax, horizOn=True, vertOn=True, useblit=False, **lineprops)[исходный код]

Базы: matplotlib.widgets.AxesWidget

Перекрестие курсора, которое охватывает оси и перемещается вместе с курсором мыши.

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

Параметры:	axmatplotlib.axes.Axes Оси Axes, к которой прикреплен курсор. horizOnbool, по умолчанию: True Определяет, будет ли отображаться горизонтальная линия. vertOnbool, по умолчанию: True Определяет, будет ли отображаться вертикальная линия. useblitbool, по умолчанию: False Использовать кеширование для более быстрого отображения, если поддерживается бэкендом.
Другие параметры:	**lineprops Свойства Line2D, управляющие внешним видом линий. См. также axhline.

Примеры

См. Курсор.

clear(event)[исходный код]

Внутренний обработчик событий для очистки курсора.

onmove(event)[исходный код]

Внутренний обработчик событий для отображения курсора при перемещении мыши.

класс matplotlib.widgets.EllipseSelector(ax, onselect, drawtype='box', minspanx=0, minspany=0, useblit=False, lineprops=None, rectprops=None, spancoords='data', button=None, maxdist=10, marker_props=None, interactive=False, state_modifier_keys=None)[исходный код]

Базы: matplotlib.widgets.RectangleSelector

Выбор эллиптической области на оси.

Для сохранения отзывчивости курсора необходимо сохранить ссылку на него.

Пример использования:

import numpy as np
import matplotlib.pyplot as plt
from matplotlib.widgets import EllipseSelector

def onselect(eclick, erelease):
    "eclick and erelease are matplotlib events at press and release."
    print('startposition: (%f, %f)' % (eclick.xdata, eclick.ydata))
    print('endposition  : (%f, %f)' % (erelease.xdata, erelease.ydata))
    print('used button  : ', eclick.button)

def toggle_selector(event):
    print(' Key pressed.')
    if event.key in ['Q', 'q'] and toggle_selector.ES.active:
        print('EllipseSelector deactivated.')
        toggle_selector.RS.set_active(False)
    if event.key in ['A', 'a'] and not toggle_selector.ES.active:
        print('EllipseSelector activated.')
        toggle_selector.ES.set_active(True)

x = np.arange(100.) / 99
y = np.sin(x)
fig, ax = plt.subplots()
ax.plot(x, y)

toggle_selector.ES = EllipseSelector(ax, onselect, drawtype='line')
fig.canvas.mpl_connect('key_press_event', toggle_selector)
plt.show()

Параметры:

axAxes Родительская ось для виджета. onselectфункция Функция обратного вызова, которая вызывается после завершения выбора. Она должна иметь следующий синтаксис: def onselect(eclick: MouseEvent, erelease: MouseEvent) где eclick и erelease — события щелчка и отпускания мыши, начинающие и завершающие выбор. drawtype{"box", "line", "none"}, по умолчанию: "box" Определяет, нужно ли рисовать полную прямоугольную рамку, диагональную линию прямоугольника или ничего. minspanxfloat, по умолчанию: 0 Выбираемые области с шириной менее minspanx игнорируются. minspanyfloat, по умолчанию: 0 Выбираемые области с высотой менее minspany игнорируются. useblitbool, по умолчанию: False Использовать ли кеширование для более быстрого рисования (если поддерживается бэкендом). linepropsсловарь, необязательно Свойства, с помощью которых рисуется линия, если drawtype == "line". По умолчанию: dict(color="black", linestyle="-", linewidth=2, alpha=0.5) rectpropsсловарь, необязательно Свойства, с помощью которых рисуется прямоугольник, если drawtype == "box". По умолчанию: dict(facecolor="red", edgecolor="black", alpha=0.2, fill=True) spancoords{"data", "pixels"}, по умолчанию: "data" Определяет, интерпретировать ли minspanx и minspany в координатах данных или пикселей. buttonMouseButton, список MouseButton, по умолчанию: все кнопки Кнопки, которые вызывают выбор прямоугольника. maxdistfloat, по умолчанию: 10 Расстояние в пикселях, в пределах которого можно активировать интерактивные инструменты. marker_propsсловарь Свойства, с помощью которых рисуются интерактивные маркеры. В настоящее время не реализовано и игнорируется. interactivebool, по умолчанию: False Рисовать ли набор маркеров, которые позволяют взаимодействовать с виджетом после его отрисовки. state_modifier_keysсловарь, необязательно Модификаторы клавиатуры, которые влияют на поведение виджета. Значения изменяют значения по умолчанию. "move": Переместить существующую форму, по умолчанию: без модификатора. "clear": Очистить текущую форму, по умолчанию: "escape". "square": Сделать форму квадратной, по умолчанию: "shift". "center": Сделать начальную точку центром формы, по умолчанию: "ctrl". "square" и "center" можно комбинировать.

draw_shape(extents)[исходный код]

класс matplotlib.widgets.Lasso(ax, xy, callback=None, useblit=True)[исходный код]

Базы: matplotlib.widgets.AxesWidget

Кривая выбора произвольной формы.

Выбранная траектория может быть использована совместно с contains_point для выбора точек данных из изображения.

В отличие от LassoSelector, этот виджет должен быть инициализирован начальной точкой xy, и события виджета Lasso уничтожаются при отпускании.

Параметры:	axAxes Родительская ось для виджета. xy(float, float) Координаты начала лассо. callbackcallable Всякий раз, когда лассо отпускается, вызывается функция callback и передаются вершины выбранной траектории.

onmove(event)[исходный код]

onrelease(event)[исходный код]

класс matplotlib.widgets.LassoSelector(ax, onselect=None, useblit=True, lineprops=None, button=None)[исходный код]

Базы: matplotlib.widgets._SelectorWidget

Кривая выделения произвольной формы.

Чтобы селектор оставался отзывчивым, необходимо сохранить на него ссылку.

Выбранный путь можно использовать совместно с contains_point, чтобы выбрать точки данных на изображении.

В отличие от Lasso, LassoSelector написан с интерфейсом, похожим на RectangleSelector и SpanSelector, и будет продолжать взаимодействовать с осями до отключения.

Пример использования:

ax = plt.subplot()
ax.plot(x, y)

def onselect(verts):
    print(verts)
lasso = LassoSelector(ax, onselect)

Параметры:	axAxes Родительские оси для виджета. onselectфункция Когда отпускают лассо, функция onselect вызывается и получает вершины выбранного пути. buttonMouseButton или список MouseButton, необязательно Кнопки мыши, используемые для выбора прямоугольника. По умолчанию None, что соответствует всем кнопкам.

onpress(event)[исходный код]

onrelease(event)[исходный код]

класс matplotlib.widgets.LockDraw[исходный код]

Базы: object

Некоторые виджеты, такие как курсор, рисуют на холсте, что нежелательно во всех случаях, например, когда панель инструментов находится в режиме масштабирования по прямоугольнику и рисует прямоугольник. Чтобы избежать этого, виджет может получить блокировку холста с помощью canvas.widgetlock(widget) перед рисованием на холсте; это предотвратит рисование другими виджетами в одно и то же время (если они также попытаются получить блокировку первой).

available(o)[исходный код]

Возвращает, доступно ли рисование для o.

isowner(o)[исходный код]

Возвращает, владеет ли o этой блокировкой.

locked()[исходный код]

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

release(o)[исходный код]

Освободить блокировку от o.

класс matplotlib.widgets.MultiCursor(canvas, axes, useblit=True, horizOn=False, vertOn=True, **lineprops)[исходный код]

Базы: matplotlib.widgets.Widget

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

Чтобы курсор оставался отзывчивым, необходимо сохранить на него ссылку.

Пример использования:

from matplotlib.widgets import MultiCursor
import matplotlib.pyplot as plt
import numpy as np

fig, (ax1, ax2) = plt.subplots(nrows=2, sharex=True)
t = np.arange(0.0, 2.0, 0.01)
ax1.plot(t, np.sin(2*np.pi*t))
ax2.plot(t, np.sin(4*np.pi*t))

multi = MultiCursor(fig.canvas, (ax1, ax2), color='r', lw=1,
                    horizOn=False, vertOn=True)
plt.show()

clear(event)[исходный код]

Очистить курсор.

connect()[исходный код]

Подключить события.

disconnect()[исходный код]

Отключить события.

onmove(event)[исходный код]

класс matplotlib.widgets.PolygonSelector(ax, onselect, useblit=False, lineprops=None, markerprops=None, vertex_select_radius=15)[исходный код]

Основывается на matplotlib.widgets._SelectorWidget

Выбор области многоугольника на осях.

Поместите вершины щелчком мыши, а выбор сделайте, завершив многоугольник (щелкнув по первой вершине). Удерживая клавишу ctrl и щелкая и перетаскивая вершину, переместите её (клавиша ctrl не нужна, если многоугольник уже завершён). Удерживая клавишу shift и щелкая и перетаскивая в любом месте осей, переместите все вершины. Нажмите клавишу esc, чтобы начать новый многоугольник.

Чтобы селектор оставался отзывчивым, необходимо сохранить ссылку на него.

Параметры:

axAxes Родительские оси виджета. onselectфункция Когда многоугольник завершен или изменен после завершения, вызывается функция onselect и передаётся список вершин как (xdata, ydata) кортежи. useblitbool, по умолчанию: False linepropsсловарь, по умолчанию: dict(color='k', linestyle='-', linewidth=2, alpha=0.5). Свойства объекта для линии, представляющей края многоугольника. markerpropsсловарь, по умолчанию: dict(marker='o', markersize=7, mec='k', mfc='k', alpha=0.5). Свойства объекта для маркеров, нарисованных в вершинах многоугольника. vertex_select_radiusfloat, по умолчанию: 15 пикселей Вершина выбирается (для завершения многоугольника или перемещения вершины), если щелчок мыши находится в пределах vertex_select_radius пикселей от вершины.

Примеры

Выбор многоугольника

onmove(event)[исходный код]

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

свойство verts

Вершины многоугольника, как список (x, y) пар.

класс matplotlib.widgets.RadioButtons(ax, labels, active=0, activecolor='blue')[исходный код]

Основывается на matplotlib.widgets.AxesWidget

Радиокнопка, независимая от графического интерфейса.

Чтобы кнопки оставались отзывчивыми, необходимо сохранить ссылку на этот объект.

Подключитесь к RadioButtons с помощью метода on_clicked.

Атрибуты:	axAxes Родительские оси виджета. activecolorцвет Цвет выбранной кнопки. labelsсписок Text Метки кнопок. circlesсписок Circle Кнопки. value_selectedстрока Текст метки текущей выбранной кнопки.

Добавьте радиокнопки к Axes.

Параметры:	axAxes Оси, к которым нужно добавить кнопки. labelsсписок строк Метки кнопок. activeцелое число Индекс первоначально выбранной кнопки. activecolorцвет Цвет выбранной кнопки.

свойство cnt

disconnect(cid)[исходный код]

Удаление наблюдателя с идентификатором подключения cid.

свойство observers

on_clicked(func)[исходный код]

Подключение обратного вызова функции func к событиям нажатия на кнопки.

Возвращает идентификатор подключения, который можно использовать для отключения обратного вызова.

set_active(index)[исходный код]

Выберите кнопку с номером index.

Обратные вызовы будут вызваны, если eventson равно True.

класс matplotlib.widgets.RangeSlider(ax, label, valmin, valmax, valinit=None, valfmt=None, closedmin=True, closedmax=True, dragging=True, valstep=None, orientation='horizontal', **kwargs)[исходный код]

Базы: matplotlib.widgets.SliderBase

Ползунок, представляющий диапазон значений с плавающей точкой. Определяет минимальное и максимальное значения диапазона через атрибут val в виде кортежа (минимум, максимум).

Создаёт ползунок, определяющий диапазон, содержащийся в [valmin, valmax] в осях ax. Для того чтобы ползунок оставался отзывчивым, необходимо сохранить ссылку на него. Вызовите on_changed() для подключения к событию ползунка.

Атрибуты:	valкортеж float Значение ползунка.

Параметры:

axAxes Оси, в которые нужно поместить ползунок. labelstr Подпись ползунка. valminfloat Минимальное значение ползунка. valmaxfloat Максимальное значение ползунка. valinitкортеж float или None, по умолчанию: None Начальные позиции ползунка. Если None, начальные позиции будут в 25-м и 75-м процентилях диапазона. valfmtstr, по умолчанию: None Строка формата %-, используемая для форматирования значений ползунка. Если None, вместо неё используется ScalarFormatter. closedminbool, по умолчанию: True Является ли интервал ползунка закрытым снизу. closedmaxbool, по умолчанию: True Является ли интервал ползунка закрытым сверху. draggingbool, по умолчанию: True Если True, ползунок можно перетаскивать мышью. valstepfloat, по умолчанию: None Если задано, ползунок будет «прилипать» к кратным значениям valstep. orientation{'horizontal', 'vertical'}, по умолчанию: 'horizontal' Направление ползунка.

Примечания

Дополнительные параметры kwargs передаются в self.poly, который является Rectangle и рисует рукоятку ползунка. Допустимые имена свойств (facecolor, edgecolor, alpha и т. д.) см. в документации по Rectangle.

on_changed(func)[исходный код]

Подключить func в качестве функции обратного вызова при изменении значения ползунка.

Параметры:	funcвызываемая функция Функция, которая должна вызываться при изменении ползунка. Функция должна принимать в качестве аргумента массив numpy с формой (2,) .
Возвращает:	int Идентификатор соединения (который может быть использован для отключения func).

set_max(max)[исходный код]

Устанавливает нижнее значение ползунка на max.

Параметры:	maxfloat

set_min(min)[исходный код]

Устанавливает нижнее значение ползунка на min.

Параметры:	minfloat

set_val(val)[исходный код]

Устанавливает значение ползунка на val.

Параметры:	valкортеж или массивоподобный тип float

класс matplotlib.widgets.RectangleSelector(ax, onselect, drawtype='box', minspanx=0, minspany=0, useblit=False, lineprops=None, rectprops=None, spancoords='data', button=None, maxdist=10, marker_props=None, interactive=False, state_modifier_keys=None)[исходный код]

Базы: matplotlib.widgets._SelectorWidget

Выбор прямоугольной области на оси.

Для сохранения чувствительности курсора необходимо сохранить ссылку на него.

Примеры

Выбор прямоугольника

Параметры:

axAxes Родительская ось виджета. onselectфункция Функция обратного вызова, которая вызывается после завершения выбора. Она должна иметь сигнатуру: def onselect(eclick: MouseEvent, erelease: MouseEvent) где eclick и erelease — события клика и отпускания мыши MouseEvent, которые начинают и завершают выбор. drawtype{"box", "line", "none"}, по умолчанию: "box" Определяет, будет ли отображаться полная прямоугольная рамка, диагональная линия прямоугольника или вообще ничего. minspanxfloat, по умолчанию: 0 Выборы с размахом x менее minspanx игнорируются. minspanyfloat, по умолчанию: 0 Выборы с размахом y менее minspany игнорируются. useblitbool, по умолчанию: False Использовать ли блиттинг для ускорения отрисовки (если это поддерживается бэкендом). linepropsdict, необязательно Свойства, с помощью которых рисуется линия, если drawtype == "line". По умолчанию: dict(color="black", linestyle="-", linewidth=2, alpha=0.5) rectpropsdict, необязательно Свойства, с помощью которых рисуется прямоугольник, если drawtype == "box". По умолчанию: dict(facecolor="red", edgecolor="black", alpha=0.2, fill=True) spancoords{"data", "pixels"}, по умолчанию: "data" Определяет, интерпретировать ли minspanx и minspany в координатах данных или пикселей. buttonMouseButton, список MouseButton, по умолчанию: все кнопки Кнопка(и), которые вызывают выбор прямоугольника. maxdistfloat, по умолчанию: 10 Расстояние в пикселях, в пределах которого можно активировать интерактивные инструменты. marker_propsdict Свойства, с помощью которых рисуются интерактивные маркеры. В настоящее время не реализовано и игнорируется. interactivebool, по умолчанию: False Определяет, будет ли нарисован набор маркеров, позволяющих взаимодействовать с виджетом после его отрисовки. state_modifier_keysdict, необязательно Модификаторы клавиш, которые влияют на поведение виджета. Значения заменяют значения по умолчанию. "move": Перемещение существующей фигуры, по умолчанию: без модификатора. "clear": Очистка текущей фигуры, по умолчанию: "esc". "square": Делает фигуру квадратной, по умолчанию: "shift". "center": Делает начальную точку центром фигуры, по умолчанию: "ctrl". "square" и "center" можно комбинировать.

свойство center

Центр прямоугольника.

свойство corners

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

draw_shape(extents)[исходный код]

свойство edge_centers

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

свойство extents

Возвращает (xmin, xmax, ymin, ymax).

свойство geometry

Возвращает массив формы (2, 5), содержащий координаты x (RectangleSelector.geometry[1, :]) и y (RectangleSelector.geometry[0, :]) четырёх углов прямоугольника, начиная и заканчивая в верхнем левом углу.

класс matplotlib.widgets.Slider(ax, label, valmin, valmax, valinit=0.5, valfmt=None, closedmin=True, closedmax=True, slidermin=None, slidermax=None, dragging=True, valstep=None, orientation='horizontal', *, initcolor='r', **kwargs)[исходный код]

Основывается на matplotlib.widgets.SliderBase

Ползунок, представляющий диапазон с плавающей точкой.

Создаёт ползунок от valmin до valmax в осях ax. Для сохранения отзывчивости ползунка необходимо сохранить на него ссылку. Вызовите on_changed() для подключения к событию ползунка.

Атрибуты:	valfloat Значение ползунка.

Параметры:

axAxes Оси, в которых будет размещен ползунок. labelstr Метка ползунка. valminfloat Минимальное значение ползунка. valmaxfloat Максимальное значение ползунка. valinitfloat, по умолчанию: 0.5 Начальное положение ползунка. valfmtstr, по умолчанию: None Строка %-формата для форматирования значения ползунка. Если None, используется ScalarFormatter. closedminbool, по умолчанию: True Является ли интервал ползунка закрытым снизу. closedmaxbool, по умолчанию: True Является ли интервал ползунка закрытым сверху. sliderminSlider, по умолчанию: None Не допускать, чтобы значение текущего ползунка было меньше значения ползунка slidermin. slidermaxSlider, по умолчанию: None Не допускать, чтобы значение текущего ползунка было больше значения ползунка slidermax. draggingbool, по умолчанию: True Если True, ползунок можно перетаскивать мышью. valstepfloat или массив, по умолчанию: None Если задано значение float, ползунок будет привязываться к кратным valstep. Если задан массив, ползунок будет привязываться к значениям в массиве. orientation{'horizontal', 'vertical'}, по умолчанию: 'horizontal' Ориентация ползунка. initcolorцвет, по умолчанию: 'r' Цвет линии в позиции valinit. Установите в 'none', чтобы скрыть линию.

Примечания

Дополнительные параметры kwargs передаются в self.poly, который является Rectangle, рисующим рычаг ползунка. Обратитесь к документации Rectangle, чтобы увидеть допустимые имена свойств (facecolor, edgecolor, alpha и т. д.).

свойство cnt

свойство observers

on_changed(func)[исходный код]

Подключить func в качестве функции обратного вызова при изменении значения ползунка.

Параметры:	funcвызываемый объект Функция, которая вызывается при изменении ползунка. Функция должна принимать единственное значение с плавающей точкой в качестве аргумента.
Возвращает:	int Идентификатор подключения (который может использоваться для отключения func).

set_val(val)[исходный код]

Установить значение ползунка равным val.

Параметры:	valfloat

класс matplotlib.widgets.SliderBase(ax, orientation, closedmin, closedmax, valmin, valmax, valfmt, dragging, valstep)[исходный код]

Основывается на matplotlib.widgets.AxesWidget

Базовый класс для создания виджетов-ползунков. Не предназначен для прямого использования.

Для сохранения отзывчивости ползунка необходимо сохранить на него ссылку.

disconnect(cid)[исходный код]

Удалить наблюдателя с идентификатором подключения cid.

Параметры:	cidint Идентификатор подключения наблюдателя, которого нужно удалить.

reset()[исходный код]

Сбросить ползунок до начального значения.

класс matplotlib.widgets.SpanSelector(ax, onselect, direction, minspan=None, useblit=False, rectprops=None, onmove_callback=None, span_stays=False, button=None)[исходный код]

Базы: matplotlib.widgets._SelectorWidget

Визуально выбирает диапазон min/max на одной оси и вызывает функцию с этими значениями.

Для обеспечения отзывчивости селектора сохраняйте ссылку на него.

Чтобы отключить SpanSelector, установите span_selector.active в False. Чтобы снова включить его, установите это значение в True.

Параметры:

axmatplotlib.axes.Axes onselectfunc(min, max), min/max — числа с плавающей точкой direction{"horizontal", "vertical"} Направление выбора диапазона. minspanчисло с плавающей точкой, по умолчанию: None Если выбранный диапазон меньше minspan, функция onselect не вызывается. useblitbool, по умолчанию: False Если True, используйте функции блиттинга (зависящие от бэкенда) для более быстрого обновления холста. rectpropsсловарь, по умолчанию: None Словарь свойств matplotlib.patches.Patch. onmove_callbackfunc(min, max), min/max — числа с плавающей точкой, по умолчанию: None Вызывается при перемещении мыши во время выбора диапазона. span_staysbool, по умолчанию: False Если True, диапазон остается видимым после отпускания кнопки мыши. buttonMouseButton или список MouseButton Кнопки мыши, которые активируют SpanSelector.

Примеры

>>> import matplotlib.pyplot as plt
>>> import matplotlib.widgets as mwidgets
>>> fig, ax = plt.subplots()
>>> ax.plot([1, 2, 3], [10, 50, 100])
>>> def onselect(vmin, vmax):
...     print(vmin, vmax)
>>> rectprops = dict(facecolor='blue', alpha=0.5)
>>> span = mwidgets.SpanSelector(ax, onselect, 'horizontal',
...                              rectprops=rectprops)
>>> fig.show()

См. также: Селектор диапазона

ignore(event)[исходный код]

Возвращает, следует ли игнорировать event.

Этот метод следует вызывать в начале любого обработчика событий.

new_axes(ax)[исходный код]

Настраивает SpanSelector для работы с новой осью.

класс matplotlib.widgets.SubplotTool(targetfig, toolfig)[исходный код]

Базы: matplotlib.widgets.Widget

Инструмент для изменения параметров подграфиков в matplotlib.figure.Figure.

Параметры:	targetfigFigure Экземпляр фигуры, которую нужно изменить. toolfigFigure Экземпляр фигуры, в который встраивается инструмент подграфиков.

свойство axbottom

свойство axhspace

свойство axleft

свойство axright

свойство axtop

свойство axwspace

funcbottom(val)[исходный код]

[Устарело]

Замечания

Устарело начиная с версии 3.3:

funchspace(val)[исходный код]

[Устарело]

Замечания

Устарело начиная с версии 3.3:

funcleft(val)[исходный код]

[Устарело]

Замечания

Устарело начиная с версии 3.3:

funcright(val)[исходный код]

[Устарело]

Замечания

Устарело начиная с версии 3.3:

functop(val)[исходный код]

[Устарело]

Замечания

Устарело начиная с версии 3.3:

funcwspace(val)[исходный код]

[Устарело]

Замечания

Устарело начиная с версии 3.3:

класс matplotlib.widgets.TextBox(ax, label, initial='', color='.95', hovercolor='1', label_pad=0.01)[исходный код]

Базы: matplotlib.widgets.AxesWidget

Ввод текста в графическом интерфейсе.

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

Вызовите on_text_change для обновления при изменении текста.

Вызовите on_submit для обновления при нажатии Enter или выходе из поля ввода текста.

Атрибуты:	axAxes Родительские оси виджета. labelText colorцвет Цвет текстового поля при отсутствии наведения курсора. hovercolorцвет Цвет текстового поля при наведении курсора.

Параметры:	axAxes Экземпляр Axes, в который будет помещён элемент управления. labelstr Метка для данного поля ввода текста. initialstr Начальное значение в текстовом поле. colorцвет Цвет поля. hovercolorцвет Цвет поля при наведении курсора. label_padfloat Расстояние между меткой и правой стороной поля ввода текста.

begin_typing(x)[исходный код]

свойство change_observers

свойство cnt

disconnect(cid)[исходный код]

Удаление наблюдателя с идентификатором соединения cid.

on_submit(func)[исходный код]

При нажатии Enter или выходе из поля ввода, вызывается func с событием.

Возвращается идентификатор соединения, который может быть использован для отключения.

on_text_change(func)[исходный код]

При изменении текста, вызывается func с событием.

Возвращается идентификатор соединения, который может быть использован для отключения.

свойство params_to_disable

position_cursor(x)[исходный код]

set_val(val)[исходный код]

stop_typing()[исходный код]

свойство submit_observers

свойство text

класс matplotlib.widgets.ToolHandles(ax, x, y, marker='o', marker_props=None, useblit=True)[исходный код]

Базы: object

Управляющие элементы для инструментов.

Параметры:	axmatplotlib.axes.Axes Оси Matplotlib, где отображаются управляющие элементы инструментов. x, yодномерные массивы Координаты управляющих элементов. markerstr Форма маркера, используемого для отображения элемента управления. Смотрите matplotlib.pyplot.plot. marker_propsdict Дополнительные свойства маркера. Смотрите matplotlib.lines.Line2D.

closest(x, y)[исходный код]

Возвращает индекс и пиксельное расстояние до ближайшего индекса.

set_animated(val)[исходный код]

set_data(pts, y=None)[исходный код]

Устанавливает координаты x и y элементов управления.

set_visible(val)[исходный код]

свойство x

свойство y

класс matplotlib.widgets.Widget[исходный код]

Базы: object

Абстрактный базовый класс для виджетов, не зависящих от графического интерфейса.

свойство active

Является ли виджет активным?

drawon = True

eventson = True

get_active()[исходный код]

Получить, активен ли виджет.

ignore(event)[исходный код]

Возвращает, следует ли игнорировать event.

Этот метод следует вызывать в начале любого обработчика событий.

set_active(active)[исходный код]

Установить, активен ли виджет.