matplotlib.widgets

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

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

класс matplotlib.widgets.AxesWidget(ax)[source]

Базы: matplotlib.widgets.Widget

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

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

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

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

свойство cids

connect_event(event, callback)[source]

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

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

disconnect_events()[source]

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

класс matplotlib.widgets.Button(ax, label, image=None, color='0.85', hovercolor='0.95')[source]

Базы: matplotlib.widgets.AxesWidget

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

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

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

...

класс matplotlib.widgets.CheckButtons(ax, labels, actives=None)[source]

Базы: 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)[source]

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

get_status()[source]

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

свойство observers

on_clicked(func)[source]

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

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

set_active(index)[source]

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

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

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

класс matplotlib.widgets.Cursor(ax, horizOn=True, vertOn=True, useblit=False, **lineprops)[source]

Базы: matplotlib.widgets.AxesWidget

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

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

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

Примеры

См. Cursor.

clear(event)[source]

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

onmove(event)[source]

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

class 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)[source]

Bases: 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)[source]

class matplotlib.widgets.Lasso(ax, xy, callback=None, useblit=True)[source]

Bases: matplotlib.widgets.AxesWidget

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

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

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

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

onmove(event)[source]

onrelease(event)[source]

класс matplotlib.widgets.LassoSelector(ax, onselect=None, useblit=True, lineprops=None, button=None)[source]

Базы: 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функция Когда lasso отпускается, функция onselect вызывается и получает вершины выбранного пути. buttonMouseButton или список MouseButton, необязательно Кнопки мыши, используемые для выбора прямоугольника. По умолчанию None, что соответствует всем кнопкам.

onpress(event)[source]

onrelease(event)[source]

класс matplotlib.widgets.LockDraw[source]

Базы: object

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

available(o)[source]

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

isowner(o)[source]

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

locked()[source]

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

release(o)[source]

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

класс matplotlib.widgets.MultiCursor(canvas, axes, useblit=True, horizOn=False, vertOn=True, **lineprops)[source]

Базы: 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)[source]

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

connect()[source]

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

disconnect()[source]

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

onmove(event)[source]

класс matplotlib.widgets.PolygonSelector(ax, onselect, useblit=False, lineprops=None, markerprops=None, vertex_select_radius=15)[source]

Основывается на 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)[source]

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

свойство verts

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

класс matplotlib.widgets.RadioButtons(ax, labels, active=0, activecolor='blue')[source]

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

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

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

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

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

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

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

свойство cnt

disconnect(cid)[source]

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

свойство observers

on_clicked(func)[source]

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

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

set_active(index)[source]

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

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

class matplotlib.widgets.RangeSlider(ax, label, valmin, valmax, valinit=None, valfmt=None, closedmin=True, closedmax=True, dragging=True, valstep=None, orientation='horizontal', **kwargs)[source]

Bases: 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, который рисует рукоятку ползунка. См. документацию по Rectangle для допустимых имён свойств (facecolor, edgecolor, alpha, и т.д.).

on_changed(func)[source]

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

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

set_max(max)[source]

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

Параметры:	maxfloat

set_min(min)[source]

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

Параметры:	minfloat

set_val(val)[source]

Устанавливает значение ползунка на 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)[source]

Базы: 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 Использовать ли blitting для ускорения отрисовки (если это поддерживается бэкендом). 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)[source]

свойство 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)[source]

Основывается на 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)[source]

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

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

set_val(val)[source]

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

Параметры:	valfloat

класс matplotlib.widgets.SliderBase(ax, orientation, closedmin, closedmax, valmin, valmax, valfmt, dragging, valstep)[source]

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

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

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

disconnect(cid)[source]

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

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

reset()[source]

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

класс matplotlib.widgets.SpanSelector(ax, onselect, direction, minspan=None, useblit=False, rectprops=None, onmove_callback=None, span_stays=False, button=None)[source]

Базы: 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, используйте функции блиттинга (backend-зависимые) для более быстрого обновления холста. 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()

См. также: Span Selector

ignore(event)[source]

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

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

new_axes(ax)[source]

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

класс matplotlib.widgets.SubplotTool(targetfig, toolfig)[source]

Базы: matplotlib.widgets.Widget

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

Параметры:	targetfigFigure Экземпляр фигуры для изменения. toolfigFigure Экземпляр фигуры для встраивания инструмента subplot.

свойство axbottom

свойство axhspace

свойство axleft

свойство axright

свойство axtop

свойство axwspace

funcbottom(val)[source]

[Устарело]

Замечания

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

funchspace(val)[source]

[Устарело]

Замечания

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

funcleft(val)[source]

[Устарело]

Замечания

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

funcright(val)[source]

[Устарело]

Замечания

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

functop(val)[source]

[Устарело]

Замечания

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

funcwspace(val)[source]

[Устарело]

Замечания

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

класс matplotlib.widgets.TextBox(ax, label, initial='', color='.95', hovercolor='1', label_pad=0.01)[source]

Базы: matplotlib.widgets.AxesWidget

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

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

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

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

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

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

begin_typing(x)[source]

свойство change_observers

свойство cnt

disconnect(cid)[source]

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

on_submit(func)[source]

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

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

on_text_change(func)[source]

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

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

свойство params_to_disable

position_cursor(x)[source]

set_val(val)[source]

stop_typing()[source]

свойство submit_observers

свойство text

класс matplotlib.widgets.ToolHandles(ax, x, y, marker='o', marker_props=None, useblit=True)[source]

Базы: object

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

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

closest(x, y)[source]

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

set_animated(val)[source]

set_data(pts, y=None)[source]

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

set_visible(val)[source]

свойство x

свойство y

class matplotlib.widgets.Widget[source]

Bases: object

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

свойство active

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

drawon = True

eventson = True

get_active()[source]

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

ignore(event)[source]

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

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

set_active(active)[source]

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