matplotlib.widgets

GUI-нейтральные виджеты

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

class matplotlib.widgets.AxesWidget(ax) [source]

Базовые классы: matplotlib.widgets.Widget

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

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

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

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

connect_event(self, event, callback) [source]

Подключить обратный вызов к событию.

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

disconnect_events(self) [source]: Отключить все события, созданные этим виджетом.

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

Базовые классы: matplotlib.widgets.AxesWidget

GUI-нейтральная кнопка.

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

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

Параметры:

Параметры:	`axAxes` Экземпляр `Axes`, в который будет помещена кнопка. `labelstr` Текст кнопки. Принимает строку. `imagearray-like or PIL image` Изображение для размещения на кнопке, если не None. Поддерживаемые входные данные аналогичны входным данным для `Axes.imshow`. `colorcolor` Цвет кнопки в неактивном состоянии. `hovercolorcolor` Цвет кнопки при наведении на нее.

axAxes: Экземпляр Axes, в который будет помещена кнопка.
labelstr: Текст кнопки. Принимает строку.
imagearray-like or PIL image: Изображение для размещения на кнопке, если не None. Поддерживаемые входные данные аналогичны входным данным для Axes.imshow.
colorcolor: Цвет кнопки в неактивном состоянии.
hovercolorcolor: Цвет кнопки при наведении на нее.

disconnect(self, cid) [source]: Удалить функцию обратного вызова с идентификатором соединения cid.

on_clicked(self, func) [source]

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

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

class matplotlib.widgets.CheckButtons(ax, labels, actives=None) [source]

Базовые классы: matplotlib.widgets.AxesWidget

GUI-нейтральный набор флажков.

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

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

Атрибуты:

Атрибуты:	ax `matplotlib.axes.Axes` для размещения кнопок. labels Список `matplotlib.text.Text`. lines Список кортежей (line1, line2) для x в флажках. Эти линии существуют для каждой коробки, но имеют `set_visible(False)` когда коробка не выбрана. rectangles Список `matplotlib.patches.Rectangle`.

ax: matplotlib.axes.Axes для размещения кнопок.
labels: Список matplotlib.text.Text.
lines: Список кортежей (line1, line2) для x в флажках. Эти линии существуют для каждой коробки, но имеют set_visible(False) когда коробка не выбрана.
rectangles: Список matplotlib.patches.Rectangle.

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

Параметры:	`axAxes` Родительский Axes для виджета. `labelslist of str` Метки флажков. `activeslist of bool, optional` Начальное состояние включения кнопок. Список должен иметь такую же длину, как и labels. Если не указано, все кнопки отключены.

disconnect(self, cid) [source]: Удалить наблюдателя с идентификатором соединения cid

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

on_clicked(self, func) [source]

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

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

set_active(self, index) [source]

Непосредственно активировать/деактивировать флажок по индексу.

index — индекс в исходном списке меток, с которым был создан этот объект. ValueError генерируется, если index недействителен.: Обратные вызовы будут вызваны, если eventson равно True.

END_OF_DOCUMENT_MARKER ```

class matplotlib.widgets.Cursor(ax, horizOn=True, vertOn=True, useblit=False, **lineprops) [source]

Базы: matplotlib.widgets.AxesWidget

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

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

Параметры:

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

axmatplotlib.axes.Axes: Axes для прикрепления курсора.
horizOnbool, optional, default: True: Рисовать ли горизонтальную линию.
vertOnbool, optional, default: True: Рисовать ли вертикальную линию.
useblitbool, optional, default: False: Использовать blitting для более быстрого рисования, если это поддерживается бэкендом.

Другие параметры:

**lineprops: Line2D свойства, управляющие внешним видом линий. См. также axhline.

Примеры

См. Курсор.

clear(self, event) [source]: Внутренний обработчик событий для очистки курсора.

onmove(self, event) [source]: Внутренний обработчик событий для рисования курсора при перемещении мыши.

class matplotlib.widgets.EllipseSelector(ax, onselect, drawtype='box', minspanx=None, minspany=None, useblit=False, lineprops=None, rectprops=None, spancoords='data', button=None, maxdist=10, marker_props=None, interactive=False, state_modifier_keys=None) [source]

Базы: 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()

Создайте селектор в ax. Когда выделение выполнено, очистите область и вызовите onselect с:

onselect(pos_1, pos_2)

и очистите нарисованный прямоугольник/линию. pos_1 и pos_2 — массивы длиной 2, содержащие x- и y-координаты.

Если minspanx не None, события, меньшие, чем minspanx по оси x, игнорируются (то же самое для оси y).

Прямоугольник рисуется с rectprops; по умолчанию:

rectprops = dict(facecolor='red', edgecolor = 'black',
                 alpha=0.2, fill=True)

Линия рисуется с lineprops; по умолчанию:

lineprops = dict(color='black', linestyle='-',
                 linewidth = 2, alpha=0.5)

Используйте drawtype, если вы хотите, чтобы мышь рисовала линию, прямоугольник или ничего между нажатием и текущим положением, установив

drawtype = 'line', drawtype='box' или drawtype = 'none'. Рисование линии приведет к линии от вершины A до вершины C в прямоугольнике ABCD.

spancoords может быть 'data' или 'pixels'. Если 'data', minspanx и minspanx будут интерпретироваться в тех же координатах, что и оси x и y. Если 'pixels', они в пикселях.

button — список целых чисел, указывающий, какие кнопки мыши должны использоваться для выбора прямоугольника. Вы также можете указать одно целое число, если требуется только одна кнопка. По умолчанию — None, что не ограничивает используемую кнопку.

Примечание, обычно:: 1 = левая кнопка мыши 2 = центральная кнопка мыши (колесо прокрутки) 3 = правая кнопка мыши

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

state_modifier_keys — это модификаторы клавиш, влияющие на поведение виджета.

Значения по умолчанию: dict(move=' ', clear='escape', square='shift', center='ctrl')

Модификаторы клавиш, которые: 'move': Переместить существующую фигуру. 'clear': Очистить текущую фигуру. 'square': Сделать фигуру квадратной. 'center': Сделать начальную точку центром фигуры. 'square' и 'center' можно комбинировать.

draw_shape(self, extents) [source]

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

Базы: matplotlib.widgets.AxesWidget

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

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

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

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

onmove(self, event) [source]

onrelease(self, event) [source]

class matplotlib.widgets.LassoSelector(ax, onselect=None, useblit=True, lineprops=None, button=None) [source]

Базы: matplotlib.widgets._SelectorWidget

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

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

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

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

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

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

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

Параметры:

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

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

onpress(self, event) [source]

onrelease(self, event) [source]

END_OF_DOCUMENT_MARKER

class matplotlib.widgets.LockDraw [source]

Базовые классы: object

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

available(self, o) [source]: Возвращает, доступно ли рисование для o.

isowner(self, o) [source]: Возвращает, владеет ли o этой блокировкой.

locked(self) [source]: Возвращает, заблокирована ли блокировка в данный момент владельцем.

release(self, o) [source]: Освободить блокировку от o.

class 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(self, event) [source]: Очистить курсор

connect(self) [source]: Подключить события

disconnect(self) [source]: Отключить события

onmove(self, event) [source]

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

Базовые классы: matplotlib.widgets._SelectorWidget

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

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

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

Параметры:

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

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

Примеры

Демонстрация селектора многоугольника

onmove(self, event) [source]: Обработчик событий перемещения курсора и валидатор

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

class matplotlib.widgets.RadioButtons(ax, labels, active=0, activecolor='blue') [source]

Базовые классы: matplotlib.widgets.AxesWidget

Радиокнопка нейтральная для GUI.

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

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

Атрибуты:

Атрибуты:	ax Экземпляр `Axes` содержащий виджет. activecolor Цвет выделенной кнопки. labels Список экземпляров `Text` с метками кнопок. circles Список экземпляров `Circle` , определяющих кнопки. `value_selectedstr` Текст метки текущей выделенной кнопки.

ax: Экземпляр Axes содержащий виджет.
activecolor: Цвет выделенной кнопки.
labels: Список экземпляров Text с метками кнопок.
circles: Список экземпляров Circle , определяющих кнопки.
value_selectedstr: Текст метки текущей выделенной кнопки.

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

Параметры:	`axAxes` Оси для добавления кнопок. `labelslist of str` Метки кнопок. `activeint` Индекс выбранной по умолчанию кнопки. `activecolorcolor` Цвет выделенной кнопки.

disconnect(self, cid) [source]: Удалить наблюдателя с идентификатором соединения cid.

on_clicked(self, func) [source]

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

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

set_active(self, index) [source]

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

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

class matplotlib.widgets.RectangleSelector(ax, onselect, drawtype='box', minspanx=None, minspany=None, 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

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

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

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

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

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.RS.active:
        print('RectangleSelector deactivated.')
        toggle_selector.RS.set_active(False)
    if event.key in ['A', 'a'] and not toggle_selector.RS.active:
        print('RectangleSelector activated.')
        toggle_selector.RS.set_active(True)

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

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

Создайте селектор в ax. Когда выделение выполнено, очистите область и вызовите onselect с:

onselect(pos_1, pos_2)

и очистите нарисованный прямоугольник/линию. pos_1 и pos_2 — массивы длиной 2, содержащие координаты x и y.

Если minspanx не равно None, события с размером меньше minspanx по оси x игнорируются (то же самое для оси y).

Прямоугольник рисуется с помощью rectprops; по умолчанию:

rectprops = dict(facecolor='red', edgecolor = 'black',
                 alpha=0.2, fill=True)

Линия рисуется с помощью lineprops; по умолчанию:

lineprops = dict(color='black', linestyle='-',
                 linewidth = 2, alpha=0.5)

Используйте drawtype, если вы хотите, чтобы мышь рисовала линию, прямоугольник или ничего между щелчком и фактическим положением, установив

drawtype = 'line', drawtype='box' или drawtype = 'none'. Рисование линии будет результатом линии от вершины A к вершине C в прямоугольнике ABCD.

spancoords может быть 'data' или 'pixels'. Если 'data', minspanx и minspanx будут интерпретированы в тех же координатах, что и оси x и y. Если 'pixels', они находятся в пикселях.

button — список целых чисел, указывающих, какие кнопки мыши следует использовать для выделения прямоугольника. Также можно указать единственное целое число, если требуется только одна кнопка. По умолчанию — None, что не ограничивает использование кнопок.

Примечание, обычно:: 1 = левая кнопка мыши 2 = средняя кнопка мыши (колесо прокрутки) 3 = правая кнопка мыши

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

state_modifier_keys — это модификаторы клавиш, которые влияют на поведение виджета.

Значения по умолчанию: dict(move=' ', clear='escape', square='shift', center='ctrl')

Модификаторы клавиш:

'move': Перемещение существующей формы. 'clear': Очистка текущей формы. 'square': Делает форму квадратной. 'center': Делает начальную точку центром формы. 'square' и 'center' могут быть объединены.

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

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

draw_shape(self, extents) [source]

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

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

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

class matplotlib.widgets.Slider(ax, label, valmin, valmax, valinit=0.5, valfmt='%1.2f', closedmin=True, closedmax=True, slidermin=None, slidermax=None, dragging=True, valstep=None, orientation='horizontal', **kwargs) [source]

Основы: matplotlib.widgets.AxesWidget

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

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

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

Параметры:

Параметры:	`axAxes` Оси, в которые помещается ползунок. `labelstr` Метка ползунка. `valminfloat` Минимальное значение ползунка. `valmaxfloat` Максимальное значение ползунка. `valinitfloat, optional, default: 0.5` Начальное положение ползунка. `valfmtstr, optional, default: "%1.2f"` Используется для форматирования значения ползунка, строка формата fprint. `closedminbool, optional, default: True` Интервал ползунка закрыт слева. `closedmaxbool, optional, default: True` Интервал ползунка закрыт справа. `sliderminSlider, optional, default: None` Не разрешает текущему ползунку иметь значение меньше значения ползунка `slidermin`. `slidermaxSlider, optional, default: None` Не разрешает текущему ползунку иметь значение больше значения ползунка `slidermax`. `draggingbool, optional, default: True` Если True, ползунок может быть перетащен мышью. `valstepfloat, optional, default: None` Если указано, ползунок будет фиксироваться на кратных значениях `valstep`. `orientation{'horizontal', 'vertical'}, default: 'horizontal'` Ориентация ползунка.

axAxes: Оси, в которые помещается ползунок.
labelstr: Метка ползунка.
valminfloat: Минимальное значение ползунка.
valmaxfloat: Максимальное значение ползунка.
valinitfloat, optional, default: 0.5: Начальное положение ползунка.
valfmtstr, optional, default: "%1.2f": Используется для форматирования значения ползунка, строка формата fprint.
closedminbool, optional, default: True: Интервал ползунка закрыт слева.
closedmaxbool, optional, default: True: Интервал ползунка закрыт справа.
sliderminSlider, optional, default: None: Не разрешает текущему ползунку иметь значение меньше значения ползунка slidermin.
slidermaxSlider, optional, default: None: Не разрешает текущему ползунку иметь значение больше значения ползунка slidermax.
draggingbool, optional, default: True: Если True, ползунок может быть перетащен мышью.
valstepfloat, optional, default: None: Если указано, ползунок будет фиксироваться на кратных значениях valstep.
orientation{'horizontal', 'vertical'}, default: 'horizontal': Ориентация ползунка.

Примечания

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

disconnect(self, cid) [source]

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

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

on_changed(self, func) [source]

При изменении значения ползунка вызовите func с новым значением ползунка

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

reset(self) [source]: Сбросить ползунок до начального значения

set_val(self, val) [source]

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

Параметры:	`valfloat`

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

Bases: matplotlib.widgets._SelectorWidget

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

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

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

Параметры:

Параметры:	`axmatplotlib.axes.Axes object` `onselectfunc(min, max), min/max are floats` `direction{"horizontal", "vertical"}` Направление, по которому нужно рисовать селектор диапазона. `minspanfloat, default is None` Если выбор меньше, чем minspan, не вызывать onselect. `useblitbool, default is False` Если True, используйте функции блиттинга, зависящие от бэкенда, для более быстрых обновлений холста. `rectpropsdict, default is None` Словарь свойств `matplotlib.patches.Patch`. `onmove_callbackfunc(min, max), min/max are floats, default is None` Вызывается при перемещении мыши, пока выбирается диапазон. `span_staysbool, default is False` Если True, диапазон остаётся видимым после отпускания мыши. `buttonMouseButton or list of MouseButton` Кнопки мыши, которые активируют селектор диапазона.

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

Примеры

>>> 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()

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

property buttonDown

ignore(self, event) [source]

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

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

new_axes(self, ax) [source]: Устанавливает SpanSelector для работы с новыми осями.

class matplotlib.widgets.SubplotTool(targetfig, toolfig) [source]

Bases: matplotlib.widgets.Widget

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

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

funcbottom(self, val) [source]

funchspace(self, val) [source]

funcleft(self, val) [source]

funcright(self, val) [source]

functop(self, val) [source]

funcwspace(self, val) [source]

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

Bases: matplotlib.widgets.AxesWidget

Ввод текста с независимым от GUI интерфейсом.

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

Вызовите on_text_change(), чтобы обновить его при изменении текста.

Вызовите on_submit(), чтобы обновить его при нажатии клавиши Enter или при выходе из поля ввода текста.

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

Параметры:

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

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

begin_typing(self, x) [source]

disconnect(self, cid) [source]: Удаляет наблюдателя с идентификатором соединения cid.

on_submit(self, func) [source]

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

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

on_text_change(self, func) [source]

При изменении текста, вызовите эту функцию func со значением события.

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

position_cursor(self, x) [source]

set_val(self, val) [source]

stop_typing(self) [source]

END_OF_DOCUMENT_MARKER

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

Bases: object

Обработчики инструментов для холста.

Параметры:

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

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

closest(self, x, y) [source]: Возвращает индекс и пиксельное расстояние до ближайшего индекса.

set_animated(self, val) [source]

set_data(self, pts, y=None) [source]: Устанавливает x и y координаты обработчиков.

set_visible(self, val) [source]

property x

property y

class matplotlib.widgets.Widget [source]

Bases: object

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

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

drawon = True

eventson = True

get_active(self) [source]: Получить, является ли виджет активным.

ignore(self, event) [source]

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

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

set_active(self, active) [source]: Установить, является ли виджет активным.